設(shè)備內(nèi)的短音頻及其應(yīng)用

時間：2024-04-02

編輯：

簡介

本文目的是介紹設(shè)備內(nèi)短音頻的管理和使用方法，與短音頻有關(guān)的事件使用。最后介紹使用HTTP API觸發(fā)短音頻本地播放的實例。

適用設(shè)備

SIP2703x等型號V6以上固件版本

1 前言

短音頻(audio clips)是存儲在設(shè)備內(nèi)部的音頻文件（MP3/WAV格式），可以通過Manager應(yīng)用程序，網(wǎng)頁(HTTP)等方式上傳到設(shè)備，通過事件觸發(fā)。觸發(fā)后在本地揚聲器播放，也可以向網(wǎng)絡(luò)廣播音頻流。

觸發(fā)事件包括：

• HTTP命令

• SIP會話接通

• SIP會話中的dtmf鍵值（RFC2833,SIPINFO）

• GPIO(通用輸入輸出口)

短音頻經(jīng)常用在重復(fù)性的音頻告警，警示，提示應(yīng)用。

本文目的是介紹設(shè)備內(nèi)短音頻的使用和管理的方法，與短音頻有關(guān)的事件使用。最后介紹使用HTTP API觸發(fā)短音頻本地播放的實例。

相關(guān)文檔

《使用Manager應(yīng)用程序發(fā)現(xiàn)和配置設(shè)備參數(shù)》

《使用SIP呼叫和DTMF觸發(fā)短音頻文件播放》

《使用設(shè)備的GPIO觸發(fā)短音頻文件播放》

2 名詞

HTTP:超文本傳輸協(xié)議，瀏覽器使用此協(xié)議訪問web服務(wù)。

SIP（Session initialization Protocol）:會話初始協(xié)議，用于創(chuàng)建，修改和結(jié)束會話。

DTMF:傳統(tǒng)電話的雙音頻信號，在本文中指在SIP會話中發(fā)出的按鍵信息,使用SIPINFO/RFC2833協(xié)議。

GPIO:通用輸入輸出，通常指模塊上的引腳或設(shè)備上的輸入/輸出端點。

CLIP：短音頻，指存儲在設(shè)備內(nèi)部的音頻文件，推薦使用mp3格式。

x-lite：一種軟電話軟件。

minisipserver：一種sip服務(wù)器軟件(https://www.myvoipapp.com)

Manager：我司開發(fā)的windows設(shè)備發(fā)現(xiàn)和配置應(yīng)用程序(www.jshgolf.com)

chrome：谷歌瀏覽器。

3 短音頻

設(shè)備可以存儲多個短音頻（存儲數(shù)量由內(nèi)部存儲容量決定，從幾MByte~幾百Mbyte不等，由設(shè)備型號決定）

部分設(shè)備（例如SIP2xxx型號）內(nèi)所能存儲的短音頻文件數(shù)量是需要設(shè)置的，受存儲容量限制，調(diào)整文件數(shù)量同時會改變短音頻的最大文件長度。

警告：調(diào)整文件數(shù)量會格式化內(nèi)部存儲器，會導(dǎo)致所有的短音頻損壞，需要重新上傳。

以下操作使用chrome瀏覽器訪問設(shè)備web服務(wù)。在這之前，請先設(shè)置好設(shè)備的IP地址，以使設(shè)備可以正常網(wǎng)絡(luò)通訊。請參考《使用Manager應(yīng)用程序發(fā)現(xiàn)和配置設(shè)備參數(shù)》了解相關(guān)操作。

3.1 設(shè)置短音頻數(shù)量

在chrome地址欄輸入設(shè)備ip地址，打開“more/Audio Clip”頁。

修改Max capacities為所需的數(shù)量，點擊“Set”完成設(shè)置。

提示：

建議使用mp3文件，對于128kbps比特流的mp3文件，1Mbyte大約能播放1分鐘。如果是64kbps文件，大概能播放2分鐘。使用者需要根據(jù)自己的需求調(diào)整文件數(shù)量和大小。

注：有些設(shè)備的存儲容量比較大，則不需要設(shè)置此項。

3.2上傳

將音頻文件上傳到設(shè)備。

在audio clip頁面，點擊add clip按鈕，在彈出的文件打開對話框選擇音頻文件，支持mp3和wav文件（建議使用mp3文件）

上傳后的短音頻，系統(tǒng)自動給一個從1開始的ID號，后續(xù)使用短音頻，使用此ID。

提示

如果上次的文件超過max size，文件被截斷，超過部分不會保存。

wav文件僅支持單/雙聲道，pcm編碼，16bits數(shù)據(jù)的文件類型。

3.3更新

用新的短音頻文件覆蓋原來的文件。

在3.2小節(jié)界面，點擊clip條目后面的更新按鈕，在彈出的文件打開對話框選擇新的音頻文件。

3.4刪除

刪除不需要的短音頻文件

在3.2小節(jié)界面，點擊clip條目后面的刪除按鈕，進行刪除。

3.5測試

測試設(shè)備內(nèi)的短音頻是否可正常使用，通過下載到電腦和設(shè)備播放的方式測試。

3.5.1在電腦上播放

在3.2小節(jié)界面，點擊clip條目前面的，瀏覽器下載音頻文件并在電腦端播放。

3.5.2在設(shè)備端播放

在3.2小節(jié)界面，點擊clip條目后面的，可將鏈接地址復(fù)制到粘貼板。然后打開瀏覽器新頁面，在地址欄選擇粘貼，將剛才的鏈接地址輸入到地址欄，Enter確認。正常設(shè)備回應(yīng){“result”:200}并在設(shè)備端播放音頻文件。如果回應(yīng)不是200，可能設(shè)備正在忙，無法播放短音頻。

如下圖示例：

4 事件

事件通常與短音頻關(guān)聯(lián)，當(dāng)事件發(fā)生后，就會播放指定的短音頻。

4.1設(shè)備支持的事件

類別	值	active	說明
dtmf	dtmf值串	clip play and hang up	[注1]
dtmf	dtmf值串	clip play and talk	[注2]
status change	Answer	clip play and hang up	[注3]
status change	Answer	clip play and talk	[注4]
http request		clip play	播放clip[注5]
http request		clip stop	停止clip
gpio		clip play/stop	[注6]

注1：會話接通后，遠端向設(shè)備發(fā)送dtmf串值。設(shè)備收到指定的dtmf串后，播放指定的clip，播放結(jié)束后掛機。

注2：觸發(fā)事件后播放clip，播放結(jié)束后繼續(xù)通話。

注3：Answer事件為會話接通事件，會話接通后立即觸發(fā)。文件播放結(jié)束后自動掛機。

注4：會話接通后立即觸發(fā)事件，播放結(jié)束會繼續(xù)通話。

注5：http request僅生成一個http請求鏈接，需要在瀏覽器使用這個鏈接才能觸發(fā)事件。

注6：gpio對應(yīng)模塊的C1/C2引腳，需要通過Manager配置，詳細請參考相關(guān)文檔說明。

4.2事件動作參數(shù)

參數(shù)	說明
clip	與事件相關(guān)的短音頻的ID號
volume	本地播放音量，0~100
repeat	重復(fù)播放次數(shù)
then session over	播放clip時，發(fā)生觸發(fā)條件變?yōu)闊o效，如何影響播放。continue繼續(xù)播放。stop立即結(jié)束播放。對于dtmf和answer，會話結(jié)束表示觸發(fā)條件無效。對于IN類型， IN輸入變?yōu)闊o效狀態(tài)表示觸發(fā)條件無效。

4.3向設(shè)備添加事件

在瀏覽器的Events頁面，點擊“Add event”

彈出編輯窗口，編輯event的各項參數(shù)，如下圖。

添加動作完成后，需要點擊save按鈕保存才是生效。

5 示例

5.1通過HTTP API觸發(fā)短音頻

此示例以SIP2703V+SIP2703Demo板為例，演示如何通過HTTP API觸發(fā)短音頻在本地播放。

5.1.1 準備

系統(tǒng)圖

材料

·SIP2703V模塊

·SIP2703DEMO板

·喇叭（4~8歐姆）

·測試用計算機

·網(wǎng)線

·DC12~24@1A電源，用于Demo板供電。

準備

SIP2703V模塊接到DEMO板上，給DEMO板通電，

用網(wǎng)線連接計算機與DEMO板

參考《使用Manager應(yīng)用程序發(fā)現(xiàn)和配置設(shè)備參數(shù)》使用Manager工具發(fā)現(xiàn)和配置SIP2703V的網(wǎng)絡(luò)參數(shù)，使SIP2703V可被訪問（通常使用控制臺的“ping ip地址”命令測試）。

此例中，

計算機的IP地址為192.168.3.199/255.255.255.0

SIP2703V IP地址為192.168.3.11/255.255.255.0

DEMO板有2 x 15W功放輸出，可直接驅(qū)動4歐姆揚聲器。

5.1.2 上傳短音頻

參考第三節(jié)，將一個或數(shù)個短音頻，通過瀏覽器上傳到設(shè)備。

打開瀏覽器，在地址欄輸入192.168.3.11，瀏覽器彈出登錄窗口，輸入設(shè)備的賬號密碼（默認空密碼，直接點“Sign in”登錄）

登錄成功后，進入More/AudioClip頁面，這里先設(shè)置短音頻的存儲模式，將Max capacity 設(shè)置為12，表示最多存放12組短音頻。Max size是只讀項，顯示1024K，表示最大的短音頻是1024K字節(jié)。

注意：在后續(xù)的上傳文件中，注意文件長度不要超過1024K，否則將會被截斷。

接下來點擊Add clip按鈕，在彈出的打開文件窗口選擇需要上傳的音頻文件（mp3/wav文件）上傳短音頻。如果上傳成功，顯示information窗口

5.1.3 測試

點擊clip列表的圖標，瀏覽器生成一個鏈接并復(fù)制到粘貼板。內(nèi)容

http://192.168.3.11/clip/clip.cgi?action=play&id=1&volume=90&repeat=1

打開瀏覽器新頁面，地址欄為輸入焦點，ctrl+v，將鏈接粘貼到新的頁面，回車執(zhí)行。

如果SIP2703V設(shè)置賬號保護，會彈出窗口

需要在此輸入設(shè)備的賬號信息，點擊登錄。

則在揚聲器播放剛才上傳的音樂文件。

5.2會話中，通過dtmf觸發(fā)播放短音頻

5.2.1準備工作

需要被測試的網(wǎng)絡(luò)音頻設(shè)備和一臺windows操作系統(tǒng)計算機，一臺網(wǎng)絡(luò)交換機，網(wǎng)線若干。

準備好后，設(shè)備上電，接入計算機網(wǎng)絡(luò)，確保計算機與設(shè)備處于同一局域網(wǎng)。

啟動計算機的命令窗口（WIN+R彈出的窗口輸入cmd），

在命令提示符窗口輸入“ipconfig /all”

找到計算機使用的IPv4地址和子網(wǎng)掩碼（上圖的192.168.3.199和255.255.255.0）

在計算機上運行Manager，發(fā)現(xiàn)設(shè)備。

雙擊設(shè)備條目，在彈出的窗口進入基本參數(shù)（base parameter）頁修改設(shè)備的IP地址和子網(wǎng)掩碼，分配一個未被使用的IP地址。并使之與計算機同一網(wǎng)絡(luò)（這里修改為192.168.3.21/255.255.255.0）。如果設(shè)備有密碼保護，在修改參數(shù)時需要提供賬號密碼（默認為admin:1234或空賬號密碼）

留意http port參數(shù)，默認80。如果不是80，在后續(xù)使用瀏覽器訪問設(shè)備時需要額外提供端口號（假設(shè)端口號為8080，則瀏覽器的地址是“http://192.168.3.21:8080”）。