Asterisk Extension中的Application命令详解六

MailboxExists()               如果指定的语音邮箱存在则有条件的转移

如果被mailbox参数指定的语音邮箱存在则条件转移到优先级n+101(n是指当前优先级),如果语音邮箱不是指定的缺省值的话可以指定一个语音环境.



Math()         执行数学操作并返回结果

在数字1和数字2之间执行浮点操作并将指定结果保存在变量returnvar中。缺省操作符号为:+,-,/,*,%,<,>,>=,<=,和==,并且其等同于C语言中的符号.

总是返回0.

;添加两个数字,并返回结果.
;两数字相减,返回结果.


MeetMe()      将呼叫放置于MeetMe会议网桥.

通过会议参数将当前呼叫者加入当前正在进行的MeetMe会议，如果会议号码缺省，将提示用户输入一个。字符选项可能包含0或者下面列表中的其它字符。

m   设置为监控模式（只能听不能交谈）
t   设置为交谈模式(只能交谈不能听)
T   设置交谈检测(发送管理端口和MeetMe列表)
i   通告用户加入/离开
p   允许用户按#键离开会议
x   允许用户通过输入一个合法的数字范围离开会议(通过设置变量${MEETME_EXIT_CONTEXT}),
    如果变量未定义则从当前环境来确定数字范围.
d   动态添加会议
D   动态添加会议并提示PIN
e   选择一个空闲的会议
E   选择一个空闲的无人的会议
v   设置视频模式
r   会议记录(作为${MEETME_RECORDINGFILE} 使用格式${MEETME_RECORDINGFORMAT}),缺省文件     名是.....${(CONFNO}-${UNIQUEID}缺省的格式是.....
q   设置静音模式(不能播放输入/输出声音)
M   当会议中只有一个人的时候能够开启音乐
x   当最后一个用户离开的时候关闭会议室
w   等待标识用户进入会议室才开始会议
b   运行在${MEETME_AGI_BACKGROUND}变量中指定的AGI脚本,缺省......(注意:在相同的会议中     不能工作在non-Zap信道)
s   当收到*符号时出现菜单( 用户或者管理员)
a   设置管理模式
A   设置标识模式
如果pin变量通过的话，用户必须输入pin号码才能成功进入会议室。
如果用户按#号键离开则MeetMe()返回0，否则返回-1

要想MeetMe会议工作的话你必须安装一个适当的Zaptel计时器端口。

MeetMeAdmin()    执行MeetMe会议管理

在指定的会议中执行指定的MeetMe管理命令。命令可能包含以下的其中之一（注意pin参数仅仅用于K选项）

K  将所有用户踢出会议
k  将某一用户踢出（指定的PIN号码做为第三方参数）
e  将最后加入的用户踢出
L  锁定会议
l  解除会议锁定
M  将会议设置为静音
m  将会议的静音设置解除
N  将整个会议静音（管理员除外）
n  将整个会议静音解除（管理除外）


；将501会议设置为静音
；从501会议将PIN号码为1234的用户踢出去

MeetMeCount()                 计算参加MeetMe会议的人的数量

程序返回通过confno标识的在MeetMe会议中的人的数量。如果变量参数被指定，该程序将被跳过并将数量保存到指定变量中。

成功返回0否则返回-1

；统计在会议501中的用户数量，并将值保存到${count}


Milliwatt()      产生1000Hz声音

在0dbm(mu-law)生成一个1000Hz声音。该程序经常用来测试指定通道的音频属性

；生成一个milliwatt声音用于测试

Monitor()           监控当前通道中的音频

开始监控信道。信道的输入和输出语音将被保存到文件直到信道被挂起或者信道被StopMonitor()程序停止掉。Monitor()使用如下参数：

file_format   指定保存文件格式，如果没有设置，则缺省为wav.
fname_base    如果被设置，则用指定的参数来改变文件名称
option        一到两个选项被指定
      m       当记录结束后，将两个文件合并为一个并删除原始文件。如果变量${MONITOR_EXEC}被指定，the application referenced in it will be executed instead of....并且原始文件将被自动删除
(或者${MONITOR_EXEC})有三个参数:the two leg files and the filename
for the target mixed file, which is the same as the leg filenames but without the
in/out designator.如果${MONITOR_EXEC_ARGS}被设置,相关内容将被做为附加参数输出到变量${MONITOR_EXEC}并通过.${MONITOR_EXEC}和m标识可以通过管理端口来设置.
      b     除非调用被桥接到另一个信道否则不开始记录


如果监控文件未被打开或者信道已经被监控则返回-1，其它情况则返回0

；记录当前信道，并且在语音记录结束时合并文件。


MP3Player()      播放MP3文件或流

使用.....程序播放给定的呼叫。指定的呼叫可以是文件名称或者有效的URL。通过按任意键退出

The correct version of ........ must be installed for this application to
work properly. Asterisk currently works best with ..........

如果挂起则返回-1，否则返回0


MusicOnHold()                播放音乐通过不确定的句柄

通过类来播放指定的句柄音乐。as configured in.........如果忽略，将使用系统缺省的音乐。可以通过SetMusicOnHold()应用程序为信道设置缺省的音乐类。

如果挂起则返回-1，否则没有返回值。

NBScat()     播放NBS本地流

使用nbscat8k程序监控本地网络广播声音（NBS）流。（更多信息请参见...module in Digium's CVS server).按任意键退出。

如果挂起则返回-1，否则没有返回值。


NoCDR()       禁止当前呼叫使用CDR

禁止当前呼叫使用CDR

；不要记录555-1212的呼叫

NoOp()               没有任何操作

Does nothing--该应用只是一个简单的占位符。另外，该应用对文本进行求值并打印结果到Asterisk命令行端口，而且可以通过debugging来调用。
不要在文本上加“”，如果引号加到方括号中，则引号将显示在控制台中。


Park()              停放当前呼叫


停放当前呼叫(typically in combination with a supervised transfer to determine the
parking space number).该应用总是在中心注册并且不需要明确的添加到拨号盘中，虽然应该包含在归位环境中。

；停放呼叫到701


ParkAndAnnounce()            停放当前呼叫并且通告当前呼叫到指定通道

停放当前呼叫到停放列表并且通告当前呼叫到指定通道。模板是文件到通告用：分离的；PARKED是被呼叫者的号码空间代替。timeout参数是指以秒为单位的呼叫返回到return_context时长。通道参数是指用来进行通告的相关通道。Console/dsp调用控制台。return_context参数是一个GoTo()类型的标签，The return_context argument is a GoTo( )-style label to jump the call back into after timeout, which defaults to n+1 (where n is the current priority) in the return_context context.

ParkedCall()             应答归位调用

通过exten标识并连接调用到归位调用。该程序总是自动注册而且不需要明确的添加到拨号盘上。尽管应该包含调用文本。

；pick up the call parked in parking space 701


PauseQueueMember()     从接收到的调用中临时排一个队列

暂停（排队调用）一个队列号码。在给出的队列中的指定端口将被暂停。除非被UnpauseQueueMember()应用程序解除暂停或者被管理端口解除暂停否则将防止将从队列到端口的调用。如果未指定队列，端口将按照号码从每一个队列暂停掉。如果端口没有包含在命名队列中，或者没有队列被指定并且端口未在任何队列中，则将跳过优先级N+101（N是指当前优先级），如果存在。

如果端口不存大或者跳转不存在则返回-1,否则返回0




Playback()         为呼叫者播放指定的音频文件


对呼叫者播放指定的文件.文件不是一个范围,Asterisk将选择一个最低的变换开销来自动选择文件.应该包含0或者更多的选项.如果信道为非"up"状态则跳过options选项(例如未应答).如果skip被指定,则当信道为非挂起状态时应用程序将立即返回.否则除非没有应答被指定,声音文件被播放之前信道将被应答.(在挂起状态时并非所有的信道均支持播放消息)
如果信道为挂起状态,文件不存大,跳至优先级n+101(n为当前优先级),如果存在,则返回-1

Playtones()          播放声音列表

播放声音列表.当声音连续播放时立即继续执行. 声音列表有可能是在.....定义的配置文件,也有可能是指定频率和宽度的列表,参见....声音列表规范描述


使用StopPlaytones()应用来停止声音播放.
;两秒后播放一个忙的声音,再过两秒播放一个拥塞声音.

exten => 123,1,Playtones(busy) exten => 123,2,Wait(2) exten => 123,3,StopPlaytones( ) exten => 123,4,Playtones(congestion) exten => 123,5,Wait(2) exten => 123,6,StopPlaytones( ) exten => 123,7,Goto(1) 参 见 Playtones( ), indications.conf