Asterisk-Java技术文档

邵河翊Doyle

于 2024-10-18 12:24:19 发布

阅读量979

点赞数 10

本文链接：https://blog.csdn.net/gitblog_01243/article/details/143047495

版权

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服务器交互的过程。本库支持FastAGI协议和Manager API两种主要接口，允许你在Java应用中灵活地控制电话呼叫和管理Asterisk服务器状态。

本文档将引导你了解安装过程、基础使用方法、API详情以及如何从源代码进行构建。

安装指南

Maven依赖（推荐）

如果你的项目是基于Maven的，只需在pom.xml文件中添加以下依赖：

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

Gradle依赖

对于使用Gradle的项目，可以在build.gradle中加入：

implementation 'org.asteriskjava:asterisk-java:3.39.0'

源码编译安装

使用Git克隆仓库到本地：

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

进入项目目录并使用Maven安装：
```
cd asterisk-java
mvn install
```

完成上述步骤后，会在项目的target目录下生成所需的.jar文件。

项目的使用说明

FastAGI示例

FastAGI让你能够像处理HTTP请求一样管理电话通话。下面的代码片段展示了如何创建一个简单的FastAGI脚本来接听并播放音频文件。

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

public class ExampleCallIn extends BaseAgiScript {
    @Override
    public void service(AgiRequest request, AgiChannel channel) throws AgiException {
        answer(); // 接听电话
        execute("Playback", "tt-monkeys"); // 播放 tt-monkeys 音频文件
        hangup(); // 挂断电话
    }
}