1、文檔版本042007-12-18發布日期BOM編碼N/A為客戶提供全方位的技術支持，用戶可與就近的海思辦事處聯系，也可直接與公司總部聯系。地址：市龍崗區坂田電氣生產中心：518129：http:/客戶服務：客戶服務傳真：sup.客戶服務郵箱：非經本公司。2006-2008。 保留一切權利。，任何和個人不得擅自摘抄、本文檔內容的部分或全部，并不得以商標、海思，均為的商標。本文檔提及的其他所有商標或商標，由各自的所有人擁有。注意由于產品版本升級或其他原因，本文檔內容會不定期進行更新。除非另有約定，本文檔僅作為使用指導，本文檔中的所有陳述、信息和建議不任何明示或暗示的擔保。目 錄目錄前 言11 概

2、述1-1描述范圍1-1接口格式1-1函數列表1-1函數描述方式1-2結構體描述方式1-2海思語音幀結構1-32 API參考2-2.4初始化海思語音編2-1初始化海思語音器2-2海思語音編器2-4初始化海思語音轉.2-72.5 海思語音轉.2-8其它信息3-1數據類型3-1常數定義3-13.1.2 hiVOICE_G711_SE_S3-3E_S3-3E_S3-43.1.3 hiVOICE_CM_S3.1.4 hiVOICE_G726_S3.1.5 hiVOICE_TRANSCODE_SE_S3-43.2 錯誤碼3-4A 縮略語A-1i前 言本本文檔版本文表定本文檔版本本參考初

3、描述解 Hi3510音頻編庫本參考列 C 語言本參考佪概述 Hi3510客戶端音頻編庫 API 參考類其參考信息 3 11概述 Hi3510客戶端音頻編庫 API 參考有類參考信息類參考信息本 Hi3510音頻編庫參考信息有體解2API 參考佪據類列 API API 接口函數本 Hi3510音頻編庫 APIHi3510解方V100R001前 言約定符號約定在本文中可能出現下列標志，它們所代表的含義如下。通用格式約定2格式說明宋體正文采用宋體表示。黑體一級、二級、三級標題采用黑體。楷體警告、提示等內容一律用楷體，并且在內容前后增加線條與正文。“Terminal Display”格式“Termin

4、al Display”格式表示屏幕輸出信息。此外，屏幕輸出信息中夾雜的用戶從終端輸入的信息采用加粗字體表示。符號說明以本標志開始的文本表示有高度潛在，如果不能避免，會導致或嚴重。以本標志開始的文本表示有中度或低度潛在，如果不能避免，可能導致輕微或中等。以本標志開始的文本表示有潛在風險，如果忽視這些文 本，可能導致設備或器件損壞、數據丟失、設備性能降低或不可預知的結果。以本標志開始的文本能幫助您解決某個問題或節省您的時間。以本標志開始的文本是正文的附加信息，是對正文的強調和補充。章節內容3其他信息介紹除上述參考項外的其他信息參考（如數據結構、錯誤碼等）。A縮略語列出本文檔中出現的縮略語。前 言

5、文檔版本文檔前有文檔版本32007-12-18041.3 函數列表函數 HI_VOICE_TransCodeReset HI_VOICE_TransCodeFrame HI_VOICE_EncReset 函數 HI_VOICE_DecReset 函數 2.4 海思語音轉初始化2.5 海思語音轉3.1.1 常數定義 DVS版本編器類型轉類型2 錯誤碼定義3.1.5 VOICE_TransSe_S3.2 錯誤碼錯誤碼 HI_ERR_VOICE_TRANS_TYPE HI_ERR_VOICE_TRANS_DEVICE2007-04-2003 HI_VOICE_EncodeFrame 函數3.1.1

6、常數定義碼 .33.1.4 定義碼文 HI_VOICE_EncodeFrame HI_VOICE_DecodeFrame 前言4修訂日期版本修訂說明2006-12-2902修改 API 接口為 API 參考。修改 HI_VOICE_EncReset 函數的描述。刪除 HI_VOICE_DecReset 函數前的一句 typedef unsigned char HI_U8 孤立代碼。修改 HI_VOICE_EncodeFrame 函數的目的、描述，增加注意內容。修改 HI_VOICE_DecodeFrame 函數的描述、參數，增加注意內容。將數據類型和錯誤碼合并在一章，為其他信息

7、。修改錯誤代碼為錯誤碼。修改縮略語表為縮略語。2006-05-1601第 1 次發布。1 概 述1概述1.1 描述范圍本音頻編庫支持 8kHz 采樣率 G.711、CM、G.726 編。其中，G.711 編解提供 A 律與 律壓縮編碼，采用非線性量化把 128kbit/s 采樣數據壓縮為 64kbit/s數據。G.711 標準適用于綜合業務網和大多數數字與通常采用 律鏈路。編碼，歐洲和其他地區大都采用 A 律編碼。CM（Adaptive Differential Pulse CodeModulation）提供自適應差分脈沖編碼調制編碼，把 128kbit/s 線性數據壓縮為 32kbit/s數

8、據。G.726 編40kbit/s 數據。器把 128kbit/s 線性數據壓縮為 16kbit/s、24kbit/s、32kbit/s、1.2 接口格式無。1.3 函數列表本文檔中所有 API 函數如表 1-1 所示。表1-1 API 函數列表1-1函數功能頁碼HI_VOICE_EncReset初始化海思語音編。2-1HI_VOICE_DecReset初始化海思語音器。2-2HI_VOICE_EncodeFrame以幀為進行海思語音編碼。2-4HI_VOICE_DecodeFrame以幀為進行海思語音。2-5HI_VOICE_TransCodeReset初始化海思語音轉。2-71 概 述1.

9、4 函數描述方式本文檔用 10 個域對 API 參考信息進行描述，如表 1-2 所示。表1-2 API 參考域說明1.5 結構體描述方式本文檔用 3 個域對結構體進行描述，如表 1-3 所示。表1-3 結構體參考域1-2參考域作用說明簡要描述結構體所實現的功能。定義列出結構體的定義。參考域作用目的簡要描述 API 的主要功能。語法列出 API 的語法樣式。描述簡要描述 API 的工作過程。參數列出 API 的參數、參數說明及參數屬性。返回值列出 API 的返回值及返回值說明。錯誤碼列出 API 的錯誤碼及錯誤碼說明。需求列出 API 包含的頭文件和 API 編譯時要的庫文件。注意使用 API

10、時應注意的事項。舉例使用 API 的實例。相關API 的其他相關信息。函數功能頁碼HI_VOICE_TransCodeFrame以幀為進行海思語音轉碼，將 Hi3510 DMS V100R001C210、 Hi3510_VSSDK_V 版本的 G711A、 G711U、CM_DVI4、G726_16KBPS 編碼碼流轉為之后版本的編碼碼流。2-91概述1.6 海思語音幀結構海思語音幀結構如表 1-4 所示。表1-4 海思語音幀結構注：n 的取值范圍請參見“2.3 海思語音編器”中“HI_VOICE_EncodeFrame”的描述。1-3參數位置(：HI_S16)參數比特位說明參數含義015:8

11、數據幀類型標志位。01：語音幀；其他：保留。7:0保留。115:8幀循環計數器：0255。7:0數據凈荷長度(：HI_S16)。215:0凈荷數據。315:0凈荷數據。15:0凈荷數據。2+n-215:0凈荷數據。2+n-115:0凈荷數據。參考域作用注意事項列出結構體的注意事項。2 API 參考2API 參考2.1 初始化海思語音編HI_VOICE_EncReset【目的】初始化海思語音編。【語法】#include hi_voice_api.hHI_VOICE_API HI_RESULT HI_VOICE_EncReset(HI_VOID *pEncS HI_S16 nCoder);e,【描

12、述】開始編碼任務前，根據上層傳入的編碼設備指針，初始化海思語音編。【參數】【返回值】2-1返回值描述0成功。非 0失敗，其值為錯誤碼。參數名稱描述輸入/輸出全局/局部pEncSe用戶指定的編碼設備，設備定義請參見 “3.1.2 hiVOICE_G711_SE_S”、 “3.1.3 hiVOICE_CM_SE_S”、 “3.1.4 hiVOICE_G726_SE_S”。輸入/輸出全局nCoder用戶指定的編類型，類型定義請參見 “3.1.1 常數定義”。輸入局部2 API 參考【錯誤碼】【需求】頭文件：/include/hi_voice_api.h【注意】G711_A、G711_U、CM_DVI

13、4、G726_16KBPS 四種編類型僅針對 Hi3510 DMS V100R001C210、Hi3510_VSSDK_V 版本編碼，之后版本不使用。【舉例】HI_VOID VoiceDemo()HI_RESULT Ret;hiVOICE_G711_SE_S g_sG711EncSe;Ret =HI_VOICE_EncReset (&g_sG711EncSe, G711_A);if (Ret != 0)MyErrorExit(HISI_VOICE_enc_resetelse);prf(HISI_VOICE_enc_reset SUCS.n);【相關】HI_VOICE_EncodeFrame2.

14、2 初始化海思語音HI_VOICE_DecReset【目的】器初始化海思語音器。【語法】#include “hi_voice_api.h”HI_VOICE_API HI_RESULT HI_VOICE_DecReset(HI_VOIDHI_S16 nCoder);*pDecSe,2-2錯誤碼描述HI_ERR_VOICE_ENC_TYPE編類型。HI_ERR_VOICE_INVALID_DEVICE編碼設備。2 API 參考【描述】開始任務前，初始化海思語音器。【參數】【返回值】【錯誤碼】【需求】頭文件：/include/hi_voice_api.h【注意】G711_A、G711_U、CM_DV

15、I4、G726_16KBPS 四種器類型僅針對 Hi3510 DMS V100R001C210、Hi3510_VSSDK_V 版本解碼，之后版本不使用。【舉例】HI_VOID VoiceDemo()HI_RESULT Ret;hiVOICE_G711_SE_S g_sG711DecSe;Ret=HI_VOICE_DecReset (&g_sG711DecSe, G711_A);2-3錯誤碼描述HI_ERR_VOICE_DEC_TYPE器類型。HI_ERR_VOICE_INVALID_DEVICE設備。返回值描述0成功。非 0失敗，其值為錯誤碼。參數名稱描述輸入/輸出全局/局部pDecSe用戶指

16、定的設備，設備定義請參見 “3.1.2 hiVOICE_G711_SE_S”、 “3.1.3 hiVOICE_CM_SE_S”、 “3.1.4 hiVOICE_G726_SE_S”。輸入/輸出全局nCoder用戶指定的器類型，類型定義請參見 “3.1.1 常數定義”。輸入局部2 API 參考if (Ret != 0) MyErrorExit(HISI_VOICE_dec_reset);elseprf(HISI_VOICE_dec_reset SUCS.n);【相關】HI_VOICE_DecodeFrame2.3 海思語音編器編對原始語音數據進行編碼，打海思語音幀輸出；器對海思語音幀解碼，輸出語

17、音數據。HI_VOICE_EncodeFrame【目的】以幀為進行海思語音編碼。【語法】#include “hi_voice_api.h”HI_VOICE_API HI_RESULT HI_VOICE_EncodeFrame(HI_VOID*pEncSe,HI_S16 HI_S16HI_S16*pInputBuf,*pOutputBuf, len);【描述】用戶傳入待編碼語音數據，編編碼后，把已編碼數據按照海思語音幀結構存放在用戶指定的輸出緩沖區。注意數據為 Word16，最大幀長為HI_VOICE_MAX_FRAME_SIZE，除的整數倍，即 80、160、240、320、480。CM_IM

18、A 編CM_IMA 編器之外，必須保證幀長為 80器需要多輸入一個樣點作為參考每幀編碼的參考電平，即幀長為 81、161、241、321、481。【參數】【返回值】2-4參數名稱描述輸入/輸出全局/局部pEncSe用戶指定的編碼設備。輸入/輸出全局pInputBuf待編碼數據輸入緩沖。輸入局部pOutputBuf已編碼數據輸出緩沖。輸出局部len數據幀長度。輸入局部2 API 參考【錯誤碼】【需求】頭文件：/include/hi_voice_api.h【注意】編碼前，必須保證編已經正確初始化。【舉例】HI_VOID VoiceDemo()Ret=HI_VOICE_EncodeFrame(&g_

19、sG711EncS_SIZE);e,in_pcm_buf,ou_enc_buf,MAX_FRAME【相關】HI_VOICE_EncReset海思語音幀結構HI_VOICE_DecodeFrame【目的】以幀為進行海思語音。【語法】#include “hi_voice_api.h”HI_VOICE_API HI_RESULT HI_VOICE_DecodeFrame (HI_VOID *pDecS HI_S16 * pInputBuf,e,2-5錯誤碼描述HI_ERR_VOICE_ENC_TYPE編類型。HI_ERR_VOICE_INVALID_DEVICE編碼設備。HI_ERR_VOICE_I

20、NVALID_INBUF輸入緩沖區。HI_ERR_VOICE_INVALID_OUTBUF輸出緩沖區。HI_ERR_VOICE_ENC_FRAMESIZE編碼數據幀長。返回值描述0成功。非 0失敗，其值為錯誤碼。2 API 參考HI_S16 * pOutputBuf,HI_S16 * pLen);【描述】用戶傳入編碼壓縮幀，沖區。器后，把已數據存放在用戶指定的輸出緩【參數】【返回值】【錯誤碼】【需求】頭文件：/include/hi_voice_api.h【注意】2-6錯誤碼描述HI_ERR_VOICE_DEC_TYPE器類型。HI_ERR_VOICE_INVALID_DEVICE設備。HI_E

21、RR_VOICE_INVALID_INBUF輸入緩沖區。HI_ERR_VOICE_INVALID_OUTBUF輸出緩沖區。HI_ERR_VOICE_DEC_FRAMETYPE語音幀類型。HI_ERR_VOICE_DEC_FRAMESIZE數據幀長。返回值描述0成功。非 0失敗，其值為錯誤碼。參數名稱描述輸入/輸出全局/局部pDecSe用戶指定的設備。輸入/輸出全局pInputBuf壓縮碼流的輸入緩沖區。輸入局部pOutputBuf數據的輸出緩沖區。輸出局部pLen指針，指向輸出幀的長度。輸出局部2 API 參考前，必須保證器已經正確初始化，并確保輸出緩沖區足以容納一幀數據。壓縮碼流格式采用海思

22、語音幀結構。【舉例】HI_VOID VoiceDemo()Ret = HI_VOICE_DecodeFrame(&g_sG711DecS &len);e, in_unpacked, ou_dec_pcmbuf,【相關】HI_VOICE_DecReset海思語音幀結構2.4 初始化海思語音轉HI_VOICE_TransCodeReset【目的】初始化海思語音轉。【語法】#include “hi_voice_api.h”HI_VOICE_API HI_RESULT HI_VOICE_TransCodeReset HI_S16 nCoder);(HI_VOID*pTransSe,【描述】開始轉碼任務

23、前，初始化海思語音轉。【參數】【返回值】2-7參數名稱描述輸入/輸出全局/局部pTransSe用戶指定的轉碼設備，設備定義請參見 “3.1.5hiVOICE_TRANSCODE_SE_S”。輸入/輸出全局nCoder用戶指定的轉類型。轉類型由Hi3510 DMS V100R001C210、Hi3510_VSSDK_V 版本編類型確定，類型定義請參見“3.1.1 常數定義”。輸入局部2 API 參考【錯誤碼】【需求】頭文件：/include/hi_voice_api.h【注意】僅針對 Hi3510 DMS V100R001C210、Hi3510_VSSDK_V 版本編碼碼流進行轉碼。【舉例】HI

24、_VOID VoiceDemo()HI_RESULT Ret; hiVOICE_TRANSCODE_SE_S g_TransSe;Ret= HI_VOICE_TransCodeReset (&g_TransS if (Ret != 0) MyErrorExit(HISI_VOICE_trans_reset);elsee,_G711A_TRANSF2_G711A);prf(HISI_VOICE_trans_reset SUCS.n);【相關】HI_VOICE_TransCodeFrame2.5 海思語音轉海思語音轉將 Hi3510 DMS V100R001C210、Hi3510_VSSDK_V

25、版本G711A、G711U、CM_DVI4、G726_16KBPS 編碼碼流轉為之后版本編碼碼流，打海思語音幀輸出。2-8錯誤碼描述HI_ERR_VOICE_TRANS_TYPE轉類型。HI_ERR_VOICE_TRANS_DEVICE轉碼設備。返回值描述0成功。非 0失敗，其值為錯誤碼。2 API 參考HI_VOICE_TransCodeFrame【目的】以幀為進行海思語音轉碼。【語法】#include “hi_voice_api.h”HI_VOICE_API HI_RESULT HI_VOICE_TransCodeFrame (HI_VOID *pTransS HI_S16 *pInput

26、Buf);e,【描述】用戶傳入待轉碼壓縮幀，轉碼完成后，把已轉碼數據按照海思語音幀結構存放在輸出緩沖區。【參數】【返回值】【錯誤碼】【需求】頭文件：/include/hi_voice_api.h【注意】轉碼前，必須保證轉已經正確初始化。2-9錯誤碼描述HI_ERR_VOICE_TRANS_TYPE轉類型。HI_ERR_VOICE_TRANS_DEVICE轉碼設備。HI_ERR_VOICE_INVALID_INBUF輸入緩沖區。返回值描述0成功。非 0失敗，其值為錯誤碼。參數名稱描述輸入/輸出全局/局部pTransSe用戶指定的轉碼設備。輸入/輸出全局pInputBuf待轉碼數據輸入緩沖。轉碼后

27、數據輸出緩沖。輸入/輸出局部2 API 參考需保證輸入編碼碼流為 Hi3510 DMS V100R001C210、Hi3510_VSSDK_V 版本編碼碼流。【舉例】HI_VOID VoiceDemo()Ret=HI_VOICE_TransCodeFrame(&g_TransSe,in_enc_buf);【相關】HI_VOICE_TransCodeReset海思語音幀結構2-103 其它信息33.1 3.1.1 / * 編幀 * /#d e f i n e HI _VOI CE_MAX_FRAME_S I ZE481/ * 海思編器類型 * / * Rea l - time t r a n s

28、 po r t p r o t o c o l ( RTP ) * / * 64kb it/ s G. 711#d e f i n e G711_AA,s eeRFC3551 . t x t4 . 5 . 14 PCMA * /0 x01/ * 64kb it/ s G. 711#d e f i n e G711_UU,s eeRFC3551 . t x t4 . 5 . 14 PCMU * /0 x02/ * 32kb it/ sCM(DVI 4 )f o rRTP ; s ee DVI 4 d i ff e r s 4 . 5 . 1 DVI 4 * /0 x03h r eer e s p

29、 ec t s fr omt h e IMA#d e f i n eCM a t RFC3551 . t x tCM_DVI 4/ * 16kb it/ s G. 726 , s ee#d e f i n e G726_16KBPSRFC3551 . t x t4 . 5 . 4 G726 - 160 x04* / * 24kb it/ s G. 726 , s ee#d e f i n e G726_24KBPSRFC3551 . t x t4 . 5 . 4 G726 - 240 x05* / * 32kb it/ s G. 726 , s ee#d e f i n e G726_32KB

30、PSRFC3551 . t x t4 . 5 . 4 G726 - 320 x06* / * 40kb it/ s G. 726 , s eeRFC3551 . t x t4 . 5 . 4 G726 - 400 x07* /#d e f i n eG726_40KBPS/ * IMA#d e f i n eCM wa v e t yp e , 32kb it/ sCM_ IMACM ( IMA) * /0 x233-13其它信息/ *An e xl e o ft h e p ac k i ng s c h eme f726 - 32o f t h ec od ewo r d s i s a

31、sc od ewo r d :s howna ndb it RTP 00 1A3 i s t h eG726 - 32 :l ea s ts i gn i f i ca n t b it 19 0 1 2 3 4 52 3 4 5 6 7 8+ - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + -| B B B B | A A A A | D D D D | C C C C | 0 1 2 3 | 0 1 2 3 | 0 1 2 3 | 0 1 2 3 |+ - + - + - + - + - + - + - + -

32、 + - + - + - + - + - + - + - + - + -. . . MEDIA G726 - 32 :0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5+ - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + - + -| A A A A | B B B B | C C C C | D D D D | 3 2 1 0 | 3 2 1 0 | 3 2 1 0 | 3 2 1 0 |+ - + - + - + - + - + - + - + - + - + - + - + - + - + - + - +

33、- + -* /. . . #d e f i n e #d e f i n e #d e f i n e#d e f i n eMEDIA_G726_16KBPS MEDIA_G726_24KBPS MEDIA_G726_32KBPSMEDIA_G726_40KBPS0 x240 x250 x260 x27/ */ */ */ *G726 G726 G726G72616kb it/ s 24kb it/ s 32kb it/ s40kb it/ sf o r f o r f o rf o rASF ASF ASFASF* /* /* /* / * Hi 3510 DMSV100R001C210

34、Hi 3510_VSSDK_V1 . 3 . 1 . 0版本編器類型A * /U * /* /* /* /#d e f i n e #d e f i n e #d e f i n e#d e f i n eG711_ G711_CM_G726_A_U_DVI 4_16KBPS0 x410 x420 x430 x44/ * 64kb it/ s/ * 64kb it/ s/ * 32kb it / sG. 711G. 711 CM/ * 16kb it/ s G. 726/ * 轉類型 * / * t r a n s f o rm Hi 3510 DMSV100R001C210Hi 3510_V

35、SSDK_V1 . 3 . 1 . 064kb it/ sG. 711 A t o c u rr e n t G711_A* /#d e f i n e_G711A_TRANSF2_G711A0 x61/ * t r a n s f o rm Hi 3510 DMS V100R001C210Hi 3510_VSSDK_V1 . 3 . 1 . 064kb it/ sG. 711 U t o c u rr e n tG711_U* /#d e f i n e_G711U_TRANSF2_G711U0 x62/ * t r a n s f o rm Hi 3510 DMS V100R001C210

36、Hi 3510_VSSDK_V1 . 3 . 1 . 032kb it/ sCM t o c u rr e n tCM_DVI 4* /#d e f i n e_CM_DVI 4_TRANSF2_CM_DVI 40 x63/ * t r a n s f o rm Hi 3510 DMS V100R001C210Hi 3510_VSSDK_V1 . 3 . 1 . 016kb it/ s3-23 其它信息G. 726 t o c u rr e n t G726_16KBPS* /#d e f i n e_G726_16KBPS_TRANSF2_G726_16KBPS0 x64/ * 海思語音幀類

37、型 * /#d e f i n e HI _NORMAL_FRAME0 x01/ * 語音幀 * / * 碼定義 * /#d e f i n e HI _SUCS0 x00/ * * /#d e f i n e HI _ERR_VOI CE_PREF IX0 xA1220000 / * 錯誤碼前定義 * / * 錯誤碼定義 * /#d e f i n e #d e f i n e #d e f i n e #d e f i n e #d e f i n e #d e f i n e #d e f i n e #d e f i n e #d e f i n e#d e f i n eHI _ER

38、R_VOI CE_ENC_TYPEHI _ERR_VOI CE_ENC_FRAMES I ZE HI _ERR_VOI CE_DEC_TYPEHI _ERR_VOI CE_DEC_FRAMES I ZE HI _ERR_VOI CE_DEC_FRAMETYPE HI _ERR_VOI CE_ INVAL ID_DEVICE HI _ERR_VOI CE_ INVAL ID_ INBUF HI _ERR_VOI CE_ INVAL ID_OUTBUF HI _ERR_VOI CE_TRANS_DEVI CEHI _ERR_VOI CE_TRANS_TYPE(HI _ERR_VOI CE_PREF IX (HI _ERR_VOI CE_PREF IX (HI _ERR_VOI CE_PREF IX (HI _ERR_VOI CE_PREF IX (HI _ERR_VOI CE_PREF IX (HI _ERR_VOI CE_PREF IX (HI _ERR_VOI CE_PREF IX (HI _ERR_VOI C