sunau --- 读写 Sun AU 文件¶
源代码: Lib/sunau.py
sunau 模拟提供了一个处理 Sun AU 声音格式的便利接口。请注意此模块与 aifc 和 wave 是兼容接口的。
音频文件由标头和数据组成。标头的字段为：
域 |
目录 |
|---|---|
magic word |
四个字节 |
header size |
标头的大小，包括信息，以字节为单位。 |
data size |
数据的物理大小，以字节为单位。 |
编码 |
指示音频样本的编码方式。 |
sample rate |
采样率 |
# of channels |
采样中的通道数。 |
info |
提供音频文件描述的ASCII字符串（用空字节填充）。 |
除了 info 字段，所有标头字段的大小都是 4 字节。 它们都是采用大端字节序编码的 32 位无符号整数。
sunau 模块定义了以下函数:
-
sunau.open(file, mode)¶ 如果 file 是一个字符串，打开相应名称的文件，否则就把它作为可定位的文件类对象来处理。 mode 可以是
'r'只读模式。
'w'只写模式。
注意它不支持同时读/写文件。
mode 为
'r'时返回一个AU_read对象，而 mode 为'w'或'wb'时返回一个AU_write对象。
-
sunau.openfp(file, mode)¶ 同
open()，用于向后兼容。Deprecated since version 3.7, will be removed in version 3.9.
sunau 模块定义了以下异常:
-
exception
sunau.Error¶ 当 Sun AU 规范或实现的低效导致无法操作时引发的错误。
sunau 模块定义了以下数据条目:
-
sunau.AUDIO_FILE_MAGIC¶ 位于每个有效的 Sun AU 文件开头的整数，以大端序形式存储。 这是一个被当作整数来解读的字符串
.snd。
-
sunau.AUDIO_FILE_ENCODING_MULAW_8¶ -
sunau.AUDIO_FILE_ENCODING_LINEAR_8¶ -
sunau.AUDIO_FILE_ENCODING_LINEAR_16¶ -
sunau.AUDIO_FILE_ENCODING_LINEAR_24¶ -
sunau.AUDIO_FILE_ENCODING_LINEAR_32¶ -
sunau.AUDIO_FILE_ENCODING_ALAW_8¶ AU 标头中被此模块所支持的 encoding 字段值。
-
sunau.AUDIO_FILE_ENCODING_FLOAT¶ -
sunau.AUDIO_FILE_ENCODING_DOUBLE¶ -
sunau.AUDIO_FILE_ENCODING_ADPCM_G721¶ -
sunau.AUDIO_FILE_ENCODING_ADPCM_G722¶ -
sunau.AUDIO_FILE_ENCODING_ADPCM_G723_3¶ -
sunau.AUDIO_FILE_ENCODING_ADPCM_G723_5¶ AU 标头中附加的已知但不被此模块所支持的 encoding 字段值。
AU_read 对象¶
由上面的 open() 所返回的 AU_read 对象具有以下几种方法:
-
AU_read.close()¶ 关闭流，并使实例不可用。 （此方法会在删除对象时自动调用。）
-
AU_read.getnchannels()¶ 返回音频的通道数（单声道为 1，立体声为 2）。
-
AU_read.getsampwidth()¶ 返回采样字节长度。
-
AU_read.getframerate()¶ 返回采样频率。
-
AU_read.getnframes()¶ 返回音频总帧数。
-
AU_read.getcomptype()¶ 返回压缩类型。 受支持的压缩类型有
'ULAW','ALAW'和'NONE'。
-
AU_read.getcompname()¶ getcomptype()的人类可读的版本。 受支持的类型将为相应的名称'CCITT G.711 u-law','CCITT G.711 A-law'和'not compressed'。
-
AU_read.getparams()¶ 返回一个
namedtuple()(nchannels, sampwidth, framerate, nframes, comptype, compname)，与get*()方法的输出相同。
-
AU_read.rewind()¶ 重置文件指针至音频开头.
以下两个方法都使用指针，具体实现由其底层决定。
-
AU_read.tell()¶ 返回当前文件指针的位置。 请注意该返回值与文件中的实例位置无关。
以下两个函数是为了与 aifc 保持兼容而定义的，实际不做任何事件。
-
AU_read.getmarkers()¶ 返回
None。
-
AU_read.getmark(id)¶ 引发错误异常。
AU_write 对象¶
由上面的 open() 所返回的 AU_write 对象具有以下几种方法:
-
AU_write.setnchannels(n)¶ 设置声道数。
-
AU_write.setsampwidth(n)¶ 设置采样宽度（字节长度。）
在 3.4 版更改: 增加了对 24 位采样的支持。
-
AU_write.setframerate(n)¶ 设置帧速率。
-
AU_write.setnframes(n)¶ 设置总帧数。 如果写入了更多的帧，此值将会被更改。
-
AU_write.setcomptype(type, name)¶ 设置压缩类型和描述。 对于输出只支持
'NONE'和'ULAW'。
-
AU_write.setparams(tuple)¶ tuple 应该是
(nchannels, sampwidth, framerate, nframes, comptype, compname)，每项的值可用于set*()方法。 设置所有形参。
-
AU_write.tell()¶ 返回文件中的当前位置，其含义与
AU_read.tell()和AU_read.setpos()方法的一致。
-
AU_write.writeframesraw(data)¶ 写入音频数据但不更新 nframes。
在 3.4 版更改: 现在可接受任意 bytes-like object。
-
AU_write.writeframes(data)¶ 写入音频数据并更新 nframes。
在 3.4 版更改: 现在可接受任意 bytes-like object。
-
AU_write.close()¶ 确保 nframes 正确，并关闭文件。
此方法会在删除时被调用。
请注意在调用 writeframes() 和 writeframesraw() 之后再设置任何形参都是无效的。