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

時(shí)間：2024-04-08

編輯：

1、簡介

音頻設(shè)備內(nèi)可以存儲(chǔ)多個(gè)短音頻文件，可以通過HTTP,SIP-ANSWER,SIP-DTMF,GPIO等多種觸發(fā)短音頻文件的本地播放。

SIP-ANSWER方式是通過SIP電話呼叫音頻設(shè)備，設(shè)備接通后立即在本地播放短音頻，短音頻播放結(jié)束后，根據(jù)事件的設(shè)置，進(jìn)入正常的雙向通話狀態(tài)或立即掛機(jī)。SIP電話掛機(jī)時(shí)，根據(jù)設(shè)置，會(huì)終止或繼續(xù)播放短音頻。

SIP-DTMF方式是通過SIP電話呼叫設(shè)備，設(shè)備接通后進(jìn)入正常通話狀態(tài)，此時(shí)可以通過按鍵向音頻設(shè)備發(fā)送一串DTMF信息，設(shè)備根據(jù)DTMF信息串，觸發(fā)不同的短音頻，短音頻播放完成后，可以設(shè)置成繼續(xù)通話或結(jié)束會(huì)話。中途掛機(jī)，可設(shè)置成終止播放或繼續(xù)播放。

短音頻播放期間，音頻設(shè)備會(huì)將短音頻重新編碼，發(fā)給SIP呼叫端，呼叫端可以實(shí)時(shí)監(jiān)聽音頻設(shè)備的播放內(nèi)容。

SIP會(huì)話中，有SIPINFO、RFC2833、INBAND，三種方式傳輸DTMF。設(shè)備只支持SIPINFO和RFC2833兩種。

本文通過實(shí)例演示SIP- ANSWER和 SIP-DTMF兩種觸發(fā)短音頻播放的操作方法。

2、名詞

SIP:Session Initiation Protocol（會(huì)話發(fā)起協(xié)議）

SIP-ANSWER:會(huì)話接通時(shí)，觸發(fā)的事件名稱

SIP-DTMF:會(huì)話中，通過鍵盤，發(fā)送的信息名稱。

SIPINFO:通過sip info機(jī)制發(fā)送的DTMF信息。

RFC2833:一種網(wǎng)絡(luò)通訊標(biāo)準(zhǔn)

X-LITE: 一種軟電話軟件

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

3、實(shí)例

測試系統(tǒng)圖

3.1 SIP-INVITE觸發(fā)音頻播放

這個(gè)示例中，通過x-lite軟件和呼叫音頻設(shè)備，在音頻設(shè)備接通會(huì)話后，立即播放短音頻，播放完成后自動(dòng)掛斷。

3.1.1 準(zhǔn)備工作

需要被測試的網(wǎng)絡(luò)音頻設(shè)備（例如SIP2703DEMO板+SIP2703V模塊）

計(jì)算機(jī)（windows操作系統(tǒng)）

網(wǎng)線若干。

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

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

使用ping命令檢測設(shè)備是否可以正常通訊。

此例中，計(jì)算機(jī)的IP地址設(shè)置成192.168.3.199/255.255.255.0

SIP2703V模塊IP地址設(shè)置從192.168.3.21/255.255.255.0

我們還需要在Manager發(fā)現(xiàn)和配置工具，設(shè)置網(wǎng)頁訪問端口=80，如為其他值，訪問設(shè)備web服務(wù)時(shí)，需要指明端口號(hào)。

3.1.2、添加短音頻

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

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

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

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

2.1.3、添加事件

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

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

參數(shù)說明：

Name:事件的名稱，任意取名。

Event Type:事件類型，設(shè)置為status change

Status:何種狀態(tài)觸發(fā)事件，設(shè)置為Answer

Action：事件觸發(fā)的動(dòng)作類型，設(shè)置為clip play and hang up，表示播放結(jié)束自動(dòng)掛斷。

clip:播放的短音頻。

Voume：本地播放短音頻時(shí)的音量。設(shè)置為85

Repeat:短音頻的播放循環(huán)次數(shù)。

If event ends:掛機(jī)對(duì)短音頻播放的影響，設(shè)置為Stop，表示掛機(jī)立即終止短音頻播放。

這個(gè)事件設(shè)置，在sip會(huì)話接通后，立即觸發(fā)設(shè)備在本地播放bbg30.mp3文件，音量=85，播放1次。文件播放結(jié)束后繼續(xù)通話。如果在播放文件時(shí)，掛機(jī)，則立即終止播放。

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

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

點(diǎn)擊工具欄按鈕”Local users”，彈出窗口點(diǎn)擊“Add，添加設(shè)備端電話賬號(hào)(用于設(shè)備SIP注冊(cè))。

user name:1001

user password:2345

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

user name:1010

user password:2345

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

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

說明：賬號(hào)密碼需要與3.1.4小節(jié)設(shè)備端賬號(hào)一致。

選中“Use sip server”

User account：1001

password：2345

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

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

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

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

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

運(yùn)行x-lite，點(diǎn)擊抬頭的，進(jìn)入SIP account settings…對(duì)話框，添加賬號(hào)信息（與3.1.4 xlite賬號(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)行下一步測試。

3.1.7、測試

a，在x-lite鍵盤上，輸入1001，點(diǎn)擊呼叫音頻設(shè)備。

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

c，設(shè)備會(huì)將當(dāng)前播放的音頻，回送x-lite，計(jì)算機(jī)聲卡實(shí)時(shí)聽到播放。

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

e，結(jié)束測試。

3.2、通過DTMF觸發(fā)短音頻播放

本實(shí)例演示在SIP通話中，會(huì)話接通后，進(jìn)行正常的雙向通話，此時(shí)向音頻設(shè)備發(fā)送DTMF數(shù)據(jù)串，觸發(fā)短音頻播放，播放完成后重新進(jìn)入雙向通話。

提示：如果設(shè)置了SIP-ANSWER事件，會(huì)先觸發(fā)此事件。

3.2.1、準(zhǔn)備工作

參考3.1小節(jié)進(jìn)行所有的準(zhǔn)備工作，包括添加短音頻，啟動(dòng)和配置sip Server，設(shè)置設(shè)備賬號(hào)，啟動(dòng)x-lite軟電話等。

3.2.2、添加事件

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

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

參數(shù)說明：

Name：事件名稱

Event Type：選擇dtmf

value：dmtf鍵值。完全匹配才觸發(fā)事件。鍵值需要連續(xù)輸入，如果按鍵間隔過長，前面輸入會(huì)被忽略。

Action：選擇clip play and talk，表示播放文件完成后繼續(xù)通話。

clip：短音頻的文件名。

volume：本地播放音量。

Repead：短音頻播放循環(huán)次數(shù)。

If event end：選擇continue playing，表示播放期間如果掛斷電話，繼續(xù)播放，播放結(jié)束自動(dòng)掛斷。

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