NAME

audioplay − Play an audio file. 
 
 

SYNOPSIS

audioplay [-filename filename] [-odevice #] [-channels #] [-bitspersample #] [-rate #] [-encoding format] [-numbuffers #] [-sizebuffers #] [-msbuffers #] [-verbose] [-help]
 
 

DESCRIPTION

audioplay plays an audio file using the Multimedia Services product. The file may be in WAVE format or SUN (.au) format. This includes files recorded using the audiorecord and DECsound programs. If the file is not in one of these formats, it will be played as a raw audio file. 

The format options which are in the file header will be used to play the file. The user can override any of these using the command line options.  If the file is a raw audio file, then the default values will be used. 

Pressing Ctrl/C will pause the playback, which can be resumed by pressing the Return key. The program can be terminated by pressing a second Ctrl/C.  Otherwise, the entire file is played. 

To determine the device number and formats supported for an audio output device, use the audiodevices program. 
 
 

OPTIONS

audioplay accepts the following command line options:

[-filename filename]
Audio file name to play.  If the file name is "-", input will be taken from stdin.  Defaults to tempfile.wav.

[-odevice #]
Output device number.  The default is search all.

[-channels #]
Number of channels. Options are 1 (Mono) or 2 (Stereo). The default is 1 (Mono) for raw audio files.

[-bitspersample #]
Number of bits per sample.  Defaults to 8 for raw audio files.

[-rate #]
Sample rate in Hz.  Defaults to 8000 for raw audio files.

[-encoding format]
Audio encoding format.  Valid entries are pcm for PCM format or mulaw for mulaw format.  Default is mulaw for raw audio files.

[-numbuffers #]
Number of buffers to allocate.  The default is 4.

[-sizebuffers #]
Size, in bytes, of each buffer. If values are entered for [-sizebuffers #] and [-msbuffers #], the [-msbuffers #] value is used and the [-sizebuffers #] value is ignored. By default the byte size of each buffer is dependent on the value for [-msbuffers #]. 

[-msbuffers #]
Size, in milliseconds, of each buffer. Unless [-sizebuffers #] overrides this value, the default value is 250 milliseconds. 

[-verbose]
Prints various status messages.

[-help] Displays help information. 
 
 

FILES

/usr/bin/mme/audioplay
 
 

SEE ALSO

audiocontrol(1mms), audiodevices(1mms), audioplay(1mms), audioselectports(1mms), decsound(1mms), mms(1mms), mmeserver(1mms)