小程序 SDK 常见问题集

最近更新时间：2022-09-20 05:17:40

推流/拉流处理
退后台处理
闪退
只启用小程序的音频功能，不需要发送视频，应该如何设置？
小程序和 Native 互通有问题？
小程序和 Native 互通时，Native 端视频画面为什么上下颠倒？
小程序和 Web 互通时，Web 端可以看到小程序的视频，但小程序看不到 Web 端的视频？
小程序的 live-pusher 组件里的 src 应该写什么？
集成小程序 SDK 时，如何打开和保存日志？
出现客户端初始化失败之后，该如何做?
出现错误码
微信小程序可以在 WebView 网页中调用 anyRTC Web SDK 的接口吗？
在某些社交娱乐场景中，小程序会需要播放背景音乐，anyRTC 微信小程序 SDK 是否支持播放背景音乐？
小程序编译报错-typeerror：-function（）is-not-a-function

推流/拉流处理

推流/拉流处理可以参考或直接使用 GitHub 上开源代码。

退后台处理

可以通过设置小程序的 live-pusher 组件中的 waiting-image 属性来处理。设置后，推流端退到后台时，可以推送静态图片来维持推流，其他端会收到本端预设的 waiting-image 图片来代替视频流。 除非通过一些方式 (例如后台播放背景音乐)，小程序会在某些场景下断开 websocket 或者 rtmp 连接，例如点击右上角按钮将程序退到后台。这种情况下，若回到前台后收到 error code 904 或 501，则应使用 SDK 进行重连，具体方法请参考 重新加入频道 rejoin 中的描述。

闪退

这个问题可能是因为启用了其它 Websocket，但没有开启验证 Https 引起的。如需启用其它的 Websocket，请在本地设置中确保取消勾选不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书。

只启用小程序的音频功能，不需要发送视频，应该如何设置？

直接使用微信小程序的接口处理即可。在小程序的 live-pusher 组件中，通过设置 enable-camera 来实现开启/关闭摄像头。详见 小程序 live-pusher 组件文档。

小程序和 Native 互通有问题？

频道中有小程序 SDK 和 Native SDK 时，可以选择如下一种方式实现互通：

  • Native 端在直播模式下，将用户角色设置为 ArClientRoleBroadcaster = 1：主播，实现互通
  • Native 端在直播模式下，不设置用户角色为主播，也可以接收到小程序端的流，实现互通

小程序和 Native 互通时，Native 端视频画面为什么上下颠倒？

该问题可能是由于 Native SDK 中的 setVideoEncoderConfiguratio 设置的方向模式 orientationMode 为 ORIENTATION_MODE.ORIENTATION_MODE_ADAPTIVE 导致的。解决方法是，将方向模式改成 ORIENTATION_MODE.ORIENTATION_MODE_FIXED_PORTRAIT 就可以解决问题。

小程序和 Web 互通时，Web 端可以看到小程序的视频，但小程序看不到 Web 端的视频？

Web 与小程序互通时，Web 端只支持 H264 模式的编码，不支持 VP8。将 Web SDK 的 index.html 文件修改为如下设置即可： client = ArRtc.createClient({mode: "live", codec: "h264"})；

小程序的 live-pusher 组件里的 src 应该写什么？

客户端调用 client.publish 方法后，会回调一个以 rtmp 开头的临时地址，这个地址就分别是 live-player 和 live-pusher 组件中的 rtmp 播放地址 和 rtmp 推流地址。

集成小程序 SDK 时，如何打开和保存日志？

调用如下 API 实现保存和打开日志：

  • 保存日志：
ArMiniappSDK.LOG.onlog = (text) => {
  Utils.log(text);
};
  • 打开日志：

ArMiniappSDK.LOG.setLogLevel(-1);

出现客户端初始化失败之后，该如何做?

通常，客户端初始化失败，会伴随着错误码 901 或 903，处理方法如下：

  • 901：出现错误码 901 绝大部分原因是没开小程序的服务权限，或没有配置域名，或 uid 参数格式不正确。请参考快速开始完成基本配置；
  • 903：这个错误通常是网络原因引起的；也可能是因为鉴权失败，如没有填 Token，或 Token 无效导致的。请检查并填入有效的 Token 进行尝试。

出现错误码

anyRTC Miniapp SDK for WeChat 在调用 API 或运行时，可能会返回一个错误码对象，也可能会返回一个错误码。详细可以参考 错误代码和警告代码 进行排查。

微信小程序可以在 WebView 网页中调用 anyRTC Web SDK 的接口吗？

微信小程序目前不支持在 WebView 网页中调用 anyRTC Web SDK 的接口。

要在微信小程序中快速实现实时音视频功能，你可以在小程序项目中集成 anyRTC 微信小程序 SDK。详见集成微信小程序 SDK。

在某些社交娱乐场景中，小程序会需要播放背景音乐，anyRTC 微信小程序 SDK 是否支持播放背景音乐？

微信小程序的背景音频需要用微信小程序的原生 API 来集成实现，anyRTC 微信小程序 SDK 无法建立音频播放器。

你可以通过 wx.getBackgroundAudioManager() 接口获取全局唯一的背景音频管理器，并调用 BackgroundAudioManager 类提供的接口来管理背景音频。

小程序编译报错-typeerror：-function（）is-not-a-function

你可以尝试在微信开发者工具中开启增强编译。