iOS:生命周期、权限与排错
核对账号切换、权限拒绝和容器能力。
下载接入包
- iOS
WKWebView Swift 容器示例,加入现有 Xcode 工程编译;不含预编译 framework。
生命周期
复用当前页面;进入后台、离开页面或音频中断时停止语音与麦克风,返回后由用户重新开始。退出登录先 closeForAccountChange(),再从导航栈移除;临时网页数据不承诺关闭后的历史续接。
权限与功能边界
用户开始语音后,仅对当前入口主框架的可信 HTTPS 麦克风请求显示授权;摄像头拒绝。使用渠道现有 Web 语音链路,需同步更新 /support;没有 APNs、后台通话、CallKit 或附件原生保存桥。
连接被拒绝时
核对 HTTPS、key、entryId 与入口启用状态;网站渠道的 Referer 限制可能不适用于原生容器。为 App 创建专用入口评估策略,不伪造来源、不关闭旧网站的来源限制。
最小回归
- 真机验收首次允许/拒绝录音、AI 出声与打断、挂断释放、后台/锁屏/电话中断、耳机、账号切换、安全区、键盘和文件选择。
- A 账号聊天后退出,B 看不到 A 的历史;关闭后旧回调不再触发。
- 接收真实 AI 与人工回复;网络未知时保留待核对,不自动重复提交。
官方原始接入文档
先按云蝠指南完成入口、智能体和服务配置,再按下列官方原文配置宿主权限或供应商资源。外部文档说明对应平台能力,不代表云蝠已开放其中全部接口;腾讯 SecretKey、签名密钥和管理 API Key 仅放服务端。参数、地域、类目和资费以官方当前页面及账号实际开通结果为准。
- Apple · NSMicrophoneUsageDescription ↗:将真实录音用途写入宿主 Info.plist;只复制 Swift 容器不足以完成权限接入。
- Apple · WKUIDelegate 媒体采集权限 ↗:按可信 origin、frame 与媒体类型处理网页请求;系统录音权限和网页媒体授权需要分别处理。
实现依据 · 仓库内路径
sdk/client-kit/ios/YunfuSupportViewController.swiftsdk/client-kit/README.md
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。