操作步驟

1. 創(chuàng)建Client對象。

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

2. 加入頻道。

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

   加入頻道所需信息:

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

3. 發(fā)布或取消發(fā)布本地音視頻軌道。

   • 創(chuàng)建本地音頻軌道和視頻軌道

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

     說明

     創(chuàng)建完成后可通過play方法進行本地預(yù)覽,例如：

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

   • 發(fā)布本地音頻軌道和視頻軌道

     client.publish([cameraTrack, micTrack]);

   • 取消發(fā)布本地音頻軌道和視頻軌道

     client.unpublish([cameraTrack, micTrack]);

4. 訂閱或取消訂閱遠(yuǎn)程流。

   • 訂閱遠(yuǎn)端音視頻

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

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

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

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

     說明

     當(dāng)前還未支持指定到個人的音頻訂閱，請需要訂閱音頻時將userId 置為字符串'mcu'，代表訂閱的是頻道內(nèi)遠(yuǎn)端用戶合流后的音頻。指定到個人的音頻訂閱將在近期支持。

   • 取消訂閱遠(yuǎn)端音視頻

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

     說明

     當(dāng)前還未支持指定到個人的音頻訂閱，請需要取消訂閱音頻時將userId 置為字符串'mcu'，代表取消訂閱的是頻道內(nèi)遠(yuǎn)端用戶合流后的音頻。指定到個人的音頻的取消訂閱將在近期支持。

   • 訂閱不同規(guī)格視頻流

     當(dāng)前訂閱視頻規(guī)格有high和low兩種，默認(rèn)為high，如果您需要修改指定用戶的訂閱視頻軌道為流暢模式，請調(diào)用以下接口：

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

     或者修改全局默認(rèn)訂閱視頻規(guī)格：

     client.setRemoteDefaultVideoStreamType('low');

     說明

     此接口作用于后續(xù)入會的遠(yuǎn)端用戶，對于調(diào)用此接口之前已經(jīng)入會的遠(yuǎn)端用戶，此接口不會產(chǎn)生影響。

5. 離開頻道。

   client.leave();