使用 Webphone SDK 添加浏览器通话
使用当前 SDK,将长期凭证保留在服务器,并安全测试浏览器通话。
从受支持的软件包和参考文档开始
打开API 文档 → Webphone SDK。下载网页 SDK 包或文档列出的资源,遵循同版本示例。集成旧版本前阅读关联安全公告。这是网页 SDK,不替代原生移动通话集成。
开发者应准备有身份验证的 HTTPS 应用、允许的 SIP 身份、麦克风权限和当前 SDK 必需资源。SDK Playground可检查账户和浏览器,但其中的通话真实发生并可能收费。
将长期凭证保留在后端
- 生产环境通常从参考文档的托管令牌示例开始。
- 后端认证应用用户并检查其可使用的 IllyVoIP 身份。
- 后端用账户 API 密钥请求文档规定的短期浏览器授权。仅返回 SDK 所需浏览器数据,不返回永久 API 密钥。
- 用返回数据和匹配的当前示例初始化 SDK。处理到期、退出和连接错误,不要反复新建会话。
不要接受未认证浏览器提供的任意身份,也不能让用户为其他账户生成令牌。API 密钥和 SIP 密码不得进入公开 JavaScript、仓库、页面 URL 或诊断截图。原始 SIP 模式是高级替代方式,不是把永久秘密放到前端的理由。
让用户看见就绪状态
通过 SDK 事件显示连接中、就绪、呼入、通话中、结束和失败。由明确用户操作请求麦克风,支持时允许选音频设备,并清楚处理拒绝权限。显示拨号盘不代表已注册;注册不代表双向音频可用。
不要假设 SDK 包含应用全部多设备策略。遵循连接和断开生命周期,清楚显示会话冲突。断开或结束的会话不得继续表现为活动电话。退出时清除账户专属状态,初始化新登录用户的授权身份,而非前用户缓存。
做小规模验收
经许可测试一次呼出和呼入、接听/结束、麦克风与扬声器,以及提供的保持、拨号盘、转接。测试拒绝权限、断网、退出/换账户及预期多设备行为。遵循当前诊断和区域指南;区域回退不保证中断中的通话能继续。
使用有权测试的目标,检查费率,不要把反复拨号当免费诊断。没有必要告知和授权,不得收集或发送录音。
按阶段诊断
授权失败时检查后端响应和用户身份权限,不记录秘密。信令失败时检查区域和网络/浏览器兼容性。接通无音频时检查设备、权限和媒体网络访问。为支持保留 SDK/浏览器版本、脱敏错误、时间/时区和公开通话编号。
方法、数据格式及令牌寿命以 API 参考为准。参阅API 快速入门了解账户访问和安全请求处理。