Asterisk命令MeetMe詳解
2010/02/02
MeetMe
概要
MeetMe 會議橋
描述
語法：MeetMe([confno][,[options][,pin]])
用途: 讓用戶進入一個指定的MeetMe會議。如果省略了會議編號，系統(tǒng)會提示用戶選擇一個。（注意：MeetMe會議需要一個Zaptel時鐘才能工作，你可以不裝任何板卡，但是你需要安裝Zaptel）
參數(shù)：options可以為空，也可以設置一個或者多個參數(shù)，參數(shù)有如下一些：
- '1' — 當會議室的第一個成員進入會議時，不向用戶提示"you are currently the only person in
this conference您是當前會議室唯一的成員" (Asterisk 1.2.11以上版本才支持)
- 'a' — 設為管理員
- 'A' — 設為標記成員
- 'b' — 運行在${MEETME_AGI_BACKGROUND}指定的AGI腳本
- 缺省: conf-background.agi (注意：需要會議室內(nèi)有ZAP通道才能運行)
- 'c' — 加入會議時提示會議成員數(shù)量
- 'd' — 動態(tài)加入會議
- 'D' — 動態(tài)加入會議，提示要求輸入密碼
- 'e' — 選擇一個空會議。
- 'E' — 選擇一個沒密碼的空會議。
- 'F' — 在會議中透傳DTMF按鍵，所有成員都能收到DTMF。
- 'i' —提示有成員加入/離開會議with review— 需要chan_zap.so (Asterisk 1.2以上版本才支持)
- 'I' --提示有成員加入/離開會議 without review
- 'M' —當會議室只有一個人的時候放等待音樂
- 'm' —旁聽狀態(tài)(只能聽，不能說)
- 'p' —允許用戶按井退出會議室
- 'P' — 無論用戶是否指定，總是提示用戶輸入會議密碼
- 'q' — 安靜模式 (有成員加入/離開會議不做任何提示)
- 'r' — 會議錄音 (錄音文件名${MEETME_RECORDINGFILE}，格式 ${MEETME_RECORDINGFORMAT})。缺省文件名是：meetme-conf-rec-${CONFNO}-${UNIQUEID}
，缺省格式是wav。 — 這個參數(shù)同樣需要chan_zap.so。
- 's' —收到*鍵的時候播放菜單，普通成員是普通菜單，管理員是管理員菜單('send' to menu)
- 't' — 設為只說模式 (只說，不聽)
- 'T' — 設置說話人檢測 (在manager interface 和 meetme list可以看到)
- 'v' — 視頻模式 (目前還不支持)
- 'w' — 等待標記成員進入會議。
- • 'X' — 允許用戶輸入${MEETME_EXIT_CONTEXT}里面的一個有效的單個數(shù)字來退出會議。如果${MEETME_EXIT_CONTEXT}沒有定義，則從當前的內(nèi)容里找有效數(shù)字。allow
user to exit the conference by entering a valid single digit extension
of the context specified in or the current context if that variable
is not defined. （此參數(shù)不支持Asterisk v1.2.0版本）
- 'x' — 當最后一個標記用戶退出會議室的時候，關閉會議。
參數(shù)詳解
參數(shù) 's'
's' 和 'p' 參數(shù)不能跟 'X' 參數(shù)共同使用。
- 普通成員: 按鍵*將聽到語音菜單"Please press 1 to mute or unmute yourself"; Asterisk
v1.2 版本現(xiàn)在支持對單獨會議的單獨成員進行音量調整。
- 管理員(在加入會議的時候使用了 'a' 參數(shù)): 按鍵*將聽到語音菜單"Press 1 to mute/unmute yourself,
2 to lock/unlock this conference"
參數(shù) 'q'
最好在 Asterisk v1.2以上版本用，早期版本的SIP通道會有延遲。
參數(shù) 'r'
在開始MeetMe()錄音之前，要指定Set ${MEETME_RECORDINGFILE}的值。
否則，錄音文件將存放在/var/lib/asterisk/sounds目錄下，該目錄是存放系統(tǒng)提示音的，不適合存放錄音文件。
例如：
exten => s,1,SetVar(MEETME_RECORDINGFILE=/var/conf_recording-${EPOCH}-${USER})
exten => s,2,MeetMe(,rD) ;開設一個新會議，對會議錄音，
例子
在meetme.conf 中設定一個會議室號為101，密碼為123456的會議。
exten => 500,1,MeetMe(101||123456)
授權的會議
exten => 18,1,Answer
exten => 18,2,Wait(1)
exten => 18,3,Authenticate(5678)
exten => 18,4,MeetMe(18|p)
exten => 18,5,Playback(vm-goodbye)
exten => 18,6,Hangup
動態(tài)會議室，用戶需要按鍵輸入要創(chuàng)建的會議室號
exten => 9999,1,Wait(1)
exten => 9999,2,MeetMe(|Md)
注意:如果你加入?yún)?shù)'e', 按*將選擇#會議室
如果你需要為會議室設定一個密碼，，請將 'd' 參數(shù)改為 'D' 。
動態(tài)會議室123設為安靜模式。如果用戶foo 撥打分機號10，他將成為一個標記用戶（’A’），foo離開會議后，會議室將被關閉，其他的撥打11的用戶也將被迫離開會議室。
exten => 10,1,MeetMe(123|Aqd)
exten => 11,1,MeetMe(123|xqd)
OEJ發(fā)表的回顧 (May 23, 2004)
你發(fā)現(xiàn)這個簡單得不能再簡單的(not-so-simple-anymore)簡單MeetMe會議橋了嗎？這可是Asterisk的一個殺手級應用哦。它帶來豐富的功能應用：
- 多種渠道，包括VoIP 和 PSTN，都能參加的多方會議
- 宣講模式：一個說話人，眾多的旁聽者。
- 管理功能：踢用戶，讓會議靜音，鎖定會議
- 等待其他成員的時候可以收聽等待音樂
- 可以預設會議
- 也可以動態(tài)創(chuàng)建會議(第一個成員將被告知會議號碼)
更多豐富命令包括：
- MeetMe – 加入會議 (有時候也用于創(chuàng)建新會議)
- MeetMeAdmin – 踢人、鎖定會議、讓會議靜音
- MeetMeCount – 統(tǒng)計會議室內(nèi)的成員名單
在CLI 下面也可以管理MeetMe:
- Meetme List all conferences
- MeetMe kick 踢一個人
- MeetMe kick 踢所有人
- MeetMe list 列出會議室內(nèi)的所有成員
- MeetMe lock 鎖定會議室，不再加人
- MeetMe unlock 解鎖會議室
- MeetMe mute 禁止某個人發(fā)言
- MeetMe unmute 允許某個人發(fā)言
OEJ附加說明
- 會議橋默認語音編碼格式是ulaw。 如果采用其他編碼，將額外占用CPU資源。
- MEETMESECS參數(shù)包含了用戶參加會議中的時長（以秒為單位）。
- 改動meetme.conf無需重新加載，系統(tǒng)會自動讀取
- 在dial plan中，您可以通過meetmecount()和參數(shù)來限制參加會議的人數(shù)
- MeetMe依賴Zaptel時鐘，您需要安裝Zaptel驅動，最好有一片Asterisk兼容的語音卡。
- 潛規(guī)則
- MeetMe應用需要一個時鐘才能工作。 有幾種方法可以獲得時鐘，其中Zaptel卡提供的工作時鐘是一個不錯的選擇，如果你沒有Zaptel卡，也可以使用ztdummy
時鐘。
- 動態(tài)會議 的工作方式可能跟你想得不太一樣。很明顯，動態(tài)會議的意思就是創(chuàng)建一個并未存在的會議。所以當用戶A創(chuàng)建了一個會議號為200的會議之后，如果用戶也來創(chuàng)建一個會議號為200的會議，那么用戶B將被直接加入用戶A的會議，而不會對用戶B提示說已經(jīng)會議號200已經(jīng)被人用了。另外，如果用戶A創(chuàng)建的這個#200會議有密碼，那么用戶B將聽到密碼無效的聲音，然后系統(tǒng)會提示用戶B重新輸入一個要創(chuàng)建的會議號碼。要想解決這個問題，我們能做的就是通過參數(shù)
'e' 來讓系統(tǒng)自動分配會議號碼。
性能方面的考慮
在ISDN PRI環(huán)境下開超過10個人的MeetMe會議
我曾經(jīng)發(fā)現(xiàn)在ISDN PRI環(huán)境下超過10個人的會議回發(fā)生嘯叫。人們認為電信運營商已經(jīng)對ISDN-PRI這樣的純數(shù)字化環(huán)境做過回聲消除了，所以不需要再設置回聲消除。然而事實并非如此。我在配置文件
/etc/asterisk/zapata.conf下面增加了下列的參數(shù)項，從而解決了這個問題：
echocancel=yes
echocancelwhenbridged=yes
echotraining=yes
架構和局限
在Asterisk 1.2版本中，同時開很多個會議的時候可能會有些局限。目前大部分版本已經(jīng)升到1.4及以上，也就不存在這些問題了，不再鏊述。
關于參數(shù)'b' (AGI_BACKGROUND)
網(wǎng)友疑問：
我看了論壇上一些老的帖子，但是還是有個疑問，是關于AGI_BACKGROUND的。如果我的機器上安裝了Asterisk兼容板卡但是會議里沒有加入Zap通道，只有SIP通道，那么SIP通道上的MEETME_AGI_BACKGROUND腳本能正常工作嗎？
回答：
不能正常工作。下面我們分析一下工作原理：
合并輸入的語音包，輸出合并后的語音包，這些工作是在Zaptel驅動里面做的。對于真實的Zap通道，這個工作是在驅動層就請全部完成的。而對于非Zap通道，系統(tǒng)會創(chuàng)建一個Zap虛擬通道，然后在非Zap通道和Zap虛擬通道之間雙向拷貝語音數(shù)據(jù)。
看一下這部分源代碼（在conf_run()中），我們會發(fā)現(xiàn)，conf_run() 函數(shù)要么執(zhí)行AGI腳本，要么執(zhí)行虛擬通道拷貝循環(huán)，不能同時執(zhí)行兩個。所以當你使用AGI腳本的時候，在非Zap
通道和Zap虛擬通道之間就沒有任何連接了。
擁有一塊Asterisk卡或者dummy時鐘驅動 (比如： ztdummy 或者 zaprtc) 都能使用MeetMe功能，但是這并不意味著你可以在參加會議的SIP通道上使用AGI：他們沒有執(zhí)行任何AGI的能力。你可以試下看，但是最終的結果一定是什么聲音也得不到。
還要注意的是，使用AGI將會使其他的一些內(nèi)置功能，比如說靜音、踢人和音樂等待等功能不能使用。
AGI_BACKGROUND Pros/Cons
使用AGI將會使其他的一些內(nèi)置功能，比如說不用通過命令行實現(xiàn)靜音、踢人和音樂等待等功能。
參數(shù) 'p' (按#退出) 也不能用。錄音功能也不能用。
如果你需要把會議中的某個成員踢出去，首先需要停止該成員的AGI_BACKGROUND 任務。
一旦AGI_BACKGROUND腳本停止，該成員就自動退出會議室了。
所有的DTMF按鍵事件都被送到AGI_BACKGROUND 進程/腳本。所以你可以讓你的.agi腳本不停地循環(huán)，捕獲按鍵音，來決定怎樣處理一個特定的按鍵。
AGI_BACKGROUND 也開放了很多開發(fā)的編程機會。你可以使用進程間通訊（sockets, signals等等）來遠程控制會議室（即：
基于外部時間或用戶輸入來給會議室放音）。
從普通通話發(fā)起多方通話（邀請用戶參加會議）
下面我講一下怎樣從一個普通通話（兩方通話）發(fā)起多方通話。主要是通過MeetMe和ChannelRedirect來實現(xiàn)。
疑問: 在 Asterisk 1.4 版本中，我們是否需要用'ManagerRedirect'來替換 'ChannelRedirect'？
下面是dialplan 例子:
[default]
exten => _XXX,1,Set(DYNAMIC_FEATURES=nway-start)
exten => _XXX,n,Dial(SIP/${EXTEN})
[dynamic-nway]
exten => _XXX,1,Answer
exten => _XXX,n,Set(CONFNO=${EXTEN})
exten => _XXX,n,Set(MEETME_EXIT_CONTEXT=dynamic-nway-invite)
exten => _XXX,n,Set(DYNAMIC_FEATURES=)
exten => _XXX,n,MeetMe(${CONFNO},pdMX)
exten => _XXX,n,Hangup
[dynamic-nway-invite]
exten => 0,1,Read(DEST,dial,,i)
exten => 0,n,Set(DYNAMIC_FEATURES=nway-inv#nway-noinv)
exten => 0,n,Dial(Local/${DEST}@dynamic-nway-dest,,g)
exten => 0,n,Set(DYNAMIC_FEATURES=)
exten => 0,n,Goto(dynamic-nway,${CONFNO},1)
exten => i,1,Goto(dynamic-nway,${CONFNO},1)
[dynamic-nway-dest]
exten => _XXX,1,Dial(SIP/${EXTEN})
[macro-nway-start]
exten => s,1,Set(CONFNO=${FindFreeConf()})
exten => s,n,ChannelRedirect(${BRIDGEPEER},dynamic-nway,${CONFNO},1)
exten => s,n,Read(DEST,dial,,i)
exten => s,n,Set(DYNAMIC_FEATURES=nway-inv#nway-noinv)
exten => s,n,Dial(Local/${DEST}@dynamic-nway-dest,,g)
exten => s,n,Set(DYNAMIC_FEATURES=)
exten => s,n,Goto(dynamic-nway,${CONFNO},1)
[macro-nway-ok]
exten => s,1,ChannelRedirect(${BRIDGEPEER},dynamic-nway,${CONFNO},1)
[macro-nway-notok]
exten => s,1,SoftHangup(${BRIDGEPEER})
注意：你需要用 FindFreeConf() 函數(shù) (或者其他方式) 來獲得空閑的會議室號碼。
此外，還需要修改 features.conf，增加下面的內(nèi)容：
[applicationmap]
nway-start => *0,caller,Macro,nway-start
nway-inv => **,caller,Macro,nway-ok
nway-noinv => *#,caller,Macro,nway-notok
（譯注：事實上，F(xiàn)indFreeConf()這個函數(shù)好像需要Trunk版本支持，需要修改一下這個例子的部分內(nèi)容才能運行。另外，實際測試中我們也發(fā)現(xiàn)，兩個按鍵*0之間的間隔時間不能太長，最好是連續(xù)按鍵。）
工作原理:
普通通話情況下：
當你和別人通話的時候，按*0 (執(zhí)行宏 nway-start)。 被叫馬上被傳遞到一個空閑的會議室，而你將聽到撥號音，等待你輸入你要邀請的電話號碼。當被邀請方接通后，你在和這個第三方通話的過程中，可以按
** （在features.conf可以定義）加入會議，按 *# 掛掉他然后返回會議。
會議室情況下：
在會議室里面，任何用戶可以按0邀請其他用戶加入會議，其他的步驟同上。
合并會議
這些可以使用使用 Asterisk local channels 和 Asterisk manager API來實現(xiàn)(一般使用AGI 或者Call
Files) 。
下面是一個合并會議123和會議124的OriginateAction例子：
在dialplan (context = default):
exten => 7799,1,Meetme(123|qd)
exten => 7798,1,Meetme(124|qd)
在Manager API:
Action: Originate
ActionID: 12345678
Channel: local/7798
Context: default
Exten: 7799
Priority: 1
與某個成員悄悄話
在Meetme中，還有一個類似ChanSpy的悄悄話功能（密談）。會議成員可以與其他成員通過'whisper'功能來密談。
我還增加了一個 'z' 標志:
'z' — 所有的DTMF按鍵事件將被送到manager
用戶可以通過對MeetMe系統(tǒng)中的按鍵進行偵測，然后在決定在manager命令中如何處理。
除了標準MeetMe之外的其他選擇
MeetMe2
MeetMe2是在MeetMe基礎上增加了Web控制界面的一個變體。
"目的是控制會議室里面的聲音和成員。這個功能可以為你提供一個通過網(wǎng)絡來控制會議和直觀查看會議的方法。app_meetme已經(jīng)做了大量改動，將一些會議信息寫入DB，并檢查會議屬性是否已經(jīng)改變。"
Q: 我看到會議中的成員，但是我不能把他們踢出去，也不能將他們的模式從說變成可聽可說。沒有顯示任何錯誤。
A: 在php中打開register_globals。
你也可以在php文件的頂部加入"extract($_GET);"
（也有網(wǎng)友建議使用MeetMe-Web-Control來替代MeetMe2）
app_conference
另外一個變種 app_conference，針對大容量的會議。
http://sourceforge.net/projects/appconference/
有些人認為它比MeetMe更為強大，但是目前還沒有人提供詳細的比較測試數(shù)據(jù)。
遠程會議主機
通過第三方會議提供商: http://www.junctionnetworks.com，IAX和SIP通道可以加入遠程會議。在dialplan里面可以這樣寫：
exten => 7000,1,Dial(IAX2/conference@iax.jnctn.net)
exten => 7000,1,Dial(SIP/conference@sip.jnctn.net)
通過撥打7000，您就可以參加他們的會議。
他們提供很多種參加會議的方法，可以通過Web網(wǎng)頁來訂制，方便了會議管理和統(tǒng)計。
CTI論壇編輯
相關閱讀: