語音對(duì)講說明文檔

1、語音對(duì)講說明文檔一. 語音對(duì)講功能語音對(duì)講功能就是DVR與網(wǎng)絡(luò)端進(jìn)行通話的功能。對(duì)于現(xiàn)有的大華設(shè)備，視通、視豪系 列只支持單向語音對(duì)講：網(wǎng)絡(luò)端到設(shè)備端。視新、視通增強(qiáng)型系列支持雙向語音對(duì)講。二. 接線方式1. DVR 端：視通、視豪系列（支持單向語音對(duì)講：網(wǎng)絡(luò)）設(shè)備）：00O)兀ZB'包邁一 |©音頻輸出接口，BNC 口連接（即Q9頭）視新、視通增強(qiáng)型系列（支持雙向語音對(duì)講） 音頻接口， RCA 口連接（蓮花頭）?？捎秒S機(jī)附帶的485轉(zhuǎn)接線連接，其中紅色 RCA 接口為語音對(duì)講輸入接口，藍(lán)色 RCA接口為音頻輸出接口，黃色 RCA接口為通道音頻 輸入接口。音頻輸出接口可以直接

2、外接低阻抗值耳機(jī)、有源音箱或者通過功放驅(qū)動(dòng)其他聲音輸出設(shè) 備。語音對(duì)講輸入接口必須采用有源拾音器。連接好語音對(duì)講輸入接口（視通、視豪系 列無此接口，不用連接）及音頻輸出接口，設(shè)備端的連線工作就完成了。2. 網(wǎng)絡(luò)端：網(wǎng)絡(luò)端（PC端）的音頻輸出接口可以直接外接低阻抗值耳機(jī)、有源音箱或者通過功放驅(qū) 動(dòng)其他聲音輸出設(shè)備。音頻輸入接口采用麥克風(fēng)或有源拾音器。三. 語音對(duì)講注意事項(xiàng)1. 語音對(duì)講時(shí)，DVR本地必須處于多畫面監(jiān)視狀態(tài)。由于DVR端只有一個(gè)音頻輸出口, 處于單畫面狀態(tài)時(shí)，輸出的是該畫面對(duì)應(yīng)的音頻。只有多畫面時(shí)，才輸出語音對(duì)講的 音頻。2.打開音頻有獨(dú)占方式(Play_PlaySounc函數(shù))和

3、共享方式(Play_PlaySoundShareS數(shù)), 多個(gè)程序同時(shí)打開音頻時(shí)，請(qǐng)注意此區(qū)別，具體參見播放SDK說明。3 .語音對(duì)講服務(wù)器開發(fā)可以參考網(wǎng)絡(luò) SDKS音對(duì)講Demo在網(wǎng)絡(luò)SD!開發(fā)包 “ 分類 語音對(duì)講、日志管理 ”下四. 網(wǎng)絡(luò) SDK 音頻接口接口說明1. CLIENT_API BOOL CALL_METHOD CLIENT_QueryDevState(LONG lLoginID, int nType, char *pBuf, int nBufLen, int *pRetLen, int waittime)函數(shù)說明：查詢?cè)O(shè)備支持的對(duì)講音頻格式列表。目前音頻編碼類型有： PCM

4、、G711a AMR、G711u和G726等。在語音對(duì)講之前，先查詢?cè)O(shè)備支持的對(duì) 講音頻格式列表，再指定某種格式(CLIENT_SetDeviceMode),然后進(jìn)行對(duì)講 (CLIENT_StartTalkEx) 。參數(shù)說明：inlLoginID登入返回的設(shè)備句柄innType 查詢類型，這里為 DH_DEVSTATE_TALK_ECTYPE 類型。outpBuf輸出參數(shù)， 用于接收查詢返回的數(shù)據(jù)的緩存。 這里為結(jié)構(gòu)體 DHDEV_TALKFORMAT_LIST 。innBufLen緩存長(zhǎng)度，單位字節(jié)。outpRetLen輸出參數(shù)，實(shí)際返回的數(shù)據(jù)長(zhǎng)度，單位字節(jié)。inwaittime查詢狀態(tài)等待

5、時(shí)間。2. CLIENT_API BOOL CALL_METHOD CLIENT_SetDeviceMode(LONG lLoginID, EM_USEDEV_MODE emType, void* pValue) 函數(shù)說明：設(shè)置對(duì)講模式。參數(shù)說明：inlLoginID登入返回的設(shè)備句柄inemType設(shè)置類型。DH_TALK_SERVER_MODE服務(wù)器方式，用于音頻數(shù)據(jù)轉(zhuǎn)發(fā)， SDK 內(nèi)部不啟動(dòng)錄音和解碼。DH_TALK_ENCODE_TYPE指定對(duì)講音頻編碼類型。i npValue當(dāng)類型為 DH_TALK_ENCODE_TYPE 時(shí)，參數(shù)為結(jié)構(gòu)體 DHDEV_TALKDECODE_INFO

6、。3. CLIENT_API LONG CLIENT_StartTalkEx(LONGILogi nID,pfAudioDataCallBack pfcb, DWORD dwUser);函數(shù)說明：向設(shè)備發(fā)起語音對(duì)講請(qǐng)求 參數(shù)說明：in lLogi nID登入返回的設(shè)備句柄i npfcb用戶自定義的數(shù)據(jù)回調(diào)接口in dwUser用戶自定義信息，通過回調(diào)函數(shù)返回給用戶回調(diào)函數(shù)參數(shù)說明typedef void(CALLBACK *pfAudioDataCallBack)(LONGlTalkHa ndle,char*pDataBuf, DWORD dwBufSize, BYTE byAudioFlag

7、, DWORD dwUser);(in )ITalkHa ndle就是CLIENT_StartTalkEx 的返回值(in )pDataBuf回調(diào)出來的音頻數(shù)據(jù)的內(nèi)容(in )dwBufSize回調(diào)出來的音頻數(shù)據(jù)的長(zhǎng)度，(單位字節(jié))(in )byAudioFlag音頻數(shù)據(jù)歸屬標(biāo)志0表示是本地錄音庫(kù)米集的音頻數(shù)據(jù)1表示收到的設(shè)備發(fā)過來的音頻數(shù)據(jù)(in )dwUser用戶調(diào)用CLIENT_StartTalkEx時(shí)自定義的用戶數(shù)據(jù)返回值：成功返回和設(shè)備對(duì)講的句柄，失敗返回0；典型應(yīng)用：打開和設(shè)備的對(duì)講；【注意】 在以后(包含才有這個(gè)接口，代替之前的CLIENT_StartTalk4.CLIENT_S

8、etAudioClie ntVolume(LONGCLIENT_APIBOOLITalkHa ndle, WORD wVolume);函數(shù)說明：在進(jìn)行語音對(duì)講的時(shí)候設(shè)置音量； 參數(shù)說明：in ITalkHa ndleCLIENT_StartTalkEx的返回值in wVolume要設(shè)置的音量，范圍是OOXFFFF, 0的音量最小返回值：成功返回TRUE，失敗返回FALSE ； 典型應(yīng)用：【注意】在以后（包含才有的。5. CLIENT_API LONG CLIENT_TalkSendData（LONGlTalkHandle,char *pSe ndBuf, DWORD dwBufSize）;函數(shù)

9、說明：向設(shè)備發(fā)送用戶的音頻數(shù)據(jù)，這里的數(shù)據(jù)可以是從CLIENT StartTalkEx 的回調(diào)接口中回調(diào)出來的數(shù)據(jù)； 參數(shù)說明：in lTalkHa ndleCLIENT StartTalkEx的返回值；in pSe ndBuf要發(fā)送的音頻數(shù)據(jù)；in dwBufSize是要發(fā)送的音頻數(shù)據(jù)的長(zhǎng)度，（單位字節(jié)）返回值：成功時(shí)返回實(shí)際傳輸給設(shè)備的數(shù)據(jù)長(zhǎng)度，失敗返回-1典型應(yīng)用：接收到CLIENT_StartTalkEx的回調(diào)出來的錄音數(shù)據(jù)后通過這個(gè) 接口發(fā)送給設(shè)備?！咀⒁狻吭谝院螅ò庞械?。6. CLIENT_API BOOL CLIENT_RecordStart（）;函數(shù)說明：?jiǎn)?dòng)本地錄音功能，

10、錄音采集出來的音頻數(shù)據(jù)通過 CLIENT StartTalkEx的回調(diào)函數(shù)回調(diào)給用戶，對(duì)應(yīng)操作是CLIENT_RecordStop ； 參數(shù)：無 返回值：成功返回TRUE，失敗返回FALSE；典型應(yīng)用：語音對(duì)講中使用；【注意】在以后（包含才有的。7. CLIENT_API BOOL CLIENT_RecordStop();函數(shù)說明：停止本地錄音，對(duì)應(yīng)操作是CLIENT_RecordStart ;參數(shù)：無返回值：成功返回TRUE，失敗返回FALSE;典型應(yīng)用：語音對(duì)講中使用；【注意】在以后（包含才有的。8. CLIENT_APIvoidCLIENT_AudioDec（char*pAudioDat

11、aBuf, DWORD dwBufSize）;函數(shù)說明：對(duì)輸入的音頻數(shù)據(jù)進(jìn)行解碼； 參數(shù)說明：in pAudioDataBuf要求解碼的音頻數(shù)據(jù)內(nèi)容；in dwBufSize要求解碼的音頻數(shù)據(jù)的長(zhǎng)度，（單位字節(jié)） 返回值：無典型應(yīng)用：語音對(duì)講中對(duì)設(shè)備傳過來的數(shù)據(jù)進(jìn)行解碼； 【注意】在以后（包含才有的。9. CLIENT_API BOOL CLIENT_StopTalkEx（LONG ITalkHandle）;函數(shù)說明：停止與設(shè)備的對(duì)講，對(duì)應(yīng)操作是 CLIENT_StartTalkEx ； 參數(shù)說明：in lTalkHa ndleCLIENT StartTalkEx返回的對(duì)講句柄返回值：成功返回

12、TRUE，失敗返回FALSE； 典型應(yīng)用：語音對(duì)講中使用；【注意】在以后（包含才有的。10. CLIENT_API BOOL CLIENT_AudioBroadcastAddDev（LONG lLogi nID）;函數(shù)說明：把設(shè)備增加到廣播組中，當(dāng)本地錄音庫(kù)啟動(dòng)后，采集出 來的數(shù)據(jù)會(huì)自動(dòng)發(fā)送給廣播組中的設(shè)備，對(duì)應(yīng)操作是CLIENT AudioBroadcastDelDev；參數(shù)說明：in lLogi nID登錄設(shè)備時(shí)得到的設(shè)備句柄返回值：成功返回TRUE，失敗返回FALSE； 典型應(yīng)用：在語音對(duì)講服務(wù)器開發(fā)中使用；【注意】在以后（包含才有的。11. CLIENT_API BOOL CLIENT

13、_AudioBroadcastDelDev（LONG lLogi nID）;函數(shù)說明：把設(shè)備從廣播組中刪除，對(duì)應(yīng)操作是 CLIENT_AudioBroadcastAddDev；參數(shù)說明：in ILogi nID設(shè)備句柄返回值：成功返回TRUE，失敗返回FALE ；典型應(yīng)用：在語音對(duì)講服務(wù)器開發(fā)中使用；【注意】在以后(包含才有的。12. CLIENT_APIintCLIENT_I ni tAudioE ncode(DH_AUDIO_FORMAT aft);函數(shù)說明：初始化對(duì)講中的音頻編碼接口，告訴SDK內(nèi)部要編碼的 源音頻數(shù)據(jù)的音頻格式，對(duì)不支持的音頻格式初始化會(huì)失??； 參數(shù)說明：i naft要

14、編碼的音頻格式，類型 DH_AUDIO_FORMAT返回值：成功返回0,失敗返回錯(cuò)誤碼，參考錯(cuò)誤碼解釋； 相關(guān)函數(shù)：典型應(yīng)用：通過配置接口獲取設(shè)備支持的音頻解碼格式，目前配置 接口還不支持獲取，這里的音頻格式默認(rèn)只支持(0, 1, 16, 8000), 格式表示是(編碼類型，聲道數(shù)，采樣深度，采樣率)13. CLIENT_API int CLIENT_AudioE ncode(LONGlTalkHa ndle, BYTE *lp In Buf, DWORD *lpln Le n, BYTE *lpOutBuf, DWORD *lpOutLe n);函數(shù)說明：進(jìn)行音頻的數(shù)據(jù)二次編碼，從標(biāo)準(zhǔn)音頻格

15、式轉(zhuǎn)換成設(shè)備 支持的大華格式；參數(shù)說明：in ITalkHa ndle該參數(shù)不起作用，僅為兼容考慮而保留，可填任意值。in lpI nBuf要編碼的源音頻數(shù)據(jù)；(in,o ut)lp InLen源音頻數(shù)據(jù)的長(zhǎng)度，當(dāng)接口返回?cái)?shù)據(jù)過長(zhǎng)時(shí)，Ipln Len 的值 是接口支持的最長(zhǎng)的輸入長(zhǎng)度，最好不要超過1024*2,當(dāng)返 回成功時(shí)，其值表示剩下還沒有編碼數(shù)據(jù)長(zhǎng)度，(單位字節(jié))outlpOutBuf用來存儲(chǔ)編碼的音頻數(shù)據(jù)；(in,o ut)lpOutLe n調(diào)用接口時(shí)表示IpOutBuf的最大長(zhǎng)度，當(dāng)接口返回緩沖不足時(shí)，其值是需要的緩沖長(zhǎng)度，(單位字節(jié))返回值：成功返回0,失敗返回錯(cuò)誤碼，參考錯(cuò)誤碼解

16、釋相關(guān)函數(shù)：CLIENTnitAudioEncode，CLIENT_StartTalkEx，CLIENT ReleaseAudioEncode典型應(yīng)用：在對(duì)講中，如果是用戶使用自己的錄音數(shù)據(jù)，傳給*的數(shù)據(jù)必須是經(jīng)過編碼的數(shù)據(jù)；14. CLIENT_API intCLIENT_ReleaseAudioE ncode();函數(shù)說明：解碼功能使用完畢后，告訴接口清理內(nèi)部資源；參數(shù)說明：返回值：成功返回0,失敗返回錯(cuò)誤碼，參考錯(cuò)誤碼解釋；相關(guān)參數(shù)： CLIENTnitAudioEncode， CLIENT_AudioEncode典型應(yīng)用：五. 播放SDK音頻相關(guān)接口說明4. BOOL PLAY_Pla

17、ySou nd(LONG nPort)函數(shù)說明：打開聲音；同一時(shí)刻只能有一路聲音。如果現(xiàn)在已經(jīng)有聲音打開，則自動(dòng)關(guān)閉原來已經(jīng)打開的聲音。注意：默認(rèn)情況下聲音是關(guān)閉的參數(shù)說明：輸入?yún)?shù)：n Port通道號(hào)返回值：成功返回TRUE，不成功返回FALSE5. BOOL PLAY_StopSou nd()函數(shù)說明：關(guān)閉聲音參數(shù)說明：(無)返回值：成功返回TRUE，不成功返回FALSE6. BOOL PLAY_PlaySoundShare(LONG nPort)函數(shù)說明：以共享方式播放聲音，播放本路聲音而不去關(guān)閉其他路的聲音 參數(shù)說明：輸入?yún)?shù)：nPort通道號(hào)返回值：成功返回 TRUE ，不成功返回

18、FALSE7. BOOL PLAY_StopSoundShare(LONG nPort)函數(shù)說明： 以共享方式關(guān)閉聲音。 PLAY_PlaySound 和 PLAY_StopSound 以獨(dú)占方式播放聲音的。注意：在同一個(gè)進(jìn)程中，所有通道必須 使用相同的方式播放或關(guān)閉聲音參數(shù)說明：輸入?yún)?shù)：nPort通道號(hào)返回值：成功返回 TRUE ，不成功返回 FALSE8. BOOL PLAY_SetVolume(LONG nPort,WORD nVolume)函數(shù)說明：設(shè)置音量參數(shù)說明：輸入?yún)?shù)：nPort通道號(hào)nVolume音量的值，范圍 0-0XFFFF返回值：成功返回 TRUE ，不成功返回 FALSE9. WORD PLAY_GetVolume(LONG nPort)函數(shù)說明：獲得當(dāng)前設(shè)置的音量參數(shù)說明：輸入?yún)?shù)：nPort通