一、完整代码示例
你可通过以下示例代码,实现从业务微信小程序拉起腾讯会议微信小程序的交互体验。
const meetingCode = '948050239'; // 会议码const password = '6666'; // 会议密码const channel = 'ExampleChannel'; // 从哪里跳转到腾讯会议小程序的const nickname = encodeURIComponent('小程序用户'); // 入会昵称wx.navigateToMiniProgram({ appId: 'wx33fd6cdc62520063', // 跳转的目标小程序(腾讯会议小程序AppId) path: `pages/index/index?chn=${channel}&code=${meetingCode}&pwd=${password}&nm=${nickname}`, // 跳转到的页面路径 extraData: { }, envVersion: 'release', // 是指要打开的小程序的版本,默认为'release' success(res) { // 打开成功 }, fail(err) { // 打开失败 console.error(`launch Tencent Meeting Miniprogram failed: ${err.errMsg}`); },})
二、控制跳转腾讯会议微信小程序后的页面路径
你可以基于“path”字段控制跳转到腾讯会议微信小程序后的具体页面,格式示例及参数说明如下:
三、路径格式示例
pages/index/index[?chn=fromWhere[&code=meetingCode[&pwd=password][&nm=nickname]][&customerData=yourCustomerData]]
四、参数说明
| 参数名称 | 必选 | 示例值 | 参数描述 |
| chn | 否 | Test1234 | 来源渠道标识,建议格式为首字母大写的字母、数字组合,具体名称可自行定义。例如第三方为小白兔公司,可赋值"WhiteRabbit"。 |
| code | 否 | 123456789 | 需要进入的会议号,格式为9 – 12位数字,例如123456789;如果未传该字段,则跳转到腾讯会议小程序后会停留在首页。 |
| pwd | 否 | abc123 | 会议密码,格式为4~6位数字、字母的组合,例如 abc123;如果目标会议未设置密码,则传入的 pwd 会被忽略。如果传入错误的入会密码时,跳转到腾讯会议微信小程序后将不会自动入会并提示密码错误,需要用户手动修改密码后加入。 |
| nm | 否 | %E7%94%A8%E6%88%B7_%E6%B5%8B%E8%AF%95ABC | 入会昵称,需使用 encodeURIComponent 编码。 |
| customerData | 否 | eyJ2ZXIiOiAiMS4wIiwgInVzZXJEYXRhIjoiY2h1eGlhb2h1b2RvbmcxMDAxIn0= | 用户专属字段,用于给用户生成特定的入会链接,方便第三方应用识别当前用户的身份。具体方法是:通过此链接并携带 customerData 跳转入会的用户,开发者可以从“用户入会”的服务端 WebHook 中拿到 customerData 字段,实现用户身份的识别。customerData 需以{"ver": "1.0","userData":"自定义字段"}的结构,进行 Base64编码。注意:传递时需使用 Base64 编码,且编码后的长度不要超过256字节。后续通过腾讯会议 RestAPI 或者 WebHook 回调获取到的 customerData 字段是明文,无需再次进行 Base64解码。 |
五、跳转页面示例
| 场景 | 示例代码 | 页面示意 |
| 跳转到首页 | path: `pages/index/index?chn=ExampleChannel` | |
| 无密码的会议入会 | path: `pages/index/index?chn=ExampleChannel&code=561767737` | |
| 有密码的会议入会 (传入密码) | path: `pages/index/index?chn=ExampleChannel&code=396839244&pwd=123457`说明:密码错误或未输入密码就会停留在当前页面。密码正确则直接入会。如果用户未完成实名认证,此页面会引导用户去授权或者验证手机号,政策要求入会需要实名。 | |
| 有密码的会议入会 (未传密码) | path: `pages/index/index?chn=ExampleChannel&code=396839244` | |
| 前往某个录制文件的详情页 | path: `pages/sub-web/web/web?url=${encodeURIComponent(xxxx)}`说明:xxxx 替换为具体的录制文件链接 url,不要进行 url 的编码,url 是什么就传递什么。 | |
六、参考文档
更多相关信息,可参见 微信小程序产品文档。