獨立授權
更新時間：2024-10-21 09:33:43
功能路徑
课节管理 → 课节详情 → 观看条件 → 独立授权
功能介紹
開啟直播觀看頁面時，URL 需帶上指定的參數，經直播系統驗證請求合法後，直接進入直播觀看頁面，同時將使用者所傳參數作為觀看頁面的觀眾資訊進行設定。要求介面回傳的觀眾帳號具有唯一性，即同一個帳號不能在兩個地方同時登入，較早登入的帳號會被踢出。
選擇觀看條件為獨立授權，系統自動生成。
授權流程詳解
- 將頻道設定為獨立授權後，透過後台或 API 介面取得使用者獨立授權觀看條件的 secretkey。
- 在請求保利威直播觀看頁面時，需帶上相關參數，例如：
https://s.vclass.com/live-web-hi-class/student/tokenLogin?lessonId=xx&viewerId=1b448be323×tamp=1498547407000&sign=dd9dc9e42ad7c0204398e925a4ee0f46&name=viewerTests&avatar=http://livestatic.videocc.net/assets/wimages/missing_face.png
- 互動學堂系統會對使用者提交的 sign 參數值進行比對，判斷是否合法。一次成功請求後，該連結將失效（sign 只能成功使用一次）。如果合法，直播系統將使用 nickname、viewerId、avatar，進入保利威視直播觀看頁面聊天區後，將顯示學員的暱稱和頭像。如果驗證失敗，則顯示錯誤頁面。
請求參數描述
| 參數名 | 必選 | 類型 | 說明 |
|---|---|---|---|
| lessonId | true | Long | 課節 ID |
| viewerId | true | String | 觀眾 ID，需保證唯一性（長度最大 64 位字元）（僅支援英文大小寫、數字和底線） |
| timestamp | true | Long | 當前 13 位毫秒級時間戳，3 分鐘內有效 |
| sign | true | String | 用於校驗的簽名，生成規則為 secretkey + viewerId + secretkey + timestamp 拼接起來（注意沒有加號和空格）進行 MD5 加密，為 32 位大寫的 MD5 值 |
| name | true | String | 觀眾暱稱，需進行 URL 安全的 Base64 編碼 |
| avatar | false | String | 觀眾頭像的 URL 地址 |
注意事項
簽名：注意 sign 值為 32 位 MD5 大寫。
