SuperAPI AI 工具集

telnyx-voice-conferencing-java

编程与开发

查看项目

更新于 10-16 08:41

技能介绍

用途:该技能面向使用 Java 构建呼叫中心或电话会议应用的开发者,基于 Telnyx Java SDK 创建和管理会议、队列与多方会话。

安装:Maven 依赖为 com.telnyx.sdk:telnyx:6.36.0;Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.36.0")。

初始化:通过 TelnyxOkHttpClient.fromEnv() 创建 TelnyxClient,示例默认 client 已初始化。

主要能力:

  • 队列:将呼叫入队(POST /calls/{call_control_id}/actions/enqueue,必填 queue_name)及移出队列(leave_queue)。
  • 会议管理:列出、创建、检索、结束会议。创建需 call_control_id 与 name,可选 beep_enabled、max_participants、region、duration_minutes 等;会议在所有参与者离开或 4 小时后过期。
  • 参与者操作:加入、离开、静音、保持、列出参与者。加入支持 supervisor_role(barge、monitor、none、whisper)等参数。
  • 音频与交互:播放音频、停止播放、语音播报(speak,需 payload 与 voice)、发送 DTMF、使用音频提示收集 DTMF。
  • 录音:开始、暂停、恢复、停止会议录音,开始需 format,可选 channels、trim 等。

错误处理:调用可能返回网络错误、429 限流、422 校验错误或 401 认证错误,生产代码应捕获 TelnyxServiceException 并按状态码处理,429 建议指数退避重试。

分页:列表方法返回分页对象,可用 .autoPager() 自动遍历,或 .hasNextPage() 与 .nextPage() 手动控制。

限制:会议最多参与者数由创建时的 max_participants 决定;会议在参与者全部离开或 4 小时后过期;部分操作会触发 webhook(如 conference.participant.left、conference.recording.saved)。具体计费、价格与平台支持情况暂未提供。