研討會獨立授權

更新時間：2022-08-01 11:00:28

功能介紹

開啟研討會進行參會時，URL需帶上指定的參數，經過研討會系統驗證請求合法後，直接進入研討會參會/主持，同時將使用者所傳參數作為參會人資訊進行設定。

獨立授權流程詳解

將頻道設定為獨立授權後，透過 API 介面取得使用者獨立授權參會條件的 directkey（對應後台主持 SecretKey 或參會 SecretKey）。
在請求保利威研討會時需帶上相關參數，如：https://meet.polyv.net/?channelId=2424333&ts=1628126283856&sign=6a90485fe4682c0c7621b388df2eb744&nickname=xou&role=attendee&userid=user13
研討會系統會對使用者提交的 sign 參數的值做比較判斷是否合法，一次成功請求後，該連結將失效（sign 只能成功使用一次），如果合法，研討會系統將使用 nickname，進入到保利威視研討會中。如果驗證失敗，則顯示錯誤頁面。

請求參數描述

參數名	必選	類型	說明
channelId	true	Long	頻道號
ts	true	Long	當前 13 位毫秒級時間戳，3 分鐘內有效
sign	true	String	用於校驗的簽名，生成規則是 directKey + channelId + directKey + ts 進行 MD5 加密（directKey 對應後台主持 SecretKey 或參會 SecretKey），sign 校驗時不區分大小寫
nickname	true	String	參會暱稱，需要進行 url 安全的 base64 編碼
role	true	String	研討會參會的角色 host：主持人 attendee：參會人
userid	false	String	參會 ID，需要保證唯一性（長度最大 64 位字元）（僅支援英文大小寫、數字和底線）
avatar	false	String	參會頭像的 url 地址
param4	false	String	統計參會觀看日誌的自訂參數，需要先進行 base64 加密後再進行 urlencode
param5	false	String	統計參會觀看日誌的自訂參數，需要先進行 base64 加密後再進行 urlencode

程式碼範例（Java）

    //TODO 设置为独立授权的directKey
    private static final String DIRECT_SECRET_KEY = "******";
    
    public static void main(String[] args) throws UnsupportedEncodingException, NoSuchAlgorithmException {
        String url = "https://meet.polyv.net/";
        //TODO 设置为独立授权的频道号
        String channelId = "2424333";
        String ts = String.valueOf(System.currentTimeMillis());
        String nickname = URLEncoder.encode(new BASE64Encoder().encode("保利威".getBytes(StandardCharsets.UTF_8)), "GBK");
        String sign = DIRECT_SECRET_KEY+channelId+DIRECT_SECRET_KEY+ts;
        sign = LiveSignUtil.md5Hex(sign);
        url += "?channelId="+channelId+"&ts="+ts+"&sign="+sign+"&nickname="+nickname+"&role="+role;
        //浏览器直接访问url即可进入研讨会
        System.out.println(url);
    }

注意事項

主持人只能登入一個，主持人不能重複登入
userid 如果傳入，則要保證提交的 userid 的唯一性，當多個參會人使用同一個 userid 進入觀看頁時，較早登入的參會人會被後面登入的參會踢出