22.9. ossaudiodev
—访问与OSS兼容的音频设备¶
此模块允许您访问OSS(开放声音系统)音频接口。 OSS可用于广泛的开源和商业版本,是Linux和最新版本的FreeBSD的标准音频接口。
ossaudiodev
定义了以下变量和函数:
-
exception
ossaudiodev.
OSSAudioError
¶ 对某些错误引发此异常。参数是一个描述错误的字符串。
(如果
ossaudiodev
从诸如open()
,write()
或ioctl()
的系统调用接收到错误,则它提高OSError
。由ossaudiodev
直接检测到的错误导致OSSAudioError
)。(为了向后兼容,异常类也可用作
ossaudiodev.error
。)
-
ossaudiodev.
open
(mode)¶ -
ossaudiodev.
open
(device, mode) 打开音频设备并返回OSS音频设备对象。此对象支持许多类似文件的方法,例如
read()
,write()
和fileno()
(虽然在常规Unix读/写语义和OSS音频设备之间有微妙的差别)。它还支持许多音频专用方法;请参阅下面的完整方法列表。device 是要使用的音频设备文件名。如果未指定,则此模块首先在环境变量
AUDIODEV
中查找要使用的设备。如果没有找到,它会回到/dev/dsp
。mode 是用于只读(记录)访问的
'r'
,用于只写(回放)访问的'w'
和用于两者的'rw'
中的一个。由于许多声卡只允许一个进程一次打开录音机或播放器,因此最好只为所需的活动打开设备。此外,一些声卡是半双工的:它们可以打开以进行读取或写入,但不能同时打开。注意不寻常的调用语法:first 参数是可选的,第二个是必需的。这是一个与
ossaudiodev
取代的旧linuxaudiodev
模块兼容的历史工件。
-
ossaudiodev.
openmixer
([device])¶ 打开混音器设备并返回OSS混音器设备对象。 device 是要使用的混合设备文件名。如果未指定,则此模块首先在环境变量
MIXERDEV
中查找要使用的设备。如果没有找到,它会回到/dev/mixer
。
22.9.1. 音频设备对象¶
在对音频设备进行写入或读取之前,必须按正确的顺序调用三种方法:
setfmt()
设置输出格式channels()
设置通道数speed()
设置采样率
或者,您可以使用 setparameters()
方法一次设置所有三个音频参数。这更方便,但在所有情况下可能不那么灵活。
open()
返回的音频设备对象定义以下方法和(只读)属性:
-
oss_audio_device.
close
()¶ 显式关闭音频设备。当您完成对音频设备的写入或读取时,应该明确地关闭它。闭合的设备不能再次使用。
-
oss_audio_device.
fileno
()¶ 返回与设备关联的文件描述符。
-
oss_audio_device.
read
(size)¶ 从音频输入读取 size 字节,并将它们作为Python字符串返回。与大多数Unix设备驱动程序不同,处于阻塞模式(默认)的OSS音频设备将阻止
read()
,直到整个请求的数据量可用。
-
oss_audio_device.
write
(data)¶ 将 bytes-like object data 写入音频设备并返回写入的字节数。如果音频设备处于阻塞模式(默认),则总是写入整个数据(同样,这与通常的Unix设备语义不同)。如果设备处于非阻塞模式,可能无法写入某些数据 - 请参阅
writeall()
。在 3.5 版更改: 可写 bytes-like object 现已被接受。
-
oss_audio_device.
writeall
(data)¶ 将 bytes-like object data 写入音频设备:等待,直到音频设备能够接受数据,写入尽可能多的数据,它将接受,并重复,直到 data 已完全写入。如果设备处于阻塞模式(默认值),这与
write()
的效果相同;writeall()
仅在非阻塞模式下有用。没有返回值,因为写入的数据量总是等于提供的数据量。在 3.5 版更改: 可写 bytes-like object 现已被接受。
在 3.2 版更改: 音频设备对象还支持上下文管理协议,即它们可以在 with
语句中使用。
以下方法每个映射到一个 ioctl()
系统调用。对应是显而易见的:例如,setfmt()
对应于 SNDCTL_DSP_SETFMT
ioctl,sync()
对应于 SNDCTL_DSP_SYNC
(当咨询OSS文档时,这是有用的)。如果底层的 ioctl()
失败,他们都提高 OSError
。
-
oss_audio_device.
nonblock
()¶ 将设备置于非阻塞模式。一旦处于非阻塞模式,就无法将其返回阻塞模式。
-
oss_audio_device.
getfmts
()¶ 返回声卡支持的音频输出格式的位掩码。 OSS支持的一些格式如下:
格式
描述
AFMT_MU_LAW
对数编码(由Sun
.au
文件和/dev/audio
使用)AFMT_A_LAW
对数编码
AFMT_IMA_ADPCM
由交互式多媒体协会定义的4:1压缩格式
AFMT_U8
无符号,8位音频
AFMT_S16_LE
有符号,16位音频,小端字节顺序(由英特尔处理器使用)
AFMT_S16_BE
有符号,16位音频,大端字节顺序(由68k,PowerPC,Sparc使用)
AFMT_S8
签名,8位音频
AFMT_U16_LE
无符号,16位小端音频
AFMT_U16_BE
无符号,16位大端音频
有关音频格式的完整列表,请参阅OSS文档,并注意大多数设备仅支持这些格式的一部分。一些旧设备只支持
AFMT_U8
;今天使用的最常见的格式是AFMT_S16_LE
。
-
oss_audio_device.
setfmt
(format)¶ 尝试将当前音频格式设置为 format —参见
getfmts()
列表。返回设备设置为的音频格式,可能不是请求的格式。也可以用于返回当前音频格式 - 通过传递AFMT_QUERY
的“音频格式”来做到这一点。
-
oss_audio_device.
channels
(nchannels)¶ 将输出通道的数量设置为 nchannels。值1表示单声道声,2表示立体声。某些设备可能有2个以上的通道,有些高端设备可能不支持单声道。返回设备设置的通道数。
-
oss_audio_device.
speed
(samplerate)¶ 尝试将音频采样率设置为每秒 samplerate 个样本。返回实际设置的速率。大多数声音设备不支持任意采样率。常用价格为:
率
描述
8000
/dev/audio
的默认率11025
语音记录
22050
44100
CD质量音频(16位/样本和2通道)
96000
DVD质量音频(24位/采样)
-
oss_audio_device.
post
()¶ 告诉驾驶员输出可能有暂停,使得设备可以更智能地处理暂停。您可以在播放专色音效之后,在等待用户输入之前或在进行磁盘I/O之前使用此功能。
以下方便方法组合了几个ioctl或一个ioctl和一些简单的计算。
-
oss_audio_device.
setparameters
(format, nchannels, samplerate[, strict=False])¶ 在一个方法调用中设置关键音频采样参数—采样格式,通道数和采样率—。 format,nchannels 和 samplerate 应如
setfmt()
,channels()
和speed()
方法中所指定。如果 strict 为真,setparameters()
检查每个参数是否实际设置为请求的值,如果不是,则提高OSSAudioError
。返回指示实际由设备驱动程序设置的参数值(即,与setfmt()
,channels()
和speed()
的返回值相同)的元组(format,nchannels,samplerate)。例如,
(fmt, channels, rate) = dsp.setparameters(fmt, channels, rate)
相当于
fmt = dsp.setfmt(fmt) channels = dsp.channels(channels) rate = dsp.rate(rate)
-
oss_audio_device.
bufsize
()¶ 返回采样中硬件缓冲区的大小。
-
oss_audio_device.
obufcount
()¶ 返回在硬件缓冲区中尚未播放的样本数。
-
oss_audio_device.
obuffree
()¶ 返回可以排队进入硬件缓冲区以在无阻塞的情况下播放的样本数。
音频设备对象还支持几个只读属性:
-
oss_audio_device.
closed
¶ 布尔值,表示设备是否已关闭。
-
oss_audio_device.
name
¶ 包含设备文件名称的字符串。
-
oss_audio_device.
mode
¶ 文件的I/O模式,
"r"
,"rw"
或"w"
。
22.9.2. 混合器设备对象¶
混音器对象提供两个类文件方法:
-
oss_mixer_device.
fileno
()¶ 返回打开的混音器设备文件的文件句柄号。
在 3.2 版更改: 混合器对象也支持上下文管理协议。
其余方法特定于音频混合:
-
oss_mixer_device.
controls
()¶ 此方法返回指定可用混频器控制的位掩码(“Control”是特定可混合“通道”,例如
SOUND_MIXER_PCM
或SOUND_MIXER_SYNTH
)。该位掩码指示所有可用混频器控制的子集 - 在模块级定义的SOUND_MIXER_*
常数。要确定例如当前混音器对象是否支持PCM混音器,请使用以下Python代码:mixer=ossaudiodev.openmixer() if mixer.controls() & (1 << ossaudiodev.SOUND_MIXER_PCM): # PCM is supported ... code ...
对于大多数目的,
SOUND_MIXER_VOLUME
(主音量)和SOUND_MIXER_PCM
控制应该足够了 - 但是当选择混频器控制时,使用混频器的代码应该是灵活的。在Gravis超声上,例如,SOUND_MIXER_VOLUME
不存在。
-
oss_mixer_device.
stereocontrols
()¶ 返回指示立体声混音器控制的位掩码。如果一个位被置位,则相应的控制是立体声;如果未设置,则控制是单声道的或不由混频器支持(与
controls()
组合使用以确定哪个)。有关从位掩码获取数据的示例,请参阅
controls()
函数的代码示例。
-
oss_mixer_device.
reccontrols
()¶ 返回指定可用于记录的混音器控制的位掩码。有关从位掩码读取的示例,请参阅
controls()
的代码示例。
-
oss_mixer_device.
get
(control)¶ 返回给定混频器控制的音量。返回的卷是2元组
(left_volume,right_volume)
。卷指定为从0(无声)到100(全卷)的数字。如果控制是单声道,仍然返回2元组,但两个卷是相同的。如果指定了无效控件,则引发
OSSAudioError
;如果指定了不支持的控制,则引发OSError
。
-
oss_mixer_device.
set
(control, (left, right))¶ 将给定混频器控制的音量设置为
(left,right)
。left
和right
必须为int,介于0(无声)和100(全部音量)之间。成功后,新卷将作为2元组返回。请注意,这可能与指定的音量不完全相同,因为一些声卡的混音器的分辨率有限。如果指定了无效的混合器控制或指定的卷超出范围,则引发
OSSAudioError
。
-
oss_mixer_device.
get_recsrc
()¶ 此方法返回指示哪些控件当前用作记录源的位掩码。