SuperAPI AI 工具集

telnyx-voice-media-ruby

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

用途:面向 Ruby 开发者,在 Telnyx 通话控制中处理语音媒体,包括播放音频文件、文本转语音播报,以及通话录音的启动、暂停、恢复与停止。

安装与初始化:执行 gem install telnyx;随后 require "telnyx",客户端初始化示例为 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]),api_key 可省略并使用默认值。

主要能力与调用方式:播放音频使用 client.calls.actions.start_playback(call_control_id),可传 audio_url、audio_type、cache_audio、loop、overlay、target_legs 等参数;overlay 启用时 target_legs 仅限 self。停止播放用 stop_playback。文字转语音用 speak,必填 payload 与 voice,可选 language、payload_type、service_level、loop、target_legs、voice_settings 等。录音方面:start_recording 必填 format 与 channels,可选 transcription、transcription_engine、transcription_language、recording_track、max_length、play_beep、trim 等;pause_recording、resume_recording、stop_recording 分别用于暂停、恢复与停止,录音会在挂断时停止。

回调与校验:相关事件包括 call.playback.started/ended、call.speak.started/ended、call.recording.saved、call.recording.transcription.saved、call.recording.error。Webhook 使用 Ed25519 签名,请求头为 telnyx-signature-ed25519 与 telnyx-timestamp,需用 client.webhooks.unwrap(payload, headers) 校验后再处理。

错误处理:调用可能因网络、限流、校验或认证失败,需捕获 Telnyx::Errors::APIConnectionError、RateLimitError、APIStatusError 等;常见状态码有 401、403、404、422、429,429 建议按 Retry-After 退避重试。

限制:具体价格、配额、可用地区及平台支持等资料暂未提供,请以官方文档为准。