### Asterisk 21 AGI Python 实现拨打电话并播放语音 以下是基于 Asterisk 21 的 AGI 脚本示例，使用 Python 编写，并包含详细的注释说明。此脚本实现了拨打指定电话号码的功能，并在接通后播放一段预定义的音频文件。 #### 示例代码 ```python #!/usr/bin/env python3 import sys from asterisk.agi import * # 初始化 AGI 对象 agi = AGI() try: # 设置呼叫者的 ID (CallerID)，可以自定义显示名称和号码 agi.set_variable("CALLERID(name)", "Test Caller") # 设置来电显示名称[^1] agi.set_variable("CALLERID(num)", "9998887776") # 设置来电显示号码[^1] # 获取目标电话号码作为参数传递给脚本 phone_number = sys.argv[1] if len(sys.argv) > 1 else None if not phone_number: raise Exception("Missing target phone number") # 使用 Dial 命令发起呼叫 result = agi.dial(f"SIP/{phone_number}", timeout=30000, caller_id="Test Call <9998887776>") # 发起 SIP 拨号[^1] dial_status = result['result'][1] # 提取 Dial 状态码 if dial_status != "ANSWER": # 如果对方未接听或挂断，则退出脚本 agi.verbose(f"Dial failed with status {dial_status}") agi.hangup() exit(1) # 当通话被应答时，播放一段音频文件 audio_file_path = "/var/lib/asterisk/sounds/custom_message.gsm" agi.stream_file(audio_file_path) # 播放音频文件 except AGIAppError as e: agi.verbose(f"An error occurred during the call: {e}") # 记录错误日志 finally: agi.hangup() # 结束通话并释放资源 ``` --- ### 关键功能解释 - **设置 CALLERID**: `set_variable` 方法用于配置来电显示信息，包括姓名和号码。 - **Dialing**: 使用 `agi.dial()` 函数发起呼叫，支持多种协议（如 SIP 或 DAHDI），并通过超时参数控制最大等待时间。 - **状态检测**: 在拨号完成后，提取 `DIALSTATUS` 变量以判断呼叫结果是否成功。 - **播放音频**: 利用 `stream_file` 方法播放存储于 Asterisk 音频目录中的 `.gsm` 文件。 - **异常处理**: 捕获可能发生的 `AGIAppError` 并记录到日志中以便调试。 - **Hangup**: 不论呼叫是否成功完成，均调用 `hangup()` 来清理会话资源。 --- ### 注意事项 - 确保 `/var/lib/asterisk/sounds/` 下存在名为 `custom_message.gsm` 的音频文件。如果不存在，请上传所需的声音片段并转换为 GSM 格式。 - 安装必要的依赖库：运行前需安装 `py-Asterisk` 库，可通过命令 `pip install py-asterisk` 进行安装。 - 修改拨号字符串 (`SIP/${phone_number}`) 中的目标通道类型以匹配实际使用的硬件设备或服务提供商。 ---