# callWMPF(Object req)

本接口为异步接口，返回 Promise 对象。

需插件 2.4.0 版本开始支持

从手机客户端的小程序呼叫运行安卓 WMPF 的设备。调用此接口后，会创建 VoIP 房间，并且向设备推送 WMPF pushMsg 提醒。详情参考《手机微信呼叫设备(安卓)》。

本接口只能在微信客户端内使用，不可在 WMPF 内使用。建议先阅读接口介绍。

# 参数

# Object req

属性	类型	默认值	必填	说明	最低版本
roomType	string		是	通话类型。voice: 音频通话；video: 视频通话
sn	string		是	接听方设备 SN
modelId	string		是	接听方设备 modelId
pushToken	string		是	从设备获取的 pushToken
nickName	string		是	设备端显示的微信用户名称
deviceName	string		否	微信端显示的设备名称	2.4.1
chargeType	string	'license'	否	计费方式。duration: 时长计费；license：license 计费
timeLimit	number		否	最大通话时长，需为 > 0 的数字
enableCallerCamera	boolean	true	否	拨打方是否启用摄像头。
enableListenerCamera	boolean	true	否	接听方是否启用摄像头。
envVersion	string	'release'	否	接听方打开的小程序类型。取值：release: 正式版; trial: 体验版; develop: 开发版。正式版小程序只能拨打给正式版，设置这一字段无效。
customQuery	string		否	接听方打开小程序时，会作为 query 拼接到插件页面路径后，格式如 `a=1&b=2`。可在接听端小程序内通过 `getPluginOnloadOptions` 或 `getPluginEnterOptions` 接口获取到

# 返回值

本接口调用失败会抛出异常。

# Object

接口调用成功时，返回如下：

属性	类型	说明	最低版本
roomId	string	本次通话的房间号

# 示例代码

const wmpfVoip = requirePlugin('wmpf-voip').default

try {
  const { roomId } = await wmpfVoip.callWMPF({
    roomType: 'video',
    sn: '设备 SN',
    modelId: '设备 modelId',
    nickName: '设备端显示的微信用户名称',
    pushToken: 'xxxx*****xxxx',
  })

  if (/* 当前不在插件页面 */) {
    wx.redirectTo({
      url: wmpfVoip.CALL_PAGE_PATH,
    })
  }
} catch (e) {
  console.error('callWMPF failed:', e)
  wx.showToast({
    title: '呼叫失败',
    icon: 'error',
  })
}