asterisk AGI实战指南：脚本编写与参数传递

"asterisk AGI应用说明" Asterisk AGI (Asterisk Gateway Interface) 是一种接口，允许外部程序与Asterisk VoIP服务器进行交互。它为开发者提供了丰富的功能，比如处理复杂的呼叫逻辑、数据库操作、语音识别等。在Asterisk中，AGI的主要作用是扩展Asterisk的功能，使其能够执行更复杂的应用场景。 **AGI脚本的执行** 执行AGI脚本通常是在Asterisk的拨号计划(Dialplan)中完成的。例如，`Exten=>1,2,AGI(test.php,${CALLERID(name)})` 这行表示在拨号计划的1号上下文的第2个优先级中，调用了名为`test.php`的AGI脚本，并将呼叫者的姓名作为参数传递给脚本。脚本需放置在可执行的目录（如 `/var/lib/agi-bin`），并赋予适当的权限（如 `chmod 775`）。 **AGI参数传递** AGI脚本接收两个主要参数：一是脚本路径（可省略默认路径），二是拨号计划中EXTEN的参数。例如，`AGI(dial_agi.php,${CALLERID(name)})` 将呼叫者姓名传递给`dial_agi.php`脚本。这里`${CALLERID(name)}`是Asterisk中的一个变量，代表呼叫者的姓名。 **与Asterisk通信** AGI脚本与Asterisk之间的通信是通过标准输入（STDIN）、标准输出（STDOUT）和标准错误（STDERR）完成的。Asterisk通过STDOUT向脚本发送信息，脚本通过STDIN接收这些信息，如通道状态、呼叫者ID等。同时，通过STDOUT发送命令给Asterisk，如调用Dial、Goto等应用程序，或者设置和获取通道变量。错误信息通常写入到STDERR，便于调试。 **AGI函数** Asterisk AGI 提供了一系列内置函数，用于与Asterisk进行交互。例如： 1. **ANSWER()**: 如果通道未应答，此函数会应答通道。返回值为0表示成功，-1表示通道失败。 2. **AUTOHANGUP(time)**: 在指定的时间（单位为秒）后自动挂断通道。若时间设为0，则该命令无效。返回值为0表示成功挂断。 此外，还有其他诸如EXEC（执行Asterisk命令）、Hangup（挂断通话）、READ（从用户获取输入）等函数，它们极大地丰富了AGI脚本的可操作性。 **总结** Asterisk AGI 是一个强大的工具，允许开发者通过编写脚本直接与Asterisk服务器进行交互，实现自定义的通话处理流程。通过理解AGI的工作原理、参数传递方式以及AGI函数，开发者可以创建高度定制化的VoIP解决方案，满足各种业务需求。