发起通话成功后，微信后台会使用微信消息通道向用户推送通话提醒。要收到通话提醒，手机端需要满足下列条件：
在通话过程中，如果碰到「无法发起通话」，「通话发起后异常退出」，「接听方一接听就挂断」，「通话异常退出」等问题，可以参考本文进行排查。
一次通话有 「拨打方」（或「来电方」、「主叫」） 和 「接听方」（或「被叫」） 两个角色。通常，我们可以将一次硬件和微信小程序之间的 VoIP 通话分为 「发起」、「加入」、「等待」和「通话」 四个阶段。不同阶段可能会有不同类型的问题，在排查时，应首先根据表现确定是哪个阶段出现异常，在按照具体阶段的指引进行进一步分析。
建议使用插件 2.3.2 及以上版本。
发起阶段是指调用插件 initByCaller 接口或 Linux SDK wx_voip_session_call 创建 VoIP 房间的阶段。在此阶段中，微信后台会进行一系列通话前置的检查操作，包括但不限于：
校验通话后，微信后台会向接听方推送通话提醒。
在发起阶段如果失败，接口会返回 errCode，开发者可以根据插件文档的说明来排查问题原因，比较常见的错误有以下几类。
设备要和微信用户通话，必须先进行授权，具体过程请参考《用户授权设备》文档。
出现此错误，常见的有以下情况：
wx.requestDeviceVoIP 向用户请求过授权，或请求后用户拒接授权；在使用设备组的情况下，常见还有以下情况：
removeIotGroupDevice 接口移除;addIotGroupDevice (force_add=true) 强制转移到了另一设备组 B，也会导致设备从设备组 A 里移除。优化建议
建议使用授权状态查询 接口，判断用户和设备/设备组直接是否存在授权关系。
wx.getDeviceVoIPList 查询用户已授权设备的列表，判断设备已被授权再发起通话，否则应请求用户重新授权；getIotBindContactList 接口判断设备和用户间是否存在授权关系，存在时再发起通话，否则应提示用户重新授权；对于设备组，可以使用 getIotGroupInfo 查询设备组中的设备列表。
对于使用设备认证 SDK 注册的设备（此时 voipToken 传入 SDK 获取到的 deviceToken），常见有以下情况：
deviceToken 过期。deviceToken 是有一定有效期的，需要定时进行更新，如果获取时间过久会失效。voipToken 字段或传入空字符串。此方式仅适用于使用 WMPF registerMiniProgramDevice 接口注册的设备。对于使用 WMPF 注册的设备，可能有以下情况：
创建 VoIP 房间成功后，「拨打方」会直接加入该房间，界面上会显示「连接中…」。加入的时长一般与当前网络状态有关。
加入成功后，拨打方会触发 joinedRoomByCaller 事件。
大概率是安卓 WMPF 低版本的 bug，请升级到 >= 2.0 版本解决。如新版本仍发现类似问题，请参考第 8 节反馈。
这种情况下开发者可能会收到 joinFailCaller 事件，errMsg 包含 Already in room or joining，此时可以尝试重启 WMPF。
可能是网络状况较差导致加入过慢，此时通话可能会因接听方等待超时而结束，触发 abortVoip 和 endVoip 事件。
常见原因有：
forceHangUpVoip 接口挂断通话，触发 cancelVoip 事件和 endVoip 事件（Toast 提示 「通话已被微信小程序结束」）。
calling 事件，并判断 keepTime 来限制通话时长，不建议使用定时器。joinFailCaller 事件，可以通过 data 字段拿到 errMsg 和 message 来分析错误原因。建议使用 initByCaller 的 timeLimit 参数。插件低版本也可以根据 calling 事件的 keepTime 字段计算通话时长。超过限制后可以调用插件 forceHangUpVoip 中断通话。
不建议使用定时器实现此功能，容易出现一些异常情况导致定时器没有被清理的情况。导致影响后续通话。
插件提供了 setCustomBtnText 接口在手机端接听页面自定义按钮，开发者可配置一个自定义的弹层来实现具体功能。
C 端用户体验如下图所示：
用户可以在微信小程序设置页里取消授权，或通过在最近使用中删除微信小程序来清空授权记录。请参考「处理授权失效的情况」。
请参考「授权状态查询」。
开发者可以自行控制超时时间，超时后调用插件 forceHangUpVoip 接口中断通话。
超时后，开发者可以根据业务场景，选择自动拨打给其他用户，实现轮询呼叫的能力。例如 101 号房有 A、B、C 三位业主，打给 A 业主 30 秒未接听，可自动打给 B 业主，依此类推。
为强化设备通话的认知、保证用户体验统一，手机端用户授权设备名称、接听设备来电的名称需保持一致。
授权设备名称 = 来电方名称 = 开发者自定义名称 + 设备类型名称。如「艾玛的希沃网课学习机」。开发者需要考虑名称显示，对名称做好规范。
（案例示意：订阅设备名称、来电方名称、语音通话中设备名称）
VoIP 业务依赖于微信基础服务和微信小程序相关的业务内容，涉及比较多的 IP（在几千的量级）和域名，暂时未能提供完整的域名和 IP 列表，目前建议使用非定向的流量。
如有定向流量的需求，可在微信开放社区「硬件服务」板块发帖联系我们。
注意：IP 本身会随着业务的变更而增添或者裁撤，因而暂时没办法提供稳定的列表。
根据测算，语音通话大概是 2MB/分钟，视频是 10-30MB/分钟。
插件发起通话时可以设置 caller.cameraStatus 或 listener.cameraStatus，设置两端是否默认开启摄像头，参见 initByCaller 接口文档。
如果要禁止用户切换摄像头，可以用插件的 setUIConfig 设置 callerUI/listenerUI 的 enableToggleCamera 选项。
VOIP 插件 2.2.1 及以下版本，通话结束页显示的时间为本地定时器计算的时间，endVoip 事件的 keepTime 提供的也是这个时间。但是由于通话双方之间存在一定网络延迟，这里的时间可能与实际扣费时长并不一致（一般要多于实际扣费的时长）。
VOIP 插件 2.2.2 版本开始，会在通话结束后（即 endVoip 事件后）从后台获取实际扣费时长，并通过 finishVoip 事件的 keepTime 返回给开发者。通话结束页也会更新显示实际的扣费时长。
当设备端微信小程序只承载 VOIP 通话能力时，可能需要在通话结束后将微信小程序切后台或关闭。
微信小程序收到插件的 endVoIP 事件后，通过 WMPF 提供的通信通道(Invoke Channel)通知 App。
收到通知后，App 可以选择调用 closeWxaApp 将微信小程序切后台或关闭（可参考《性能与体验优化指南》的说明选择）。
在 WMPF 运行时，微信小程序能可以访问到 wmpf 这个全局变量。可以通过是否存在这个全局变量来判断：typeof wmpf !== 'undefined' 即为设备端。
注意：调用 wmpf 上的方法前，应提前判断 wmpf 这个全局变量是否存在，否则在手机微信端走到这段逻辑时会报错。
请参考《通话提醒异常排查指南》。
微信小程序 appId 未完成硬件设备接入导致。请确认：
wx.requestDeviceVoIP 报错 invalid scope微信小程序 appId 未完成硬件设备接入或接入后未申请「微信小程序音视频能力」设备能力导致。请确认微信小程序已在「微信小程序管理后台」完成硬件设备接入并申请通过微信小程序音视频能力。
wx.getEnterOptionsSync 或插件的 getPluginEnteroptions 无法获取到进入微信小程序的 query一般有以下几种情况：
wx.navigateTo 等路由方式跳转页面的情况，则需要在对应页面的 onLoad 生命周期获取。getPluginEnteroptions 获取 query；当微信小程序启动路径为微信小程序页面时，需要通过 wx.getEnterOptionsSync 获取 query。建议排查时同时打印返回值中的 path 字段，确认是否是预期的传入 query 的 path。
一般有以下几种情况：
initByCaller 时未设置 miniprogramState，或设置了 miniprogramState: formal，此时接听方会打开正式版微信小程序。而设备 VOIP 能力尚未发布正式版。initByCaller 时设置了 miniprogramState: trial，此时接听方会打开体验版微信小程序。而当前设置为体验版的微信小程序中并未支持设备 VOIP 能力。initByCaller 时设置了 miniprogramState: developer，此时接听方会打开开发版微信小程序。此时接听方需要提前扫码下载与拨打方相同的开发版微信小程序方可使用。一般有以下几种情况：
initByCaller 发起通话。可能是前置逻辑异常或未走到发起通话的分支。开发者应首先确定调用了该接口。initByCaller 失败，可能会抛出异常或者返回了非 0 的 errCode。开发者应正确地捕获和处理接口异常，并给用户必要的提示。这是因为你的设备类型是微信支付刷脸设备，目前这类设备不支持硬件 Voip 模式，需要重新申请设备类型。
可以使用 InitGlobalConfig 接口指定微信小程序使用的摄像头，也可以指定摄像头画面的旋转角度。
fun initGlobalConfig() {
val jsonConfig = JSONObject()
// 请注意：USB 摄像头和内置摄像头使用的参数名称是不一样的。
try {
// 案例 1：微信端画面颠倒
jsonConfig.put("cameraPushFlip", true) // USB 摄像头需使用 usbCameraPushFlip 参数
// 案例 2：使用内置摄像头，微信端显示画面旋转
jsonConfig.put("cameraRotationAngle", 90) // 根据实际情况调整角度
// 案例 3：通过指定 internalCameraName 使用设备内置摄像头（需 WMPF 2.0.0 支持）
jsonConfig.put("internalCameraName", "xxxx")
// 案例 4：通过指定 cameraId 使用设备内置摄像头
jsonConfig.put("cameraId", 0)
// 案例 5：通过直接指定摄像头设备路径使用 USB 摄像头（与案例 5 的情况二选一）
jsonConfig.put("usbCameraName", "/dev/xx/xx/xx")
// 案例 6：通过指定三元组使用 USB 摄像头（与案例 4 的情况二选一）
jsonConfig.put("usbCameraProductId", 0)
jsonConfig.put("usbCameraVendorId", 0)
jsonConfig.put("usbSerialNumber", "xxx")
// 案例 7：使用 USB 摄像头，WMPF 预览和微信端显示画面旋转
jsonConfig.put("usbCameraRotationAngle", 90) // 根据实际情况调整角度
val json = jsonConfig.toString()
LogUtils.d(TAG, "initGlobalConfig", json)
Api.initGlobalConfig(json)
.subscribe({
LogUtils.d(TAG, GsonUtils.toJson(it))
warmLaunch()
}, {
LogUtils.d(TAG, GsonUtils.toJson(it))
warmLaunch()
})
} catch (e: Exception) { }
}
如果设置摄像头画面旋转未生效，建议按照下列指引检查：
InitGlobalConfig 必须在 ActivateDevice 回调成功后、启动微信小程序前调用。建议在 ActivateDevice 的 onSuccess 回调后调用。InitGlobalConfig 设置是一次性的，在每次 WMPF 启动后都需要调用。usbCameraName，或 usbCameraProductId + usbCameraVendorId + usbSerialNumber 指定使用 USB 摄像头，需使用 usbCameraPushFlip 和 usbCameraRotationAngle 设置画面旋转internalCameraName 指定摄像头 cameraId。此时需使用 cameraPushFlip 和 cameraRotationAngle 设置画面旋转。此时只能设置微信客户端看到的推流画面的旋转，不能改变设备端看到的预览画面。