了解小程序音视频流程
- 在小程序中与设备进行双向音视频的功能,是基于小程序端的VOIP和Xp2p插件实现的
- 在SDK中,获取设备列表/添加设备等操作,是基于与赛蓝的业务服务器交互来获取的
VOIP插件
- 用于设备端呼叫小程序。
- 插件需要用到小程序端的多个权限,因此想要使用VOIP功能,必须完成环境配置中的所有七个步骤才能开始开发调试
- 小程序端的接听界面,与微信的原生视频通话界面一样。以及被呼叫时的通知横幅,也与微信的原生通知一样。

此处引用微信 官方文档 (opens in a new tab) 的示意图
- 当小程序接听设备呼叫时,会直接拉起VOIP插件并覆盖原来的小程序界面。
- VOIP通话过程中,原小程序的UI层会不显示,只有逻辑层能运行。并且逻辑层只有app.js中的逻辑能运行
- VOIP插件的调试,只能小程序上线后才能调试。因为设备呼叫后,微信拉起的是线上版小程序。因此调试比较麻烦
- ImCamWxSDK已在VOIP插件初始化时配置了常用的参数。如果您仍需要自行更改参数,可参考微信的插件文档 (opens in a new tab)并通过SDK的接口getWmpfVoip()来获取VOIP对象
- SDK中已自动初始化VOIP,请勿自行再次初始化VOIP。
Xp2p插件
- 用于小程序端主动查看设备视频
- 不需要任何小程序端的权限,也不需要设备端License即可开始开发调试。只需要申请了Xp2p的两个插件即可
- 插件本身是由腾讯侧开发的组件,该组件是基于小程序原生组件【live-pusher】和【live-player】进行了二次封装
- ImCamWxSDK不会对该插件再进行第三次封装。SDK文档以及DEMO中,提供了我们的设备所需要用到的全部用法。因此请您详细查阅文档以及参考我们的DEMO来熟悉所有功能
- 除开文档和DEMO之外,Xp2p插件仍然有很多我们没有用到的功能。您可自行查看Xp2p的插件文档 (opens in a new tab)以及github的官方DEMO (opens in a new tab)来完善您的小程序
- Xp2p插件文档中封装了部分API,如获取SD卡录像列表,发送云台等。我们并没有用到该封装的API,而是自行定义了一套UserData指令。所以请您详细查阅完我们的文档,先用DEMO熟悉一遍功能。在这之后,若发现有功能缺失,再去查阅官方文档