Early media refers to any media that is played to the initial caller’s phone before the remote party has picked up the phone. That “brrrrrrrring!” noise you hear before the person you called has picked up the phone is an example of early media.

That ringing noise is not actually the other person’s phone, but a tone that’s generated by the system that’s setting up the call. Theoretically that ring can be anything, including music or audio files.

Asterisk can set up calls while generating early media. In fact, the “r” flag in the Dial command tells asterisk to generate the necessary tones for the “rrrrring!” audio.

exten => s,1,Dial(SIP/flowroute/16466429000,30,r);  <--- that "r" flag will generate ringing while Asterisk is setting up the call.

One of the great things about Asterisk is that it tries to “abstract” out the notion of a phone call. In other words, virtually all of Asterisk’s commands work the same way regardless of whether the actual call was SIP, IAX, H323, SS7, or any other crazy VoIP protocol.

However, this doesn’t work perfectly in practice. Each VoIP protocol behaves in slightly different ways, and sometimes that conflicts with Asterisk commands. SIP and IAX will allow early media but others may not. Also, some VoIP providers will block early media and replace it with their own.

There are a couple of ways to use early media. The first way is to play a message before initiating the call. An example of this would be a message that says “please stay on the line while I complete that call” followed by ringing the other caller’s phone. The other way is to basically replace the preset ringing tone with an audio stream. An example might be to play music to the initial caller as the remote phone is ringing. As soon as the remote party picks up the phone the song would stop.

How to play early media to a caller before ringing the phone:

exten => _1NXXNXXXXXX,1,Progress()
exten => _1NXXNXXXXXX,n,Playback(demo-abouttotry,noanswer)
exten => _1NXXNXXXXXX,n,Dial(SIP/flowroute/${EXTEN},30,r)
  • Progress() will let the phone system know that we are about to forward the call to another line. This is important for SIP calls, but may be optional for IAX calls. Just to be on the safe side, use it whenever you are about to generate early media.
  • Playback() needs to include the “noanswer” flag so that it won’t automatically answer the channel when it plays the media. The remote phone won’t ring until this audio file has fully played.
  • Dial() works as you would expect.

How to play early media to a caller while ringing the phone:

exten => s,1,Progress()
exten => s,n,Dial(IAX2/ck987_iax,30,m(ck987_moh))
  • Progress() will let the phone system know that we are about to forward the call to another line. This is important for SIP calls, but may be optional for IAX calls. Just to be on the safe side, use it whenever you are about to generate early media.
  • Dial() uses the “m(music_on_hold_class)” flag to play back audio while generating the call. See below for information on how to set up Music On Hold.

More Information on Early Media

Music On Hold

The most obvious use for Music on Hold (or “moh”) is to give a caller something to listen to while they are on hold or in a queue. You can set up various Music On Hold “classes” in your musiconhold.conf files. Here’s what mine looks like:

[ck987_moh]
mode=files
directory=/home/ck987/asterisk_sounds/moh
sort=random
  • mode=files means that this moh class will use audio files as its source.
  • directory=/home/ck987/asterisk_sounds/moh tells asterisk to play any file that’s in this directory
  • sort=random will randomly play a file in this directory. The other option would be “alpha” which would go through the list in alphabetical order.

In your dialplan, you can set a channel’s music on hold like this:

exten => s,n,Set(CHANNEL(musicclass)=ck987_moh); <---replace ck987_moh with your moh class.

If a SIP or IAX phone is placed on hold, the other caller should start to hear the audio defined by the active moh class. There is a MusicOnHold() command which will force Music On Hold to start, but you really should avoid this command. If you want to play an audio file, use Playback or Background. Music on Hold is a service that other commands can use. For example, Music On Hold can be used to play “early media” to a phone while it tries to connect another phone. See above for more info.

ADVANCED: Streaming External Audio for Music On Hold
Don’t try this unless it all makes sense to you!
A music on hold class can accept properly formatted audio streams as input. The audio must be 8000 hz, 16 bit, mono, PCM (uncompressed). The data is streamed through “Standard Out” (STDOUT).

When you make a class that uses an external process and do “module reload”, it will start the process at that exact moment. This means that it is sitting in the background, using up resources on the system. That’s fine for a few streams, but may become an issue if there’s a lot of them.

Here’s a Music On Hold class where I use an app called mpg123 to reformat and output the NPR Radio MP3 stream. Feel free to use this class in your own dialplans:

[ck987_stream]
mode=custom
application=/usr/bin/mpg123 -q -r 8000 -0 -s http://nprdmp.ic.llnwd.net/stream/nprdmp_live01_mp3
  • -q stops the app from listing the name of the stream at the beginning of playback
  • -r 8000 resamples the audio to 8000Hz
  • -0 uses only the “left” channel, which is fine since we need mono and NPR isn’t in stereo. (-m would mix down a stereo stream to mono.)
  • -s sends the data to STDOUT
  • http://nprdmp.ic.llnwd.net/stream/nprdmp_live01_mp3 is the URL for National Public Radio’s realtime MP3 stream.

Early Media and Music on Hold的更多相关文章

  1. Latest China Scam: I've Been Arrested in the Brothel Crackdown!

    Latest China Scam: I've Been Arrested in the Brothel Crackdown! If the sex industry is fastest to se ...

  2. linphone3.4.0代码分析

    主要类型定义: 1.LinphoneCoreVTable /** * This structure holds all callbacks that the application should im ...

  3. SIP UserAgent (B2BUA client)——linphonec

    1.linphone编译 linphone一般用在android/ios/windows/mobile上,但是没有图形界面的linphonec命令行程序用在资源紧张的硬件平台上也跟pjsip命令行一样 ...

  4. Rx

    more detailed in WIKI's document SDP :session description protocal book AAA AA-Answer 鉴权授权应答AAR AA-R ...

  5. ICE学习笔记 -- RFC 5245

    RFC 5245 ICE   1, offer/answer model 2, ICE Step:    1) 产生候选地址(1.公网 2.NAT反射 3.Relay转发地址) Generate ca ...

  6. 转:SIP相关的RFC文档索引

    索引来源于http://www.packetizer.com/ipmc/sip/standards.html SIP Standards Core SIP Documents RFC Document ...

  7. Efficient ticket lock synchronization implementation using early wakeup in the presence of oversubscription

    A turn-oriented thread and/or process synchronization facility obtains a ticket value from a monoton ...

  8. 3 Financial Services Social Media Success Storie

    As financial services firms step-up their use of social media, we’ve been looking for some early suc ...

  9. Early 80386 CPUs

    Assembling a detailed and accurate history of the 80386, including a complete listing of all the &qu ...

随机推荐

  1. javascript的slice(),splice(),split(),substring(),substr()

    例子摘抄于http://www.w3school.com.cn/jsref/jsref_obj_array.asp 1.slice(): Array和String对象都有 在Array中  slice ...

  2. mysql忘记password

    有时候突然忘记MySQL的password会真的不爽,这里介绍一种MySQLpassword忘记时重置password的方法,操作系统win8,MySql version:5.6.10 1 在任务管理 ...

  3. 开始nodejs+express的学习+实践(1)

    开始nodejs+express的学习+实践(1) 开始nodejs+express的学习+实践(2) 开始nodejs+express的学习+实践(3) 开始nodejs+express的学习+实践 ...

  4. Redis闲谈(1):构建知识图谱

    场景:Redis面试 (图片来源于网络) 面试官: 我看到你的简历上说你熟练使用Redis,那么你讲一下Redis是干嘛用的? 小明: (心中窃喜,Redis不就是缓存吗?)Redis主要用作缓存,通 ...

  5. 49 个jquery代码经典片段

    49 个jquery代码经典片段,这些代码能够给你的javascript项目提供帮助.其中的一些代码段是从jQuery1.4.2才开始支持的做法,另一 些则是真正有用的函数或方法,他们能够帮助你又快又 ...

  6. linux下安装最新版Subversion 1.8.9

    linux下安装最新版subversion,代码: [root@localhost subversion-1.8.9]# ./configure --prefix=/usr/local/subvers ...

  7. Times[2017-01-25at JiNan]

    Times[问题描述 ]小 y 作为一名资深的 dotaer,对视野的控制有着深刻的研究.每个单位在一段特定的时间内会出现在小 y 的视野内,除此之外的时间都在小 y 看不到的地方.在小 y 看来,视 ...

  8. 【BZOJ2789】[Poi2012]Letters 树状数组

    [BZOJ2789][Poi2012]Letters Description 给出两个长度相同且由大写英文字母组成的字符串A.B,保证A和B中每种字母出现的次数相同. 现在每次可以交换A中相邻两个字符 ...

  9. mysql系列之1.mysql基础

    非关系型(NOSQL)数据库 键值存储数据库: memcached  /  redis  /  memcachedb  /  Berkeley db 列存储数据库: Cassandra  /  Hba ...

  10. 20179209课后作业之od命令重写

    一.问题描述: 1 复习c文件处理内容 2 编写myod.c 用myod XXX实现Linux下od -tx -tc XXX的功能 3. main与其他分开,制作静态库和动态库 4. 编写Makefi ...