音視頻通話（for 硬件）
小程序音視頻通話（for 硬件）
接(jie)入流程(cheng)和常見(jian)問題也可參(can)考微信小程(cheng)序音視頻通話(hua)（for 硬(ying)件(jian)） 使用手(shou)冊(ce)
1. 產品介紹
借助微信(xin)小程(cheng)序音視頻通(tong)話（for 硬(ying)(ying)件）能(neng)力，硬(ying)(ying)件開發者可以通(tong)過(guo)小程(cheng)序硬(ying)(ying)件框架(WMPF)，實現智能(neng)設備和手(shou)機微信(xin)端的一對(dui)一音視頻通(tong)話，滿足(zu)實時觸(chu)達場景(jing)，提升(sheng)通(tong)話體(ti)驗。
下圖(tu)為(wei)(wei)手機(ji)端的示意圖(tu)，授權彈窗、通(tong)話提(ti)醒、通(tong)話界(jie)面(mian)為(wei)(wei)微信提(ti)供的統一界(jie)面(mian)，硬件小程(cheng)序接(jie)入微信 VOIP 通(tong)話插件后，可實現(xian)上述(shu)功能。
適(shi)用于校園話機(ji)、門禁機(ji)、智(zhi)(zhi)能門鎖、智(zhi)(zhi)慧中控屏、智(zhi)(zhi)能電視(shi)、智(zhi)(zhi)能攝像頭、智(zhi)(zhi)能音箱、智(zhi)(zhi)慧養(yang)老(lao)等(deng)多種設備和(he)場景，支持(chi)硬件設備和(he)手機(ji)端雙向通話，實現(xian)通話強提醒。
2. 設備要求
目前支持安卓系統(tong)、Linux 系統(tong)、RTOS 系統(tong)的設(she)備。每臺(tai)設(she)備只能綁定(ding)一(yi)個小(xiao)程序，只能和一(yi)個小(xiao)程序進行(xing)通話。
目前支(zhi)持 「設備直連」和「云對云」 兩種接入(ru)模式：
2.1 設備直連（安卓）
安卓系統(tong)設備端運行(xing)(xing)小程序硬件框(kuang)架(WMPF)，WMPF 內運行(xing)(xing)開發者小程序，直(zhi)接與用戶(hu)手機(ji)微信內的(de)小程序進行(xing)(xing)通話；
設備應滿(man)足下列基本(ben)要求：
建議使用(yong)小程序(xu)硬件框架(jia) v2.1.0 及以上版本。 2.2 設備直連(lian)（Linux）
Linux 系統設備端調用 小(xiao)程序音視頻通話 SDK (Linux)，直接與用戶(hu)手機微(wei)信(xin)內的小(xiao)程序進行通話。
設備應滿足下列基(ji)本要求(qiu)：
2.3 云對云
目(mu)前支(zhi)持部分低功耗 Linux、RTOS 等(deng)系統的(de)設備(bei)。設備(bei)端進行(xing)設備(bei)驗證，經(jing)由開(kai)發者后臺中轉(zhuan)，與用戶手(shou)機微信(xin)內的(de)小程序進行(xing)通話。
設備應滿足下(xia)列基本要求：
3. 開發前準備
以下(xia)幾(ji)個環節可(ke)以同時進行，涉及到多(duo)個平(ping)臺側的審核流程，請提前預留時間。
3.1 【僅安卓直連設備】接入微信硬(ying)件(jian)平臺
注(zhu)冊(ce)微信終端合作平(ping)(ping)臺和微信開放平(ping)(ping)臺賬號、登記設備(bei)信息等環節均涉及平(ping)(ping)臺審(shen)核，請提早準備(bei)。
參考(kao)文(wen)檔指引，完成「微信終端合作平(ping)臺 (wecooper)」企業主體賬號注(zhu)冊(ce)、移(yi)動應用綁定和硬件(jian)注(zhu)冊(ce)的(de)流(liu)程。
本步(bu)驟主要(yao)是將設備(bei)(bei)接入微信的設備(bei)(bei)體系，完成設備(bei)(bei)與 APP，以及 APP 與小程序之間的關聯。
3.2 設備接入和申請設備能力
此環節涉及(ji)平臺審核，請(qing)提早準備(bei)。
小(xiao)(xiao)程(cheng)序想要(yao)使(shi)用音視頻通話能(neng)力(li)能(neng)力(li)，需要(yao)在(zai)小(xiao)(xiao)程(cheng)序管(guan)理(li)平(ping)臺申請開通「小(xiao)(xiao)程(cheng)序音視頻能(neng)力(li)」設備能(neng)力(li)。詳見「設備接入(ru)」文檔和微信小(xiao)(xiao)程(cheng)序音視頻通話（for 硬件） 使(shi)用手冊中的流(liu)程(cheng)指引，并(bing)關注《硬件 VoIP 審核驗證要(yao)求》。
完成(cheng)接入(ru)后(hou)，開(kai)發者可獲得由平臺(tai)分配的(de) model_id。model_id 對應一(yi)種設備(bei)類型，是調用小程序(xu)設備(bei)能力相關接口的(de)重要憑(ping)證。
獲取(qu) model_id 后，開發者可以調用獲取(qu)設(she)備票據接口獲取(qu) snTicket，用于后續(xu)的設(she)備驗證流程。
3.3 接(jie)入 VOIP 插件(jian)
小(xiao)程(cheng)(cheng)序(xu)音視頻(pin)通(tong)話的(de)主要功能通(tong)過(guo)「VOIP 通(tong)話」這(zhe)一小(xiao)程(cheng)(cheng)序(xu)插件（appId: wxf830863afde621eb）提供(gong)。
在小程序(xu)(xu)(xu)管理后臺完成「小程序(xu)(xu)(xu)音視(shi)頻能力」申(shen)請(qing)(qing)并通過后，小程序(xu)(xu)(xu)可(ke)以直接使(shi)用 VOIP 通話插(cha)件，無需額外申(shen)請(qing)(qing)。
如果開(kai)發(fa)者想要提前進行調(diao)試，可以(yi)手動進行申(shen)請：登錄「小程序(xu)管(guan)理后臺」——「設置(zhi)」——「第三(san)方設置(zhi)」——「插(cha)件管(guan)理」，點(dian)擊「添加(jia)插(cha)件」，搜(sou)索并添加(jia)「VOIP 通(tong)話(hua)」插(cha)件。
4. 設(she)備(bei)端(duan)開(kai)發 5. 小(xiao)程序開(kai)發
開(kai)發(fa)者需要開(kai)發(fa)（或使用現有）小程序，接入「VOIP 通話」插件，實現撥打和接聽音視頻通話的能力。
5.1 核心流程
至少使(shi)用微信客戶端(duan) 8.0.30 及以上版(ban)本(ben)，建(jian)議使(shi)用當前最新版(ban)本(ben)。
小程序開發主(zhu)要有以下(xia)環(huan)節(jie)，請參考各環(huan)節(jie)的(de)文檔：
接入「VOIP 通話(hua)」插件：參考插件文檔(dang)在(zai)小程序中引入插件； 設(she)(she)備呼(hu)叫(jiao)(jiao)(jiao)手(shou)機(ji)(ji)微信(xin)(xin)(xin)： 手(shou)機(ji)(ji)微信(xin)(xin)(xin)呼(hu)叫(jiao)(jiao)(jiao)設(she)(she)備：適(shi)用于(yu)用戶在(zai)手(shou)機(ji)(ji)微信(xin)(xin)(xin)內(nei)發起通話(hua)，已注冊并且用戶授權過的設(she)(she)備接聽，請參考《手(shou)機(ji)(ji)微信(xin)(xin)(xin)呼(hu)叫(jiao)(jiao)(jiao)設(she)(she)備(安卓)》和《手(shou)機(ji)(ji)微信(xin)(xin)(xin)呼(hu)叫(jiao)(jiao)(jiao)設(she)(she)備(Linux)》； 性能與(yu)體驗(yan)優化：請參考《性能與(yu)體驗(yan)優化》。
通(tong)話(hua)相關異常，請參(can)考(kao)《通(tong)話(hua)異常排查(cha)指南(nan)》
5.2 調試說明
VoIP 通話流程暫(zan)不支持在(zai)微信開發者工具進行調(diao)試，請使用真機進行。
5.2.1 設備端使用「開發版/體驗版小程序(xu)」
安(an)卓設備端可(ke)指定使用「開發版(ban)/體(ti)驗(yan)版(ban)小程序」進行(xing)調(diao)試。請參考《開發設備端應(ying)用（安(an)卓）》「3.2 運行(xing)開發版(ban)/體(ti)驗(yan)版(ban)小程序」。
5.2.2 使用(yong)開發版/體驗(yan)版小程序接(jie)聽通(tong)話
接聽方收(shou)到消息(xi)推送點(dian)擊接聽后，默認打開(kai)的(de)是正式版的(de)小(xiao)程序。
在(zai)開(kai)發階段(duan)，建議在(zai)調用 wmpfVoip.initByCaller 時額外(wai)傳入 miniprogramState 參(can)數(shu)指定打開(kai)開(kai)發版/體驗版小程(cheng)序。
const result = await wmpfVoip.initByCaller({
// 其他參數省(sheng)略
miniprogramState: 'developer', // formal/正式版（默認）；trial/體驗版；developer/開發(fa)版
})
使(shi)用小程序音視(shi)頻通(tong)話 SDK (Linux)時，可以在(zai)初始化時設置 wxa_flavor 指(zhi)定使(shi)用開(kai)發版(ban)/體驗(yan)版(ban)接聽(ting)通(tong)話。
注意：
6. 服務端開發
RTOS 設備(bei)使用云對云方案時，需(xu)要進行服(fu)務(wu)端開發。設備(bei)直連(Linux、Android) 無需(xu)服(fu)務(wu)端開發。
7. 常見問題
請參考 《常見問題(ti)（FAQ）》
