aplay - manual referensi, opsi, contoh perintah


NAMA

aplay arecord, aplay - perekam dan pemutar suara baris perintah untuk driver kartu suara ALSA

RINGKASAN

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

KETERANGAN

arecord adalah perekam file suara baris perintah untuk driver kartu suara ALSA. Ini mendukung beberapa format file dan beberapa kartu suara dengan beberapa perangkat. Jika merekam dengan sampel mode interleaved file secara otomatis dibagi sebelum ukuran file 2GB.

aplay hampir sama, hanya diputar alih-alih merekam. Untuk format file suara yang didukung, kecepatan pengambilan sampel, kedalaman bit, dan sebagainya dapat ditentukan secara otomatis dari header file suara.

Jika nama file tidak ditentukan, output atau input standar digunakan. Utilitas aplay menerima beberapa nama file.

PILIHAN

-h, --help

Bantuan: tampilkan sintaks.

--version

Cetak versi saat ini.

-l, --list-devices

Daftar semua kartu suara dan perangkat audio digital

-L, --list-pcms

Buat daftar semua PCM yang ditentukan

-D, --device=NAME

Pilih PCM berdasarkan nama

-q --quiet

Modus senyap. Menekan pesan (tidak terdengar :))

-t, --file-type TYPE

Jenis file (voc, wav, raw atau au). Jika parameter ini dihilangkan, format WAVE digunakan.

-c, --channels=#

Jumlah saluran. Standarnya adalah satu saluran. Nilai yang valid adalah 1 hingga 32.

-f --format=FORMAT

Contoh format
Contoh format yang dikenali adalah: 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_ HUKUM A_LAW IMA_ADPCM MPEG GSM KHUSUS S24_3LE S24_3BE U24_3LE U24_3BE S20_3LE S20_3BE U20_3LE U20_3BE S18_3LE S18_3BE U18_3LE
Beberapa di antaranya mungkin tidak tersedia pada perangkat keras yang dipilih
Pintasan format yang tersedia adalah:

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

Jika tidak ada format yang diberikan, U8 digunakan.

-r, --rate=#<Hz>

Laju pengambilan sampel dalam Hertz. Tingkat default adalah 8000 Hertz. Jika nilai yang ditentukan kurang dari 300, diambil sebagai tarif dalam kilohertz. Nilai yang valid adalah 2000 hingga 192000 Hertz.

-d, --duration=#

Interupsi setelah # detik. Nilai nol berarti tak terhingga. Standarnya adalah nol, jadi jika opsi ini dihilangkan maka proses perekaman/pemutaran akan berjalan hingga dimatikan. Opsi '-d' atau '-s' tersedia secara eksklusif.

-s, --samples=#

Interupsi setelah transmisi # frame PCM. Nilai nol berarti tak terhingga. Standarnya adalah nol, jadi jika opsi ini dihilangkan maka proses perekaman/pemutaran akan berjalan hingga dimatikan. Opsi '-d' atau '-s' tersedia secara eksklusif.

-M, --mmap

Gunakan mode I/O yang dipetakan memori (mmap) untuk streaming audio. Jika opsi ini tidak diatur, mode baca/tulis I/O akan digunakan.

-N, --nonblock

Buka perangkat audio dalam mode non-blocking. Jika perangkat sedang sibuk, program akan segera keluar. Jika opsi ini tidak disetel, program akan memblokir hingga perangkat audio tersedia kembali.

-F, --period-time=#

Jarak antar interupsi adalah # mikrodetik. Jika tidak ada waktu periode dan tidak ada ukuran periode yang diberikan maka seperempat dari waktu buffer akan diatur.

-B, --buffer-time=#

Durasi buffer adalah # mikrodetik Jika tidak ada waktu buffer dan tidak ada ukuran buffer yang diberikan, maka waktu buffer maksimal yang diizinkan tetapi tidak lebih dari 500 md telah ditetapkan.

--period-size=#

Jarak antara interupsi adalah # frame Jika tidak ada ukuran periode dan tidak ada periode waktu yang diberikan maka seperempat dari ukuran buffer diatur.

--buffer-size=#

Durasi buffer adalah # frame Jika tidak ada waktu buffer dan tidak ada ukuran buffer yang diberikan, maka waktu buffer maksimal yang diperbolehkan tetapi tidak lebih dari 500 md telah ditetapkan.

-A, --avail-min=#

Ruang minimum yang tersedia untuk bangun adalah # mikrodetik

-R, --start-delay=#

Penundaan untuk start PCM otomatis adalah # mikrodetik (relatif terhadap ukuran buffer jika <= 0)

-T, --stop-delay=#

Penundaan untuk penghentian PCM otomatis adalah # mikrodetik dari xrun

-v, --verbose

Tampilkan struktur dan pengaturan PCM. Opsi ini bersifat akumulatif. Pengukur VU ditampilkan saat diberikan dua atau tiga kali.

-V, --vumeter=TYPE

Menentukan jenis VU-meter, baik stereo atau mono. Pengukur VU stereo hanya tersedia untuk sampel stereo 2 saluran dengan format interleaved.

-I, --separate-channels

Satu file untuk setiap saluran. Opsi ini menonaktifkan max-file-time dan use-strftime, dan mengabaikan SIGUSR1. Pengukur VU stereo tidak tersedia dengan saluran terpisah.

-P

Pemutaran. Ini adalah default jika program dijalankan dengan mengetikkan aplay.

-C

Catatan. Ini adalah default jika program dipanggil dengan mengetik arecord.

-i, --interactive

Izinkan operasi interaktif melalui stdin. Saat ini hanya jeda/lanjutkan melalui spasi atau tombol enter yang diterapkan.

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

Berikan peta saluran untuk ditimpa atau diikuti. Lewati string posisi saluran seperti FL, FR, dll.

Jika perangkat mendukung penggantian peta saluran, aplay mencoba meneruskan peta saluran yang diberikan. Jika tidak mendukung penggantian peta saluran tetapi tetap memberikan informasi peta saluran, aplay mencoba mengatur ulang urutan saluran dalam buffer agar sesuai dengan peta saluran yang dikembalikan dari perangkat.

--disable-resample

Nonaktifkan contoh tarif otomatis.

--disable-channels

Nonaktifkan konversi saluran otomatis.

--disable-format

Nonaktifkan konversi format otomatis.

--disable-softvol

Nonaktifkan kontrol volume perangkat lunak (softvol).

--test-position

Uji posisi penyangga cincin.

--test-coef=<coef>

Koefisien uji untuk posisi penyangga cincin; standarnya adalah 8. Ekspresi untuk validasi adalah: coef * (buffer_size/2). Nilai minimum adalah 1.

--test-nowait

Jangan menunggu ring buffer ‐ memakan seluruh CPU.

--max-file-time

Saat merekam, ketika file keluaran telah mengumpulkan suara selama ini, tutup dan buka file keluaran baru. Standarnya adalah ukuran maksimum yang didukung oleh format file: 2 GiB untuk file WAV. Opsi ini tidak berpengaruh jika --separate-channels ditentukan.

--process-id-file <file name>

aplay menulis ID prosesnya di sini, sehingga program lain dapat mengirim sinyal ke sana.

--use-strftime

Saat merekam, interpretasikan %-codes dalam parameter nama file menggunakan fasilitas strftime setiap kali file keluaran dibuka. Kode strftime yang penting adalah: %Y adalah tahun, %m bulan, %d hari dalam sebulan, %H jam, %M menit, dan %S detik. Selain itu, %v adalah nomor file, mulai dari 1. Jika opsi ini ditentukan, direktori perantara untuk file keluaran dibuat secara otomatis. Opsi ini tidak berpengaruh jika --separate-channels ditentukan.

--dump-hw-params

Buang hw_params dari status prakonfigurasi perangkat ke stderr. Kemampuan daftar dump dari perangkat yang dipilih seperti format yang didukung, laju pengambilan sampel, jumlah saluran, periode, dan byte/ukuran/waktu buffer. Untuk perangkat mentah hw:X opsi ini pada dasarnya mencantumkan kemampuan perangkat keras kartu suara.

--fatal-errors

Menonaktifkan upaya pemulihan saat terjadi kesalahan (mis. xrun); proses aplay malah langsung dibatalkan.

SINYAL

Saat merekam, SIGINT, SIGTERM dan SIGABRT akan menutup file keluaran dan keluar. SIGUSR1 akan menutup file keluaran, membuka yang baru, dan melanjutkan perekaman. Namun, SIGUSR1 tidak berfungsi dengan --separate-channels.

CONTOH

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

akan memutar file mentah "foobar" sebagai file .au 22050-Hz, mono, 8-bit, Mu-Law.

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

akan merekam foobar.wav sebagai file gelombang kualitas CD 10 detik, menggunakan "salinan" PCM (yang mungkin ditentukan dalam file .asoundrc pengguna sebagai:

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

Rekam dari sumber audio default dalam monaural, 8.000 sampel per detik, 8 bit per sampel. Mulai file baru setiap 30 detik. Nama file adalah mon-nn.wav, di mana nn bertambah dari 01. File setelah mon-99.wav adalah mon-100.wav.

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

Rekam dalam stereo dari sumber audio default. Buat file baru setiap jam. File ditempatkan di direktori berdasarkan tanggal mulainya dan memiliki nama yang menyertakan waktu mulai dan nomor file.

LIHAT JUGA

alsamixer(1), amixer(1)

BUG

Perhatikan bahwa file .aiff saat ini tidak didukung.

PENGARANG

arecord dan aplay oleh Jaroslav Kysela Dokumen ini oleh Paul Winkler . Diperbarui untuk Alsa 0.9 oleh James Tappin