aplay - referenční příručka, možnosti, příklady příkazů


NÁZEV

aplay arecord, aplay - příkazový řádek pro záznam zvuku a přehrávač pro ovladač zvukové karty ALSA

SYNOPSE

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

POPIS

arecord je záznamník zvukových souborů příkazového řádku pro ovladač zvukové karty ALSA. Podporuje několik formátů souborů a více zvukových karet s více zařízeními. Pokud nahráváte vzorky v prokládaném režimu, soubor se automaticky rozdělí před velikostí souboru 2 GB.

Přehrávání je v podstatě stejné, jen se místo nahrávání přehrává. U podporovaných formátů zvukových souborů lze vzorkovací frekvenci, bitovou hloubku atd. automaticky určit ze záhlaví zvukového souboru.

Pokud název souboru není zadán, použije se standardní výstup nebo vstup. Nástroj aplay přijímá více názvů souborů.

MOŽNOSTI

-h, --help

Nápověda: zobrazit syntaxi.

--version

Vytisknout aktuální verzi.

-l, --list-devices

Seznam všech zvukových karet a digitálních zvukových zařízení

-L, --list-pcms

Seznam všech definovaných PCM

-D, --device=NAME

Vyberte PCM podle názvu

-q --quiet

Tichý režim. Potlačit zprávy (bez zvuku :))

-t, --file-type TYPE

Typ souboru (voc, wav, raw nebo au). Pokud je tento parametr vynechán, použije se formát WAVE.

-c, --channels=#

Počet kanálů. Výchozí nastavení je jeden kanál. Platné hodnoty jsou 1 až 32.

-f --format=FORMAT

Vzorový formát
Uznávané formáty ukázek jsou: 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_LEEC FLOAT68_BE IFRAME_LEEC95MU_BE IFRAME_LEEC95MU_BE IFRAME W A_LAW IMA_ADPCM MPEG GSM SPECIÁL S24_3LE S24_3BE U24_3LE U24_3BE S20_3LE S20_3BE U20_3LE U20_3BE S18_3LE S18_3BE U18_3LE
Některé z nich nemusí být na vybraném hardwaru dostupné
Dostupné zkratky formátu jsou:

-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]

Pokud není uveden žádný formát, použije se U8.

-r, --rate=#<Hz>

Vzorkovací frekvence v Hertzech. Výchozí sazba je 8000 Hertzů. Pokud je zadaná hodnota menší než 300, bere se jako rychlost v kilohertzech. Platné hodnoty jsou 2000 až 192000 Hertzů.

-d, --duration=#

Přerušit po # sekundách. Hodnota nula znamená nekonečno. Výchozí hodnota je nula, takže pokud je tato možnost vynechána, proces nahrávání/přehrávání poběží, dokud nebude ukončen. K dispozici je výhradně možnost „-d“ nebo „-s“.

-s, --samples=#

Přerušení po přenosu # rámců PCM. Hodnota nula znamená nekonečno. Výchozí hodnota je nula, takže pokud je tato možnost vynechána, proces nahrávání/přehrávání poběží, dokud nebude ukončen. K dispozici je výhradně možnost „-d“ nebo „-s“.

-M, --mmap

Pro audio stream použijte režim I/O mapovaný v paměti (mmap). Pokud tato možnost není nastavena, použije se režim I/O pro čtení/zápis.

-N, --nonblock

Otevřete zvukové zařízení v neblokujícím režimu. Pokud je zařízení zaneprázdněné, program se okamžitě ukončí. Pokud tato možnost není nastavena, program se zablokuje, dokud nebude zvukové zařízení opět dostupné.

-F, --period-time=#

Vzdálenost mezi přerušeními je # mikrosekund. Pokud není uvedena žádná doba periody a žádná velikost periody, nastaví se čtvrtina doby vyrovnávací paměti.

-B, --buffer-time=#

Doba trvání vyrovnávací paměti je # mikrosekund Pokud není uvedena žádná doba vyrovnávací paměti ani velikost vyrovnávací paměti, je nastavena maximální povolená doba vyrovnávací paměti, ale ne více než 500 ms.

--period-size=#

Vzdálenost mezi přerušeními je # snímků Pokud není zadána velikost periody ani doba periody, nastaví se čtvrtina velikosti vyrovnávací paměti.

--buffer-size=#

Doba trvání vyrovnávací paměti je # snímků Pokud není uvedena doba vyrovnávací paměti ani velikost vyrovnávací paměti, nastaví se maximální povolená doba vyrovnávací paměti, ale ne více než 500 ms.

-A, --avail-min=#

Minimální dostupný prostor pro probuzení je # mikrosekund

-R, --start-delay=#

Zpoždění automatického spuštění PCM je # mikrosekundy (vzhledem k velikosti vyrovnávací paměti, pokud <= 0)

-T, --stop-delay=#

Zpoždění pro automatické zastavení PCM je # mikrosekund od xrun

-v, --verbose

Zobrazit strukturu a nastavení PCM. Tato možnost je kumulativní. VU metr se zobrazí, když je zadáno dvakrát nebo třikrát.

-V, --vumeter=TYPE

Určuje typ VU-metru, buď stereo nebo mono. Stereo VU-metr je k dispozici pouze pro 2-kanálové stereo samply s prokládaným formátem.

-I, --separate-channels

Jeden soubor pro každý kanál. Tato volba zakáže max-file-time a use-strftime a ignoruje SIGUSR1. Stereo VU metr není k dispozici se samostatnými kanály.

-P

Přehrávání. Toto je výchozí, pokud je program vyvolán zadáním aplay.

-C

Záznam. Toto je výchozí hodnota, pokud je program vyvolán zadáním arecord.

-i, --interactive

Povolit interaktivní provoz přes stdin. V současné době je implementováno pouze pozastavení/obnovení pomocí mezery nebo klávesy enter.

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

Dejte mapě kanálu, kterou chcete přepsat nebo sledovat. Předejte řetězce pozice kanálu jako FL, FR atd.

Pokud zařízení podporuje přepsání mapy kanálů, aplay se pokusí předat danou mapu kanálů. Pokud nepodporuje přepsání mapy kanálů, ale přesto poskytuje informace o mapě kanálů, aplay se pokusí změnit pořadí kanálů ve vyrovnávací paměti tak, aby odpovídalo mapě kanálů vrácené ze zařízení.

--disable-resample

Zakázat automatické převzorkování rychlosti.

--disable-channels

Zakázat automatické převody kanálů.

--disable-format

Zakázat automatické převody formátů.

--disable-softvol

Zakázat softwarové ovládání hlasitosti (softvol).

--test-position

Poloha vyrovnávací paměti testovacího kroužku.

--test-coef=<coef>

Testovací koeficient pro polohu prstencového nárazníku; výchozí je 8. Výraz pro ověření je: coef * (velikost_bufferu/2). Minimální hodnota je 1.

--test-nowait

Nečekejte, až ring buffer – sežere celý CPU.

--max-file-time

Když během nahrávání výstupní soubor shromažďuje zvuk tak dlouho, zavřete jej a otevřete nový výstupní soubor. Výchozí je maximální velikost podporovaná formátem souboru: 2 GiB pro soubory WAV. Tato volba nemá žádný účinek, pokud je zadáno --separate-channels.

--process-id-file <file name>

aplay sem zapíše své ID procesu, takže do něj mohou posílat signály jiné programy.

--use-strftime

Při nahrávání interpretujte %-kódy v parametru názvu souboru pomocí funkce strftime při každém otevření výstupního souboru. Důležité kódy strftime jsou: %Y je rok, %m měsíc, %d den v měsíci, %H hodina, %M minuta a %S sekunda. Kromě toho je %v číslo souboru začínající na 1. Když je zadána tato volba, přechodné adresáře pro výstupní soubor se vytvoří automaticky. Tato volba nemá žádný účinek, pokud je zadáno --separate-channels.

--dump-hw-params

Vypište hw_params předkonfigurovaného stavu zařízení do stderr. Výpis obsahuje funkce vybraného zařízení, jako jsou podporované formáty, vzorkovací frekvence, počty kanálů, perioda a bajty/velikost/čas vyrovnávací paměti. Pro raw zařízení hw:X tato volba v podstatě uvádí hardwarové možnosti zvukové karty.

--fatal-errors

Zakáže pokusy o obnovu, když dojde k chybám (např. xrun); proces přehrávání se místo toho okamžitě přeruší.

SIGNÁLY

Při nahrávání funkce SIGINT, SIGTERM a SIGABRT zavřou výstupní soubor a ukončí se. SIGUSR1 zavře výstupní soubor, otevře nový a bude pokračovat v nahrávání. SIGUSR1 však nefunguje s --separate-channels.

PŘÍKLADY

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

přehraje surový soubor "foobar" jako 22050-Hz, mono, 8-bit, Mu-Law .au soubor.

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

zaznamená foobar.wav jako 10sekundový soubor wave v kvalitě CD pomocí „kopie“ PCM (která může být definována v souboru .asoundrc uživatele jako:

pcm.copy {
  type plug
  slave {
    pcm hw
  }
  route_policy copy
}
arecord -t wav --max-file-time 30 mon.wav

Záznam z výchozího zdroje zvuku monofonně, 8 000 vzorků za sekundu, 8 bitů na vzorek. Spusťte nový soubor každých 30 sekund. Názvy souborů jsou mon-nn.wav, kde nn se zvyšuje od 01. Soubor po mon-99.wav je mon-100.wav.

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

Nahrávejte stereo z výchozího zdroje zvuku. Vytvořte nový soubor každou hodinu. Soubory jsou umístěny v adresářích na základě jejich počátečních dat a mají názvy, které zahrnují jejich počáteční časy a čísla souborů.

VIZ TAKÉ

alsamixer(1), amixer(1)

HMYZ

Všimněte si, že soubory .aiff nejsou aktuálně podporovány.

AUTOR

Autorem arecord a aplay je Jaroslav Kysela Autorem tohoto dokumentu je Paul Winkler . Aktualizováno pro Alsa 0.9 od Jamese Tappina