SuperAPI AI 工具集

telnyx-webrtc-client-android

编程与开发

查看项目

更新于 10-16 05:42

技能介绍

用途:该技能面向在 Android 应用中集成 Telnyx WebRTC SDK,实现实时语音通话(VoIP)功能。

前置条件:需先在服务端创建 WebRTC 凭证并生成登录令牌,可参考对应服务端语言的 telnyx-webrtc-* 技能。

安装:在项目 build.gradle 的 allprojects.repositories 中添加 maven { url 'https://jitpack.io' },并添加依赖 implementation 'com.github.team-telnyx:telnyx-webrtc-android:latest-version'。

权限:在 AndroidManifest.xml 中声明 INTERNET、RECORD_AUDIO、ACCESS_NETWORK_STATE;推送通知(Android 14+)还需 POST_NOTIFICATIONS、FOREGROUND_SERVICE、FOREGROUND_SERVICE_PHONE_CALL。

主要能力:支持基于凭证或 JWT 令牌登录(CredentialConfig / TokenConfig),可配置主叫显示名与号码、FCM 令牌、铃声、日志级别、自动重连、区域等;通过 telnyxClient.call.newInvite 发起外呼,通过订阅 socketResponseFlow(推荐)或已废弃的 socketResponseLiveData 处理 INVITE、ANSWER、BYE、RINGING 等事件;支持通话控制(挂断、静音、保持、DTMF)、多路通话管理;通过 FCM 处理来电与未接来电推送,并可自动拒接推送来电(connectWithDeclinePush);开启 debug 后可采集 MOS、抖动、RTT 等通话质量指标;支持匿名登录并连接到 Telnyx Voice AI Agent,接收转写文本、发送文本消息;支持自定义日志(TxLogger)与 ProGuard 规则。

限制与注意:需正确授予录音权限以保障音频;推送需 FCM 项目与 google-services.json 匹配,否则报 sender_id_mismatch;登录失败应核对 Telnyx Portal 中的 SIP 凭证;设置认证或推送时须阅读 references/webrtc-server-api.md。文档其余细节以官方为准。