用途:在浏览器应用中集成基于 Telnyx 后端的实时语音(VoIP)通话。使用前需先在服务端创建 WebRTC 凭证并生成登录令牌,可参考对应服务端语言插件的 telnyx-webrtc-* 技能。
安装与导入:npm install @telnyx/webrtc --save,import { TelnyxRTC } from '@telnyx/webrtc'。
认证:推荐令牌方式 new TelnyxRTC({ login_token: 'your_jwt_token' }),或凭证方式 { login, password },然后 client.connect()。前端代码不要硬编码凭证。设置 client.remoteElement 指向播放远端音频的 audio 元素,并监听 telnyx.ready、telnyx.error、telnyx.notification(来电与通话更新)、telnyx.stats.frame(启用 debug 时的通话质量指标)。
通话:client.newCall({ destinationNumber, callerNumber }) 发起呼叫;来电在通知中判断 call.state === 'ringing' 后 call.answer()。控制方法包括 hangup、dtmf、muteAudio/unmuteAudio、hold/unhold。
调试与诊断:newCall 可传 debug: true、debugOutput: 'socket' 或 'file';PreCallDiagnosis.run 可在通话前测试连通性,需提供凭证与 texMLApplicationNumber。
AI 助手集成:可用 anonymous_login(target_id、target_type: 'ai_assistant')连接,AI 助手需将 telephony_settings.supports_unauthenticated_web_calls 设为 true;之后 newCall 的 destinationNumber 可留空,AI 场景推荐 Opus 编解码器(通过 preferred_codecs 传入)。
其他能力:getIsRegistered 查询注册状态,checkPermissions、麦克风启停、设备与分辨率查询、setAudioSettings 音频设置、webRTCInfo/webRTCSupportedBrowserList 检查浏览器支持,另有自定义请求头、ICE 候选预取与 Trickle ICE、通话恢复、语音隔离等选项。浏览器支持情况见资料中的平台表格。
限制:具体收费、价格与更多细节资料暂未提供。