开源项目Asterisk-Java安装与配置完全指南

开源项目Asterisk-Java安装与配置完全指南

asterisk-java The free Java library for Asterisk PBX integration. 项目地址: https://gitcode.com/gh_mirrors/as/asterisk-java

项目基础介绍及编程语言

Asterisk-Java是一款免费的Java库，专为与Asterisk PBX服务器集成而设计。它支持两种与Asterisk交互的主要接口：FastAGI协议和Manager API。这款开源工具适用于希望在Java应用中实现电话系统控制的开发者。项目采用Java作为其主要编程语言，并遵循Apache-2.0许可证。

关键技术和框架

快速AGI（FastAGI）

• 功能: 允许创建服务来管理呼叫，类似于Web服务器处理HTTP请求，非常适合替换复杂的Dialplan，以实现更高效、易调试的呼叫控制。
• 优势: 比Dialplan快数千倍，且利用熟悉的编程环境。

管理员API（Manager API）

• 能力: 支持接收来自Asterisk服务器的事件（如呼叫进度、注册对等体、通道状态）并发送动作（如发起呼叫、代理登录登出、启动/停止录音）至Asterisk。
• 使用场景: 提供全面控制，甚至可以启动和操纵通话过程。

活动（Activities）

自版本2.0起引入，旨在提供与Asterisk交互的高级界面，简化连接管理，无需深入了解Asterisk Manager Action和Event细节。

安装与配置步骤

准备工作

1. 确保环境：你需要有Java Development Kit (JDK) 1.8或更高版本安装在你的机器上。
2. 获取Maven：由于项目依赖于Maven进行构建和依赖管理，需事先安装Maven。

获取项目

通过Git克隆仓库到本地：

git clone https://github.com/asterisk-java/asterisk-java.git

安装项目

进入项目目录并执行Maven命令来编译和构建jar文件：

cd asterisk-java
mvn install

成功构建后，会在target目录下找到asterisk-java.jar。

配置Asterisk

FastAGI设置

• 在Asterisk的dialplan中配置FastAGI调用，映射到你打算使用的Java类。这通常在extensions.conf完成。

Manager API接入

• 配置Asterisk Manager Interface（AMI）允许从Asterisk-Java访问，编辑Asterisk的manager.conf，增加一个认证用户。

示例运行

1. 编译示例代码，例如examples/ExampleCallIn.java：

   javac -classpath .;$(mvn dependency:build-classpath -Dmdep.includeScope=runtime | sed 's/\:/;/g') examples.ExampleCallIn.java
   

2. 运行FastAGI服务器指向编译后的类：

   java -classpath .;asterisk-java.jar org.asteriskjava.fastagi.DefaultAgiServer
   

   注意：这里假设asterisk-java.jar在当前目录下，路径可能需要调整。

以上步骤完成后，你的Asterisk系统现在能够通过Java应用与之交互。记得根据实际部署环境调整配置细节，如端口、认证信息等。祝你在探索Asterisk-Java的世界中顺利！

asterisk-java The free Java library for Asterisk PBX integration. 项目地址: https://gitcode.com/gh_mirrors/as/asterisk-java