小程序生命周期与事件
自绘界面时连接客户端状态与页面生命周期。
下载接入包
- 微信小程序
默认 web-view 复用原版渠道页面,需业务域名;另含原生聊天与语音替代组件,按各自能力与权限完成真机验收。
订阅与显示
运行前
yunfu-sdk/examples/lifecycle.js · CommonJS 模块 · 接入包 0.3.14
- 用于自绘页面;现成 yunfu-chat 已管理自身生命周期。
- onShow/onHide/onUnload 分别转发给 controller,open 和 send 只从点击事件触发。
完整代码 · 20 行
const { YunfuMiniappClient } = require('../index');
// For a self-rendered page. Use the ready-made yunfu-chat component when no custom UI is needed.
function createSupportController(options, render) {
const client = new YunfuMiniappClient(options);
const unsubscribe = client.subscribe(render);
return {
async open() { client.setChatVisible(true); return client.connect(); },
onShow() { client.onShow(); },
onHide() { client.onHide(); },
collapse() { client.setChatVisible(false); },
send(text) { return client.sendText(text); },
logout() {
try { client.forgetSession(); }
finally { try { unsubscribe(); } finally { client.destroy(); } }
},
destroy() { try { unsubscribe(); } finally { client.destroy(); } },
};
}
module.exports = { createSupportController };使用流程预览 · 示意图
帮助理解此示例的使用顺序,不执行代码或验证连接。
- 准备
用于自绘页面;现成 yunfu-chat 已管理自身生命周期。 onShow/onHide/onUnload 分别转发给 controller,open 和 send 只从点击事件触发。
- 在项目中使用
yunfu-sdk/examples/lifecycle.js · CommonJS 模块
- 核对结果
首次 open 才连接;隐藏暂停轮询,卸载销毁,退出账号清理旧会话,不自动重放消息。
预期结果:首次 open 才连接;隐藏暂停轮询,卸载销毁,退出账号清理旧会话,不自动重放消息。
单实例约束
同一主机、key、entryId、userScope 已有存活实例时,新建会返回 SESSION_ALREADY_IN_USE。隐藏页面也占用实例;优先复用,或先 destroy 再创建。使用现成组件时,其内部管理生命周期,不要再为相同 scope 创建第二个客户端。
事件模型
当前 API 通过 subscribe(listener) 返回状态,取消订阅函数由 subscribe 返回;没有通用 on("message")、微信订阅消息或离线推送接口。前台恢复会补拉,首次历史不计为新未读。
官方原始接入文档
先按云蝠指南完成入口、智能体和服务配置,再按下列官方原文配置宿主权限或供应商资源。外部文档说明对应平台能力,不代表云蝠已开放其中全部接口;腾讯 SecretKey、签名密钥和管理 API Key 仅放服务端。参数、地域、类目和资费以官方当前页面及账号实际开通结果为准。
- 微信开放文档 · 小程序网络与合法域名 ↗:原生请求需配置 request、uploadFile、downloadFile 合法域名;WebView 另需业务域名,关闭校验不能代替正式配置。
- 微信开放文档 · 隐私授权开发指引 ↗:接入宿主隐私告知和同意流程;隐私同意、系统麦克风授权与实际收音分别验收。
- 微信开放文档 · wx.authorize 授权接口 ↗:核对 scope.record 与拒绝后的处理;进入聊天页或点击普通按钮不等于已完成录音授权。
- 微信开放文档 · live-pusher 原生推流组件 ↗:核对原生推流组件、主体及类目权限;与腾讯 SDK 配置配套,在真机验证音频事件。
- 腾讯云 · 原生小程序快速接入 ↗:先核对企业主体、允许类目、推拉流权限、TRTC 套餐和 SDK 域名,再完成进房、发布音频与退房;开发工具不能代替真机。
- 腾讯云 · 实现 AI 对话 ↗:理解 RTC、识别、LLM、TTS、转录和打断的职责;具体参数与频率以对应接口的当前版本为准。
- 腾讯云 · 开始 AI 对话任务 · StartAIConversation ↗:服务端适配时核对地域、SdkAppId、房间、目标用户与模型配置,保留 TaskId/RequestId;返回成功还需核对手机是否实际出声。
- 腾讯云 · 控制 AI 对话 · ControlAIConversation ↗:核对供应商支持的播报和模型触发命令;仅供服务端适配参考,不可直接当作云蝠公开操作调用。
- 腾讯云 · 停止 AI 对话 · StopAIConversation ↗:结束服务端 AI 对话任务并核对原 TaskId 的回收结果;退出客户端页面不应被当作云端任务已停止的证明。
- 腾讯云 · 高级权限控制 ↗:评估服务端 UserSig、PrivateMapKey 与房间隔离;通用平台表不证明小程序和 AI bot 已兼容,启用前须在实际应用核对入房。
实现依据 · 仓库内路径
sdk/wechat-miniapp/index.d.tssdk/wechat-miniapp/components/yunfu-chat/index.js
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。