Android:生命周期、权限与排错
核对账号切换、权限拒绝和容器能力。
下载接入包
- Android
WebView Kotlin 容器和 Manifest 合并片段,需宿主工程编译;不含 AAR。
生命周期
切后台取消待授权请求并挂断,回前台保留文字、不自动开麦。退出登录先 finish 所有客服 Activity,再更换宿主账号;不恢复旧账号的 WebView、回调或 savedInstanceState。
权限与功能边界
开始语音时申请系统录音权限,仅向当前可信来源授予 AUDIO_CAPTURE,拒绝摄像头和未知资源。使用渠道 Web 语音,需同步更新 /support。无后台通话、ConnectionService、厂商推送或附件原生保存桥。
连接被拒绝时
核对 HTTPS、key、entryId 与入口启用状态;网站渠道的 Referer 限制可能不适用于原生容器。为 App 创建专用入口评估策略,不伪造来源、不关闭旧网站的来源限制。
最小回归
- 真机验收允许/拒绝录音、授权中退出、AI 出声与打断、挂断释放、前后台/锁屏/电话中断、耳机、弱网、旋转和账号切换。
- A 账号聊天后退出,B 看不到 A 的历史;关闭后旧回调不再触发。
- 接收真实 AI 与人工回复;网络未知时保留待核对,不自动重复提交。
官方原始接入文档
先按云蝠指南完成入口、智能体和服务配置,再按下列官方原文配置宿主权限或供应商资源。外部文档说明对应平台能力,不代表云蝠已开放其中全部接口;腾讯 SecretKey、签名密钥和管理 API Key 仅放服务端。参数、地域、类目和资费以官方当前页面及账号实际开通结果为准。
- Android Developers · 请求运行时权限 ↗:声明并请求 RECORD_AUDIO;处理拒绝、永久拒绝及恢复,不把权限请求回调当作全部获准。
- Android Developers · WebView PermissionRequest ↗:在 UI 线程仅授予当前可信来源的音频资源,处理取消请求;不直接 grant(getResources()) 放行未知媒体权限。
实现依据 · 仓库内路径
sdk/client-kit/android/YunfuSupportActivity.ktsdk/client-kit/README.md
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。