GNU Emacs 32.0.50 (9008bf64c3) のマニュアルを PLaMo 翻訳で機械翻訳したものです。誤訳を含むことがあります。原文: https://www.gnu.org/software/emacs/manual/html_node/elisp/Sound-Output.html ・ emacs-doc.conao3.com

43.15 音声出力

Emacsで音声を再生するには、関数 play-sound を使用します。サポートされているシステムは一部に限られており、実際に動作しないシステムで play-sound を呼び出すとエラーが発生します。

音声は、RIFF-WAVE形式(‘.wav’)またはSun Audio形式(‘.au’)のファイルとして保存する必要があります。

関数: play-sound sound

この関数は、指定されたサウンドを再生します。引数 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とともに呼び出されます。

コマンド: play-sound-file file &optional volume device

この関数は、オプションの volume および device を指定して音を再生する file の代替インターフェースです。

変数: play-sound-functions

サウンドを再生する前に呼び出される関数の一覧です。各関数は、サウンドを記述するプロパティリストを1つの引数として受け取ります。