带看3 (带看Tim版) 微信小程序对接指导文档

demo项目下载地址

微信小程序带看Tim版对接demo下载地址

1、添加服务器地址（开发阶段可不配置，不校验合法域名、web-view等）

登录微信公众平台，进入开发 > 开发设置页面，配置以下服务器地址：

1、request合法域名

2、socket合法域名

wss://wss.im.qcloud.com
wss://wss.tim.qq.com

3、uploadFile合法域名

如业务或 SDK 涉及文件、图片、音视频上传，请按实际上传服务补充对应的 HTTPS 域名

4、业务域名

您的展示端服务https域名

配置完成后，可在微信公众平台的服务器域名页面查看 request、socket、uploadFile 等配置项。

配置小程序服务器域名

2、小程序中开放语音权限

<live-player>和<live-pusher>需要先满足开放类目要求，并在小程序后台开通组件权限。推荐添加工具 > 视频客服类目。

微信官方对live-player组件开放类目的说明中，工具 > 视频客服可用于一对一视频客服场景：

live-player类目

a、添加类目

进入「设置」-「基本设置」-「基本信息」-「服务类目」，点击「添加服务类目」。

服务类目

在服务类目中选择「工具」-「视频客服」并提交审核。审核通过后，服务类目列表中会展示工具 > 视频客服条目。

服务类目-条目项

b、开通组件权限

需要先通过类目审核，再在小程序管理后台进入「开发与服务」-「开发管理」-「接口设置」-「接口权限」，在其他接口中自助开通live-player和live-pusher组件权限。

需开通必要接口

3、代码集成API

1、在小程序项目中，app.js需要包含baseUrl全局变量，且需要实现一个getUserId全局方法，vr_client.js中会调用，需要保证获取的id是能够标识用户身份的唯一id

2、从index页面跳转到vr_client页面开始带看，需要一些必要的参数，如下

  // 开始VR带看
  async startVR() {
    console.log("开始VR看房")
    let url = "/pages/vr_client/vr_client"
    const params = {
      modelId: this.data.modelId, // 模型id
      vrLink: this.data.vrLink, // vr链接
      userId: app.globalData.userId, // 用户id
      useVrTakeSee: 1, // 启动带看
      callerUserId: app.globalData.userId, // 发起人id
      packageId: this.data.packageId, // 房源id
      startTour: 0, // 是否直接开启带看, 1:直接开始带看，0：先进入看房页
      pattern: 'callout', // 呼叫模式必带参数 值为callout
      vconsole: 1, // 启动debug模式
      imPlatform: 'mp', // 表示小程序环境，必要参数
      takeSeeTestMode: 1, // 启动测试模式（h5页会弹框）
      autoQuitGuidedTour: this.data.autoQuitGuidedTour,
    }

    url = this.setUrlParams(url, params)

    wx.navigateTo({
      url: url,
    })
  },

4、vr_client.js中代码是带看模板页，一般不需要修改, 如若修改请注意一下几点

// 1、初始化sdk
GuidedTourAPI.setupWechatEnv();
// 2. 设置参数<众趣带看token， 请求的众趣服务的域名>
GuidedTourAPI.setSDKParams(
  this.data.takeLookToken,
  app.globalData.serviceBaseUrl
);
// 3. 获取sdk配置信息，在sdk内部设置sdkAppId，无需客户端关心
await GuidedTourAPI.getConfig();

// 4. 获取userSign参数，并初始化小程序sdk
const res = await GuidedTourAPI.getUserSig(this.userId, options.packageId);
options.userSig = res.user_sig;

// * @options {userID, userSig, callerUserId}
// * @page 小程序页面实例，wxml页面必须带着live-player和live-pusher原生组件 （见vr_client.wxml）
await GuidedTourAPI.initWeChatImSdk(options, this);

注意事项

使用小程序trtc功能，需要在腾讯云后台开通trtc的基础服务，否则无法使用（这一点和App不同，App不需要开通也可以使用）。
带看sdk使用了async/await，需要小程序本地设置开启增强编译
小程序端仅支持发起方呼叫模式，小程序端不能作为接听方。
带看sdk直接使用takelook-plugin中的wx-vr-takelook-plugin.js即可。