arecord - リファレンスマニュアル、オプション、コマンド例

---

名前

arecord 、aplay - ALSA サウンドカード ドライバー用のコマンドライン サウンド レコーダーおよびプレーヤー

概要

arecord [flags] [filename]
aplay [flags] [filename [filename]] ...

説明

arecord は、ALSA サウンドカード ドライバー用のコマンドライン サウンドファイル レコーダーです。複数のファイル形式と、複数のデバイスでの複数のサウンドカードをサポートします。インターリーブ モードのサンプルで記録する場合、ファイルは 2GB のファイルサイズに達する前に自動的に分割されます。

aplay もほぼ同じですが、録音ではなく再生される点が異なります。サポートされているサウンドファイル形式の場合、サンプリング レート、ビット深度などはサウンドファイル ヘッダーから自動的に決定できます。

ファイル名が指定されていない場合は、標準出力または標準入力が使用されます。 aplay ユーティリティは複数のファイル名を受け入れます。

オプション

-h, --help

ヘルプ: 構文を表示します。

--version

現在のバージョンを印刷します。

-l, --list-devices

すべてのサウンドカードとデジタル オーディオ デバイスをリストする

-L, --list-pcms

定義されているすべての PCM をリストする

-D, --device=NAME

PCMを名前で選択

-q --quiet

静かモード。メッセージを抑制します (サウンドではありません:))

-t, --file-type TYPE

ファイルの種類 (voc、wav、raw、または au)。このパラメータを省略すると、WAVE 形式が使用されます。

-c, --channels=#

チャンネルの数。デフォルトは 1 チャネルです。有効な値は 1 ～ 32 です。

-f --format=FORMAT

フォーマット例
について 認識されるサンプル形式は次のとおりです。 S8 U8 S16_LE S16_BE U16_LE U16_BE S24_LE S24_BE U24_LE U24_BE S32_LE S32_BE U32_LE U32_BE FLOAT_LE FLOAT_BE FLOAT64_LE FLOAT64_BE IEC958_SUBFRAME_LE IEC958_SUBFRAME_BE MU_LAW A_LAW IMA_ADPCM MPEG GSM スペシャル S24_3LE S24_3BE U24_3LE U24_3BE S20_3LE S20_3BE U20_3LE U20_3BE S18_3LE S18_3BE U18_3LE
これらの一部は、選択したハードウェアでは利用できない場合があります
使用可能な形式のショートカットは次のとおりです。

-f cd (16 bit little endian, 44100, stereo) [-f S16_LE -c2 -r44100]
-f cdr (16 bit big endian, 44100, stereo) [-f S16_BE -c2 -r44100]
-f dat (16 bit little endian, 48000, stereo) [-f S16_LE -c2 -r48000]

形式が指定されていない場合は、U8 が使用されます。

-r, --rate=#<Hz>

サンプリングレート（ヘルツ）。デフォルトのレートは 8000 ヘルツです。指定した値が 300 未満の場合は、キロヘルツ単位のレートとして解釈されます。有効な値は 2000 ～ 192000 ヘルツです。

-d, --duration=#

# 秒後に中断します。値 0 は無限大を意味します。デフォルトはゼロであるため、このオプションを省略すると、記録/再生プロセスは強制終了されるまで実行されます。 「-d」または「-s」オプションは排他的に使用できます。

-s, --samples=#

# PCM フレームの送信後に中断します。値 0 は無限大を意味します。デフォルトはゼロであるため、このオプションを省略すると、記録/再生プロセスは強制終了されるまで実行されます。 「-d」または「-s」オプションは排他的に使用できます。

-M, --mmap

オーディオ ストリームにはメモリ マップド (mmap) I/O モードを使用します。このオプションが設定されていない場合は、読み取り/書き込み I/O モードが使用されます。

-N, --nonblock

オーディオ デバイスをノンブロッキング モードで開きます。デバイスがビジー状態の場合、プログラムはすぐに終了します。このオプションが設定されていない場合、オーディオ デバイスが再び利用可能になるまでプログラムはブロックされます。

-F, --period-time=#

割り込み間の距離は # マイクロ秒です。期間時間も期間サイズも指定されていない場合は、バッファ時間の 4 分の 1 が設定されます。

-B, --buffer-time=#

バッファ期間は # マイクロ秒です。バッファ時間とバッファ サイズが指定されていない場合は、最大許容バッファ時間が設定されますが、500 ミリ秒を超えないように設定されます。

--period-size=#

割り込み間の距離は # フレームです。期間サイズと期間時間が指定されていない場合は、バッファ サイズの 4 分の 1 が設定されます。

--buffer-size=#

バッファ期間は # フレームです。バッファ時間もバッファ サイズも指定されていない場合は、最大許容バッファ時間が 500 ミリ秒以下に設定されます。

-A, --avail-min=#

ウェイクアップに使用可能な最小スペースは # マイクロ秒です

-R, --start-delay=#

自動 PCM 開始の遅延は # マイクロ秒です (<= 0 の場合はバッファ サイズとの関係)

-T, --stop-delay=#

自動 PCM 停止の遅延は xrun から # マイクロ秒です

-v, --verbose

PCM の構造と設定を表示します。このオプションは累積的です。これを2～3回与えるとVUメーターが表示されます。

-V, --vumeter=TYPE

VU メーターのタイプをステレオまたはモノのいずれかで指定します。ステレオ VU メーターは、インターリーブ形式の 2 チャンネル ステレオ サンプルでのみ使用できます。

-I, --separate-channels

各チャンネルに 1 つのファイル。このオプションは max-file-time と use-strftime を無効にし、SIGUSR1 を無視します。ステレオ VU メーターは個別のチャンネルでは使用できません。

-P

再生。 aplay と入力してプログラムを起動した場合、これがデフォルトです。

-C

記録。これは、「arecord」と入力してプログラムを起動した場合のデフォルトです。

-i, --interactive

標準入力を介した対話型操作を許可します。現在、スペースまたは Enter キーによる一時停止/再開のみが実装されています。

-m, --chmap=ch1,ch2,...

オーバーライドまたはフォローするチャネル マップを指定します。 FL、FR などのチャネル位置文字列を渡します。

デバイスがチャネル マップのオーバーライドをサポートしている場合、aplay は指定されたチャネル マップを渡そうとします。チャネル マップのオーバーライドをサポートしていないがチャネル マップ情報を提供する場合、aplay はデバイスから返されたチャネル マップと一致するようにバッファ内のチャネルの順序を再配置しようとします。

--disable-resample

自動レートリサンプルを無効にします。

--disable-channels

自動チャンネル変換を無効にします。

--disable-format

自動フォーマット変換を無効にします。

--disable-softvol

ソフトウェアボリュームコントロール (softvol) を無効にします。

--test-position

リングバッファの位置をテストします。

--test-coef=<coef>

リングバッファ位置のテスト係数。デフォルトは 8 です。検証の式は次のとおりです: coef * (buffer_size/2)。最小値は 1 です。

--test-nowait

リング バッファを待たずに、CPU 全体を消費します。

--max-file-time

録音中、出力ファイルに長時間サウンドが蓄積されている場合は、出力ファイルを閉じて、新しい出力ファイルを開きます。デフォルトは、ファイル形式でサポートされる最大サイズです: WAV ファイルの場合は 2 GiB。 -- Separate-channels が指定されている場合、このオプションは効果がありません。

--process-id-file <file name>

aplay はここにプロセス ID を書き込むため、他のプログラムがシグナルを送信できるようになります。

--use-strftime

記録時には、出力ファイルが開かれるたびに、strftime 機能を使用してファイル名パラメーター内の % コードを解釈します。重要な strftime コードは次のとおりです。%Y は年、%m 月、%d 日、%H 時間、%M 分、%S 秒です。また、%v は 1 から始まるファイル番号です。このオプションを指定すると、出力ファイルの中間ディレクトリが自動的に作成されます。 -- Separate-channels が指定されている場合、このオプションは効果がありません。

--dump-hw-params

デバイスの事前設定ステータスの hw_params を stderr にダンプします。ダンプには、サポートされているフォーマット、サンプリング レート、チャネル数、周期、バッファのバイト/サイズ/時間など、選択したデバイスの機能がリストされます。 raw デバイス hw:X の場合、このオプションは基本的にサウンドカードのハードウェア機能をリストします。

--fatal-errors

エラー (xrun など) が発生した場合、回復の試行を無効にします。代わりに、aplay プロセスはすぐに中止されます。

信号

記録中、SIGINT、SIGTERM、および SIGABRT は出力ファイルを閉じて終了します。 SIGUSR1 は出力ファイルを閉じ、新しいファイルを開き、記録を続行します。ただし、SIGUSR1 は --dependent-channels では機能しません。

例

aplay -c 1 -t raw -r 22050 -f mu_law foobar

raw ファイル「foobar」を 22050 Hz、モノラル、8 ビット、Mu-Law .au ファイルとして再生します。

arecord -d 10 -f cd -t wav -D copy foobar.wav

PCM「コピー」(ユーザーの .asoundrc ファイル内で次のように定義されている可能性があります) を使用して、foobar.wav を 10 秒の CD 品質の Wave ファイルとして記録します。

pcm.copy {
  type plug
  slave {
    pcm hw
  }
  route_policy copy
}

arecord -t wav --max-file-time 30 mon.wav

デフォルトのオーディオ ソースからモノラル、8,000 サンプル/秒、8 ビット/サンプルで録音します。 30 秒ごとに新しいファイルを開始します。ファイル名は mon-nn.wav です。nn は 01 から増加します。mon-99.wav の次のファイルは mon-100.wav です。

arecord -f cd -t wav --max-file-time 3600 --use-strftime %Y/%m/%d/listen-%H-%M-%v.wav

デフォルトのオーディオソースからステレオで録音します。 1 時間ごとに新しいファイルを作成します。ファイルは開始日に基づいてディレクトリに配置され、開始時刻とファイル番号を含む名前が付けられます。

関連項目

alsamixer(1), amixer(1)

バグ

.aiff ファイルは現在サポートされていないことに注意してください。

著者

arecord と aplay は Jaroslav Kysela perex@perex.cz によるものです。この文書は Paul Winkler zarmzarm@erols.com によるものです。 James Tappin james@xena.uklinux.net により Alsa 0.9 用に更新されました