Android網(wǎng)絡(luò)庫sdk開發(fā)經(jīng)驗(yàn)分享

Android網(wǎng)絡(luò)庫開發(fā)文檔本文對Android網(wǎng)絡(luò)庫開發(fā)做了詳細(xì)的介紹，如下： 網(wǎng)絡(luò)庫是用C++編寫，用ndk編譯的jni動態(tài)庫，功能為使用http+p2p方式創(chuàng)建、下載視頻任務(wù)并提供播放器播放數(shù)據(jù)，所有接口線程安全，下面介紹云帆加速視頻app開發(fā)如何使用sdk。初始化sdk，程序啟動后只需要初始化一次，初始化成功后才能調(diào)用其他接口。publicvoidCallBackFunction(intid,intresult,Stringbuf){ Log.i(TAG,"CallBackFunction"+id+""+result+""+buf);}publicintTestInit(){StringstrConfigPath=Environment.getExternalStorageDirectory().toString()+"/yfnet/config/"; StringstrCachePath=Environment.getExternalStorageDirectory().toString()+"/yfnet/cache/"; StringstrSdkKey=newString("9feab35493f951d7e1ab1f07af7637bc"); Objectcls=this; StringstrMethod=newString("CallBackFunction"); intret=Yfnet.Init(strConfigPath,strCachePath,strSdkKey,cls,strMethod); Log.i(TAG,"InitYfnetret="+ret); return0;}初始化函數(shù)的參數(shù)：參數(shù)名類型說明strConfigPathStringsdk保存配置和任務(wù)信息的目錄strCachePathStringsdk緩存視頻的目錄，對空間大小有需求，建議選用存儲空間大的目錄strSdkKeyString32字節(jié)的字符串，在云帆加速網(wǎng)站申請sdk權(quán)限時產(chǎn)生的KeyclsObject回調(diào)函數(shù)所在的類對象strMethodString回調(diào)函數(shù)的函數(shù)名返回值及其含義：返回值說明E_NET_OK初始化成功，具體為創(chuàng)建配置目錄、緩存目錄及配置文件成功，啟用本地http代理成功，sdkkey驗(yàn)證成功，回調(diào)函數(shù)設(shè)置成功，sdk線程創(chuàng)建成功E_NET_PATH_NOT_ACCESS初始化失敗，原因?yàn)榕渲媚夸浕蚓彺婺夸洘o法創(chuàng)建，app需要申請訪問磁盤權(quán)限，如下，在AndroidManifest.xml中添加這一行，<uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/>并確認(rèn)目錄有權(quán)限讀寫E_NET_BIND_LOCAL_HTTP_PORT_FAIL初始化失敗，原因?yàn)閱⒂帽镜豩ttp代理時綁定端口失敗，需要app申請訪問網(wǎng)絡(luò)權(quán)限，如下，在AndroidManifest.xml中添加這一行<uses-permissionandroid:name="android.permission.INTERNET"/>hashArraybyte[]40字節(jié)的字符串，創(chuàng)建任務(wù)后對任務(wù)的操作都以該值作為索引CreateTask返回值及含義E_NET_OK創(chuàng)建任務(wù)成功E_NET_TASK_FINISH創(chuàng)建任務(wù)成功，且已經(jīng)緩存完成E_NET_ERROR_PARA參數(shù)不合法，參數(shù)為空或不是http鏈接E_NET_NO_INITsdk未初始化E_NET_URL_NOT_MATCH_DOMAINstrOrgUrl域名不包含申請sdk時提交的域名或strKeyUrl域名和申請sdk時提交的域名不一致SetPlayingStatus參數(shù)名類型說明strHashString40字節(jié)的字符串，要設(shè)置的任務(wù)statusbooleantrue為播放狀態(tài)，false為非播放狀態(tài)SetPlayingStatus返回值及含義E_NET_OK設(shè)置成功E_NET_ERROR_PARA參數(shù)不合法，參數(shù)為空E_NET_NO_INITsdk未初始化E_NET_NO_TASK_BY_HASH沒有hash對應(yīng)的任務(wù)RunTask參數(shù)名類型說明strHashString40字節(jié)的字符串，要開始緩存的任務(wù)RunTask返回值及含義E_NET_OK設(shè)置成功E_NET_ERROR_PARA參數(shù)不合法，參數(shù)為空E_NET_NO_INITsdk未初始化E_NET_NO_TASK_BY_HASH沒有hash對應(yīng)的任務(wù)組裝本地http代理播放地址，傳給播放器，播放器自動以http方式向sdk請求視頻數(shù)據(jù)，實(shí)現(xiàn)播放。播放地址的格式為:$(port)/yfhttpagent/$(hash)，其中$(port)為sdk本地http代理端口，初始化時已通過回調(diào)通知app，$(hash)為視頻任務(wù)的hash，創(chuàng)建任務(wù)后得到。播放完、退出播放、退到后臺或鎖屏，需要暫停緩存任務(wù)并設(shè)置為非播放狀態(tài)。 //設(shè)置任務(wù)為暫停緩存狀態(tài) Yfnet.PauseTask(strHash); //設(shè)置任務(wù)為非播放狀態(tài) Yfnet.SetPlayingStatus(strHash,false);PauseTask參數(shù)名類型說明strHashString40字節(jié)的字符串，要暫停緩存的任務(wù)PauseTask返回值及含義E_NET_OK設(shè)置成功E_NET_ERROR_PARA參數(shù)不合法，參數(shù)為空E_NET_NO_INITsdk未初始化E_NET_NO_TASK_BY_HASH沒有hash對應(yīng)的任務(wù)退出程序時注銷sdk，沒有失敗的情況。Yfnet.Clear();其他接口說明：//刪除指定任務(wù)及其緩存內(nèi)容Yfnet.DeleteTask(strHash);DeleteTask：刪除指定任務(wù)及其緩存內(nèi)容參數(shù)名類型說明strHashString40字節(jié)的字符串，要刪除的任務(wù)DeleteTask返回值及含義E_NET_OK刪除成功E_NET_ERROR_PARA參數(shù)不合法，參數(shù)為空E_NET_NO_INITsdk未初始化E_NET_NO_TASK_BY_HASH沒有hash對應(yīng)的任務(wù)//刪除所有任務(wù)及其緩存內(nèi)容Yfnet.CleanCache();CleanCache：刪除所有任務(wù)及其緩存內(nèi)容CleanCache返回值及含義E_NET_OK刪除成功E_NET_NO_INITsdk未初始化//允許p2p下載Yfnet.EnableP2pDownload(true);//禁止p2p下載Yfnet.EnableP2pDownload(false);EnableP2pDownload：設(shè)置是否允許p2p下載參數(shù)名類型說明statusbooleantrue為允許p2p下載，false為禁止p2p下載EnableP2pDownload返回值及含義E_NET_OK設(shè)置成功E_NET_NO_INITsdk未初始化//允許p2p上傳Yfnet.EnableUpload(true)