ossaudiodev --- 訪問兼容OSS的音頻設(shè)備?

音頻設(shè)備對象?

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

1. setfmt() 設(shè)置輸出格式

2. channels() 設(shè)置聲道數(shù)量

3. speed() 設(shè)置采樣率

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

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

oss_audio_device.close()?

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

oss_audio_device.fileno()?

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

oss_audio_device.read(size)?

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

oss_audio_device.write(data)?

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

在 3.5 版更改: 現(xiàn)在接受可寫的 字節(jié)類對象。

oss_audio_device.writeall(data)?

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

在 3.5 版更改: 現(xiàn)在接受可寫的 字節(jié)類對象。

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

oss_audio_device.nonblock()?

將設(shè)備轉(zhuǎn)為非阻塞模式。 一旦處于非阻塞模式，將無法將其轉(zhuǎn)回阻塞模式。

oss_audio_device.getfmts()?

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

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

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

oss_audio_device.setfmt(format)?

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

oss_audio_device.channels(nchannels)?

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

oss_audio_device.speed(samplerate)?

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

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

oss_audio_device.sync()?

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

oss_audio_device.reset()?

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

oss_audio_device.post()?

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

下列便捷方法合并了多個 ioctl，或是合并了一個 ioctl 與某些簡單的運算。

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

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

例如，:

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

等價于

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

oss_audio_device.bufsize()?

返回硬件緩沖區(qū)的大小，以采樣數(shù)表示。

oss_audio_device.obufcount()?

返回硬件緩沖區(qū)中待播放的采樣數(shù)。

oss_audio_device.obuffree()?

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

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

oss_audio_device.closed?

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

oss_audio_device.name?

包含設(shè)備文件名稱的字符串。

oss_audio_device.mode?

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

混音器設(shè)備對象?

混音器對象提供了兩個文件類方法:

oss_mixer_device.close()?

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

oss_mixer_device.fileno()?

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

其余方法都是混音專屬的:

oss_mixer_device.controls()?

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

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

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

oss_mixer_device.stereocontrols()?

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

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

oss_mixer_device.reccontrols()?

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

oss_mixer_device.get(control)?

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

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

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

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

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

oss_mixer_device.get_recsrc()?

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

oss_mixer_device.set_recsrc(bitmask)?

調(diào)用此函數(shù)來指定一個錄音源。 如果成功則返回一個指明新錄音源的位掩碼；如果指定了無效的源則會引發(fā) OSError。 如果要將當(dāng)前錄音源設(shè)為麥克風(fēng)輸入:

mixer.setrecsrc (1 << ossaudiodev.SOUND_MIXER_MIC)