Asterisk-Java 项目下载及安装教程

Asterisk-Java 项目下载及安装教程

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

1. 项目介绍

Asterisk-Java 是一个用于与 Asterisk PBX 服务器集成的 Java 库。它支持两种 Asterisk 提供的接口：FastAGI 协议和 Manager API。FastAGI 允许你创建一个服务来管理呼叫，类似于 Web 服务器处理 HTTP 请求的方式。Manager API 则支持从 Asterisk 服务器接收事件（如呼叫进度、已注册的节点、通道状态）并发送动作到 Asterisk（如发起呼叫、代理登录/注销、开始/停止语音录制）。

2. 项目下载位置

Asterisk-Java 项目托管在 GitHub 上，可以通过以下命令进行克隆：

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

3. 项目安装环境配置

3.1 环境要求

• Java 1.8 或更高版本
• Maven（如果需要从源码构建）

3.2 环境配置示例

以下是配置 Java 和 Maven 环境的示例：

3.2.1 Java 安装

确保你的系统上安装了 Java 1.8 或更高版本。可以通过以下命令检查 Java 版本：

java -version

3.2.2 Maven 安装

如果需要从源码构建项目，请确保安装了 Maven。可以通过以下命令检查 Maven 版本：

mvn -version

4. 项目安装方式

4.1 通过 Maven 安装

如果你使用 Maven 进行项目管理，可以在 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>org.asteriskjava</groupId>
    <artifactId>asterisk-java</artifactId>
    <version>3.41.0</version>
</dependency>

4.2 从源码安装

如果你需要从源码构建项目，可以按照以下步骤进行：

1. 克隆项目：

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

2. 进入项目目录：

   cd asterisk-java
   

3. 使用 Maven 构建项目：

   mvn install
   

构建完成后，JAR 文件将位于 target/asterisk-java.jar。

5. 项目处理脚本

以下是一个简单的示例脚本，展示了如何使用 Asterisk-Java 处理来电：

import org.asteriskjava.fastagi.AgiChannel;
import org.asteriskjava.fastagi.AgiException;
import org.asteriskjava.fastagi.AgiRequest;
import org.asteriskjava.fastagi.BaseAgiScript;

/* 示例来电处理脚本：接听电话并播放音频文件 'tt-monkeys' */
public class ExampleCallIn extends BaseAgiScript {
    public void service(AgiRequest request, AgiChannel channel) throws AgiException {
        answer();
        exec("Playback", "tt-monkeys");
        hangup();
    }
}

在 Asterisk 的 dialplan 配置文件中，将 callin.agi 映射到 ExampleCallIn 类：

callin.agi = ExampleCallIn

编译并运行脚本：

javac -cp asterisk-java.jar ExampleCallIn.java
java -cp asterisk-java.jar org.asteriskjava.fastagi.DefaultAgiServer

通过以上步骤，你就可以成功下载、安装并运行 Asterisk-Java 项目。

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