使用 Webphone SDK 添加浏览器通话

使用当前 SDK,将长期凭证保留在服务器,并安全测试浏览器通话。

从受支持的软件包和参考文档开始

打开API 文档 → Webphone SDK。下载网页 SDK 包或文档列出的资源,遵循同版本示例。集成旧版本前阅读关联安全公告。这是网页 SDK,不替代原生移动通话集成。

开发者应准备有身份验证的 HTTPS 应用、允许的 SIP 身份、麦克风权限和当前 SDK 必需资源。SDK Playground可检查账户和浏览器,但其中的通话真实发生并可能收费。

将长期凭证保留在后端

  1. 生产环境通常从参考文档的托管令牌示例开始。
  2. 后端认证应用用户并检查其可使用的 IllyVoIP 身份。
  3. 后端用账户 API 密钥请求文档规定的短期浏览器授权。仅返回 SDK 所需浏览器数据,不返回永久 API 密钥。
  4. 用返回数据和匹配的当前示例初始化 SDK。处理到期、退出和连接错误,不要反复新建会话。

不要接受未认证浏览器提供的任意身份,也不能让用户为其他账户生成令牌。API 密钥和 SIP 密码不得进入公开 JavaScript、仓库、页面 URL 或诊断截图。原始 SIP 模式是高级替代方式,不是把永久秘密放到前端的理由。

让用户看见就绪状态

通过 SDK 事件显示连接中、就绪、呼入、通话中、结束和失败。由明确用户操作请求麦克风,支持时允许选音频设备,并清楚处理拒绝权限。显示拨号盘不代表已注册;注册不代表双向音频可用。

不要假设 SDK 包含应用全部多设备策略。遵循连接和断开生命周期,清楚显示会话冲突。断开或结束的会话不得继续表现为活动电话。退出时清除账户专属状态,初始化新登录用户的授权身份,而非前用户缓存。

做小规模验收

经许可测试一次呼出和呼入、接听/结束、麦克风与扬声器,以及提供的保持、拨号盘、转接。测试拒绝权限、断网、退出/换账户及预期多设备行为。遵循当前诊断和区域指南;区域回退不保证中断中的通话能继续。

使用有权测试的目标,检查费率,不要把反复拨号当免费诊断。没有必要告知和授权,不得收集或发送录音。

按阶段诊断

授权失败时检查后端响应和用户身份权限,不记录秘密。信令失败时检查区域和网络/浏览器兼容性。接通无音频时检查设备、权限和媒体网络访问。为支持保留 SDK/浏览器版本、脱敏错误、时间/时区和公开通话编号。

方法、数据格式及令牌寿命以 API 参考为准。参阅API 快速入门了解账户访问和安全请求处理。