19.11 ossaudiodev -- OSS互換オーディオデバイスへのアクセス

19.11 ossaudiodev -- OSS互換オーディオデバイスへのアクセス

Linux, FreeBSDプラットフォームで利用できます。

バージョン 2.3 で新たに追加された仕様です。

このモジュールを使うとOSS (Open Sound System) オーディオインターフェースにアクセスできます。 OSSはオープンソースあるいは商用のUnixで広く利用でき、Linux (カーネル 2.4まで) とFreeBSDで標準のオーディオインターフェースです。

参考:

Open Sound System Programmer's Guide: OSS C API の公式ドキュメント

このモジュールではOSSデバイスドライバーが提供している多くの定数を定義しています; 定数のリストについては Linux や FreeBSDの <sys/soundcard.h>を参照してください。

ossaudiodev では以下の変数と関数を定義しています:

exception error

何らかのエラーのときに送出される例外です。引数は何が誤っているかを示す文字列です。

(ossaudiodev がopen()、write()、 ioctl() などのシステムコールからエラーを受け取った場合には IOError を送出します。 ossaudiodev が直接エラーを検出した場合には OSSAudioErrorになります。)

(以前のバージョンとの互換性のため、この例外クラスは ossaudiodev.error としても利用できます。)

open( [device, ]mode)

オーディオデバイスを開き、OSSオーディオデバイスオブジェクトを返します。このオブジェクトはread()、write()、fileno() といったファイル類似オブジェクトのメソッドを数多くサポートしています。 (とはいえ、伝統的な Unix の read/write における意味づけと OSS デバイスの read/write との間には微妙な違いがあります)。また、オーディオ特有の多くのメソッドがあります;メソッドの完全なリストについては下記を参照してください。

deviceは使用するオーディオデバイスファイルネームです。もしこれが指定されないなら、このモジュールは使うデバイスとして最初に環境変数AUDIODEVを参照します。見つからなければ/dev/dspを参照します。

mode は読み出し専用アクセスの場合には 'r'、書き込み専用 (プレイバック) アクセスの場合には 'w'、読み書きアクセスの場合には 'rw' にします．多くのサウンドカードは一つのプロセスが一度にレコーダとプレーヤのどちらかしか開けないようにしているため，必要な操作に応じたデバイスだけを開くようにするのがよいでしょう。また，サウンドカードには半二重 (half-duplex) 方式のものがあります: こうしたカードでは，デバイスを読み出しまたは書き込み用に開くことはできますが，両方同時には開けません．

呼び出しの文法が普通と異なることに注意してください: 最初の引数は省略可能で、2番目が必須です。これはossaudiodevにとってかわられた古い linuxaudiodevとの互換性のためという歴史的な産物です。

openmixer( [device])

ミキサデバイスを開き、OSSミキサデバイスオブジェクトを返します。 deviceは使用するミキサデバイスのファイル名です。 deviceを指定しない場合、モジュールはまず環境変数 AUDIODEVを参照して使用するデバイスを探します。見つからなければ、/dev/mixerを参照します。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。