Android取流播放獲取資源SDK使用說(shuō)明書(shū).doc

《Android取流播放獲取資源SDK使用說(shuō)明書(shū).doc》由會(huì)員上傳分享，免費(fèi)在線閱讀，更多相關(guān)內(nèi)容在教育資源-天天文庫(kù)。

1、AndroidSDK使用說(shuō)明文檔目錄一.文檔閱讀說(shuō)明3二.SDK內(nèi)容說(shuō)明3三.3.0SDK使用說(shuō)明4(1)登錄流程:4(2)獲取資源流程：4(3)獲取設(shè)備信息6(4)獲取播放地址6(6)遠(yuǎn)程回放查詢(xún)接口7(7)獲取的監(jiān)控點(diǎn)主要作用如下圖所示：8四.2.0SDK使用說(shuō)明11一.文檔閱讀說(shuō)明非常感謝您選購(gòu)我們公司的產(chǎn)品，申請(qǐng)我們的SDK進(jìn)行二次開(kāi)發(fā)。溫馨的提醒您在開(kāi)發(fā)前請(qǐng)您對(duì)整個(gè)說(shuō)明文檔進(jìn)行仔細(xì)閱讀，以便整體的了解開(kāi)發(fā)流程。二.SDK內(nèi)容說(shuō)明該文檔主要針對(duì)手機(jī)客戶端iVMS-5060取流播放SDK進(jìn)行說(shuō)明，文檔介紹區(qū)分手機(jī)客戶端2.0和3.0版本。2個(gè)版本的SDK區(qū)分如下：功能2.0SDK3.0

2、SDK取流方式支持MAG支持MAG、VTDU(區(qū)分主子碼流)資源獲取方式通過(guò)WebView加載平臺(tái)返回的URL(平臺(tái)實(shí)現(xiàn)，手機(jī)客戶端只需要實(shí)現(xiàn)webview相關(guān)內(nèi)容)通過(guò)VmsNetSDK.jar網(wǎng)絡(luò)庫(kù)進(jìn)行獲取資源(需要在手機(jī)客戶端實(shí)現(xiàn))是否支持遠(yuǎn)程回放否是以上是2.0SDK和3.0SDK的主要區(qū)別，開(kāi)發(fā)者可以根據(jù)平臺(tái)目前支持的手機(jī)客戶端版本進(jìn)行選擇，如果該平臺(tái)支持手機(jī)客戶端iVMS-5060V2.0系列版本，則需要使用2.0版本的SDK，如果該平臺(tái)支持手機(jī)客戶端iVMS-5060V3.0系列版本，則需要使用3.0版本的SDK。具體平臺(tái)支持哪個(gè)版本的手機(jī)客戶端，需要咨詢(xún)平臺(tái)相關(guān)開(kāi)發(fā)人員。三.

3、3.0SDK使用說(shuō)明系統(tǒng)框架圖如圖3-1所示：圖3-13.0手機(jī)客戶端與平臺(tái)系統(tǒng)架構(gòu)圖(1)登錄流程:首先要獲取線路也就是調(diào)用getLineList接口其次調(diào)用登錄接口login接口，該接口中會(huì)用到getLineList接口中返回的線路(具體參考SDKdemo中相關(guān)接口注釋)(2)獲取資源流程：獲取資源流程，用到的接口有5個(gè)getControlUnitList：獲取控制中心的列表getRegionListFromCtrlUnit：從控制中心中獲取區(qū)域列表getRegionListFromRegion：從區(qū)域獲取區(qū)域列表getCameraListFromCtrlUnit：從控制中心獲取監(jiān)控點(diǎn)列

4、表getCameraListFromRegion：從區(qū)域獲取監(jiān)控點(diǎn)列表以上各個(gè)接口的參數(shù)說(shuō)明參考SDKdemo中相關(guān)接口注釋。流程如下：首先獲取根目錄下的資源信息，根目錄也就是控制中心，所以需要調(diào)用如下接口控制中心如圖3-2所示圖3-2獲取根目錄下的資源信息1.getControlUnitList2.getRegionListFromCtrlUnit3.getCameraListFromCtrlUnit以上接口調(diào)用完成后，展示的數(shù)據(jù)是根目錄下所有的控制中心、區(qū)域和監(jiān)控點(diǎn)。當(dāng)需要獲取根目錄下控制中心下的數(shù)據(jù)時(shí)，同樣需要調(diào)用以上3個(gè)接口。注：只要是獲取控制中心下的數(shù)據(jù)，都需要調(diào)用以上3個(gè)接口。當(dāng)

5、需要獲取區(qū)域下數(shù)據(jù)時(shí)，需要調(diào)用如下接口，區(qū)域展示如圖3-3所示：圖3-3獲取控制中心下資源1.getRegionListFromRegion2.getCameraListFromRegion以上接口調(diào)用完成后，展示出該區(qū)域下所有的區(qū)域和監(jiān)控點(diǎn)注：只要是獲取區(qū)域下的數(shù)據(jù)，都需要調(diào)用以上接口?？蛻艨梢愿鶕?jù)實(shí)際情況將資源列表做成樹(shù)形結(jié)構(gòu)或者是目前我們手機(jī)客戶端3.0版本展示的方式(如果層次過(guò)深，建議采用我們手機(jī)客戶端的展示方式)。(3)獲取設(shè)備信息3.0SDK可以通過(guò)平臺(tái)獲取設(shè)備信息：getDeviceInfo調(diào)用該接口需要平臺(tái)地址，登錄成功的會(huì)話ID(登錄成功接口中獲取)、監(jiān)控點(diǎn)ID(資源獲取到

6、的監(jiān)控點(diǎn)對(duì)象的一個(gè)屬性ID)、設(shè)備ID(資源獲取到的監(jiān)控點(diǎn)對(duì)象的一個(gè)屬性ID)，、返回設(shè)備信息的對(duì)象(該對(duì)象是一個(gè)類(lèi)似指針形式的對(duì)象)。設(shè)備信息包含以下內(nèi)容設(shè)備名稱(chēng)、設(shè)備編號(hào)、設(shè)備IP、設(shè)備端口、登錄設(shè)備的用戶名(這個(gè)是登錄設(shè)備的用戶名，并不是登錄平臺(tái)的用戶名)、登錄設(shè)備的密碼(這個(gè)是登錄設(shè)備的密碼，并不是登錄平臺(tái)的密碼，和登錄設(shè)備用戶名對(duì)應(yīng))、設(shè)備類(lèi)型、設(shè)備供應(yīng)商等。(4)獲取播放地址3.0SDK獲取播放地址是通過(guò)以下接口實(shí)現(xiàn)的getRealPlayURL調(diào)用該接口需要平臺(tái)地址、登錄成功的會(huì)話ID(登錄成功接口中獲取)、監(jiān)控點(diǎn)ID(資源獲取到的監(jiān)控點(diǎn)對(duì)象的一個(gè)屬性ID)、碼流類(lèi)型、返回播放

7、地址的對(duì)象(該對(duì)象是一個(gè)類(lèi)似指針形式的對(duì)象)。對(duì)于碼流類(lèi)型，如果傳入0，在返回的播放地址對(duì)象中url1表示主碼流，url2表示MAG；如果傳入1，在返回的播放地址對(duì)象中url1表示子碼流，url2表示MAG。開(kāi)發(fā)者可以根據(jù)需要選擇對(duì)象的碼流(清晰度以主碼流最為清晰，流暢度以MAG最為流暢)。(5)云臺(tái)接口云臺(tái)接口采用的是UDP協(xié)議，只負(fù)責(zé)發(fā)送，接口如下sendStartPTZCmd調(diào)用該接口需要的參數(shù)有：云臺(tái)