# 腾讯会议企业应用接入指南

本指南旨在帮助企业应用从零开始快速接入到腾讯会议中，服务端接入指南请前往服务端说明文档。

# 环境准备

知音楼版本 >= 1.6.9，腾讯会议客户端（用于开启控制台进行调试）。

# 接入步骤

# 第一步

申请测试环境腾讯会议企业应用，提供材料如下：

应用名称；
应用logo（128*128，大小20K以内，PNG格式），logo 设计规范 (opens new window)；
桌面端首页地址 & 移动端首页地址；（用户点击应用 icon 后，跳转到的地址，仅支持 https）（例：https://www.meeting.tencent.com）；
调用js-api的域名；（例：meeting.qq.com）；
应用希望适配的布局（侧边栏、内嵌视图、独立弹窗（必选，历史会议中打开需用此布局））及希望默认打开布局；
调试者手机号（用于开发调试，需要是应用企业下的账号）。

# 第二步

创建日程，会议绑定企业应用，请参考创建日程。

# 第三步

如使用腾讯会议 jssdk 相关 api，需要引入腾讯会议 jssdk：https://cdn.meeting.tencent.com/jssdk/wemeet-js-sdk-1.0.24.js，腾讯会议 js-api 参考文档 (opens new window)。

# 第四步

如使用到的腾讯会议 api 有权限限制，则需要鉴权，鉴权数据需要企业应用的服务端向开放平台服务端获取，请参考获取鉴权数据。

# 第五步

由于腾讯会议无环境区分，我们的测试环境与线上环境对应腾讯会议不同的账号，所以需要单独申请不同环境对应的应用。测试环境应用调试完成，申请线上环境腾讯会议企业应用，材料与步骤一相同。

# 调试说明

需要用户创建日程后，发起腾讯会议进行调试。由于腾讯会议 SDK 版本对调试功能做了阉割处理，开发过程中的一切调试需要在腾讯会议客户端完成。腾讯会议客户端下载 (opens new window)。

腾讯客户端免登链接获取，替换 AUTHORIZATION，为知音楼接口请求 headers 中的 authorization；替换 user_id，知音楼账号 userId

    curl --location --request POST 'https://yach-capi-test.zhiyinlou.com/usergroup/userinfo/aggre' \
    --header 'AUTHORIZATION: caViKXIRR1EL96sUyI5QkgQueUrXzFpmxzPIvafC9RCEqSkUQ8n9uPr/aWeY93ap' \
    --header 'api-debug: 7d5c710ee348107f69e25b71cffa16e1' \
    --header 'Content-Type: application/json' \
    --data-raw '{"user_id":"112362","appID":"sdfasdfasdfasdf","sign":"sfasdfasdfasdf"}'

只有在申请应用时提供的调试者手机号对应的账号才可以进入开发者模式

# Windows

下载资源包；
找到 User 文件夹，快速访问输入： %appdata%\Tencent\WeMeet\Users；

（参考C:\Users\用户名\AppData\Roaming\Tencent\WeMeet\Users）； 3. 将下载的资源包拷贝到 User 目录并解压； 4. 关闭腾讯会议，重新启动； 5. 按快捷键 ctrl + alt + shift + D，进入调试模式； 6. 在需要调试的页面上点击右键，点“开发者工具”，进入调试模式。

# Mac

按下command+shift+control+D进入调试模式
内置浏览器右键--检查元素进入调试窗口

# 腾讯会议自建应用 demo

知音楼扩展应用app2 为知音楼已申请扩展应用，测试环境发起腾讯会议可自动打开此应用（仅用于接入方了解调试流程使用，如需开发自己的应用，需按照步骤申请接入）。

由于腾讯会议应用的跳转地址仅支持 https，可以将本地的测试项目地址代理到指定地址下，即将本地 host 代理到 https://yach-meeting-app.zhiyinlou.com，增加路由 /app2，即 https://yach-meeting-app.zhiyinlou.com/app2，可在腾讯会议扩展应用中调试自己的页面。

注意：https://yach-meeting-app.zhiyinlou.com/app2 链接为接入步骤一中点击 icon 跳转的地址，需接入方确定。

代理工具推荐使用 whistle (opens new window)，例如：

← 应用接入指南