操作步驟

1. 創建Client對象。

   import DingRTC from 'dingrtc';
   
   const client = DingRTC.createClient();

2. 加入頻道。

   await client.join({
    	appId: joinInfo.appId,
    	token: joinInfo.token,
    	uid: joinInfo.uid,
    	channel: joinInfo.channel,
    	userName: joinInfo.userName,
   });

   加入頻道所需信息:

   屬性	類型	描述
   appId	string	您在 DingRTC 項目的 AppId，僅支持大小寫字母、數字和下劃線。
   channel	string	頻道 Id，字符內容只允許[A-Za-z0-9_-]，長度不超過64個字符。
   token	string	頻道鑒權令牌
   uid	string	標識用戶的 Id，字符內容只允許[A-Za-z0-9_-]，長度不超過64個字符。 說明 同一個用戶Id在其他端登錄，先入會的端會被后入會的端踢出頻道。
   userName	string	用戶名稱，長度不超過UTF-8編碼64個字節。

3. 發布或取消發布本地音視頻軌道。

   • 創建本地音頻軌道和視頻軌道

     // 攝像頭軌道
     const cameraTrack = await DingRTC.createCameraVideoTrack({
       frameRate: 15,
       dimension: 'VD_1280x720',
     });
     // 麥克風軌道
     const micTrack = await DingRTC.createMicrophoneAudioTrack();

     說明

     創建完成后可通過play方法進行本地預覽,例如：

     cameraTrack.play('#local');
     micTrack.play();

   • 發布本地音頻軌道和視頻軌道

     client.publish([cameraTrack, micTrack]);

   • 取消發布本地音頻軌道和視頻軌道

     client.unpublish([cameraTrack, micTrack]);

4. 訂閱或取消訂閱遠程流。

   • 訂閱遠端音視頻

     請在加入房間前在Client對象上監聽"user-published"事件，以確保不會錯過遠端用戶發布音視頻軌道的通知，在此事件對應的回調中可通過subscribe()來訂閱遠端用戶的音視頻軌道；

     client.on('user-published', (user, mediaType, auxiliary) => {
       client.subscribe(user.userId, mediaType, auxiliary).then((track) => {
         track.play(`#uid${user.userId}`);
       });
     });

     或者從客戶端實例上的remoteUsers屬性上，訂閱指定遠端用戶發布的音視頻軌道；

     for (const user of client.remoteUsers) {
       if (user.hasVideo) {
         client.subscribe(user.userId, 'video').then((track) => {
           track.play(`#uid${user.userId}`);
         });
       }
       if (user.hasAudio && mcuNotSubscribed) {
         mcuNotSubscribed = true;
         client.subscribe('mcu', 'audio').then((track) => {
           track.play();
         });
       }
     }

     說明

     當前還未支持指定到個人的音頻訂閱，請需要訂閱音頻時將userId 置為字符串'mcu'，代表訂閱的是頻道內遠端用戶合流后的音頻,音頻合流全局只需訂閱一次，當遠端有新用戶發布音頻流時會自動合入已訂閱的mc音頻流內。

   • 取消訂閱遠端音視頻

     client.unsubscribe(user.userId, 'video'); // 取消訂閱用戶的視頻軌道
     client.unsubscribe('mcu', 'audio'); // 取消訂閱遠端音頻合流的音頻軌道

     說明

     當前還未支持指定到個人的音頻訂閱，請需要取消訂閱音頻時將userId 置為字符串'mcu'，代表取消訂閱的是頻道內遠端用戶合流后的音頻，音頻合流全局亦只需取消訂閱一次。

   • 訂閱不同規格視頻流

     當前訂閱視頻規格有high和low兩種，默認為high，如果您需要修改指定用戶的訂閱視頻軌道為流暢模式，請調用以下接口：

     client.setRemoteVideoStreamType(user.userId, 'low');

     或者修改全局默認訂閱視頻規格：

     client.setRemoteDefaultVideoStreamType('low');

     說明

     1. 此接口作用于后續入會的遠端用戶，對于調用此接口之前已經入會的遠端用戶，此接口不會產生影響;

     2. WebSDK 3.3.0 版本及以后版本針對上面兩個接口新增訂閱視頻規格FHD、HD、SD、LD 四種，詳情查看RemoteStreamType，同時保留舊版本的high、low 兩種，分別對應與FHD與LD。默認值為high或FHD，代表當前遠端用戶已發布的最高分辨率，例如：若遠端發布1080P, FHD或high代表要訂閱的視頻規格為1080P，若遠端發布480P,則FHD或high代表要訂閱的視頻規格為480P;

5. 離開頻道。

   client.leave();