aplay - hướng dẫn tham khảo, tùy chọn, ví dụ về lệnh


TÊN

aplay arecord, aplay - trình ghi và phát âm thanh dòng lệnh cho trình điều khiển cạc âm thanh ALSA

TÓM TẮT

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

SỰ MIÊU TẢ

arecord là trình ghi tệp âm thanh dòng lệnh dành cho trình điều khiển cạc âm thanh ALSA. Nó hỗ trợ một số định dạng tệp và nhiều soundcard với nhiều thiết bị. Nếu ghi với các mẫu chế độ xen kẽ, tệp sẽ tự động được phân tách trước kích thước tệp 2GB.

aplay cũng giống như vậy, chỉ khác là phát thay vì ghi. Đối với các định dạng tệp âm thanh được hỗ trợ, tốc độ lấy mẫu, độ sâu bit, v.v. có thể được xác định tự động từ tiêu đề tệp âm thanh.

Nếu tên tệp không được chỉ định, đầu ra hoặc đầu vào tiêu chuẩn sẽ được sử dụng. Tiện ích aplay chấp nhận nhiều tên tệp.

TÙY CHỌN

-h, --help

Trợ giúp: hiển thị cú pháp.

--version

In phiên bản hiện tại.

-l, --list-devices

Liệt kê tất cả các soundcard và thiết bị âm thanh kỹ thuật số

-L, --list-pcms

Liệt kê tất cả các PCM được xác định

-D, --device=NAME

Chọn PCM theo tên

-q --quiet

Chế độ yên lặng. Chặn tin nhắn (không có âm thanh :))

-t, --file-type TYPE

Loại tệp (voc, wav, raw hoặc au). Nếu tham số này bị bỏ qua, định dạng WAVE sẽ được sử dụng.

-c, --channels=#

Số lượng kênh. Mặc định là một kênh. Các giá trị hợp lệ là từ 1 đến 32.

-f --format=FORMAT

Định dạng mẫu
Các định dạng mẫu được công nhận là: 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_ LUẬT IMA_ADPCM MPEG GSM ĐẶC BIỆT S24_3LE S24_3BE U24_3LE U24_3BE S20_3LE S20_3BE U20_3LE U20_3BE S18_3LE S18_3BE U18_3LE
Một số trong số này có thể không khả dụng trên phần cứng được chọn
Các phím tắt định dạng có sẵn là:

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

Nếu không có định dạng nào được đưa ra thì U8 sẽ được sử dụng.

-r, --rate=#<Hz>

Tốc độ lấy mẫu tính bằng Hertz. Tốc độ mặc định là 8000 Hertz. Nếu giá trị được chỉ định nhỏ hơn 300, thì nó được coi là tốc độ tính bằng kilohertz. Giá trị hợp lệ là 2000 đến 192000 Hertz.

-d, --duration=#

Ngắt sau # giây. Giá trị bằng không có nghĩa là vô cùng. Giá trị mặc định là 0, vì vậy nếu tùy chọn này bị bỏ qua thì quá trình ghi/phát lại sẽ chạy cho đến khi nó bị tắt. Tùy chọn '-d' hoặc '-s' chỉ khả dụng.

-s, --samples=#

Ngắt sau khi truyền khung # PCM. Giá trị bằng không có nghĩa là vô cùng. Giá trị mặc định là 0, vì vậy nếu tùy chọn này bị bỏ qua thì quá trình ghi/phát lại sẽ chạy cho đến khi nó bị tắt. Tùy chọn '-d' hoặc '-s' chỉ khả dụng.

-M, --mmap

Sử dụng chế độ I/O ánh xạ bộ nhớ (mmap) cho luồng âm thanh. Nếu tùy chọn này không được đặt, chế độ I/O đọc/ghi sẽ được sử dụng.

-N, --nonblock

Mở thiết bị âm thanh ở chế độ không chặn. Nếu máy bận chương trình sẽ thoát ngay. Nếu tùy chọn này không được đặt, chương trình sẽ chặn cho đến khi thiết bị âm thanh khả dụng trở lại.

-F, --period-time=#

Khoảng cách giữa các lần ngắt là # micro giây. Nếu không có khoảng thời gian và kích thước khoảng thời gian không được đưa ra thì một phần tư thời gian đệm được đặt.

-B, --buffer-time=#

Thời lượng bộ đệm là # micro giây Nếu không có thời gian bộ đệm và kích thước bộ đệm không được cung cấp thì thời gian bộ đệm tối đa được phép nhưng không quá 500 mili giây sẽ được đặt.

--period-size=#

Khoảng cách giữa các lần ngắt là # khung Nếu không có kích thước khoảng thời gian và không có khoảng thời gian được đưa ra thì một phần tư kích thước bộ đệm được đặt.

--buffer-size=#

Thời lượng bộ đệm là # khung Nếu không có thời gian bộ đệm và kích thước bộ đệm không được cung cấp thì thời gian bộ đệm tối đa được phép nhưng không quá 500 mili giây sẽ được đặt.

-A, --avail-min=#

Dung lượng trống tối thiểu để đánh thức là # micro giây

-R, --start-delay=#

Độ trễ khởi động PCM tự động là # micro giây (so với kích thước bộ đệm nếu <= 0)

-T, --stop-delay=#

Độ trễ để dừng PCM tự động là # micro giây từ xrun

-v, --verbose

Hiển thị cấu trúc và thiết lập PCM. Tùy chọn này là tích lũy. Đồng hồ VU được hiển thị khi điều này được đưa ra hai lần hoặc ba lần.

-V, --vumeter=TYPE

Chỉ định loại máy đo VU, âm thanh nổi hoặc mono. Máy đo VU âm thanh nổi chỉ khả dụng cho các mẫu âm thanh nổi 2 kênh với định dạng xen kẽ.

-I, --separate-channels

Một tập tin cho mỗi kênh. Tùy chọn này vô hiệu hóa thời gian tệp tối đa và thời gian sử dụng và bỏ qua SIGUSR1. Máy đo VU âm thanh nổi không khả dụng với các kênh riêng biệt.

-P

phát lại. Đây là giá trị mặc định nếu chương trình được gọi bằng cách gõ aplay.

-C

Ghi. Đây là giá trị mặc định nếu chương trình được gọi bằng cách gõ arecord.

-i, --interactive

Cho phép thao tác tương tác thông qua stdin. Hiện tại, chỉ tạm dừng/tiếp tục thông qua dấu cách hoặc phím enter mới được triển khai.

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

Đưa ra bản đồ kênh để ghi đè hoặc theo dõi. Chuyển các chuỗi vị trí kênh như FL, FR, v.v.

Nếu một thiết bị hỗ trợ ghi đè bản đồ kênh, thì aplay sẽ cố gắng chuyển bản đồ kênh đã cho. Nếu nó không hỗ trợ ghi đè bản đồ kênh nhưng nó vẫn cung cấp thông tin bản đồ kênh, thì aplay sẽ cố gắng sắp xếp lại thứ tự kênh trong bộ đệm để khớp với bản đồ kênh được trả về từ thiết bị.

--disable-resample

Vô hiệu hóa việc lấy mẫu lại tỷ lệ tự động.

--disable-channels

Vô hiệu hóa chuyển đổi kênh tự động.

--disable-format

Vô hiệu hóa chuyển đổi định dạng tự động.

--disable-softvol

Vô hiệu hóa điều khiển âm lượng phần mềm (softvol).

--test-position

Kiểm tra vị trí đệm vòng.

--test-coef=<coef>

Hệ số kiểm tra vị trí đệm vòng; mặc định là 8. Biểu thức để xác thực là: coef * (buffer_size/2). Giá trị tối thiểu là 1.

--test-nowait

Đừng đợi bộ đệm đổ chuông – ăn toàn bộ CPU.

--max-file-time

Trong khi ghi âm, khi tệp đầu ra đã tích lũy âm thanh trong một thời gian dài, hãy đóng tệp đó lại và mở một tệp đầu ra mới. Mặc định là kích thước tối đa được định dạng tệp hỗ trợ: 2 GiB cho tệp WAV. Tùy chọn này không có hiệu lực nếu --separate-channels được chỉ định.

--process-id-file <file name>

aplay viết ID tiến trình của nó ở đây, vì vậy các chương trình khác có thể gửi tín hiệu đến nó.

--use-strftime

Khi ghi, diễn giải %-codes trong tham số tên tệp bằng tiện ích strftime bất cứ khi nào tệp đầu ra được mở. Các mã strftime quan trọng là: %Y là năm, %m tháng, %d ngày trong tháng, %H giờ, %M phút và %S giây. Ngoài ra, %v là số tệp, bắt đầu từ 1. Khi tùy chọn này được chỉ định, các thư mục trung gian cho tệp đầu ra sẽ được tạo tự động. Tùy chọn này không có hiệu lực nếu --separate-channels được chỉ định.

--dump-hw-params

Kết xuất hw_params của trạng thái được cấu hình sẵn của thiết bị sang thiết bị lỗi chuẩn. Kết xuất liệt kê các khả năng của thiết bị đã chọn, chẳng hạn như định dạng được hỗ trợ, tốc độ lấy mẫu, số lượng kênh, khoảng thời gian và byte/kích thước/thời gian của bộ đệm. Đối với thiết bị thô hw:X, tùy chọn này về cơ bản liệt kê các khả năng phần cứng của card âm thanh.

--fatal-errors

Vô hiệu hóa các nỗ lực khôi phục khi gặp lỗi (ví dụ: xrun); Thay vào đó, quá trình aplay bị hủy bỏ ngay lập tức.

TÍN HIỆU

Khi ghi, SIGINT, SIGTERM và SIGABRT sẽ đóng tệp đầu ra và thoát. SIGUSR1 sẽ đóng tệp đầu ra, mở một tệp mới và tiếp tục ghi. Tuy nhiên, SIGUSR1 không hoạt động với --separate-channels.

VÍ DỤ

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

sẽ phát tệp thô "foobar" dưới dạng tệp 22050-Hz, mono, 8-bit, Mu-Law .au.

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

sẽ ghi foobar.wav dưới dạng tệp sóng 10 giây, chất lượng CD, sử dụng "bản sao" PCM (có thể được định nghĩa trong tệp .asoundrc của người dùng là:

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

Ghi từ nguồn âm thanh mặc định ở dạng đơn âm, 8.000 mẫu mỗi giây, 8 bit mỗi mẫu. Bắt đầu một tệp mới cứ sau 30 giây. Tên tệp là mon-nn.wav, trong đó nn tăng từ 01. Tệp sau mon-99.wav là mon-100.wav.

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

Ghi âm thanh nổi từ nguồn âm thanh mặc định. Tạo một tệp mới mỗi giờ. Các tệp được đặt trong các thư mục dựa trên ngày bắt đầu của chúng và có tên bao gồm thời gian bắt đầu và số tệp.

XEM THÊM

alsamixer(1), amixer(1)

LỖI

Lưu ý rằng các tệp .aiff hiện không được hỗ trợ.

TÁC GIẢ

arecord và aplay là của Jaroslav Kysela Tài liệu này là của Paul Winkler . Cập nhật cho Alsa 0.9 bởi James Tappin