用途:基于 Telnyx Java SDK 对通话媒体做实时操作,面向实时音频分析与 AI 集成,例如欺诈检测或生成式语音响应。
主要能力:通过 Call Control 动作接口实现分叉(fork)开始/停止、流式(streaming)开始/停止、实时转写开始/停止。分叉可把通话媒体实时送到指定目标;流式可把媒体以 base64 编码 RTP 载荷包在 JSON 中发送到 WebSocket 或 Dialogflow;转写支持指定引擎(如 Google、Telnyx、Deepgram、Azure)。
用法:以 Maven 依赖 com.telnyx.sdk:telnyx:6.36.0 或 Gradle implementation("com.telnyx.sdk:telnyx:6.36.0") 引入,使用 TelnyxOkHttpClient.fromEnv() 初始化客户端,再调用 client.calls().actions() 下的 startForking、stopForking、startStreaming、stopStreaming、startTranscription、stopTranscription,参数用对应 Params.builder() 构建。需处理 401、403、404、422、429 等错误,429 可退避重试。
Webhook:需配置回调 URL,校验 Ed25519 签名(telnyx-signature-ed25519、telnyx-timestamp 头,使用 client.webhooks().unwrap()),相关事件包括 callForkStarted、callForkStopped、callStreamingFailed、callStreamingStarted、callStreamingStopped、transcription。
限制:官方技能资料未提供价格、平台可用性或配额等信息;转写会在通话挂断时停止;须在生产环境验证 webhook 签名并处理异常。