音頻設備對象?

在你寫(xiě)入或讀取音頻設備之前，你必須按照正確的順序調用三個(gè)方法:

1. setfmt() 設置輸出格式

2. channels() 設置聲道數量

3. speed() 設置采樣率

或者，你也可以使用 setparameters() 方法一次性地設置全部三個(gè)音頻參數。 這更為便捷，但可能不會(huì )在所有場(chǎng)景下都一樣靈活。

open() 所返回的音頻設備對象定義了下列方法和（只讀）屬性:

oss_audio_device.close()?

顯式地關(guān)閉音頻設備。 當你完成寫(xiě)入或讀取音頻設備后，你應當顯式地關(guān)閉它。 已關(guān)閉的設備不可被再次使用。

oss_audio_device.fileno()?

返回與設備相關(guān)聯(lián)的文件描述符。

oss_audio_device.read(size)?

從音頻輸入設備讀取 size 個(gè)字節并返回為 Python 字節串。 與大多數 Unix 設備驅動(dòng)不同，處于阻塞模式（默認）的 OSS 音頻設備將阻塞 read() 直到所請求大小的數據全部可用。

oss_audio_device.write(data)?

將一個(gè) bytes-like object data 寫(xiě)入音頻設備并返回寫(xiě)入的字節數。 如果音頻設備處于阻塞模式（默認），則總是會(huì )寫(xiě)入完整數據（這還是不同于通常的 Unix 設備語(yǔ)義）。 如果設備處于非阻塞模式，則可能會(huì )有部分數據未被寫(xiě)入 --- 參見(jiàn) writeall()。

在 3.5 版更改: 現在接受可寫(xiě)的 字節類(lèi)對象。

oss_audio_device.writeall(data)?

將一個(gè) bytes-like object data 寫(xiě)入音頻設備：等待直到音頻設備能夠接收數據，將根據其所能接收的數據量盡可能多地寫(xiě)入，并重復操作直至 data 被完全寫(xiě)入。 如果設備處于阻塞模式（默認），則其效果與 write() 相同；writeall() 僅適用于非阻塞模式。 它沒(méi)有返回值，因為寫(xiě)入的數據量總是等于所提供的數據量。

在 3.5 版更改: 現在接受可寫(xiě)的 字節類(lèi)對象。

下列方法各自映射一個(gè) ioctl() 系統調用。 對應關(guān)系很明顯：例如，setfmt() 對應 SNDCTL_DSP_SETFMT ioctl，而 sync() 對應 SNDCTL_DSP_SYNC (這在查閱 OSS 文檔時(shí)很有用)。 如果下層的 ioctl() 失敗，它們將引發(fā) OSError。

oss_audio_device.nonblock()?

將設備轉為非阻塞模式。 一旦處于非阻塞模式，將無(wú)法將其轉回阻塞模式。

oss_audio_device.getfmts()?

返回聲卡所支持的音頻輸出格式的位掩碼。 OSS 支持的一部分格式如下:

格式	描述
AFMT_MU_LAW	一種對數編碼格式（被 Sun .au 文件和 /dev/audio 所使用）
AFMT_A_LAW	一種對數編碼格式
AFMT_IMA_ADPCM	一種 4:1 壓縮格式，由 Interactive Multimedia Association 定義
AFMT_U8	無(wú)符號的 8 位音頻
AFMT_S16_LE	有符號的 16 位音頻，采用小端字節序（如 Intel 處理器所用的）
AFMT_S16_BE	有符號的 16 位音頻，采用大端字節序（如 68k, PowerPC, Sparc 所用的）
AFMT_S8	有符號的 8 位音頻
AFMT_U16_LE	無(wú)符號的 16 位小端字節序音頻
AFMT_U16_BE	無(wú)符號的 16 位大端字節序音頻

請參閱 OSS 文檔獲取音頻格式的完整列表，還要注意大多數設備都只支持這些列表的一個(gè)子集。 某些較舊的設備僅支持 AFMT_U8；目前最為常用的格式是 AFMT_S16_LE。

oss_audio_device.setfmt(format)?

嘗試將當前音頻格式設為 format --- 請參閱 getfmts() 獲取格式列表。 返回為設備設置的音頻格式，這可能并非所請求的格式。 也可被用來(lái)返回當前音頻格式 --- 這可以通過(guò)傳入特殊的 "音頻格式" AFMT_QUERY 來(lái)實(shí)現。

oss_audio_device.channels(nchannels)?

將輸出聲道數設為 nchannels。 值為 1 表示單聲道，2 表示立體聲。 某些設備可能擁有 2 個(gè)以上的聲道，并且某些高端設備還可能不支持單聲道。 返回為設備設置的聲道數。

oss_audio_device.speed(samplerate)?

嘗試將音頻采樣率設為每秒 samplerate 次采樣。 返回實(shí)際設置的采樣率。 大多數設備都不支持任意的采樣率。 常見(jiàn)的采樣率為:

采樣率	描述
8000	/dev/audio 的默認采樣率
11025	語(yǔ)音錄音
22050
44100	CD品質(zhì)的音頻（16位采樣和2通道）
96000	DVD品質(zhì)的音頻（24位采樣）

oss_audio_device.sync()?

等待直到音頻設備播放完其緩沖區中的所有字節。 （這會(huì )在設備被關(guān)閉時(shí)隱式地發(fā)生。） OSS 建議關(guān)閉再重新打開(kāi)設備而不是使用 sync()。

oss_audio_device.reset()?

立即停止播放或錄制并使設備返回可接受命令的狀態(tài)。 OSS 文檔建議在調用 reset() 之后關(guān)閉并重新打開(kāi)設備。

oss_audio_device.post()?

告知設備在輸出中可能有暫停，使得設備可以更智能地處理暫停。 你可以在播放一個(gè)定點(diǎn)音效之后、等待用戶(hù)輸入之前或執行磁盤(pán) I/O 之前使用此方法。

下列便捷方法合并了多個(gè) ioctl，或是合并了一個(gè) ioctl 與某些簡(jiǎn)單的運算。

oss_audio_device.setparameters(format, nchannels, samplerate[, strict=False])?

在一次方法調用中設置關(guān)鍵的音頻采樣參數 --- 采樣格式、聲道數和采樣率。 format, nchannels 和 samplerate 應當與在 setfmt(), channels() 和 speed() 方法中所指定的一致。 如果 strict 為真值，則 setparameters() 會(huì )檢查每個(gè)參數是否確實(shí)被設置為所請求的值，如果不是則會(huì )引發(fā) OSSAudioError。 返回一個(gè)元組 (format, nchannels, samplerate) 指明由設備驅動(dòng)實(shí)際設置的參數值 (即與 setfmt(), channels() 和 speed() 的返回值相同)。

例如，:

(fmt, channels, rate) = dsp.setparameters(fmt, channels, rate)

等價(jià)于

fmt = dsp.setfmt(fmt)
channels = dsp.channels(channels)
rate = dsp.rate(rate)

oss_audio_device.bufsize()?

返回硬件緩沖區的大小，以采樣數表示。

oss_audio_device.obufcount()?

返回硬件緩沖區中待播放的采樣數。

oss_audio_device.obuffree()?

返回可以被加入硬件緩沖區隊列以非阻塞模式播放的采樣數。

音頻設備對象還支持幾個(gè)只讀屬性:

oss_audio_device.closed?

指明設備是否已被關(guān)閉的布爾值。

oss_audio_device.name?

包含設備文件名稱(chēng)的字符串。

oss_audio_device.mode?

文件的 I/O 模式，可以為 "r", "rw" 或 "w"。

混音器設備對象?

混音器對象提供了兩個(gè)文件類(lèi)方法:

oss_mixer_device.close()?

此方法會(huì )關(guān)閉打開(kāi)的混音器設備文件。 在文件被關(guān)閉后任何繼續使用混音器的嘗試都將引發(fā) OSError。

oss_mixer_device.fileno()?

返回打開(kāi)的混音器設備文件的文件處理句柄號。

其余方法都是混音專(zhuān)屬的:

oss_mixer_device.controls()?

此方法返回一個(gè)表示可用的混音控件的位掩碼 ("控件" 是專(zhuān)用的可混合 "聲道"，例如 SOUND_MIXER_PCM 或 SOUND_MIXER_SYNTH)。 該掩碼會(huì )指定所有可用混音控件的一個(gè)子集 --- 它們是在模塊層級上定義的 SOUND_MIXER_* 常量。 舉例來(lái)說(shuō)，要確定當前混音器對象是否支持 PCM 混音器，就使用以下 Python 代碼:

mixer=ossaudiodev.openmixer()
if mixer.controls() & (1 << ossaudiodev.SOUND_MIXER_PCM):
    # PCM is supported
    ... code ...

對于大多數目的來(lái)說(shuō)，SOUND_MIXER_VOLUME (主音量) 和 SOUND_MIXER_PCM 控件應該足夠了 --- 但使用混音器的代碼應當在選擇混音器控件時(shí)保持靈活。 例如在 Gravis Ultrasound 上，SOUND_MIXER_VOLUME 是不存在的。

oss_mixer_device.stereocontrols()?

返回一個(gè)表示立體聲混音控件的位掩碼。 如果設置了比特位，則對應的控件就是立體聲的；如果未設置，則控件為單聲道或者不被混音器所支持（請配合 controls() 使用以確定是哪種情況）。

請查看 controls() 函數的代碼示例了解如何從位掩碼獲取數據。

oss_mixer_device.reccontrols()?

返回一個(gè)指明可被用于錄音的混音器控件的位掩碼。 請查看 controls() 的代碼示例了解如何讀取位掩碼。

oss_mixer_device.get(control)?

返回給定混音控件的音量。 返回的音量是一個(gè) 2 元組 (left_volume,right_volume)。 音量被表示為從 0 (靜音) 到 100 (最大音量) 的數字。 如果控件是單聲道的，仍然會(huì )返回一個(gè) 2 元組，但兩個(gè)音量必定相同。

如果指定了無(wú)效的控件則會(huì )引發(fā) OSSAudioError，或者如果指定了不受支持的控件則會(huì )引發(fā) OSError。

oss_mixer_device.set(control, (left, right))?

將給定混音控件的音量設為 (left,right)。 left 和 right 必須為整數并在 0 (靜音) 至 100 (最大音量) 之間。 當執行成功的，新的音量將以 2 元組形式返回。 請注意這可能不完全等于所指定的音量，因為某些聲卡的混音器有精度限制。

如果指定了無(wú)效的混音控件，或者指定的音量超出限制則會(huì )引發(fā) OSSAudioError。

oss_mixer_device.get_recsrc()?

此方法返回一個(gè)表示當前被用作錄音源的的控件的位掩碼。

oss_mixer_device.set_recsrc(bitmask)?

調用此函數來(lái)指定一個(gè)錄音源。 如果成功則返回一個(gè)指明新錄音源的位掩碼；如果指定了無(wú)效的源則會(huì )引發(fā) OSError。 如果要將當前錄音源設為麥克風(fēng)輸入:

mixer.setrecsrc (1 << ossaudiodev.SOUND_MIXER_MIC)