簡介

1.基本描述

  保利威直播源自公司多年影片技術累積，基於專業的跨平台影片編解碼技術和大規模影片內容分發網路，提供穩定流暢、低延遲、高並發的即時音視訊服務。

  保利威互動學堂Java SDK讓您不用複雜程式設計即可輕鬆接入保利威直播視訊雲服務，實現雲直播相關視訊服務。

  保利威互動學堂Java SDK依託保利威互動學堂API實現，對其進行包裝和最佳化。解放B端用戶的共性工作。將API呼叫邏輯和異常處理進行了封裝最佳化，B端用戶只需將請求參數封裝後，交給保利威互動學堂Java SDK處理即可，保利威互動學堂Java SDK處理完成後返回結果，B端依據返回資料繼續完成B端業務邏輯。現階段保利威互動學堂Java SDK涵蓋了頻道管理、觀看管理、直播互動、聊天室、播放器等絕大部分經常使用的API操作。

  如果您在使用保利威互動學堂Java SDK的過程中遇到任何問題，直接使用線上客服找到售後技術支援提問。請將問題的執行環境、操作步驟、錯誤回饋資訊、聯絡方式同步提交，便於問題的快速定位和解決。

2.SDK整體設計

1.B端管理員透過SDK建立課節基本資訊，例如課節名稱、課節開始時間等基本屬性；

2.B端管理員透過SDK對課節進行基本的資訊設定，例如觀看條件設定、上課時長、上課老師、連麥人數等設定；

3.C端講師透過網頁登入課節，開始上課；

4.C端學生透過上課連結進入，開始聽課；

5.B端待課程結束後，進行回放、統計分析資料獲取，完成互動學堂業務閉環；

3.SDK詳細設計

4.SDK業務邏輯分析

 * 前置條件：SDK全域初始化：在呼叫SDK前必須配置全域參數，可配置參數包括帳戶資訊（appId、userId、appSecret) 和HTTP連線池參數（timeout、maxClientNum)，具體請見 初始化

 * SDK全域參數注入：SDK將全域配置的參數，注入到請求物件中；

 * 簽名生成：SDK採用MD5演算法簽名規則，生成簽名；

 * 參數合法性校驗：SDK採用自訂參數校驗工具對輸入參數進行校驗，如有參數不合格，將拋出PloyvSdkException異常，exception的message包括具體校驗不通過的欄位資訊，此異常是執行時期異常，必須捕獲處理相關業務邏輯；

 * 發送HTTP請求，獲取返回資料：SDK在初始化階段初始化了一個HTTP連線池，所有SDK請求都是透過該連線池來發送請求；

 * 解析返回資料：解析返回資料，如SDK呼叫正常成功，將封裝回應物件，正常返回，如伺服器返回錯誤資訊，SDK將拋出PloyvSdkException異常，exception的message包括具體伺服器執行錯誤資訊，此異常是執行時期異常，必須捕獲處理相關業務邏輯；

5.呼叫流程模板

  上述業務流程圖解析到程式碼層次如下，所有對保利威互動學堂Java SDK的呼叫都可以參考如下呼叫模板（全域初始化只需要全域呼叫一次）。