Android系統(tǒng)上的 “自助式網(wǎng)絡(luò)直播SDK”技術(shù)方案

《Android系統(tǒng)上的 “自助式網(wǎng)絡(luò)直播SDK”技術(shù)方案》由會(huì)員分享，可在線閱讀，更多相關(guān)《Android系統(tǒng)上的 “自助式網(wǎng)絡(luò)直播SDK”技術(shù)方案（13頁珍藏版）》請(qǐng)?jiān)谘b配圖網(wǎng)上搜索。

1、 Android 系統(tǒng)上的 “自助式網(wǎng)絡(luò)直播SDK”技術(shù)方案 目錄 一、 簡(jiǎn)介 3 三、 權(quán)限開通申請(qǐng) 3 四、 SDK 使用準(zhǔn)備 3 1、 下載 SDK&DEMO 3 2、 開發(fā)環(huán)境要求 3 3、 需要導(dǎo)入的 Jar 4 4、 動(dòng)態(tài)庫 SO 4 5、 權(quán)限及配置 4 6、 代碼混淆 5 五、 快速接入介紹 5 1、 權(quán)限認(rèn)證信息配置 5 2、 發(fā)起直播流程 5 3、 觀看直播流程 5 4、 基礎(chǔ)功能說明 6 5、

2、響應(yīng)事件（回調(diào)） 6 6、 發(fā)起直播詳解 7 7、 RTMP觀看直播詳解 8 8、 HLS觀看直播及HLS觀看回放 9 9、 支持文檔演示 10 六、 DEMO簡(jiǎn)介 10 七、 第三方K值認(rèn)證 11 1、 認(rèn)證流程 11 2、 開啟設(shè)置 11 3、 K 值使用 11 一、 簡(jiǎn)介 本文檔為了指導(dǎo)開發(fā)者更快使用Android系統(tǒng)上的“自助式網(wǎng)絡(luò)直播服務(wù)SDK”，默認(rèn)讀 者已經(jīng)熟悉IDE的基本使用方法（本文以Eclipse為例），以及具有一定的編程知識(shí)基礎(chǔ)等。 支持的產(chǎn)品特性如下: 分類 特性名稱 描述 發(fā)起直播 支持編碼類型 音頻編碼：AAC，

3、視頻編碼：H.264 支持推流協(xié)議 RTMP 視頻分辨率 640*480 屏幕朝向 橫屏、豎屏 閃光燈 開/關(guān) 靜音 開/關(guān) 切換攝像頭 前、后置攝像頭 目標(biāo)碼率 使用軟編，碼率固定在300-400之間，暫不可修改 支持環(huán)境 Android4.0 以上， 觀看直播 支持播放協(xié)議 RTMP/HLS 延時(shí) RTMP:2-4 秒，HLS： 20 秒左右 支持解碼 H.264 文檔演示 （new） 支持文檔演示 文檔可與視頻冋步演示 觀看回放 支持協(xié)議 HLS 權(quán)限 第三方K值認(rèn)證 支持客戶自己的權(quán)限驗(yàn)證機(jī)制來控制觀看直播、觀看

4、 回放的權(quán)限 其它 代碼安全 支持代碼混淆 二、 權(quán)限開通申請(qǐng) 請(qǐng)點(diǎn)擊 API&SDK 權(quán)限申請(qǐng) 立即溝通申請(qǐng)，申請(qǐng)后客戶經(jīng)理會(huì)在線上與您直接聯(lián)系。 審核通過后，可以獲取開發(fā)應(yīng)用的權(quán)限信息：App_Key、Secret_Key、AppSecret_Key。 三、 SDK 使用準(zhǔn)備 1、 下載 SDK&DEMO 2、 開發(fā)環(huán)境要求 Pc 操作系統(tǒng)： 64window 系統(tǒng) JDK:1.6 以上 Eclipse: 建議使用官方已經(jīng)集成的 Eclipse, 謹(jǐn)慎使用 Androidstudio Android:4.0 以上 備注：Android設(shè)備操作系統(tǒng)需要4.0以上

5、，需要訪問手機(jī)硬件,暫不支持模擬器開發(fā) 3、 需要導(dǎo)入的 Jar Vhallsdk.jar 4、 動(dòng)態(tài)庫 SO Libdynload.so Libffmpeg.so Libjingle.so libstlport_shared.so libVinnyLive.so 5、 權(quán)限及配置

6、rmission android:name="android.permission.RECORD_AUDIO" /> 備注：主要是訪問網(wǎng)絡(luò).Wife?還有手機(jī)硬件的Camera 6、 代碼混淆 若 app 打包需要進(jìn)行代碼混淆，請(qǐng)?zhí)砑樱? -dontwarn - com.vhall.** -dontwarn - com.vinny.** -keep class com.vhall.**{*;} -keep class com.vinny.**{*;} 四、 快速接入介紹 1、 權(quán)限認(rèn)證信息配置 以下信息配置到文件里。文件名稱：s

9、rc\com\example\rtmpdemo\Constants.java publicclassConstants{ publicstaticfinalStringAPP_KEY=""; publicstaticfinalStringAPP_SECRET_KEY=""; } 其中：App_Key、App_Secret_Key：從此頁面獲取到， 2、 發(fā)起直播流程 第一步 預(yù)覽采集 Camera： 在 Activity 的 onCreate 方法中，創(chuàng)建 CameraNewView ，并且初始化 第二步 發(fā)起直播： 設(shè)置開始按鈕，在可點(diǎn)擊情況下調(diào)用 NativeLive.Sta

10、rtPublish(String Url)。 第三步 建立 Socket 發(fā)起直播成功后 ，連接 Socket 建立參會(huì) new ZReqEngine().new Attend() 第四步 停止直播： 設(shè)置停止按鈕，在可點(diǎn)擊情況下調(diào)用 NativeLive.StopPublish() 3、 觀看直播流程 第一步 創(chuàng)建觀看 View 在 Activity 的 onCreate 方法中，創(chuàng)建 PlayView ，并且初始化 第二步 開始觀看 NativeLive.StartRecv(String watchUrl) 第三步 停止觀看 NativeLive.StopRecv() 4

11、、 基礎(chǔ)功能說明 備注： 以下功能根據(jù)各自需求自行選取使用，設(shè)置后即可顯示 Step 1 :初始化播放器 PlayView playview = new PlayView(GLSurfaceView) playview.init(with,height) playview.updataScreen(byte [] Y ,byte [] U ,byte [] V ) playview.updataScreenAll(byte [] YUV) Step 2 : 初始化音頻 AudioPlay audio = new AudioPlay() Audio.init(int sampleRa

12、te, int channelConfig, int audioFormat) Audio.play(byte[] data, int size) Audio.destory() Step 3 : 使用自定義 CameraNewView 自定義view已經(jīng)對(duì)手機(jī)攝像頭(Camera)做好了處理，實(shí)時(shí)采集每一幀數(shù)據(jù)，包括 攝像頭的切換，閃光的開啟，用戶可以自行調(diào)用。 mCameraView=(CameraNewView) this.findViewById(R.id.cameraview); 5、 響應(yīng)事件(回調(diào)) 直播觀看過程中的回調(diào) LiveCallback: 在你當(dāng)前開啟直播的

13、頁面，初始化直播回調(diào)： LiveCallback livecallback = new LiveCallback ; 實(shí)現(xiàn)其中的回調(diào)方法： public void notifyVideoData(byte[] data) public int notifyAudioData(byte[] data, int size) public void notifyEvent(int resultCode, String content) public void onH264Video(byte[] data, int size, int type) 在當(dāng)前 Activity onCreate

14、 方法中加入回調(diào) LiveObs.setCallBack(livecallback); 其中 notifyEvent(resultCode ， content) 返回的 resultCode 是底層定義的直播狀態(tài)， 需要用戶對(duì)其自行處理。 狀態(tài)定義如下： = 0; //直播連接服務(wù)器成 public static final int OK_PublishConnect public static final int ERROR_PublishConnect = 1; //直播連接服務(wù)器失敗 public static final int OK_WatchConnect = 2; //

15、觀看直播連接服務(wù)器成功 public static final int ERROR_WatchConnect = 3;//觀看直播連接服務(wù)器失敗 public static final int StartBuffering public static final int StopBuffering public static final int ERROR_Param = 4;//開始緩沖 = 5;// 停止緩沖 = 6;// 錯(cuò)誤參數(shù) public static final public static final public static final public

16、 static final public static final public static final public static final int ERROR_NeedReconnect int ERROR_Send int INFO_Speed_Upload int INFO_Speed_Download int INFO_NetWork_Status int INFO_Decoded_Video int INFO_Decoded_Audio = 7;// 錯(cuò)誤 需要重新連接 = 8;// 發(fā)送直播流失敗 = 9;// 上傳速度 Kbps 單位 = 10;// 下載速度

17、Kbps 單位 = 11;// 網(wǎng)絡(luò)狀態(tài) 12;//視頻解碼 13;//音頻解碼 public static final int INFO_Record_Audio = 20;//錄音 6、 發(fā)起直播詳解 用戶使用 VhallSDK 發(fā)起直播 需要首先了解幾個(gè)重要的類 LiveParam 直播中所需的重要參數(shù)（這些參數(shù)會(huì)被傳入底層，錯(cuò)誤的參數(shù)會(huì)讓 Activity 報(bào)錯(cuò) ，目前默認(rèn)使用分辨率 640*480 更高的分辨率暫不支持） ConnectionChangeReceiver 用來檢測(cè)網(wǎng)絡(luò)變化 定義的一些常量 public static final int NET_E

18、RROR = 0; public static final int NET_UNKNOWN = 1; public static final int NET_2G3G = 2; public static final int NET_WIFI = 3; 第一步 初始化直播信息 創(chuàng)建 Activity ，初始化自定義 view CameraNewView , 此時(shí)的 CameraNewView 被創(chuàng)建， 開啟PreviewCallback回調(diào)，實(shí)現(xiàn)onPreviewFram(),獲取Camera采集的每一幀的數(shù)據(jù)， 將此數(shù)據(jù)傳遞底層處理 mCameraView = (CameraNe

19、wView) this.findViewById(R.id.cameraview); mCameraView.init(param, this, new RelativeLayout.LayoutParams(0, 0)); mCameraView.startPublish() // 此方法須直播回調(diào)中返回 OK_PublishConnect 才能 調(diào)用 此處代碼必須添加 NativeLive.CreateVinnyLive(); // 創(chuàng)建 VinnyLive 對(duì)象 LiveObs.setCallback(mLiveCallBack); // 設(shè)置直播回調(diào) Nati veLive.En

20、ableDebug( true); // 是否打開 Debug 模式 (會(huì)打印日志) NativeLive.AddObs(); //添加直播的監(jiān)聽 第二步 創(chuàng)建 button ， 開啟直播 。 這時(shí)調(diào)用底層方法，連接推流地址，需要傳遞一個(gè)參數(shù)Pa th , Pa th為流的地址。判 斷這個(gè)方法，如果返回的是0 ，則連接成功 ，返回非0，則連接失敗 NativeLive.StartPublish（path） // 連接推流地址 第三步 處理直播時(shí)的回調(diào) 當(dāng)直播成功之后，處理直播時(shí)時(shí)返回的信息 ，詳細(xì)方法可以參考直播過程的回調(diào) LiveCallback , 處理方案根據(jù)各自需求自行處理。

21、 第四步 停止直播 CameraView.stopPublish(); NativeLive.StopPublish() 7、 RTMP 觀看直播詳解 第一步 初始化 PlayView AudioPlay playView 初始化時(shí)需要傳入 GLSurfaceView , 使用它需要用戶自定義一個(gè)渲染器 (render)不過這里在初始化時(shí)已經(jīng)定義好，用戶可以直接使用 mPlayView = new PlayView(glSurfaceview); mPlayView.init(width , height) // 傳入初始化的寬高; 此處代碼必須添加 NativeLive.Cre

22、ateVinnyLive(); // 創(chuàng)建 VinnyLive 對(duì)象 LiveObs.setCallback(mLiveCallBack); // 設(shè)置直播回調(diào) NativeLive.EnableDebug(true); // 是否打開 Debug 模式 (會(huì)打印日志) NativeLive.AddObs(); //添加直播的監(jiān)聽 獲取用戶的活動(dòng)ID (此ID需要在PC上取得)， 請(qǐng)求 ZReqEngine.watch(id , APP_KEY , APP_SECRET_KEY , name , email , password , new ReqCallback()) @param

23、 id //活動(dòng)ID必傳 @param APP_KEY // app_key @param APP_SECRET_KEY // app_secret_key @param name // 必傳 @param email // 必傳且保證唯一性 @param password // 活動(dòng)如果有 K 值需要傳 @callback ReqCallback // 傳入回調(diào) 獲取返回的參數(shù) 請(qǐng)求成功之后，會(huì)在ReqCallback OnSuccess()返回Json參數(shù)。 @result rtmp_video @result video @result status

24、@result msg_server @result msg_token // rtmp 觀看直播地址 // hls 觀看直播回放地址 // 當(dāng)前播放狀態(tài) // 建立參會(huì) // 建立參會(huì) 請(qǐng)求失敗之后，會(huì)在ReqCallback OnFail()返回信息，直接打印即可 建立參會(huì)，參會(huì)建立成功，可以統(tǒng)計(jì)參會(huì)人數(shù)。 ZReqEngine.Attend attend = new ZReqEngine().new Attend(msg_server, msg_token); 第二步 創(chuàng)建 button 開始觀看 將之前獲取的觀看地址傳入當(dāng)前方法 Natiive.StarRecv(

25、path) // 連接接受地址 0 則連接成功 ，非 0 則連接失敗 第三步 處理直播時(shí)的回調(diào) 這時(shí)會(huì)用到 LiveCallback 中的方法 public void notifyVideoData(byte[] data) //得到正在直播的視頻數(shù)據(jù) 這時(shí)調(diào)用 UpdateScreenAll() , 將取得的視頻信息傳給 PlayView mPlayView.UpdateScreenAll(data) public int notifyAudioData(byte[] data, int size) // 得到正在直播的音頻數(shù) 據(jù) 這時(shí)調(diào)用 play() , 將取得的視頻信息傳給

26、 AudioPlay 備注 : notifyEvent() 依然需要調(diào)用 第四步 停止觀看 NativeLive.StopRecv() stopAudioPlay attend.disAttend(); // 關(guān)閉參會(huì) 8、 HLS觀看直播及HLS觀看回放 初始化 VhallHlsPlayer ，實(shí)現(xiàn) VhallHLSPlayer.Listener 需要用戶設(shè)置 SurfaceView String userAgent = Util.getUserAgent(this, "VhallAPP"); mMediaPlayer = new VhallHlsPlayer(new HlsRe

27、ndererBuilder(this, userAgent, path)); // 這里需要傳入地址 mMediaPlayer.addListener(mVhallPlayerListener); mMediaPlayer.setSurface(Surface); // 設(shè)置 SurfaceView mMediaPlayer.setPlayWhenReady(true) // 為 true 的時(shí)候開始播放 實(shí)現(xiàn) VhallHLSPlayer.Listener 所需實(shí)現(xiàn)的方法如下 public void onStateChanged(boolean playWhenReady, int p

28、laybackState) {} // 當(dāng) 播放狀態(tài)發(fā)生改變的時(shí)候 public void onError(Exception e) {} // 播放錯(cuò)誤的時(shí)候 public void onVideoSizeChanged(int width, int height, int unappliedRotationDegrees,float pixelWidthHeightRatio) {} // Video 尺寸發(fā)生改變的時(shí) 候 獲取播放地址之前需要先獲取用戶的活動(dòng)ID (通過服務(wù)器接口獲取) 請(qǐng)求 ZReqEngine.watch(id , APP_KEY , APP_SECRET_K

29、EY , name , email , password , new ReqCallback()) @param id //活動(dòng)ID必傳 @param APP_KEY // app_key @param APP_SECRET_KEY // app_secret_key @param name // 必傳，參會(huì)人員姓名，用于統(tǒng)計(jì) @param email // 必傳且保證唯一性，參會(huì)人員郵箱，用于統(tǒng)計(jì)，并做為用 戶的唯一標(biāo)識(shí) @param password // 可選，活動(dòng)如果有 K 值需要傳 @callback ReqCallback // 傳入回調(diào) 獲取返回

30、的參數(shù) 請(qǐng)求成功之后，會(huì)在ReqCallback OnSuccess()返回Json參數(shù) @result rtmp_video @result video @result status @result msg_server @result msg_token // rtmp 觀看直播地址 // hls 觀看直播回放地址 // 當(dāng)前播放狀態(tài) // 建立參會(huì) // 建立參會(huì) 請(qǐng)求失敗之后，會(huì)在ReqCallback OnFail()返回信息，直接打印即可 建立Socket連接參會(huì)，建立成功后，可以統(tǒng)計(jì)參會(huì)人數(shù)。 ZReqEngine.Attend attend = ne

31、w ZReqEngine().new Attend(msg_server, msg_token); 9、 支持文檔演示 當(dāng)直播活動(dòng)類型為“視頻+文檔”或“音頻+文檔”時(shí)，通過以下方法可集成觀看，文檔會(huì) 與視頻或音頻播放同步。 public class ClassName implements ZReqEngine.FlashMsgListener //觀看直播頁 面實(shí)現(xiàn)此接口用于處理文檔翻頁消息 ZReqEngine.Attend attend;// 參會(huì) 用于統(tǒng)計(jì)參與人數(shù) 接收文檔 聊天等即時(shí)消息 attend = new ZReqEngine().new Attend(msg_ser

32、ver, msg_token); att end.se tFlashMsgLis tener( this);//設(shè)置文檔翻頁消息接口 att end.a tt end();//參會(huì) 參會(huì)后可接受文檔翻頁消息 @Override publicvoidonFlash(StringflashMsg){ //當(dāng)直播文檔翻頁時(shí)，通過此回調(diào)處理消息， flashMsg 為 json 數(shù)據(jù) //具體處理請(qǐng)看 demo } attend.disAttend(); //退出觀看時(shí)取消參會(huì) 五、 DEMO 簡(jiǎn)介 1、 DEMO 簡(jiǎn)介 DEMO只針對(duì)核心功能進(jìn)行演示，不包括UI界面設(shè)計(jì)。 2、

33、 主要測(cè)試參數(shù)說明： 1) 活動(dòng)ID：指的是客戶創(chuàng)建的一個(gè)直播活動(dòng)的唯一標(biāo)識(shí)，Demo測(cè)試時(shí)可從 的控制臺(tái)頁面上獲取到 2) Token： Demo 測(cè)試時(shí)可從頁面調(diào)用接口獲取到，有效期為 24 小時(shí) 3) 碼率設(shè)置：主要用于視頻編碼設(shè)置，碼率與視頻的質(zhì)量成正比，默認(rèn)值 300，單位 Kbps 4) 緩沖時(shí)間：延時(shí)觀看時(shí)間 5) 分辨率： 640*480 6) K 值： 默認(rèn)為空，指的是控制直播觀看權(quán)限的參數(shù)，具體使用說明參考 3、 客戶 Server 端需提供給 APP 的信息 客戶 Server 端需要提供如下信息： 1) Id:通過客戶Server端接口獲取到，此接口需調(diào)

34、用VHALL接口獲取。 2) AccessToken：通過客戶Server端接口獲取到，此接口需調(diào)用VHALL接口獲取。 六、第三方K值認(rèn)證 觀看直播、觀看回放的權(quán)限控制，支持使用客戶的權(quán)限驗(yàn)證邏輯。 1、 認(rèn)證流程 第三方認(rèn)liFSer^Br Vhall URL接口 第三方認(rèn)證 2、 開啟設(shè)置 1) 全局設(shè)置： 針對(duì)所有的活動(dòng)配置生效，如果針對(duì)單個(gè)活動(dòng)再做配置，以單個(gè)活動(dòng)配置為最 終配置。通過接口調(diào)用設(shè)置webinar/whole-auth-url全局配置第三方K值驗(yàn)證URL 2) 針對(duì)某個(gè)活動(dòng)的配置方式一：通過頁面配置，數(shù)字表示自己帳號(hào)下的活動(dòng)id 3) 針對(duì)某個(gè)活動(dòng)

35、的配置方式二：通過接口(webinar/create或webinar/update)設(shè)置 3、 K值使用 1)網(wǎng)頁嵌入或SDK里的調(diào)用方法，請(qǐng)務(wù)必帶上k參數(shù)，如果這個(gè)參數(shù)為空或者沒有這個(gè)參數(shù)， 則視為認(rèn)證失敗 ?網(wǎng)頁嵌入地址類似： ? SDK里的調(diào)用方法，需要傳遞3個(gè)參數(shù)name,email,pass email:可選參數(shù)，如果不填寫系統(tǒng)會(huì)隨機(jī)生成郵箱地址。由于ema訂自身的唯一性，我們 推薦使用email來作為唯一標(biāo)識(shí)有效用戶的字段。對(duì)于第三方自有用戶數(shù)據(jù)的系統(tǒng)，也可 以使用一些特征ID作為此標(biāo)識(shí)，請(qǐng)以emai l的格式組織，比如在第三方系統(tǒng)中，用戶ID為 123456，可在其后添

36、加一個(gè)@,組成 形式的email地址。 name: 可選參數(shù)，如果不填寫系統(tǒng)會(huì)隨機(jī)生成。此字段表示用戶昵稱、姓名或其他有意義 的字符串?？梢詾橹形?，但必須為UTF-8，且經(jīng)過URL編碼(urlencode)。 k：可選參數(shù)，此字段為了提供給第三方可以根據(jù)自己的權(quán)限系統(tǒng)，驗(yàn)證客戶是否可訪問 直播地址。 ZReqEngine.watch(id , APP_KEY , APP_SECRET_KEY , name , email , password , new ReqCallback()) @param id //活動(dòng)ID必傳 @param APP_KEY // app_key

37、 @param APP_SECRET_KEY // app_secret_key @param name // 必傳 @param email // 必傳且保證唯一性 @param password // 活動(dòng)如果有K值需要傳 @callback ReqCallback // 傳入回調(diào) 獲取返回的參數(shù) 觀看直播(僅HLS可用) ZReqEngine.watch(id , APP_KEY , APP_SECRET_KEY , name , email , password , new ReqCallback()) @param id /

38、/活動(dòng)ID必傳 @param APP_KEY // app_key @param APP_SECRET_KEY // app_secret_key @param name // 必傳，參會(huì)人員姓名，用于統(tǒng)計(jì) @param email // 必傳且保證唯一性，參會(huì)人員郵箱，用于統(tǒng)計(jì)，并做為用 戶的唯一標(biāo)識(shí) @param password // 可選，活動(dòng)如果有K值需要傳 @callback ReqCallback // 傳入回調(diào) 獲取返回的參數(shù) 2) Vhall系統(tǒng)收到用戶的接口訪問請(qǐng)求后，會(huì)向第三方認(rèn)證URL(au th_ur l)發(fā)送HT

39、TP POST請(qǐng) 求，同時(shí)將email和k值作為POST數(shù)據(jù)提交 給第三方認(rèn)證。由第三方系統(tǒng)驗(yàn)證k值的合法性。如 果認(rèn)證通過，第三方認(rèn)證URL(auth_url)返回字符串pass,否則的返回fail 注：需要確保您的回調(diào)地址支持 multipart/form-data 方式接收 post 數(shù)據(jù)。 3) Vhall系統(tǒng)根據(jù)第三方認(rèn)證URL返回值判斷認(rèn)證是否成功。只有收到pass，才能認(rèn)定為驗(yàn) 證成功，否則一律跳轉(zhuǎn)到指定的認(rèn)證失敗URL，或者提示'非法訪問’ 4) 參數(shù)特征 URL請(qǐng)求很容易被探測(cè)截獲，這就要求第三方系統(tǒng)生成的K值必須有以下特征： ? 唯一性：每次調(diào)用接口必須產(chǎn)生不同的K值 ? 時(shí)效性：設(shè)定一個(gè)時(shí)間范圍，超時(shí)的K值即失效。 ? 如果包含有第三方系統(tǒng)內(nèi)部信息，必須加密和混淆過。 5) 建議的K值實(shí)現(xiàn) 第三方系統(tǒng)可以考慮K值元素包括：用戶ID、Vhall直播ID、時(shí)間戳（1970-01-01至今的秒數(shù)） 元素組合后加密后，使用Base64或者h(yuǎn)ex匹配成URL可識(shí)別編碼。K值在第三方系統(tǒng)中持久化或 放在Cache中 回調(diào)驗(yàn)證時(shí)，根據(jù)時(shí)間戳判斷是否在設(shè)定時(shí)間內(nèi)有效 驗(yàn)證結(jié)束，若認(rèn)證通過，則從DB或Cache中移除K值 DB或Cache建議有時(shí)效性控制，自動(dòng)失效或定期清理過期數(shù)據(jù)