前端集成协同评审

在前端集成协同评审页面，支持以下两种方式。

  • 从第三方应用跳转至协同评审的页面。
  • 通过ifame嵌套协同评审的页面链接。

若需要调用会议API接口，应该选择第二种方式。

下面详细介绍两种从第三方应用跳转至协同评审页面的方式。

跳转至协同评审主页（会议列表页面）

window.open(‘http://服务器ip:端口/index.html#/middle?userId=${userId}&userName=${userName}&userAvatar={userAvatar}&uiHide={uiHide}&btnHide={btnHide}&meetOverPage={meetOverPage}’,’_blank’)

参数说明：

参数 说明
userId 用户id
userName 用户名称（长度不超过20个字符）
userAvatar 用户头像，没有即传空
uiHide 头部和底部区域是否隐藏（非必然填项，默认不隐藏）
  • 0：不隐藏
  • 1：仅隐藏头部
  • 2：仅隐藏底部
  • 3：隐藏头部和底部
btnHide 用户权限按钮是否隐藏，多选的时候以“|”分隔 （非必填，默认不隐藏）
  • 1： 静音按钮
  • 2：同步按钮
  • 3：成员管理按钮
  • 4：查看批注按钮
  • 5：快速截屏按钮
  • 6：打开文件按钮
  • 7：结束按钮（主持人）
  • 8：退出按钮（非主持人）
  • 9：被设为主持人
  • 10：邀请成员
  • 11：复制链接
  • 12：语音批注（默认隐藏）

示例：取消静音按钮和同步按钮btnHide=1|2

示例：显示语音按钮 btnHide=12
meetOverPage 会议结束后用户返回的页面（默认返回会议列表页）
  • 1：会议列表页
  • 2：会议结束页
themeConfig 非必填
  • 0：默认主题
  • 1：浅灰
  • 2：黑色

创建协同评审并且打开模型

window.open(‘http://服务器ip:nginx端口/index.html#/middle?userId=${userId}&userName=${userName}&userAvatar={userAvatar}&meetingTitle={encodeURIComponent(meetingTitle)}
&lightUrl=${lightUrl}&fileType=${fileType}&fileName=${encodeURIComponent(fileName)}&uiHide=${uiHide}&btnHide={btnHide}&meetOverPage={meetOverPage}’,’_blank’)

参数说明：

参数 说明
userId 用户id
userName 用户名称（长度不超过20个字符）
userAvatar 用户头像，没有即传空
meetingTitle 会议标题（非必填项）
lightUrl 打开的模型的轻量化地址
fileType 打开的模型类型：
  • 2：2D文件
  • 3：3D文件
fileName 文件名称（非必填项）
uiHide 头部和底部区域是否隐藏（非必填项，默认不隐藏）
  • 0：不隐藏
  • 1：仅隐藏头部
  • 2：仅隐藏底部
  • 3：隐藏头部和底部
btnHide 用户权限按钮是否隐藏，多选的时候以“|”分隔 （非必填，默认不隐藏）
  • 1： 静音按钮
  • 2：同步按钮
  • 3：成员管理按钮
  • 4：查看批注按钮
  • 5：快速截屏按钮
  • 6：打开文件按钮
  • 7：结束按钮（主持人）
  • 8：退出按钮（非主持人）
  • 9：被设为主持人
  • 10：邀请成员
  • 11：复制链接

示例：取消静音按钮和同步按钮btnHide=1|2
meetOverPage 会议结束后用户返回的页面（默认返回会议列表页）
  • 1：会议列表页
  • 2：会议结束页
themeConfig 非必填
  • 0：默认主题
  • 1：浅灰
  • 2：黑色

邀请成员集成

  1. 监听邀请成员事件（详情可参考邀请成员（协同评审通知外层页面））。
  2. 弹出成员列表展示页面（需自行开发，包括成员数据获取及展示）。
  3. 选择成员后，通知协同评审（详情可参考邀请成员（外层页面通知协同评审））。
  4. （可选）如需实时通知到微信、QQ等系统，可在以上步骤完成后，自行开发通知功能，会议相关信息可通过相关对外接口获取。
  5. 成员进入到协同评审主页，会展示当前成员已经被邀请的所有会议，直接点击进入即可。

邀请链接集成

  1. 监听复制链接事件（详情可参考复制链接（协同评审通知外层页面））。
  2. 封装邀请链接内容，邀请链接地址应是集成方的页面地址，协同评审的地址需要拼接在URL中，例如：

    http://[集成方地址]/user.html?linkUrl=http%3A%2F%2F[协同评审地址]%2Findex.html%23%2F3Dxtps%2F686890288&meetingNumber=686890288

  3. 用户打开邀请链接，集成方需要获取到用户信息后（如：要求用户登录、匿名随机生成用户信息等方式），带入用户信息跳转到协同评审会议页面，跳转示例：

    http://[协同评审地址]/index.html#/middle?userName=张三&userId=999&meetId=686890288

  4. 邀请链接需要同步配置用户权限，参数说明参考创建协同评审并且打开模型（不配置语音批注默认隐藏）。