簡介

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的呼叫都可以參考如下呼叫模板（全域初始化只需要全域呼叫一次）。