(一)小程序音视频通话(for 硬件)
借助微信小程序音视频通话(for 硬件)能力,硬件开发者可以通过小程序硬件框架(WMPF),实现智能设备和手机微信端的一对一音视频通话,满足实时触达场景,提升通话体验。
-
设备要求
目前支持安卓系统、Linux 系统、RTOS 系统的设备。每台设备只能绑定一个小程序,只能和一个小程序进行通话。
(二)开发前准备
1 【仅安卓直连设备】接入微信硬件平台
注册微信终端合作平台和微信开放平台账号、登记设备信息等环节均涉及平台审核,请提早准备
具体参考文档指引 ,我们就不多说了
2 设备接入和申请设备能力
此环节涉及平台审核,请提早准备。
小程序想要使用音视频通话能力能力,需要在小程序管理平台申请开通「小程序音视频能力」设备能力。 具体参考文档指引
3 配置微信小程序后台
在初始化 音视频SDK 前,需要在 微信公众平台 中进行如下配置:
- 服务器域名配置:在“小程序后台 > 开发管理 > 开发设置 > 服务器域名”中,按照协议分类,将即构 Server 地址、LogUrl、以及用户业务需要用到的地址填到指定的“request合法域名”或“socket合法域名”中。
- 相关功能开启:在“小程序后台 > 开发管理 > 接口设置 > 接口权限”中,打开 双人音视频对话 。
4 接入 VOIP 插件
小程序音视频通话的主要功能通过「VOIP 通话」这一小程序插件(appId: wxf830863afde621eb)提供。
在小程序管理后台完成「小程序音视频能力」申请并通过后,小程序可以直接使用 VOIP 通话插件,无需额外申请。
如果开发者想要提前进行调试,可以手动进行申请:登录「小程序管理后台」——「设置」——「第三方设置」——「插件管理」,点击「添加插件」,搜索并添加「VOIP 通话」插件。
(三)设备端开发
我这里主要讲前端的小程序开发,设备硬件开发准备请看去官方文档。
(四)小程序开发
开发者需要开发(或使用现有)小程序,接入「VOIP 通话」插件,实现拨打和接听音视频通话的能力。
- 与安卓设备通话时,开发者需要使用同一个小程序,既运行在安卓设备端(设备发起或接听通话),也运行在手机端微信客户端(手机用户发起或接听通话)。
- 与 Linux 设备通话时,设备端运行「小程序音视频通话 SDK (Linux)」,手机端微信客户端内运行小程序(手机用户发起或接听通话)。
- 与 RTOS 设备通话时,设备端的 SDK 用于发起呼叫,服务端的 SDK 用于通过过程中的视频流转,手机端微信客户端内运行小程序(手机用户发起或接听通话)。
1 核心流程
至少使用微信客户端 8.0.30 及以上版本,建议使用当前最新版本。
小程序开发主要有以下环节,请参考各环节的文档:
- 接入「VOIP 通话」插件:参考开发前准备的接入 VOIP 插件在小程序中引入插件;
- 设备呼叫手机微信:
- 需要用户在手机微信端先对设备进行授权,请参考 《用户授权》;
- 适用于已注册并且用户授权过的设备发起通话,用户在手机微信内接听,请参考《设备呼叫手机微信》;
- 手机微信呼叫设备:适用于用户在手机微信内发起通话,已注册并且用户授权过的设备接听,请参考《手机微信呼叫设备(安卓)》和《手机微信呼叫设备(Linux)》;
- 性能与体验优化:请参考《性能与体验优化》。
(五)调试说明
VoIP 通话流程暂不支持在微信开发者工具进行调试,请使用真机进行
(六) 服务端开发
详见文档 服务端开发
(七) 常见问题
详见文档 《常见问题(FAQ)》