名前 | 形式 | 機能説明 | オプション | オペランド | 使用法 | 環境 | 属性 | 関連項目
audiorecord [-af] [-v vol] [-b bal] [-m monvol] [-p mic | line | internal-cd] [-c channels] [-s rate] [-e encoding] [-t time] [-i info] [-d dev] [-T au | aif[f] | wav] [file[.au|.aif[f]]|.wav]
audiorecord ユーティリティは、オーディオデバイスのオーディオデータを指定されたオーディオファイル (ファイル名が存在しない場合は、標準出力) にコピーします。出力ファイルを指定していない場合、かつ、標準出力が tty である場合、コマンド行に指定したボリューム、バランス、モニターボリューム、ポート、およびオーディオ形式の設定が適用され、プログラムは終了します。
デフォルトでは、モノラルのオーディオデータは 8kHz で記録され、-law 形式でエンコードされます。オーディオデバイスが拡張構成をサポートする場合、-c、-s、および -e オプションを使用してデータ形式を指定できます。出力ファイルには、オーディオファイルのヘッダーが接頭辞として付くので、その出力ファイルにエンコードされているデータ形式が分かります。
記録は即座に開始され、SIGINT シグナル (たとえば、Control-C) を受信するまで続けられます。-t オプションを指定した場合、audiorecord は指定された量のデータを記録した後に停止します。
オーディオデバイスが利用できない場合、つまり、ほかのプロセスが読み取りアクセスを行っている場合、audiorecord はエラーメッセージを出力して、即座に終了します。
次のオプションを指定できます。
Help: コマンド行の使用法に関するメッセージを出力します。
Append: 指定されたオーディオファイルの終わりに、データを追加します。この場合、指定されたオーディオファイルのオーディオデータ形式をオーディオデバイスがサポートする必要があります。
Balance: 入力バランスを bal に設定してから、記録を開始します。そして、audiorecord の終了時に、以前のレベルに戻します。bal 引数は、-100 から 100 までの整数値です (両端を含む)。-100 は左、0 は中央、100 は右を表します。このオプションを指定しない場合、入力バランスは現在のレベル (つまり、最後にほかのプロセスが設定したレベル) のままになります。
Channels: オーディオチャネルの数を指定します。この値は、整数 (1 または 2) または文字列 (mono または stereo) のどちらでも指定できます。デフォルトの値は mono です。
Device: 代替のオーディオデバイスを指定します。dev 引数は、入力元となるオーディオデバイスです。-d オプションを指定しない場合、AUDIODEV 環境変数に設定されているオーディオデバイスが使用されます (以下を参照)。AUDIODEV 環境変数が設定されていない場合、/dev/audio がデフォルトのオーディオデバイスとして使用されます。
Encoding: オーディオデータのエンコード方法を指定します。この値は、ulaw、alaw、または linear のうちの 1 つです。デフォルトのエンコード方法は ulaw です。
Force: -a オプションを指定した場合、オーディオデバイスのサンプル率は、オリジナルのファイルが記録されたときのサンプル率に一致する必要があります。-a オプションと一緒に -f オプションも指定した場合、サンプル率の違いは無視されます。そして、警告メッセージが標準エラーに出力されます。
Information: 出力ファイルのヘッダーの「information (情報)」フィールドに、info 引数に指定された文字列を設定します。このオプションは、-a オプションと一緒に指定してはなりません。
Monitor Volume: モニター (スピーカ) の出力ボリュームを monvol に設定してから、記録を開始します。そして、audiorecord の終了時に、以前のレベルに戻します。monval 引数は、0 から 100 までの整数値です (両端を含む)。0 以外の値を指定した場合、記録中、直接接続された入力デバイスの音がモニター (スピーカ) から流れます。このオプションを指定しない場合、出力ボリュームは現在のレベル (つまり、最後にほかのプロセスが設定したレベル) のままになります。
Input Port: オーディオ出力シグナルの入力元である入力ポートを指定します。指定できる値は、mic、line、または internal-cd です。このオプションを指定しない場合、入力ポートは現在のままになります。システムによっては、指定した入力ポートをサポートしないものもあるので注意してください。指定した入力ポートが存在しない場合、このオプションは無視されます。
Sample Rate: サンプル率を 1 秒あたりのサンプル数で指定します。rate の後に文字「k」を付けた場合、rate は 1000 倍されます。たとえば、「44.1k」は「44100」を意味します。デフォルトのサンプル率は 8kHz です。
Time: 記録できる最長時間を指定します。time 引数は、浮動小数点数として、あるいは、形式「hh:mm:ss.dd」として指定できます。前者の場合、小数部分は秒数を意味します。後者の場合、時間 (hh) と分 (mm) は省略できます。
作成するオーディオファイルの種類を指定します。-a オプションを指定した場合、ファイルの種類は、オリジナルのファイルの種類に一致する必要があります。-T オプションを指定した場合、ファイルの接尾辞にかかわらず、ファイルの種類は -T オプションに指定したファイルの種類に設定されます。このオプションを指定しない場合、ファイルの種類はファイルの接尾辞によって決定されます。
Volume: 入力ボリューム (記録ゲイン) を vol に設定してから、記録を開始します。そして、audiorecord の終了時に、以前のレベルに戻します。vol 引数は、0 から 100 までの整数値です (両端を含む)。このオプションを指定しない場合、入力ボリュームは現在のレベル (つまり、最後にほかのプロセスが設定したレベル) のままになります。
File Specification: 指定されたオーディオファイルを作成または追加します。ファイル名が存在しない場合、かつ、標準出力が tty でない場合、あるいは、特別なファイル名「-」を指定した場合、出力は標準出力に送られます。
-T オプションを指定しない場合、ファイルの種類はファイルの接尾辞によって決定されます。接尾辞が認識されない場合、デフォルトは .au です。-T オプションを指定した場合、ファイルの接尾辞にかかわらず、ファイルの種類は -T オプションに指定したファイルの種類に設定されます。
ファイルのサイズが 2G バイト (231 バイト) 以上ある場合の audiorecord の動作については、largefile(5) のマニュアルページを参照してください。
次の属性については、attributes(5) のマニュアルページを参照してください。
属性タイプ |
属性値 |
---|---|
アーキテクチャ |
SPARC, x86 |
使用条件 |
SUNWauda |
インタフェースの安定性 |
開発中 |