arecord - manual de referência, opções, exemplos de comandos


NOME

arecord , aplay - gravador de som de linha de comando e player para driver de placa de som ALSA

SINOPSE

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

DESCRIÇÃO

arecord é um gravador de arquivo de som de linha de comando para o driver da placa de som ALSA. Ele suporta vários formatos de arquivo e várias placas de som com vários dispositivos. Se gravar com amostras no modo intercalado, o arquivo é automaticamente dividido antes do tamanho do arquivo de 2 GB.

aplay é praticamente o mesmo, apenas toca em vez de gravar. Para formatos de arquivo de som suportados, a taxa de amostragem, profundidade de bits e assim por diante podem ser determinados automaticamente a partir do cabeçalho do arquivo de som.

Se o nome do arquivo não for especificado, a saída ou entrada padrão será usada. O utilitário aplay aceita vários nomes de arquivos.

OPÇÕES

-h, --help

Ajuda: mostre a sintaxe.

--version

Imprima a versão atual.

-l, --list-devices

Listar todas as placas de som e dispositivos de áudio digital

-L, --list-pcms

Listar todos os PCMs definidos

-D, --device=NAME

Selecione PCM pelo nome

-q --quiet

Modo silencioso. Suprimir mensagens (sem som :))

-t, --file-type TYPE

Tipo de arquivo (voc, wav, raw ou au). Se este parâmetro for omitido, o formato WAVE será usado.

-c, --channels=#

O número de canais. O padrão é um canal. Os valores válidos são de 1 a 32.

-f --format=FORMAT

Exemplo de formato
Os formatos de amostra reconhecidos são: 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_ LEI A_LAW IMA_ADPCM MPEG GSM ESPECIAL S24_3LE S24_3BE U24_3LE U24_3BE S20_3LE S20_3BE U20_3LE U20_3BE S18_3LE S18_3BE U18_3LE
Alguns deles podem não estar disponíveis no hardware selecionado
Os atalhos de formato disponíveis são:

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

Se nenhum formato for fornecido, U8 será usado.

-r, --rate=#<Hz>

Taxa de amostragem em Hertz. A taxa padrão é 8000 Hertz. Se o valor especificado for menor que 300, será considerado a taxa em kilohertz. Os valores válidos são de 2.000 a 192.000 Hertz.

-d, --duration=#

Interrompa após # segundos. Um valor de zero significa infinito. O padrão é zero, portanto, se esta opção for omitida, o processo de gravação/reprodução será executado até ser encerrado. A opção '-d' ou '-s' está disponível exclusivamente.

-s, --samples=#

Interrupção após a transmissão de # quadros PCM. Um valor de zero significa infinito. O padrão é zero, portanto, se esta opção for omitida, o processo de gravação/reprodução será executado até ser encerrado. A opção '-d' ou '-s' está disponível exclusivamente.

-M, --mmap

Use o modo de E/S mapeado em memória (mmap) para o fluxo de áudio. Se esta opção não for definida, o modo de E/S de leitura/gravação será usado.

-N, --nonblock

Abra o dispositivo de áudio no modo sem bloqueio. Se o dispositivo estiver ocupado, o programa será encerrado imediatamente. Se esta opção não for definida, o programa será bloqueado até que o dispositivo de áudio esteja disponível novamente.

-F, --period-time=#

A distância entre as interrupções é de # microssegundos. Se nenhum período de tempo e nenhum tamanho de período for fornecido, um quarto do tempo do buffer será definido.

-B, --buffer-time=#

A duração do buffer é de # microssegundos Se nenhum tempo de buffer e nenhum tamanho de buffer for fornecido, o tempo de buffer máximo permitido, mas não mais que 500 ms, será definido.

--period-size=#

A distância entre as interrupções é de # quadros Se nenhum tamanho de período e nenhum tempo de período for fornecido, um quarto do tamanho do buffer será definido.

--buffer-size=#

A duração do buffer é # frames Se nenhum tempo de buffer e nenhum tamanho de buffer for fornecido, então o tempo de buffer máximo permitido, mas não mais que 500 ms, será definido.

-A, --avail-min=#

O espaço mínimo disponível para ativação é de # microssegundos

-R, --start-delay=#

O atraso para o início automático do PCM é de # microssegundos (relativo ao tamanho do buffer se <= 0)

-T, --stop-delay=#

O atraso para a parada automática do PCM é de # microssegundos a partir do xrun

-v, --verbose

Mostrar estrutura e configuração do PCM. Esta opção é acumulativa. O medidor VU é exibido quando é dado duas ou três vezes.

-V, --vumeter=TYPE

Especifica o tipo de medidor VU, estéreo ou mono. O medidor VU estéreo está disponível apenas para amostras estéreo de 2 canais com formato intercalado.

-I, --separate-channels

Um arquivo para cada canal. Esta opção desativa o tempo máximo de arquivo e o tempo de uso strf e ignora o SIGUSR1. O medidor VU estéreo não está disponível com canais separados.

-P

Reprodução. Este é o padrão se o programa for chamado digitando aplay.

-C

Registro. Este é o padrão se o programa for chamado digitando arecord.

-i, --interactive

Permitir operação interativa via stdin. Atualmente, apenas pausar/reiniciar via espaço ou tecla enter é implementado.

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

Dê o mapa do canal para substituir ou seguir. Passe strings de posição do canal como FL, FR, etc.

Se um dispositivo suportar a substituição do mapa de canal, aplay tenta passar o mapa de canal fornecido. Se não for compatível com a substituição do mapa de canal, mas ainda fornecer as informações do mapa de canal, aplay tentará reorganizar a ordem do canal no buffer para corresponder ao mapa de canal retornado do dispositivo.

--disable-resample

Desative a reamostragem de taxa automática.

--disable-channels

Desative as conversões automáticas de canal.

--disable-format

Desative as conversões automáticas de formato.

--disable-softvol

Desative o controle de volume do software (softvol).

--test-position

Teste a posição do buffer do anel.

--test-coef=<coef>

Coeficiente de teste para a posição do buffer de anel; o padrão é 8. A expressão para validação é: coef * (buffer_size/2). O valor mínimo é 1.

--test-nowait

Não espere pelo buffer circular - consome toda a CPU.

--max-file-time

Durante a gravação, quando o arquivo de saída estiver acumulando som por tanto tempo, feche-o e abra um novo arquivo de saída. O padrão é o tamanho máximo suportado pelo formato de arquivo: 2 GiB para arquivos WAV. Esta opção não tem efeito se --separate-channels for especificado.

--process-id-file <file name>

aplay grava seu ID de processo aqui, para que outros programas possam enviar sinais para ele.

--use-strftime

Ao gravar, interprete %-codes no parâmetro de nome de arquivo usando o recurso strftime sempre que o arquivo de saída for aberto. Os códigos strftime importantes são: %Y é o ano, %m mês, %d dia do mês, %H hora, %M minuto e %S segundo. Além disso, %v é o número do arquivo, começando em 1. Quando esta opção é especificada, diretórios intermediários para o arquivo de saída são criados automaticamente. Esta opção não tem efeito se --separate-channels for especificado.

--dump-hw-params

Despeje hw_params do status pré-configurado do dispositivo para stderr. O dump lista os recursos do dispositivo selecionado, como formatos suportados, taxas de amostragem, números de canais, período e bytes/tamanhos/tempos de buffer. Para o dispositivo raw hw:X, esta opção basicamente lista os recursos de hardware da placa de som.

--fatal-errors

Desativa as tentativas de recuperação quando são encontrados erros (por exemplo, xrun); o processo de reprodução aborta imediatamente.

SINAIS

Ao gravar, SIGINT, SIGTERM e SIGABRT fecharão o arquivo de saída e sairão. O SIGUSR1 fechará o arquivo de saída, abrirá um novo e continuará gravando. No entanto, SIGUSR1 não funciona com --separate-channels.

EXEMPLOS

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

reproduzirá o arquivo bruto "foobar" como um arquivo Mu-Law .au de 22050 Hz, mono, 8 bits.

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

gravará foobar.wav como um arquivo wave de 10 segundos com qualidade de CD, usando a "cópia" PCM (que pode ser definida no arquivo .asoundrc do usuário como:

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

Grave da fonte de áudio padrão em mono, 8.000 amostras por segundo, 8 bits por amostra. Inicie um novo arquivo a cada 30 segundos. Os nomes dos arquivos são mon-nn.wav, onde nn aumenta de 01. O arquivo após 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

Grave em estéreo a partir da fonte de áudio padrão. Crie um novo arquivo a cada hora. Os arquivos são colocados em diretórios com base em suas datas de início e têm nomes que incluem seus horários de início e números de arquivo.

VEJA TAMBÉM

alsamixer(1), amixer(1)

INSETOS

Observe que os arquivos .aiff não são suportados no momento.

AUTOR

arecord e aplay são de Jaroslav Kysela perex@perex.cz Este documento é de Paul Winkler zarmzarm@erols.com. Atualizado para Alsa 0.9 por James Tappin james@xena.uklinux.net