售前電話
135-3656-7657
售前電話 : 135-3656-7657
話機在通話過程中,可以啟用錄音服務保存通話錄音。配置有兩種方式保存錄音:
1) 將 rtp 數(shù)據(jù)存儲成指定格式文件保存在本地。
2) 將錄音的 rtp 數(shù)據(jù)傳送給服務器,在服務器上保存成文件格式。
1.2 適用型號
本文檔適用于 Fanvil X3S、X4 、X5S、X6、X7、X7C、X210、X210i、XU 系列等型號
1.3 目標受眾
此文檔是針對那些想了解錄音功能是如何改進的公司內(nèi)部研發(fā)或者測試人員。
2 錄音框架介紹
2.1 通話錄音方案架構
創(chuàng)建本地 stream,和要錄音的 stream 進行混音處理,本地的 stream 只接收。通過本地stream,可以本地綁定端口,接收 stream 上經(jīng)過混音處理的 rtp 數(shù)據(jù),再講 rtp 數(shù)據(jù)寫入本地文件保存或發(fā)送給服務器保存。
3 通話錄音功能模塊介紹
3.1 本地錄音
本地錄音只有掛載 U 盤才可以支持錄音,獲取到 U 盤掛載點后對 U 盤可用容量進行檢查,創(chuàng)建文件保存 rtp 數(shù)據(jù),文件名以“Record_當前系統(tǒng)時間”命名。如果開啟本地錄音文件大小限制,錄音文件達到限制值且 U 盤有可用容量會創(chuàng)建新的錄音文件繼續(xù)保存 rtp數(shù)據(jù)。錄音過程中可暫停、恢復通話錄音。
本地錄音文件格式為:
在本地錄音過程中,會生成以上文件格式信息,保存在錄音文件中,用于播放時使用。codec 為錄音編碼;rtpLen 為 rtp 數(shù)據(jù)長度;incremet 為時間戳增量;dataSize 為 rtp 數(shù)據(jù)總長度。錄音文件格式為.wav。
3.2 服務器錄音
服務器錄音需要配置錄音服務器地址serverAddr和端口serverPort。話機和服務器通信,分為控制指令和 rtp 數(shù)據(jù)。
3.2.1 控制指令
開始錄音時,話機需要先和服務器通信交互信息,雙方確認后,再開始傳輸 rtp 數(shù)據(jù)。話機和服務器 Addr + Port 進行控制指令通信,基于 TCP 方式。
首先話機發(fā)起錄音開始請求,服務器收到后會重新分配一個地址和端口,專門監(jiān)聽話機的 rtp 數(shù)據(jù),收到后保存為文件。話機端收到響應后,需要根據(jù)服務器響應的消息,連接指定的地址和端口,上傳 rtp 數(shù)據(jù),基于 UDP 方式。
Record Start 指令格式
指令請求:
cmd=RecordStartRequest&id=xxx&device=xxx&remote_number=xxx&remote_name=xxx&local_number=xxx&local_name=xxx&dir=in|out&codec=xxx
指令響應:
cmd=RecordStartResponse&id=xxx&result=success|failed&reason=xxx&server=xxx&port =xxx
id 表示此次錄音的唯一標識,由話機端生成一個隨機數(shù),整個錄音過程中,保持該值不變
device 表示設備的 mac 地址,用于服務器端分類管理設備dir 表示通話類型,呼入還是呼出
codec 表示 rtp 的編碼,PCMA|PCMU
server port 表示監(jiān)聽 rtp 數(shù)據(jù)的服務器和端口,由錄音服務器動態(tài)生成
注意:如果服務器回復 failed,表示服務器有問題,無法保存錄音,話機需要提示錄音失敗停止指令,既可以由話機端發(fā)送,也可以由服務器端發(fā)送。當服務器端錄音異常時,可以發(fā)送 Stop 指令通知錄音結(jié)束。
Recrod Stop 指令格式
指令請求:
cmd=RecordStopRequest&id=xxx&remote_number=xxx&remote_name=xxx&local_number=xxx&local_name=xxx&reason=xxx
指令響應:
cmd=RecordStopResponse&id=xxx&result=success
如果錄音期間,socket 連接出錯,雙方都需要設置為錄音已停止狀態(tài),清楚之前的狀態(tài)。
RecordStopRequest 指令中,除了 cmd 和 id 是必選參數(shù),其它都是可選。如果有,且和RecrodStartRequest 指令中的值不一樣時,使用新值覆蓋。
3.2.2 RTP 數(shù)據(jù)
話機從服務器響應消息中提取出地址和端口,使用 UDP 方式上傳 rtp 數(shù)據(jù)。直到收到停止指令,或者 socket 異常了,停止 rtp 發(fā)送,設置為錄音停止狀態(tài)。
3.3 服務停止/播放