IntroductionOverviewThis文檔主要介紹語音自檢功能
本文件主要介紹產品的語音自檢功能。
語音自檢係指測試裝置的喇叭與麥克風，又稱回音自檢。其運作原理為裝置透過喇叭播放聲音，並以麥克風擷取聲音，藉此判斷喇叭與麥克風是否正常運作。常用於遠端檢測設備音訊元件的運行狀態。以下章節將詳細說明工業裝置的語音自檢操作方式。
i12、i11、i16V、i18S、i20S、i30、i32V、i33V、i16SV、i10SV、PA3、PA2S。
裝置透過喇叭播放音訊（例如短片音檔），麥克風同步擷取聲音並計算接收比例。若數值高於臨界值，判定測試成功；若低於臨界值，則判定測試失敗。運作原理如下圖1所示：
圖1 語音自檢原理圖
語音自檢普遍用於設備遠端維護。為節省時間、提升檢測效率，當廣播音訊中斷或聲音突然停止時，管理人員可從控制室對設備執行遠端自檢。
圖2 語音自檢應用場景
① 對講系列設備（本文件以i12為範例）、PoE交換器（或直流電源）、Yunyi伺服器各一台，並將設備連接至交換器。
② 設定用電腦與伺服器各一台，將電腦接入同一台交換器，確保與設備網路互通。
① 將i12、伺服器、設定電腦皆連接至同一台交換器，確保網路連線正常。連接架構如下圖3所示。
圖3 設備與電腦連接圖
執行回音自檢有多種方式，以下分別詳細說明。
主動URI係由遠端控制台發送HTTP GET請求，設備內建HTTP伺服器解析指令並回覆，藉此實現設備遠端控制。
(1) 自檢指令格式：http://device_ip/cgi-bin/ConfigManApp.com?key=ECHO_TEST；
① device_ip：待測設備IP位址，範例：172.18.8.15；
② 回傳結果：喇叭與麥克風正常連線時顯示success；未連接或硬體損毀則顯示Failure；
(2) 操作範例：於瀏覽器輸入上述網址。音訊元件正常時會回傳success，如下圖4。
圖4 主動URI語音自檢示意圖
HTTP API為第三方系統整合使用的程式介面。設備做為HTTP伺服器，於http://ip/xmlservice提供服務。第三方程式做為用戶端，發送XML格式之HTTP POST請求。
HTTP API請求格式：
(1) 用戶端 → 伺服器請求：
（?xml version="1.0" encoding="UTF-8" ?）
（FanvilPhoneExecute beep=”yes” ）
（ExecuteItem>URI="cmd:echo_test"（/FanvilPhoneExecute）
cmd:audio_play：代表執行回音自檢指令；
(2) 伺服器 → 用戶端回覆：
（?xml version="1.0" encoding="UTF-8"?）
（FanvilPhoneExecute）
（ExecuteItem>URI="cmd:echo_test"）
（RetCode>0）
（info）
（![CDATA[success]]）
（/info）
（/FanvilPhoneExecute）
(3) 回傳結果：音訊正常為success；異常或損毀為Failure；
(4) 操作範例：可使用Postman、ApiPost等工具，發送POST請求至http://device_ip/xmlservice。填入正確XML內容後點擊“發送”，即可取得測試結果，如下圖5。
圖5 HTTP API語音自檢示意圖
可於時間排程設定中新增語音自檢任務。設備會依設定的時間週期或定時自動執行自檢，並透過動作網址回報結果。
(1) 登入設備網頁介面，依序進入“對講機設定” --- “時間排程” --- “排程規則”以新增排程，如下圖6：
① 執行類型：選擇“語音自檢”；
② 執行時間：選取自檢執行時段。
圖6 時間排程語音自檢示意圖
(2) 排程新增完成後，將顯示於時間排程清單。抵達排程時間時，設備會自動執行語音自檢。
SIP訊息方式適用公網環境。伺服器發送訊息型主動URI指令，設備以200 OK回覆MESSAGE請求，接著傳送結果回報訊息至平台，平台同樣以200 OK回覆確認。
(1) 於伺服器註冊設備帳號。
(2) 於Yunyi伺服器建立自檢任務：登入伺服器網頁，選擇“自檢任務” --- “新增”。
(3) 任務建立後選取並點擊執行。喇叭與麥克風正常連線則執行成功；若元件異常，伺服器會顯示異常狀態。亦可於後台點擊“自檢結果”查看詳細紀錄。
圖7 SIP訊息語音自檢示意圖
(4) 亦可透過設備封包擷取確認結果。自檢前進入設備網頁“系統” --- “輔助工具” --- “網路封包擷取”，點擊“開始”。
圖8 設備封包擷取示意圖
自檢完成後，於設備網頁點擊“停止”。使用Wireshark開啟封包檔，篩選「sip」欄位。若MESSAGE內容出現“Success”代表自檢成功；顯示“Fail”或“Failure”則為自檢失敗。
圖9 封包擷取結果示意圖
實際使用過程中，可能發生語音自檢失敗狀況，成因各異，可依下列項目逐一檢查：
(1) 檢查連線狀態
語音自檢失敗時，先確認喇叭與麥克風接線是否牢固。喇叭未接上通常會判定失敗；但若環境噪音過大，可能出現誤判為成功。麥克風未連接，必定會導致自檢失敗。
(2) 檢查周邊配件
接線正常卻持續失敗時，檢查喇叭、麥克風配件是否損毀。若硬體皆無異常，請聯繫技術支援。
(3) 確認環境安靜度
自檢原理為設備播放1 kHz音訊訊號，並由麥克風接收相同頻率訊號。若環境存在1 kHz雜音，會造成檢測失準。舉例：喇叭故障時，環境同頻雜音仍可能被設備偵測，誤判測試為成功。
