Page 442 - Asterisk™: The Future of Telephony

See Also
SayAlpha(), SayPhonetic()

MP3Player() Plays an MP3 file or stream
MP3Player(location)

Uses the mpg123 program to play the given location to the caller. The specified loca-
tion can be either a filename or a valid URL. The caller can exit by pressing any key.

The correct version of mpg123 must be installed for this application to
work properly. Asterisk currently works best with mpg123-0.59r. Other
versions may give less than desirable results.

exten => 123,1,Answer()
exten => 123,2,MP3Player(test.mp3)
exten => 123,1,Answer()
exten => 123,2,MP3Player(http://example.com/test.mp3)

MusicOnHold() Plays music on hold indefinitely

MusicOnHold(class)
Plays hold music specified by class, as configured in musiconhold.conf. If omitted, the
default music class for the channel will be used. You can use the MUSICCLASS dialplan
function to set the default music class for the channel.
; transfer telemarketers to this extension to keep them busy
exten => 123,1,Answer()
exten => 123,n,Playback(tt-allbusy)
exten => 123,n,MusicOnHold(default)

See Also
SetMusicOnHold(), WaitMusicOnHold(), MUSICCLASS

NBScat() Plays an NBS local stream
NBScat()

Uses the nbscat8k program to listen to the local Network Broadcast Sound (NBS)
stream. (For more information, see the nbs module in Digium’s Subversion server.) The
caller can exit by pressing any key.
Returns -1 on hangup; otherwise, does not return.

414 | Appendix B: Application Reference