小程序端相关问题

最近更新时间:2020-07-01 12:09:45

小程序端可以禁用重力感应吗?

小程序暂未开放重力感应设置接口。

小程序支持做最小化悬浮窗吗?

<live-player> 标签有个 picture-in-picture-mode 属性,可以设置小窗模式,更多详情请参阅 微信官方文档。但目前该属性在不同的机型和系统上存在兼容性问题,不建议使用。

小程序端有没有区分退房事件类型的,例如主动退房、被踢、解散房间?

复杂的信令管理,建议结合 IM SDK 配合群组及自定义消息来实现。

小程序端横屏推流的时候,为什么画面被裁剪了?

iOS 端可以通过打开竖屏方向锁定,Android 端暂时没有办法规避,需要小程序底层来修改。

小程序网络波动通过哪个值来判断?

通过 netQualityLevel 来判断:

  • 0:未定义
  • 1:最好
  • 2:好
  • 3:一般
  • 4:差
  • 5:很差
  • 6:不可用

小程序端和桌面浏览器端支持自定义流 ID 吗?

  • 小程序端从微信7.0.12版本开始支持自定义流 ID,在 rtcConfig 构造时字段填写自定义流 ID,具体可以参考 Demo 实现。
  • 桌面浏览器端4.3.8以上版本已支持自定义流 ID,在 createClient 时自定义该字段。

小程序端调试时为什么要开启调试模式?

开启调试后,可以略过把“request 合法域名”加入小程序白名单的操作,避免遇到登录失败,通话无法连接的问题。

小程序端为什么会出现黑屏/画面卡住?

您可以检查小程序 Demo 左下方的控制面板,打开【调试模式】即可在界面上看到详细的推拉流信息,如果没有推拉流信息则表示未成功进房或 live-pusher,live-player 创建失败。

参数 含义
appVersion 微信版本号
libVersion 基础库版本号
template trtc-room 组件的 template
debug 是否开启推拉流的 debug 信息
userID 生成的用户 ID
roomID 房间号
camera 是否开启摄像头
mic 是否开启麦克风
switch camera 摄像头位置(front / back)
Room 进房,退房,退房并返回上一界面操作
user count 房间内人数以及 user 信息
userID:用户 ID
mainV:该用户是否有主路视频
mainA:该用户是否有主路音频
auxV:该用户是否有辅路视频
stream count 房间内流的数量以及流信息
userID:用户 ID
SubV:是否订阅此路流的视频
SubA:是否订阅此路流的音频

小程序端集成实时音视频 SDK 前需要做哪些准备工作?

  1. 创建腾讯云实时音视频应用,购买相应的套餐,并获取到 SDKAppID 和密钥信息。
  2. 小程序服务器域名配置。
  3. 开通小程序类目与推拉流标签权限。
    出于政策和合规的考虑,微信暂未放开所有小程序对实时音视频功能(即 <live-pusher> 和 <live-player> 标签)的支持:
    • 小程序推拉流标签不支持个人小程序,只支持企业类小程序。
    • 小程序推拉流标签使用权限暂时只开放给有限 类目
    • 符合类目要求的小程序,需要在【微信公众平台】>【开发】>【接口设置】中自助开通该组件权限,如下图所示:

更多详情请参见 跑通Demo(小程序)快速集成(小程序)

小程序的环境要求是怎样的?

  • 微信 App iOS 最低版本要求:7.0.9
  • 微信 App Android 最低版本要求:7.0.8
  • 小程序基础库最低版本要求:2.10.0
  • 由于微信开发者工具不支持原生组件(即 <live-pusher> 和 <live-player> 标签),需要在真机上进行运行体验。

更多详情请参见 快速集成(小程序)

小程序端进入多人音视频看不到画面,该如何处理?

  1. 请使用手机真机运行,微信开发者工具内部的模拟器目前暂不支持直接运行。
  2. 请通过 wx.getSystemInfo 查询小程序基础库版本,小程序基础库最低版本要求为2.10.0。
  3. 请确认小程序所属的类目,由于监管要求,小程序推拉流标签使用权限暂时只开放给有限 类目

如有更多需求,或希望深度合作,可以 提交工单 或致电95716联系我们。

小程序端运行出错,该如何排查?

  1. 请检查开通的小程序类目是否正确,<live-pusher> 和 <live-player> 标签是否已开启。
  2. 请确认已将 小程序域名白名单 添加到小程序 request 合法域名,或已开启调试模式。
  3. 请重新解压小程序端 Demo 直接运行,若运行正常,建议参考 快速集成(小程序) 重新集成 SDK。
  4. 若问题依然存在,可以登录 微信小程序开发者社区 查找相关资料,也可以 提交工单 或致电 95716 联系我们。

小程序端如果需要上线或者部署正式环境怎么办?

  1. 请申请域名并做好备案工作。
  2. 请将服务端代码部署到申请的服务器上。
  3. 请将推流域名及 IM 域名配置到小程序控制台 request 合法域名里面:
    • https://official.opensso.tencent-cloud.com
    • https://yun.tim.qq.com
    • https://cloud.tencent.com
    • https://webim.tim.qq.com

<live-pusher> 和 <live-player> 标签使用及错误码参考:

小程序使用组件内置模板不符合预期是什么原因?

目前我们的组件仅支持在同层模式下使用(微信已全量支持同层模式),如果使用不符合预期,请您检查 app.json 下是否有"renderingMode": "seperated"配置,此配置会强制开启非同层模式,导致内置模板样式失效。

目录