簡(jiǎn)介

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

適用設(shè)備

SIP2703x等型號(hào)V6以上固件版本

 

1  前言

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

觸發(fā)事件包括：

• HTTP命令

• SIP會(huì)話接通

• SIP會(huì)話中的dtmf鍵值（RFC2833,SIPINFO）

• GPIO(通用輸入輸出口)

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

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

相關(guān)文檔

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

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

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

 

2 名詞

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

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

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

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

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

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

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

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

chrome：谷歌瀏覽器。

 

3 短音頻

設(shè)備可以存儲(chǔ)多個(gè)短音頻（存儲(chǔ)數(shù)量由內(nèi)部存儲(chǔ)容量決定，從幾MByte~幾百M(fèi)byte不等，由設(shè)備型號(hào)決定）

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

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

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

 

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

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

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

 

        

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

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

 

3.2上傳

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

在audio clip頁(yè)面，點(diǎn)擊add clip按鈕，在彈出的文件打開(kāi)對(duì)話框選擇音頻文件，支持mp3和wav文件（建議使用mp3文件）

上傳后的短音頻，系統(tǒng)自動(dòng)給一個(gè)從1開(kāi)始的ID號(hào)，后續(xù)使用短音頻，使用此ID。

 

 

提示 如果上次的文件超過(guò)max size，文件被截?cái)?，超過(guò)部分不會(huì)保存。 wav文件僅支持單/雙聲道，pcm編碼，16bits數(shù)據(jù)的文件類型。

        

 

3.3更新

用新的短音頻文件覆蓋原來(lái)的文件。

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

 

3.4刪除

刪除不需要的短音頻文件

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

 

3.5測(cè)試

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

3.5.1在電腦上播放

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

3.5.2在設(shè)備端播放

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

如下圖示例：

 

 

4 事件

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

 

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

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

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

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

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

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

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

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

4.2事件動(dòng)作參數(shù)

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

 

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

在瀏覽器的Events頁(yè)面，點(diǎn)擊“Add event”

 

 

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

 

 

添加動(dòng)作完成后，需要點(diǎn)擊save按鈕保存才是生效。

 

5 示例

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

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

5.1.1 準(zhǔn)備

系統(tǒng)圖

 

材料

·SIP2703V模塊

·SIP2703DEMO板

·喇叭（4~8歐姆）

·測(cè)試用計(jì)算機(jī)

·網(wǎng)線

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

準(zhǔn)備

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

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

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

此例中，

計(jì)算機(jī)的IP地址為192.168.3.199/255.255.255.0

SIP2703V IP地址為192.168.3.11/255.255.255.0

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

 

5.1.2 上傳短音頻

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

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

 

        

 

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

 

 

注意：在后續(xù)的上傳文件中，注意文件長(zhǎng)度不要超過(guò)1024K，否則將會(huì)被截?cái)唷?/span>

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

 

 

5.1.3 測(cè)試

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

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

打開(kāi)瀏覽器新頁(yè)面，地址欄為輸入焦點(diǎn)，ctrl+v，將鏈接粘貼到新的頁(yè)面，回車(chē)執(zhí)行。

 如果SIP2703V設(shè)置賬號(hào)保護(hù)，會(huì)彈出窗口

 

 

需要在此輸入設(shè)備的賬號(hào)信息，點(diǎn)擊登錄。

則在揚(yáng)聲器播放剛才上傳的音樂(lè)文件。

 

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

5.2.1準(zhǔn)備工作

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

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

啟動(dòng)計(jì)算機(jī)的命令窗口（WIN+R彈出的窗口輸入cmd），

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

 

 

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

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

 

        

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

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

 

        

 

        

在命令提示符窗口輸入“ping 192.168.3.21”，測(cè)試ping命令。

        

        

收到回應(yīng)幀表示測(cè)試通過(guò)。

 

5.2.2添加短音頻

打開(kāi)瀏覽器，這里使用chrome，在地址欄輸入192.168.3.21，出現(xiàn)web登錄窗口

 

 

輸入賬號(hào)密碼登錄web服務(wù)。（如果是空密碼，直接點(diǎn)擊sign in按鈕）

進(jìn)入web服務(wù)后，切換到More/Audio Clip頁(yè)面。

點(diǎn)擊Add clip按鈕上傳短音頻。下圖為上傳短音頻后的截圖。

 

 

5.2.3添加事件

在web服務(wù)器進(jìn)入More/Events頁(yè)面，通過(guò)“Add event”按鈕打開(kāi)添加事件窗口，填入事件參數(shù)，如下圖。

 

 

點(diǎn)擊“Confirm”保存，退出編輯后，點(diǎn)擊“Save”保存事件。然后點(diǎn)擊Log out，使設(shè)備應(yīng)用新的事件設(shè)定。

上圖編輯的事件，在sip會(huì)話接通后，使用鍵盤(pán)依次輸入123，觸發(fā)設(shè)備播放bbg30.mp3文件，音量=85，播放1次結(jié)束。文件播放結(jié)束后繼續(xù)通話。如果在播放文件時(shí)，掛機(jī)，則設(shè)備繼續(xù)播放文件，播放完后自動(dòng)掛機(jī)。

 

5.2.4設(shè)置設(shè)備sip賬號(hào)

在web頁(yè)面中，進(jìn)入Sip Setting/Account 頁(yè)面，填入sip服務(wù)器和賬號(hào)信息。

 

 

選中“Use sip server”

User account：1001

password：2345

server address：192.168.3.199（在測(cè)試計(jì)算機(jī)上運(yùn)行minisipserver，故填測(cè)試計(jì)算機(jī)ip地址）

server port：5060 （sip默認(rèn)端口）

接著進(jìn)入“sip setting/intercom”頁(yè)面，設(shè)置會(huì)話codec，選中所有的編碼格式如下圖。

將auto answer time設(shè)置為3秒，（自動(dòng)接通延時(shí)）

 

 

5.2.5啟動(dòng)和配置sip server

在計(jì)算機(jī)上運(yùn)行minisipserver

點(diǎn)擊工具欄按鈕”Local users”，彈出窗口點(diǎn)擊“Add，添加用戶窗口添加用戶。

user name:1001

user password:2345

(user name 和user password 需要與5.1.4小節(jié)的User account和password相同。)

 

 

用同樣的方法，添加一個(gè)賬號(hào)用于x-lite軟電話。

user name:1010

user password:2345

5.2.6運(yùn)行x-lite軟電話

運(yùn)行x-lite，點(diǎn)擊抬頭的，進(jìn)入SIP account settings…對(duì)話框，添加賬號(hào)信息。

 

 

在賬號(hào)對(duì)話框輸入賬號(hào)：1010，密碼2345，點(diǎn)擊應(yīng)用，退出設(shè)置。

如果設(shè)置都正確，可以在minisipserver的對(duì)話框看到1001和1010都登錄到sip服務(wù)器了。

如下圖所示，

 

 

賬號(hào)前面的頭像變成藍(lán)色，表示成功登錄，我們可以進(jìn)行下一步測(cè)試。

 

5.2.7測(cè)試

a，在x-lite上，依次點(diǎn)擊1001，點(diǎn)擊呼叫設(shè)備。

b，會(huì)話接通后，依次點(diǎn)擊x-lite鍵盤(pán)1，2，3鍵，設(shè)備就會(huì)播放bbg30.mp3，

c，設(shè)備會(huì)將當(dāng)前播放的音頻，送回x-lite進(jìn)行播放。

d，音頻結(jié)束后繼續(xù)通話。

e，你還可以再次輸入123，設(shè)備會(huì)再次播放一次bbg30.mp3。

f，掛機(jī)，結(jié)束測(cè)試。

 

5.3 接通會(huì)話立即觸發(fā)短音頻

5.3.1 準(zhǔn)備工作

參考5.1.1準(zhǔn)備工作和5.1.2添加短音頻

5.3.2 添加事件

在web服務(wù)器進(jìn)入More/Events頁(yè)面，通過(guò)“Add event”按鈕打開(kāi)添加事件窗口，填入事件參數(shù)，如下圖。

        

 

點(diǎn)擊“Confirm”保存，退出編輯后，點(diǎn)擊“Save”保存事件。然后點(diǎn)擊Log out，使設(shè)備應(yīng)用新的事件設(shè)定。

上圖編輯的事件，在sip會(huì)話接通后，立即觸發(fā)設(shè)備播放bbg30.mp3文件，音量=85，播放1次結(jié)束。如果在播放文件時(shí)，掛機(jī)，則設(shè)備立即停止播放，并掛機(jī)。

 

5.3.3 設(shè)備參數(shù)及SIP環(huán)境配置

參考5.1.4，5.1.5，5.1.6小節(jié)

 

5.3.4 測(cè)試

a，在x-lite上，依次點(diǎn)擊1001，點(diǎn)擊呼叫設(shè)備。

b，會(huì)話接通后，設(shè)備就會(huì)播放bbg30.mp3，

c，設(shè)備會(huì)將當(dāng)前播放的音頻，送回x-lite進(jìn)行播放。

d，x-lite掛機(jī)，設(shè)備停止播放。

e，結(jié)束測(cè)試。

 

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