Emacsで音声を再生するには、関数 play-sound
を使用します。サポートされているシステムは一部に限られており、実際に動作しないシステムで play-sound を呼び出すとエラーが発生します。
音声は、RIFF-WAVE形式(‘.wav’)またはSun Audio形式(‘.au’)のファイルとして保存する必要があります。
この関数は、指定されたサウンドを再生します。引数 sound は (sound properties...)
という形式をしており、properties
はキーワード(特別に認識される特定の記号)とそれに対応する値が交互に並んだ構成になっています。
以下に、soundにおいて現在意味を持つキーワードとその意味をまとめた表を示します。
:file file再生するサウンドを含むファイルを指定します。ファイル名が絶対パスでない場合は、ディレクトリ data-directory を基準として展開されます。
:data dataこれは、ファイルを参照することなく再生するサウンドを指定します。値 data には、サウンドファイルと同じバイト列を含む文字列を指定してください。ユニバイト文字列の使用を推奨します。
:volume volumeサウンドの音量を指定します。0から1の範囲の数値を指定してください。デフォルトでは、それまでに指定された音量が使用されます。
:device device音を再生するシステムデバイスを文字列で指定します。デフォルトのデバイスはシステムによって異なります。
実際に音を再生する前に、play-soundはリストplay-sound-functions内の関数を呼び出します。各関数は、1つの引数soundとともに呼び出されます。
この関数は、オプションの volume および device を指定して音を再生する file の代替インターフェースです。
サウンドを再生する前に呼び出される関数の一覧です。各関数は、サウンドを記述するプロパティリストを1つの引数として受け取ります。