基于Asterisk的VoIP开发指南——(2)Asterisk AGI程序编写指南

本文涉及的产品
云数据库 RDS SQL Server,独享型 2核4GB
云数据库 RDS MySQL Serverless,0.5-2RCU 50GB
简介:

5. Asterisk AGI程序编写指南   

5.1概述

 

很多时候,我们需要在拨号方案中做某些业务逻辑的判断或者外部数据库的查询,根据具体地需要,有几种做法:

 

1.使用Asterisk的通道变量、Goto函数、Gotoif函数等实现某些简单跳转,通过几个这样的函数的组合,实现简单的业务。

 

2.对终端接入用户的呼叫请求中的某些属性,进行简单的数据库增删改查,在Asterisk官方发布的asterisk-addons开发包中安装MYSQL模块,具体地方法在这不细述。使用类似下面的方式:

exten => _0[0-9].,1, MYSQL(Connect connid dhhost dbuser dbpass dbname)

exten => _0[0-9].,2., MYSQL(Query resultid ${connid} query-string)

exten => _0[0-9].,3MYSQL(Fetch fetchid ${resultid} var1/ var2/ .../ varN)

exten => _0[0-9].,4MYSQL(Disconnect ${connid})

 

3.如果碰到了结合了12的业务需求,这时候拨号方案配置文件中就会出现大量地与业务逻辑有关的复杂代码,造成技术人员阅读上不方便,并且代码也不好维护,如下面这段配置文件:

……

exten => 888,1,MYSQL(Connect connid localhost ipcontact passwd ipcontact) 
exten => 888,n,GotoIf($["${connid}" = ""]?error,1) 
exten => 888,n,MYSQL(Query resultid ${connid} SELECT/ `number`/ FROM/ `phones`/ WHERE/ `channel`=/'${chan}/') 
……

exten => 888,n,GotoIf($["${foundRow}" = "1"]?done) ; leave loop if no row found 
exten => 888,n,NoOp(${number}) 
exten => 888,n,Goto(fetchrow) ; continue loop if row found 
exten => 888,n(done),MYSQL(Clear ${resultid}) 
exten => 888,n,MYSQL(Disconnect ${connid})

……

 

上面综合了通道变量、GotoGotoifMYSQL数据查询等操作,其实如果配置文件中只是几行这样的操作阅读起来没问题,但业务需求具有可变性,代码维护起来就比较麻烦。所以,我们就寻找另外一种方案,即在配置文件中不进行数据库查询等重量级的操作,而是将它交到一个外部应用程序或者脚本中,即封装到AsteriskAGI后台中,可以实现各种复杂的业务需求。使用类似PHPJAVAC等编程语言内置的判断语句,而不是Asterisk封装的类似GotoGotoif等函数,会更加快地实现业务需求,代码也更好维护。下面先看看如何在拨号方案中使用AGI程序。

 

 

5.2 使用AGI脚本

 

 

执行AGI脚本时,Application应用就是'agi',参数是脚本的文件名,同时脚本需要满足以下条件:

 

l        必须可执行,chomd 755

l        必须放置在指定目录,如标准目录:/var/lib/asterisk/agi-bin 

l        必须指定完整的extension信息

 

比如说执行一个用PHP语言实现的AGI程序,有可能就是这样:

exten => 1,2,AGI(test.php, ${CALLERID(name)})

 

脚本执行时,可以从控制台上得到不同基本的详细信息,例如,文件不能被执行,或者找不到文件等等。

 

通过向Asterisk控制台信息输出,可以得到AGI脚本的执行信息,至少在开发初期中,控制台信息输出是个好办法。

 

通过agi VERBOSE命令,可以将信息发送到asterisk控制台上,并且而通过verbosity设置可以关闭开启这个功能。

 

如果直接,可以采用各种语言很方便的通过AGI接口编写实施脚本。脚本和Asterisk之间通过标准的输入输出进行交互。

 

 

5.3 AGI(Asterisk Gateway Interface)技术实现原理

 

 

 

l        传递参数到AGI脚本

 

在脚本名称后紧跟以英文半角状态下的逗号,分隔的字符串,就可以把需要的参数传入脚本:AGI(dial_agi.php,${EXTEN:11},${CALLERID(name)})AGI脚本总是接收2种参数,1是脚本的完整路径,2是拨号方案中'Exten'传递的参数,其中第1种参数,如果AGI程序放在了Asterisk默认路径,可以省略,只写AGI程序名。第2种参数是AGI程序需要拨号方案中'Exten'传递进来的参数,比如说本文中${EXTEN:11},${CALLERID(name)},一个是被叫的电话号码,一个是主叫的账号ID

 

l        通过标准的输出,发送命令到Asterisk

 

我们可以在AGI脚本程序中向Asterisk发送各种命令从而调用Asterisk的某些应用程序,如DialGotoMonitor等,也可以直接发送命令获得或者设置某些Asterisk通道变量的值。对于基于PHPAGI脚本程序,可以按照如下步骤:

 

1.打开PHP输出文件描述符:

$stdout = fopen('php://stdout', 'w');


2.向Asterisk发送命令:

fputs($stdout," SET CONTEXT media_gw1/n"); "); 
    fflush($stdout);

 

上述步骤是对于SET 或者 GET Asterisk的某些通道变量时的使用方法,如果需要调用Asterisk内置的应用,如执行跳转到某个context下的某个priorityGoto应用函数,可以调用EXEC命令后面紧跟Asterisk,如:fputs($stdout," EXEC  Goto  media_gw1|s|2/n"); ");命令必须以换行符结束,AGI命令返回文本字符串,如下格式:200 Result=<number>,有时会在number数字后附加一些信息。如果向Asterisk发送了无效的命令,信息如下:510 Invalid or unknown command。对应上面的命令,如下所示:

AGI Rx << SET CONTEXT media_gw1

AGI Tx >> 200 result=0

 

l        通过标准的输入,从Asterisk接收信息

 

AGI脚本执行时,Asterisk会向脚本发送各种的信息,可以在做其他事情之前通过标准输入获取这些信息,每项数据都是一行,发送完毕Asterisk会发送一个空行,表示结束,如:

 

AGI  Tx >> agi_request: dial_agi.php

AGI  Tx >> agi_channel: SIP/25946-0821ea88

AGI  Tx >> agi_language: en

AGI  Tx >> agi_type: SIP

AGI  Tx >> agi_uniqueid: 1209093478.477

AGI  Tx >> agi_callerid: 0000123456

AGI  Tx >> agi_calleridname: beigaolin

AGI  Tx >> agi_dnid: 998866015810370728

AGI  Tx >> agi_context: default

AGI  Tx >> agi_extension: 998866015810370728

AGI  Tx >> agi_priority: 1

 

根据项目需求,如果需要这些数据,就先保存起来,否则不用处理它。保存步骤按如下过程。

 

1.打开PHP输出文件描述符:

$in = fopen("php://stdin","r");

       2.分析从Asterisk传到AGI的头信息,如需要在AGI程序中获取终端用户的ID,那么从“agi_calleridname: beigaolin”这个头信息可以获取,我们通过分析每一行这样以:分隔的字符串,取到需要后续处理的字符串

 

while (!feof($stdin)) { 
  $temp = fgets($stdin); 
  $temp = str_replace("/n","",$temp); 
  $s = explode(":",$temp); 
  $agivar[$s[0]] = trim($s[1]); 
  if (($temp == "") || ($temp == "/n")) { 
     break; 
     } 
  }

5.4 使用开源PHP AGI类函数PHPAGI

 

像上一小节那样先是获取输入流,分析从输入头字符串中获取对应某个输入变量的值,或者获取输出流然后发送各种标准命令执行某些Asterisk内置应用,如果在AGI程序中实现很复杂的业务逻辑,这样的流程会显得有点累赘,所以需要提取某些常用的操作,我们使用的时候不用关心这些操作,直接以调用类似Asterisk内置应用那样的方式。PHPAGI就是这样的一个开源PHP类函数。它封装了对应Asterisk内置应用的常用函数调用接口,比如说从PHPAsterisk发送Dial命令的操作,可以直接调用PHP AGI类函数中的exec_dial。使用PHP AGI能够很容易的操作Asterisk AGI常用接口。使用这个类函数也很简单:

 

l        下载准备phpagi 函数文件:

 

cd /var/lib/asterisk/agi-bin/(也有可能在用户自定义的路径中)

wget http://nchc.dl.sourceforge.net/sourceforge/phpagi/phpagi-2.14.tgz

tar zxvf phpagi-2.14.tgz

 

l        在代码中使用:

include ("phpagi.php");//包含文件

include ("phpagi-asmanager.php");

$agi = new AGI;//引用PHPAGI类函数

 

5.5 使用AGI实现主叫号码透传功能

    在这里以一个例子来说明AGI程序在VoIP开发中的作用以及开发思路。

 

假设说有个普通电话为02412345678,手机号为15810370728,而网络电话虚拟号码是0000123456,如果想让拨打出去的电话号码在被叫方(手机或者带有来电显示功能的座机)的来电显示为02412345678或者15810370728,那么他们回复电话的时候就可以直接打到这个普通电话上,方便与主叫的业务联系。这个需求就叫主叫号码透传,能不能进行主叫号码的透传,取决于VoIP落地网关运营商,语音网关可以设置IP侧送过来的主叫号码是否透传。在保证号码规范的前提下,透传什么样的主叫号码,则取决于IP-PBX系统,即Asterisk的设计了。

 

l        设计思路

 

1.增加一个针对终端用户账户ID的绑定管理系统,如图用户在第二项中输入自己的账户ID,然后再输入想要作为来显示的主叫号码完成绑定操作,后台php程序向数据库中插入一条新记录(X-Lite ID对应电话号码或者手机号码)。

 

 

 

5-2 AGI后台管理系统页面

 

2.使用绑定了主叫号码的X-Lite呼叫某个被叫(手机或者座机)

 

Asterisk的后台PHP AGI程序的详细设计主叫号码透传流程设计如图4-4所示。

 

 

 

5-3 Asterisk 主叫号码透传的后台PHP AGI流程图

 

l        代码实现

 

以下代码片断展示的是PHP AGI中部分代码,并且作了简化。

#!/usr/local/php.5.2.5/bin/php –q

<?php

include_once("phpagi.php");//开源PHP类函数

......

//判断当前这个id是否做了主叫号码来电显示的绑定操作

$query_string = "select * from  xliteid where xliteid = '{$caller_name}'";

$query_result = mysql_query($query_string, $db_connection);

 

 //如果当前这个id做了绑定操作,调用PHPAGI类函数,设置Asterisk主叫号码

 if($query_result && mysql_num_rows($query_result) > 0)

 {       

         caller_phone_display_agi ();

 }              

                

 //没有做绑定,设置一个随机的号码

 else                                                             

 {      

       caller_name = $argv[2];

          $rand_num1 = rand(0,9);

          $rand_num2 = rand(0,9);

          $rand_num3 = rand(0,9);

          $caller_phone= "024{$rand_num1}{$rand_num2}650{$rand_num3}{$rand_num4}";

land_media_gw1($caller_phone);

exit();                        

 }      

 

/**

*@caller_phone_display_agi  主叫号码特殊显示

*/

function caller_phone_display_agi()

{

global $db_connection, $callee_phone, $caller_name;

       $query_string = "select caller_phone from caller_phone_display _xliteid where skype_id = '{$caller_name}'";

       $query_result = mysql_query($query_string, $db_connection); 

      

if($query_result && mysql_num_rows($query_result) > 0)

       {

              $row = mysql_fetch_array($query_result);

              $caller_phone = $row[0];

           $callerid_cli = "/"{$caller_name}/"<{$caller_phone}>";

           land_media_gw1($callerid_cli);

           exit();

       }

}

 

 

 

/**

*@ land_media_gw1  VoIP语音网关media_gw1

*/                                                        

function  land_media_gw1($callerid_num)

 {

   global $agi, $callee_phone_withpre;

   $agi->set_context("media_gw1");

   $agi->set_extension($callee_phone_withpre);

   $agi->set_priority(1);

   //调用phpagi封装的set_callerid方法,向Asterisk传递设置主叫号码的指令

   $agi->set_callerid($callerid_num);

  }

 

X-Lite账户gaolinb作了主叫号码绑定,使用X-Lite软终端呼叫普通的手机,在Asterisk中设置了agi debug,从Asterisk后台我们可以清晰地看到:

 

1AGI Tx >> *CLI>上面部分,全是从Asterisk输入到当前AGI的环境变量信息,它包含了当前这个呼叫的详细信息,如Channel的类型,是SIP还是H.323calleridname,即终端用户是gaolinb等重要信息。

 

2AGI Tx >> *CLI>下面部分,全是在上面调用PHPAGI类函数后将命令传给了AGI程序执行,对于主叫号码来电显示的命令是:

SET CALLERID ‘gaolinb’<15810370728>Asterisk15810370728传到能够支持主叫号码透传的VoIP运营商,从而被叫用户在接听电话前能够显示一个有意义的电话号码。

 

 

 

5-4 Asterisk服务器上AGI的输入输出信息



本文转自einyboy博客园博客,原文链接:http://www.cnblogs.com/einyboy/archive/2012/10/18/2728795.html,如需转载请自行联系原作者。


相关实践学习
基于CentOS快速搭建LAMP环境
本教程介绍如何搭建LAMP环境,其中LAMP分别代表Linux、Apache、MySQL和PHP。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助 &nbsp; &nbsp; 相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
目录
相关文章
|
7月前
|
安全 物联网
HarmonyOS学习路之开发篇—网络与连接(NFC开发 二)
设备可以模拟卡片,替代卡片完成对应操作,如模拟门禁卡、公交卡等。应用或者其他模块可以通过接口完成以下功能
|
7月前
|
安全 物联网 开发者
HarmonyOS学习路之开发篇—网络与连接(NFC开发 一)
NFC(Near Field Communication,近距离无线通信技术) 是一种非接触式识别和互联技术,让移动设备、消费类电子产品、PC和智能设备之间可以进行近距离无线通信
|
编解码 人工智能 物联网
透过ALSA这层迷雾剖析AliOS Things音频框架设计
ALSA是Advanced Linux Sound Architecture的缩写,即高级Linux音频架构,在Linux上提供了对音频和MIDI(较少使用)的支持。在Linux 2.6的内核版本后,AlSA目前已经成为了linux的主流音频体系结构。
透过ALSA这层迷雾剖析AliOS Things音频框架设计
|
设计模式 运维 Devops
一种开发发布合一,语言问题合一的shell programming式应用开发设想
本文关键字:最简单的编程模式,具体app具体开发,将开发局限在具体app级,demo as engine
153 0
一种开发发布合一,语言问题合一的shell programming式应用开发设想
Omni/USDT PHP开发包OmniTool简介
OmniTool开发包适用于为PHP应用快速增加对Omni Layer/USDT数字资产的支持能力,即支持使用自有Omni Layer节点的应用场景,也支持基于第三方API服务和离线裸交易的轻量级部署场景。
2222 0
|
物联网 芯片
AliOS Things标准输入输出端口对接以及修改方法
1 标准输入输出端口对接 标准输入输出用于输出系统日志、打印异常信息、软件调试、CLI交互等场景。在具体项目中,只需要对接PUTCHAR_PROTOTYPE和GETCHAR_PROTOTYPE两个函数即可。
2660 0
|
网络协议 物联网 测试技术
AliOS Things网络连接技术概述
AliOS Things具有非常丰富的连接组件和能力,主要包括: 自组织网络协议(uMesh), 套接字适配层(SAL),TCP/IP网络协议栈(LwIP)和连接协议(WiFi,BLE, LoRaWAN, GPRS和NB-IoT等)
7277 0
|
存储 缓存 JSON
ios网络开发
概览 大部分应用程序都或多或少会牵扯到网络开发,例如说新浪微博、微信等,这些应用本身可能采用iOS开发,但是所有的数据支撑都是基于后台网络服务器的。如今,网络编程越来越普遍,孤立的应用通常是没有生命力的。
1236 0
|
C++ 网络安全 编译器
【AllJoyn框架-08】AllJoyn在OpenWrt上的实践
依项目需求,需要将alljoyn移植到openwrt开发板上,其实谈不上复杂,只是这东西有点新,参考教程不多,需要足够地摸索。可参考的官方教程写得太不详细,也只能跟着它试试看了。基本步骤如下: 1、下载openwrt源码编译 貌似版本很多,也不是所有版本都适合我的板子,所以这点得弄清楚。我下得是barrier_break,支持mt7620a开发板。按照上面的教程,把该准备的给准备着,具
1691 0