# 刷臉小程序?qū)ｍ?/h1> # 產(chǎn)品類
Q1. 小程序會員卡組件跳轉(zhuǎn)會員開卡，提示請從商戶?程序跳轉(zhuǎn)
青蛙小程序暫時不支持跳轉(zhuǎn)會員組件，待此組件更新后支持，但時間暫無法預(yù)估；
建議先使用小程序“請求手機號”的組件過渡。
Q2. 打開體驗版版的小程序都需要刷臉
體驗版需要校驗用戶身份，屬于小程序基礎(chǔ)限制。
Q3. 如何獲取手機付款碼？
Q4. 設(shè)備的sn如何發(fā)送到收銀端？
通過獲取系統(tǒng)信息checkWxFacePayOsInfo接口osSerialNumber參數(shù)獲取設(shè)備號。
Q5. 青蛙Pro前屏和背屏能否配置不同?程序？
可以是不同的小程序，也可以使用同一個小程序。
小程序可以被推送到青蛙的不同位置（背屏桌面，前屏常駐，刷臉會員等）;
推送的時候每個位置可以設(shè)置單獨的小程序appid,頁面 ;
推薦的方式是使用同一個小程序的不同頁面，前屏為主，前屏通過launchApp喚起后屏小程序。
Q6. 后屏小程序調(diào)用facePay收不到付款碼
運行在后屏的小程序不支持調(diào)用facepay。
Q7. 背屏能顯示的小程序
配置成刷臉會員的小程序；
前屏通過接口調(diào)起；
配置成背屏的小程序。
Q8. 背屏“點擊登錄”小程序的作用
2.12官方提供的通用能力，在背屏需要登錄的小程序，需要先點擊這個按鈕；
掃碼登錄一下，才可以使用需要登錄的小程序，僅針對背屏小程序。
Q9. 青蛙 pro 的前后屏是否必須運行兩個小程序？
沒有限制，服務(wù)商根據(jù)需求通過商戶平臺下發(fā)即可。
Q10. 青蛙設(shè)備提示“請與收銀員確認支付結(jié)果”
沒有收到支付返回結(jié)果，先檢查小程序有沒有收到付款碼，是否已經(jīng)支付成功。
Q11. 在服務(wù)商后臺容器里，錄入兩個前屏小程序（a 和 b），如何操作實現(xiàn)從 a 切換到 b？
重新添加小程序。
Q12. 青蛙 pro 可以小程序去調(diào)起打印嗎？
可以通過藍牙調(diào)起打印外設(shè)。
Q13. 在設(shè)備上調(diào)試小程序如何查看日志？
青蛙設(shè)備上點擊右上角，打開 vConsole。
Q14. 小程序如何監(jiān)聽外置掃碼槍？
外置掃碼槍無法監(jiān)聽，可以通過 input 方式獲取外置掃碼槍傳的值。
Q15. 小程序支持 mqtt 嗎？
支持。
Q16. 服務(wù)商平臺提示：設(shè)備號不在設(shè)備列表中。
- 京東或小程序購買的青蛙 pro，如何綁定到設(shè)備列表？
設(shè)備簽收后，次日可使用購買訂單，前往商戶平臺設(shè)備列表自助綁定。
操作指引：https://docs.qq.com/doc/DVnhkSURhVkFqQUhh - 商戶平臺申請的設(shè)備，如何綁定到設(shè)備列表？
若申請的設(shè)備類型是青蛙 pro，設(shè)備物流簽收后，次日會自動綁定；
若申請的設(shè)備類型是非青蛙 pro，設(shè)備物流簽收后，請在申請進度查詢；
手動點擊”確認收貨”，次日會自動綁定。
Q17. 青蛙 pro 屏幕提示：27138676 小程序權(quán)限校驗失敗。
體驗版小程序需要使用人員添加試用權(quán)限。
Q18. 青蛙 pro 屏幕提示：27138675 小程序包下載失敗。
先檢查網(wǎng)絡(luò)連接是否正常，確認網(wǎng)絡(luò)正常后重新下發(fā)小程序。
Q19. 如何將設(shè)備上的小程序下架？
通過商戶平臺下架的小程序。
Q20. 青蛙 pro 屏幕提示：271378673 小程序核心屬性拉去失敗。
檢查小程序下發(fā)信息，開發(fā)中請選擇體驗版小程序進行調(diào)試。
Q21. 設(shè)備上的小程序如何卸載？
無法卸載，可以通過商戶平臺在小程序投放記錄中下架設(shè)備。
Q22. 是否一定要先激活設(shè)備才能將小程序下發(fā)到青蛙設(shè)備上？
沒有強制要求，符合商戶平臺下發(fā)小程序的要求即可。
# 流程類
Q1. ?程序正式版提交審核注意點
小程序提交正式版審核時，建議這樣做，有助于過審：
在備注中清晰說明：此小程序哪個功能需要配合青蛙設(shè)備使用，無法在移動端體驗；
上傳在青蛙內(nèi)使用流程的視頻；
如果200字夠用，可再附上： 青蛙API 刷臉由青蛙原生實現(xiàn)，小程序只可獲得登錄權(quán)限和支付票據(jù)，不獲取生物特征信息。
Q2. 商戶平臺配置小程序多久生效？
正常情況下5~10分鐘后設(shè)備將會自動生效。
Q3. 小程序商戶平臺推送和使用
小程序最新配置已經(jīng)上線，可以滿足多種投放范圍：按設(shè)備類型/設(shè)備型號/商戶號（最多500個）/設(shè)備號（最多500個）；
服務(wù)商（普通服務(wù)商或渠道商）需要把設(shè)備綁定在自己商戶號名下，才能獲得配置權(quán)限；
配置小程序，必須使用移動應(yīng)用AppID綁定小程序，進行下發(fā)；
歷史數(shù)據(jù)，需要修改，建議下線重新配置；
調(diào)試小程序，建議使用設(shè)備號下發(fā)；
詳情請看【騰訊文檔】商戶平臺-青蛙APP小程序配置（服務(wù)商版）。
可參考：商戶平臺-青蛙APP小程序配置（服務(wù)商版）。
Q4. 商戶平臺智能硬件小程序頁面無法顯示內(nèi)容
現(xiàn)不支持通過鏈接直接打開小程序頁面，麻煩先登錄，然后，按照流程打開小程序頁面，具體使用流程，請看FAQ 流程.2小程序商戶平臺配置和使用；
瀏覽器兼容問題，更換chrome瀏覽器。
Q5. 商戶平臺登錄時安裝安全控件后不生效，頁面一直提示未安裝
可參考：微信支付商戶平臺登錄控件異常處理指引。
Q6. 小程序的審核
由于目前申請的商戶較多，還請按照流程操作；
注意點請查閱：FAQ->刷臉?程序?qū)ｍ?>流程類->Q1. ?程序正式版提交審核注意點。
Q7. 遇到特殊情況時小程序?qū)徍巳绾渭蛹保?/strong>
代碼提審頁面選擇加急提審，具體方式可參考：加急審核的“高速直達通道”。
Q8. ?蛙Pro版本?程序，如何調(diào)?打印設(shè)備？
請嘗試使用通用藍牙能力，調(diào)用藍牙外設(shè)。
主要流程：
- 打開設(shè)備藍牙開關(guān)（青蛙v2.13提供，可先在手機調(diào)試）；
- 在小程序上，基于小程序通用藍牙能力+打印機開發(fā)文檔，來連接打印機和調(diào)用打印命令。
附： 小程序通用藍牙能力
理論上可調(diào)用支持 BLE 藍牙傳輸協(xié)議的設(shè)備，已測試可行：
- 佳博（Gprinter）GP58MBIII
- 新品佳博（Gprinter）GP58MBIII
- 芯燁（XINYE） XP-58IIH
- 得力無線藍牙DL-581PW
- 資江58mm外賣打印機
Q9. 商戶平臺里面的小程序IOT配置，移動應(yīng)用AppID是什么？
開放平臺需要申請一個 移動應(yīng)用，作為小程序容器使用。
Q10. 商戶號和appid和hostappid是否必須一致？
小程序APPID、小程序容器APPID必須一致。服務(wù)商可以推送其他服務(wù)商的小程序到自己的設(shè)備上。
Q11. 小程序版本升級后，如何下發(fā)到設(shè)備中？
前屏正式版小程序會自動進行更新，后屏小程序需要重啟一下設(shè)備或切換一下登錄狀態(tài)才會更新。
Q12. 刷臉小程序如何實現(xiàn)獨立收銀？
默認不?持獨?收銀，需要開發(fā)?程序?qū)崿F(xiàn)。?程序接收付款碼，實現(xiàn)獨?收銀的能?。
# 軟件類
Q1. 如何監(jiān)聽外接小鍵盤？
青蛙Pro在2.14已支持外接鍵盤，具體調(diào)用方式請看軟件類：青蛙小程序 - 特殊API接口 | 微信刷臉支付。
Q2. 背屏登錄已失效，請重新登錄
背屏小程序登錄態(tài)是23小時，超過此時間就會彈出提示。
Q3. 前屏彈出提示操作超時是否退出？
前屏小程序登錄態(tài)有效期是4分鐘，超過此時間就會彈出提示。
Q4. 設(shè)備上如何調(diào)試小程序？
現(xiàn)有方式是，發(fā)布一個體驗版小程序，將其配置到青蛙上。注意，因為體驗版小程序需要校驗體驗者權(quán)限，所以必須以登錄狀態(tài)拉起。
PS：青蛙特殊API不支持電腦和手機調(diào)試模擬器調(diào)試，只支持在刷臉設(shè)備上調(diào)試，如在本機運行會報錯。
Q5. wxfaceapp.postMsg如何調(diào)試？
無法調(diào)試，只能?體驗版，開啟debuginfo查看。
Q6. 如何掃碼獲取手機付款碼？
Q7. 小程序的退出是否會影響刷臉？
退出時小程序會自動退出，過一會再次啟動，無狀態(tài)首屏小程序不會存在此問題。
Q8. 小程序支付成功后，能否不顯示刷臉支付的成功頁？
不能，支付成功頁是刷臉APP默認的。
建議：在微信默認成功頁展示的同時，就同步在小程序里展示了自己的結(jié)果頁，這樣，客戶不用等待加載，體驗更平滑。
Q9. quickpay的時間限制？
quickPay有4分鐘的時間限制，建議先調(diào)用ableToQuickPay進行判斷，再調(diào)用quickpay。
Q10. 提示：首屏小程序只允許登錄無登錄態(tài)的正式小程序。
開機自啟的常駐小程序，只能支持 “以[無登錄]狀態(tài)，打開[正式版]小程序”。
原因：
- 若要求先登錄再打開，則會死循環(huán)導(dǎo)致小程序無法“自啟”；
- 體驗版小程序依賴登錄態(tài)校驗體驗權(quán)限，所以開機自啟只能以無登錄狀態(tài)打開正式版。
若要登錄怎么辦？
- 在運行過程中可以調(diào)起登錄
建議：可先將小程序配置成會員小程序進行調(diào)試。
Q11. 背屏小程序無法調(diào)起刷臉支付
運行在背屏的小程序無法完成刷臉支付，建議：背屏小程序傳指令給前屏小程序，前屏調(diào)起刷臉支付。
Q12. 雙屏小程序如何調(diào)試？
目前最優(yōu)的調(diào)試辦法：
- 設(shè)置為體驗版，前屏的會員小程序；
- 會員小程序啟動后，通過api，啟動背屏小程序；
- 進行調(diào)試。
Q13. setStorage 保存成功，但是getStorage取不到數(shù)據(jù)
接口內(nèi)部保存了一個用戶的登錄id，所以如果在A登錄的情況下進行保存，會生成一個A的內(nèi)部Key。
PS：用戶A登錄了小程序，小程序調(diào)用setStorage保存信息。
用戶A退出小程序，用戶B登錄了這個小程序，小程序調(diào)用getStorage，
是無法獲取到剛才在A登錄狀態(tài)下的信息的，無登錄態(tài)下，沒有問題，因為這種情況下，使用的內(nèi)部Key是機器的id。
Q14. 前屏setStorage保存信息，后屏getStorage獲取不到數(shù)據(jù)或后屏setStorage，前屏獲取不到
2.20的版本中，小程序基礎(chǔ)接口做了改動，為了保證用戶數(shù)據(jù)安全，在不同的進程中，setStorage的存儲數(shù)據(jù)無法共享。 對應(yīng)到青蛙Pro中，前后屏分別是不同的進程，所以無法共享數(shù)據(jù)。
Q15. 小程序獲取用戶信息
wx.login(Object object) | 微信開放文檔
調(diào)?wx.login接口之前，必須先調(diào)?facelogin或者打開刷臉?付，完成刷臉。否則，?法獲取到登錄狀態(tài)。
Q16. wx.request能否設(shè)置端口？
小程序暫不支持端口訪問，但域名可以使用。
Q17. 背屏小程序能否常駐？
背屏小程序不能設(shè)置成常駐。
Q18. vConsole如何關(guān)閉？
詳情請參考：小程序正式版本如何關(guān)閉vconsole按鈕。
Q19. 271378673小程序核心屬性拉取失敗？
請檢查小程序下發(fā)信息，在后臺獲取小程序的信息時候，獲取失敗。
PS：開發(fā)版小程序，開放平臺暫不支持此模式，如開發(fā)中還請選擇體驗版小程序進行調(diào)試。
Q20. 為何通過 wxfaceapp.faceLogin 方法獲取用戶的 openid 和小程序正常獲取的 openid 不一致？
通過 wxfaceapp.faceLogin 獲取的是該用戶基于小程序 appid 的openid，刷臉小程序獲取的 openid 是基于商戶綁定的 appid。
Q21. wxfaceapp.faceLogin({enableMultiLogin:true,relaunchUrl:"pages/pay/pay?a=xxx&b=xxx&c=xxxx"})，relaunchUrl 參數(shù)可否這樣傳遞查詢字符串？
傳遞額外參數(shù)暫時不支持。
Q22. 青蛙小程序特殊 api 回調(diào)函數(shù)里面可以使用 setData 賦值嗎？
可以
Q23. 通過哪個接口可以獲取商戶號？
wx.getLaunchOptions 接口的 mchId 參數(shù)。
Q24. 青蛙小程序支持使用 webview 跳轉(zhuǎn)嗎？
可以
Q25. wxfaceapp.onFacePayFailedEvent、wxfaceapp.onQueryPaymentSucEvent、wxfaceapp.onQueryPaymentFailedEvent 這幾個監(jiān)聽開啟了需要關(guān)嗎？ 不關(guān)會不會導(dǎo)致小程序卡頓？
不需要關(guān)閉，不會影響。
Q26. wxfaceapp.faceLogin 這個 api 用了之后，會清除緩存嗎？
會的。
Q27. 青蛙 pro 有操作語音播報的 api 嗎？
沒有特殊接口，建議使用外部 TTS 服務(wù)，再調(diào)用小程序通用音頻播放能力。
Q28. facePay 刷臉支付頁面除了手動關(guān)閉，可以通過程序控制關(guān)閉嗎？
目前沒有對應(yīng)的控制接口。
Q29. 設(shè)備上調(diào)試小程序如何查看日志呢？
打開 vconsole。