微信小程序音视频通话（for 硬件）

使用手册

1 产品介绍

1.1 基础介绍

借助微信小程序音视频通话（for 硬件）组件，开发者可以实现智能设备和手机微信端的一对一音视频通话，满足实时触达场景，提升通话体验。

下图为手机端示意图，授权弹窗、通话提醒、通话界面为微信提供的统一界面，硬件小程序接入微信VoIP通话插件后，可实现上述功能。

1.2 适用场景

微信小程序音视频通话（for 硬件）组件，适用于校园话机、门禁机、智能门锁、智慧中控屏、智能电视、智能摄像头、智能音箱、智慧养老等多种设备和场景，支持硬件设备和手机端双向通话，实现通话强提醒。

2 接入门槛

2.1 硬件要求

硬件不需要改造，需具备音频或者视频能力

•  安卓平台

（向下兼容技术研发中）

系统版本7.1 及以上

四核 2GHz CPU

内存 2GB RAM + 8GB ROM

• Linux平台及Rtos平台

（后续补充）

2.2 软件要求

- 小程序主体已认证；

- 小程序主体公司营业执照经营范围包括硬件设备销售等；

- 小程序具备“工具-设备管理”类目，并开通设备管理功能；

3 如何接入

3.1 接入前准备工作

注：以下3.1.2、3.1.3、3.1.4 注册工作可并行，该部分涉及审核工作，请提前准备，此部分预计耗时2～5个工作日

3.1.1 设备

需有1台满足接入条件的设备（确认设备的RPMB 分区没有被使用过，具有音视频能力)

3.1.2 微信开放平台

需有企业主体的微信开放平台帐号并成功绑定一款移动应用（手机端的App，未上架也可，提交审核时需要注意企业官网要有该App介绍），已有移动应用也可以直接用，注意需要获取 host appid 微信开放平台

（1）  注册开放平台账号

（2）  添加移动应用

（3）  获取移动应用id（移动应用id即hostAppid）

3.1.3 微信终端合作平台

需有一个企业主体的wecooper平台帐号 微信终端合作平台，并按照小程序硬件框架流程指引绑定3.1.2和3.1.4的账号，并注册设备、登记型号、获得公钥等；

（1）  微信终端合作平台账号注册

（2）  绑定开放平台的移动应用和小程序（图二中appid应填写hostAppid，即开放平台移动应用id，其获取见上方3.1.2.(3) )

（3）  登记硬件设备信息

a).添加设备类型

b).添加设备机型

c).设置公钥

（4）  硬件注册

通过【微信终端合作平台】-【申请注册设备】提审获取注册设备接口权限，请确认已完成登记设备信息再注册，否则审核可能不通过。

3.1.4微信小程序

需有企业主体的微信小程序帐号微信公众平台 ，并在小程序管理后台添加“工具-设备管理”类目、左侧“设备管理”添加你需要接入的设备并提交审核（注意需要获取model_id），申请设备的小程序音视频能力，能力申请无需审核（插件自动通过）；开发完成后，你需要验证设备能力，包括提交设备体验视频、以及邮寄设备给微信团队进行审核，审核通过后能力可正式发布。

（1）  注册小程序账号（若已有小程序，可忽略这步）

（2）  调用接口获取小程序的access_token

（3）  添加类目和设备

在小程序管理后台【设置】添加【工具-设备管理】类目

在小程序管理后台【功能】-【硬件设备】-【设备管理】添加设备并提审，获取model_id

（4）  申请和验证设备能力-小程序音视频能力

申请设备能力

在小程序管理后台【功能】-【硬件设备】-【设备管理】选择对应设备，点击申请设备能力，设备能力选择小程序音视频能力，填写具体的申请理由，提交申请。

验证设备能力

设备的小程序音视频能力申请通过后，点击验证能力

验证能力分为四步：下载配置SDK、下载硬件框架、视频验证、寄送设备验证

注：视频验证和寄送设备验证审核要求见硬件VoIP审核验证要求

1）下载配置SDK

2）下载硬件框架

3）视频验证

4）寄送设备验证

填写寄送信息

寄送信息验证中

寄送信息验证成功

（5）购买小程序音视频套餐包

每个小程序有1000分钟的免费时长可调用。你可以通过3.1.4(4)的指引点击验证设备能力(小程序音视频能力)后到达如下界面，点击【我的用量】查看免费额度、加购音视频套餐包。

3.2 开发流程

接入微信硬件VoIP，你需要在安卓硬件端、小程序端进行开发运行同一款微信小程序。微信将提供统一的SDK（插件），你的小程序需开通并调用该插件。此部分预计耗时5～10个工作日，具体接入流程请参考小程序音视频通话（for 硬件）开发文档

4 常见问题及反馈渠道

其他开发相关的功能介绍和常见问题请参考文档的【6. 常见问题（功能相关）】和【7. 常见问题（异常相关）】部分

4.1 接入VOIP 通话插件时，应选择哪种业务类型 (businessType)？

所有设备均可使用「手机微信拨打硬件设备」或「硬件设备拨打手机微信」。如针对校园场景的官方刷脸能力有特殊需求，可选择「校园场景支付刷脸模式」。

4.2 手机端通话结束后，结束页面有个『关闭』按钮，是否可以直接关闭小程序？

暂不支持，所有小程序的关闭都是需要点击右上角的「胶囊」关闭。但可以设置点击关闭按钮后跳转去小程序的其他页面。参考插件文档「4.2 自定义通话结束跳转页」

4.3 点击右上角胶囊有「退出设备登录」和「关闭小程序」的选项，可以去掉吗？

可以隐藏。具体可提供 hostAppId、小程序 appId 给行业经理开权限。

加完权限后安卓应用去调用 WMPF initGlobalConfig 接口，传closeButtonActionType: 10。设置完打开小程序，预期点击胶囊按钮的关闭，会弹出“不支持关闭小程序”。

4.4 每个设备都要注册吗？设备又是怎么激活的？

每个SN都是需要注册的，注册过程请参考硬件注册文档。注册完成胡，每次启动 WMPF 都需要在设备上调用 ActivateDevice 进行设备的激活，此时的签名建议从开发者后台获取。

4.5 设备端无摄像头或不希望传画面（设备无摄像头或者设备端比较敏感的场景）、手机端不希望传画面（门禁、门锁场景），应该怎样实现？

插件开发版已支持，可以控制caller or listener默认摄像头状态。

dev-14a5915d23dcc99512de366153791307

4.6 音视频通话的码流是多少？占用多少流量？

根据测算，语音通话大概是 2MB/分钟，视频是 10-30MB/分钟。

4.7 怎么找到音视频套餐包付费入口？

在小程序管理后台【功能】-【硬件设备】-【设备管理】选择对应设备，点击申请设备能力，设备能力选择【小程序音视频能力】，填写具体的申请理由，提交申请。申请会自动通过。点击验证能力，到达界面【验证小程序音视频能力】，点击【我的用量】。

4.8 设备的唯一性是怎么规定的？硬件开发者应该怎样配合？

我们要求硬件的emmc存储分区写入唯一key，且写入后不可更改，以保证设备的唯一性，从而保障通话安全。这样会要求：硬件开发者传给微信的设备sn不可变化，且硬件端运行的小程序只能为一个，不可更改。

如果遇到设备需要维修/售后的情况，强烈建议开发者不要随意更改设备sn，否则会影响用户通话权限。

其他未涉及问题，可通过硬件服务社区向我们反馈。

VoIP在技术接入、查看用量和支付过程中遇到报错，应该怎么办？

可以多试几次。如依然出现相关问题，可以留言以下信息供我们定位：

- 问题描述：

- 小程序appid：

- 小程序名称：

- 小程序主体：

- 报错时间：

- 报错界面截图：