ApsaraVideo Live：Android實現音視訊通話

步驟一：匯入SDK

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 添加ARTC SDK所在的Maven地址
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

allprojects {
    repositories {
        ...
        // 添加ARTC SDK所在的Maven地址
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

dependencies {
    // 引入即時音視頻SDK依賴
    // ${latest_version}替換為具體版本號碼
    implementation 'com.aliyun.aio:AliVCSDK_ARTC:${latest_version}'
    // 7.4.0及以下版本需添加keep
    // implementation 'com.aliyun.aio.keep:keep:1.0.1'
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 添加ARTC SDK所在位置的相對目錄
        flatDir {
            dir 'app/libs'
        }
    }
}

allprojects {
    repositories {
        ...
        // 添加ARTC SDK所在位置的相對目錄
        flatDir {
            dir 'app/libs'
        }
    }
}

//x.y.z替換為對應版本號碼
implementation(name:'AliVCSDK_ARTC', version: 'x.y.z', ext:'aar')

步驟二：設定項目支援的 CPU 架構

開啟app/build.gradle檔案，在defaultConfig中指定專案支援的 CPU 架構，如下所示。可選架構包括armeabi-v7a、arm64-v8a、x86、x86_64，根據實際需要進行配置。

android {
    defaultConfig {
        // ...其他預設配置
        // 支援 armeabi-v7a 和 arm64-v8a 架構
        ndk {
             abiFilters "armeabi-v7a", "arm64-v8a"
        }
    }
}	

步驟三：設定許可權

根據實際需求設定應用所需的許可權，具體流程如下：

進入app/src/main目錄，開啟AndroidManifest.xml檔案，添加要求的權限。

<uses-feature android:name="android.hardware.camera" android:required="false" /> 
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Request legacy Bluetooth permissions on older devices. -->
<uses-permission
  android:name="android.permission.BLUETOOTH"
  android:maxSdkVersion="30" />
<uses-permission
  android:name="android.permission.BLUETOOTH_ADMIN"
  android:maxSdkVersion="30" />

<!-- Needed only if your app communicates with already-paired Bluetooth devices. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_SETTINGS"
  tools:ignore="ProtectedPermissions" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove"/>

<!-- 聲明藍芽許可權 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<!-- 覆蓋移除高版本API 31+ 許可權 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- 聲明藍芽許可權並設定android:maxSdkVersion為30以相容更低版本裝置 -->
<uses-permission android:name="android.permission.BLUETOOTH"/>
<!-- 聲明高版本API 31+ 藍芽許可權 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<!-- 其他藍芽許可權 -->

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    String[] permissions = {
        android.Manifest.permission.BLUETOOTH_CONNECT
    };
    ActivityCompat.requestPermissions(activity, permissions, REQUEST_BLUETOOTH);
}

<!-- 覆蓋移除ARTC SDK中內建的藍芽許可權聲明 -->
<uses-permission android:name="android.permission.BLUETOOTH" tools:node="remove" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

步驟四：防止混淆代碼（可選）

在app/proguard-rules.pro檔案中，為 SDK 配置規則，防止 SDK 對外提供的介面被混淆導致無法正常調用。

-keep class com.aliyun.allinone.** {
*;
}

-keep class com.aliyun.rts.network.AliHttpTool {
*;
}

-keep class com.aliyun.common.AlivcBase {
*;
}

-keep class com.huawei.multimedia.alivc.** {
*;
}

-keep class com.alivc.rtc.** {
*;
}

-keep class com.alivc.component.** {
*;
}

-keep class org.webrtc.** {
*;
}

常見問題

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

本節介紹如何使用阿里雲 ARTC SDK 快速實現一個基礎的即時音視頻互動應用。你可以先將完整範例程式碼複製到專案，快速體驗功能，再通過以下步驟瞭解核心 API 的調用。

下圖展示了實現音視頻互動的基本流程：

1、申請許可權請求

進入音視訊通話時，檢查是否已在App中授予了所需要的許可權：

private static final int REQUEST_PERMISSION_CODE = 101;

private static final String[] PERMISSION_MANIFEST = {
    Manifest.permission.RECORD_AUDIO,
    Manifest.permission.READ_PHONE_STATE,
    Manifest.permission.WRITE_EXTERNAL_STORAGE,
    Manifest.permission.READ_EXTERNAL_STORAGE,
    Manifest.permission.CAMERA
};

private static final String[] PERMISSION_MANIFEST33 = {
    Manifest.permission.RECORD_AUDIO,
    Manifest.permission.READ_PHONE_STATE,
    Manifest.permission.CAMERA
};

private static String[] getPermissions() {
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
        return PERMISSION_MANIFEST;
    }
    return PERMISSION_MANIFEST33;
}

public boolean checkOrRequestPermission() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        if (ContextCompat.checkSelfPermission(this, "android.permission.CAMERA") != PackageManager.PERMISSION_GRANTED
                || ContextCompat.checkSelfPermission(this, "android.permission.RECORD_AUDIO") != PackageManager.PERMISSION_GRANTED) {
            requestPermissions(getPermissions(), REQUEST_PERMISSION_CODE);
            return false;
        }
    }
    return true;
}

2、鑒權Token

加入ARTC頻道需要一個鑒權Token，用於鑒權使用者的合法身份，其鑒權Token建置規則詳情請參見：Token鑒權。Token 產生有兩種方式：單參數方式和多參數方式，不同的Token產生方式需要調用SDK不同的加入頻道（joinChannel）的介面。

上線發布階段：

由於Token的產生需要使用AppKey，寫死在用戶端存在泄露的風險，因此強烈建議線上業務通過業務Server產生下發給用戶端。

開發調試階段：

開發調試階段，如果業務Server還沒有產生Token的邏輯，可以暫時參考APIExample上的Token產生邏輯，產生臨時Token，其參考代碼如下：

public final class ARTCTokenHelper {
    /**
     * RTC AppId
     */
    public static String AppId = "";

    /**
     * RTC AppKey
     */
    public static String AppKey = "";

    /**
     * 根據channelId，userId, timestamp, nonce 產生單參數入會 的token
     * Generate a single-parameter meeting token based on channelId, userId, and nonce
     */
    public static String generateSingleParameterToken(String appId, String appKey, String channelId, String userId, long timestamp,  String nonce) {

        StringBuilder stringBuilder = new StringBuilder()
                .append(appId)
                .append(appKey)
                .append(channelId)
                .append(userId)
                .append(timestamp);
        String token =  getSHA256(stringBuilder.toString());
        try{
            JSONObject tokenJson = new JSONObject();
            tokenJson.put("appid", AppId);
            tokenJson.put("channelid", channelId);
            tokenJson.put("userid", userId);
            tokenJson.put("nonce", nonce);
            tokenJson.put("timestamp", timestamp);
            tokenJson.put("token", token);
            String base64Token = Base64.encodeToString(tokenJson.toString().getBytes(StandardCharsets.UTF_8), Base64.NO_WRAP);
            return base64Token;
        }catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }

    /**
     * 根據channelId，userId, timestamp 產生單參數入會 的token
     * Generate a single-parameter meeting token based on channelId, userId, and timestamp
     */
    public static String generateSingleParameterToken(String appId, String appKey, String channelId, String userId, long timestamp) {
        return generateSingleParameterToken(appId, appKey, channelId, userId, timestamp, "");
    }

    public static String getSHA256(String str) {
        try {
            MessageDigest messageDigest = MessageDigest.getInstance("SHA-256");
            byte[] hash = messageDigest.digest(str.getBytes(StandardCharsets.UTF_8));
            return byte2Hex(hash);
        } catch (NoSuchAlgorithmException e) {
            // Consider logging the exception and/or re-throwing as a RuntimeException
            e.printStackTrace();
        }
        return "";
    }

    private static String byte2Hex(byte[] bytes) {
        StringBuilder stringBuilder = new StringBuilder();
        for (byte b : bytes) {
            String hex = Integer.toHexString(0xff & b);
            if (hex.length() == 1) {
                // Use single quote for char
                stringBuilder.append('0');
            }
            stringBuilder.append(hex);
        }
        return stringBuilder.toString();
    }

    public static long getTimesTamp() {
        return System.currentTimeMillis() / 1000 + 60 * 60 * 24;
    }
}

3、匯入ARTC SDK 相關類

匯入 ARTC SDK 相關的類和介面：

// 匯入ARTC相關類
import com.alivc.rtc.AliRtcEngine;
import com.alivc.rtc.AliRtcEngineEventListener;
import com.alivc.rtc.AliRtcEngineNotify;

4、建立並初始化引擎

• 建立RTC引擎

  調用getInstance[1/2]介面建立引擎AliRTCEngine

  private AliRtcEngine mAliRtcEngine = null;
  if(mAliRtcEngine == null) {
      mAliRtcEngine = AliRtcEngine.getInstance(this);
  }

• 初始化引擎

  • 調用setChannelProfile設定頻道為AliRTCSdkInteractiveLive（互動模式）。

    根據具體的業務需求，可以選擇適用於互動娛樂情境的互動模式，或者適合一對一或一對多廣播的通訊模式。正確的模式選擇能夠確保使用者體驗的流暢性並有效利用網路資源。您可以根據業務情境選擇合適的模式。

    模式	推流	拉流	模式介紹
    互動模式	有角色限制，只有被賦予主播身份的使用者可以進行推流操作。 在整個過程中，參與者可以靈活地切換角色。	無角色限制，所有參與者都擁有拉流的許可權。	在互動模式中，主播加入或退出會議、以及開始推送直播流的事件都會即時通知給觀眾端，確保觀眾能夠及時瞭解主播的動態。反之，觀眾的任何活動不會通告給主播，保持了主播的直播流程不受幹擾。 在互動模式下，主播角色負責進行直播互動，而觀眾角色則主要接收內容，通常不參與直播的互動過程。若業務需求未來可能發生變化，導致不確定是否需要支援觀眾的互動參與，建議預設採用互動模式。這種模式具有較高的靈活性，可通過調整使用者角色許可權來適應不同的互動需求。
    通訊模式	無角色限制，所有參與者都擁有推流許可權。	無角色限制，所有參與者都擁有拉流的許可權。	在通訊模式下，會議參與者能夠相互察覺到彼此的存在。 該模式雖然沒有區分使用者角色，但實際上與互動模式中的主播角色相對應；目的是為了簡化操作，讓使用者能夠通過調用更少的API來實現所需的功能。

  • 調用setClientRole設定使用者角色為AliRTCSdkInteractive（主播）或者AliRTCSdkLive（觀眾）。注意：主播角色預設推拉流，觀眾角色預設關閉預覽和推流，只拉流。

    說明

    當使用者在頻道內切換角色時，系統會相應調整音視頻流的推流狀態：

    • 從主播切換為觀眾（“下麥”）：系統將停止推送本地音視頻流，但已訂閱的遠端流不受影響，使用者仍可繼續觀看其他人的音視頻。

    • 從觀眾切換為主播（“上麥”）：系統將開始推送本地音視頻流，同時已訂閱的遠端流保持不變，使用者可以繼續觀看其他參與者的內容。

    // 設定頻道模式為互動模式,RTC下都使用AliRTCSdkInteractiveLive
    mAliRtcEngine.setChannelProfile(AliRtcEngine.AliRTCSdkChannelProfile.AliRTCSdkInteractiveLive);
    // 設定使用者角色，既需要推流也需要拉流使用AliRTCSdkInteractive， 只拉流不推流使用AliRTCSdkLive
    mAliRtcEngine.setClientRole(AliRtcEngine.AliRTCSdkClientRole.AliRTCSdkInteractive);

• 設定常用的回調

  SDK 在運行過程中如遇到異常情況，會優先嘗試內部重試機制以自動回復。對於無法自行解決的錯誤，SDK 會通過預定義的回調介面通知您的應用程式。

  以下是一些 SDK 無法處理、需由應用程式層監聽和響應的關鍵回調：

  異常發生原因	回調及參數	解決方案	說明
  鑒權失敗	onJoinChannelResult回調中的result返回AliRtcErrJoinBadToken	發生錯誤時App需要檢查Token是否正確。	在使用者主動調用API時，若鑒權失敗，系統將在調用API的回調中返回鑒權失敗的錯誤資訊。
  鑒權將要到期	onWillAuthInfoExpire	發生該異常時App需要重新擷取最新的鑒權資訊後，再調用refreshAuthInfo重新整理鑒權資訊。	鑒權到期錯誤在兩種情況下出現：使用者調用API或程式執行期間。因此，錯誤反饋將通過API回調或通過獨立的錯誤回調通知。
  鑒權到期	onAuthInfoExpired	發生該異常時App需要重新入會。	鑒權到期錯誤在兩種情況下出現：使用者調用API或程式執行期間。因此，錯誤反饋將通過API回調或通過獨立的錯誤回調通知。
  網路連接異常	onConnectionStatusChange回調返回AliRtcConnectionStatusFailed。	發生該異常時APP需要重新入會。	SDK具備一定時間斷網自動回復能力，但若斷線時間超出預設閾值，會觸發逾時並中斷連線。此時，App應檢查網路狀態並指導使用者重新加入會議。
  被踢下線	onBye	AliRtcOnByeUserReplaced：當發生該異常時排查使用者userid是否相同。 AliRtcOnByeBeKickedOut：當發生該異常時，表示被業務踢下線，需要重新入會。 AliRtcOnByeChannelTerminated：當發生該異常時，表示房間被銷毀，需要重新入會。	RTC服務提供了管理員可以主動移除參與者的功能。
  本地裝置異常	onLocalDeviceException	發生該異常時App需要檢測許可權、裝置硬體是否正常。	RTC服務支援裝置檢測和異常診斷的能力；當本地裝置發生異常時，RTC服務會通過回調的方式通知客戶本地裝置異常，此時，若SDK無法自行解決問題，則App需要介入以查看裝置是否正常。

  private AliRtcEngineEventListener mRtcEngineEventListener = new AliRtcEngineEventListener() {
      @Override
      public void onJoinChannelResult(int result, String channel, String userId, int elapsed) {
          super.onJoinChannelResult(result, channel, userId, elapsed);
          handleJoinResult(result, channel, userId);
      }
  
      @Override
      public void onLeaveChannelResult(int result, AliRtcEngine.AliRtcStats stats){
          super.onLeaveChannelResult(result, stats);
      }
  
      @Override
      public void onConnectionStatusChange(AliRtcEngine.AliRtcConnectionStatus status, AliRtcEngine.AliRtcConnectionStatusChangeReason reason){
          super.onConnectionStatusChange(status, reason);
  
          handler.post(new Runnable() {
              @Override
              public void run() {
                  if(status == AliRtcEngine.AliRtcConnectionStatus.AliRtcConnectionStatusFailed) {
                      /* TODO: 務必處理；建議業務提示客戶，此時SDK內部已經嘗試了各種恢複策略已經無法繼續使用時才會上報 */
                      ToastHelper.showToast(VideoChatActivity.this, R.string.video_chat_connection_failed, Toast.LENGTH_SHORT);
                  } else {
                      /* TODO: 可選處理；增加業務代碼，一般用於資料統計、UI變化 */
                  }
              }
          });
      }
      @Override
      public void OnLocalDeviceException(AliRtcEngine.AliRtcEngineLocalDeviceType deviceType, AliRtcEngine.AliRtcEngineLocalDeviceExceptionType exceptionType, String msg){
          super.OnLocalDeviceException(deviceType, exceptionType, msg);
          /* TODO: 務必處理；建議業務提示裝置錯誤，此時SDK內部已經嘗試了各種恢複策略已經無法繼續使用時才會上報 */
          handler.post(new Runnable() {
              @Override
              public void run() {
                  String str = "OnLocalDeviceException deviceType: " + deviceType + " exceptionType: " + exceptionType + " msg: " + msg;
                  ToastHelper.showToast(VideoChatActivity.this, str, Toast.LENGTH_SHORT);
              }
          });
      }
  
  };
  
  private AliRtcEngineNotify mRtcEngineNotify = new AliRtcEngineNotify() {
      @Override
      public void onAuthInfoWillExpire() {
          super.onAuthInfoWillExpire();
          /* TODO: 務必處理；Token即將到期，需要業務觸發重新擷取當前channel，user的鑒權資訊，然後設定refreshAuthInfo即可 */
      }
  
      @Override
      public void onRemoteUserOnLineNotify(String uid, int elapsed){
          super.onRemoteUserOnLineNotify(uid, elapsed);
      }
  
      //在onRemoteUserOffLineNotify回調中解除遠端視頻流渲染控制項的設定
      @Override
      public void onRemoteUserOffLineNotify(String uid, AliRtcEngine.AliRtcUserOfflineReason reason){
          super.onRemoteUserOffLineNotify(uid, reason);
      }
  
      //在onRemoteTrackAvailableNotify回調中設定遠端視頻流渲染控制項
      @Override
      public void onRemoteTrackAvailableNotify(String uid, AliRtcEngine.AliRtcAudioTrack audioTrack, AliRtcEngine.AliRtcVideoTrack videoTrack){
          handler.post(new Runnable() {
              @Override
              public void run() {
                  if(videoTrack == AliRtcVideoTrackCamera) {
                      SurfaceView surfaceView = mAliRtcEngine.createRenderSurfaceView(VideoChatActivity.this);
                      surfaceView.setZOrderMediaOverlay(true);
                      FrameLayout view = getAvailableView();
                      if (view == null) {
                          return;
                      }
                      remoteViews.put(uid, view);
                      view.addView(surfaceView, new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
                      AliRtcEngine.AliRtcVideoCanvas remoteVideoCanvas = new AliRtcEngine.AliRtcVideoCanvas();
                      remoteVideoCanvas.view = surfaceView;
                      mAliRtcEngine.setRemoteViewConfig(remoteVideoCanvas, uid, AliRtcVideoTrackCamera);
                  } else if(videoTrack == AliRtcVideoTrackNo) {
                      if(remoteViews.containsKey(uid)) {
                          ViewGroup view = remoteViews.get(uid);
                          if(view != null) {
                              view.removeAllViews();
                              remoteViews.remove(uid);
                              mAliRtcEngine.setRemoteViewConfig(null, uid, AliRtcVideoTrackCamera);
                          }
                      }
                  }
              }
          });
      }
  
      /* 業務可能會觸發同一個UserID的不同裝置搶佔的情況，所以這個地方也需要處理 */
      @Override
      public void onBye(int code){
          handler.post(new Runnable() {
              @Override
              public void run() {
                  String msg = "onBye code:" + code;
                  ToastHelper.showToast(VideoChatActivity.this, msg, Toast.LENGTH_SHORT);
              }
          });
      }
  };
  
  mAliRtcEngine.setRtcEngineEventListener(mRtcEngineEventListener);
  mAliRtcEngine.setRtcEngineNotify(mRtcEngineNotify);

5、設定音視頻屬性

• 設定音頻相關屬性

  調用setAudioProfile設定音訊編碼模式和音頻情境

  mAliRtcEngine.setAudioProfile(AliRtcEngine.AliRtcAudioProfile.AliRtcEngineHighQualityMode, AliRtcEngine.AliRtcAudioScenario.AliRtcSceneMusicMode);

• 設定視頻相關屬性

  可以設定推出去的視頻流的解析度、碼率、幀率等資訊。

  //設定視頻編碼參數
  AliRtcEngine.AliRtcVideoEncoderConfiguration aliRtcVideoEncoderConfiguration = new AliRtcEngine.AliRtcVideoEncoderConfiguration();
  aliRtcVideoEncoderConfiguration.dimensions = new AliRtcEngine.AliRtcVideoDimensions(
                  720, 1280);
  aliRtcVideoEncoderConfiguration.frameRate = 20;
  aliRtcVideoEncoderConfiguration.bitrate = 1200;
  aliRtcVideoEncoderConfiguration.keyFrameInterval = 2000;
  aliRtcVideoEncoderConfiguration.orientationMode = AliRtcVideoEncoderOrientationModeAdaptive;
  mAliRtcEngine.setVideoEncoderConfiguration(aliRtcVideoEncoderConfiguration);

6、設定推拉流屬性

設定推送音視頻流及預設拉所有使用者的流：

• 調用publishLocalAudioStream推送音頻流

• 調用publishLocalVideoStream推送視頻流，如果是語音通話，可以設定成false

//SDK預設會publish音頻，publishLocalAudioStream可以不調用
mAliRtcEngine.publishLocalAudioStream(true);
//如果是視訊通話，publishLocalVideoStream(true)可以不調用，SDK預設會publish視頻
//如果是純語音通話 則需要設定publishLocalVideoStream(false)設定不publish視頻
mAliRtcEngine.publishLocalVideoStream(true);

//設定預設訂閱遠端的音頻和視頻流
mAliRtcEngine.setDefaultSubscribeAllRemoteAudioStreams(true);
mAliRtcEngine.subscribeAllRemoteAudioStreams(true);
mAliRtcEngine.setDefaultSubscribeAllRemoteVideoStreams(true);
mAliRtcEngine.subscribeAllRemoteVideoStreams(true);

7、開啟本地預覽

• 調用setLocalViewConfig設定本地渲染視圖，同時設定本地的視頻顯示內容。

• 調用startPreview 方法，開啟本地視頻預覽

mLocalVideoCanvas = new AliRtcEngine.AliRtcVideoCanvas();
SurfaceView localSurfaceView = mAliRtcEngine.createRenderSurfaceView(VideoChatActivity.this);
localSurfaceView.setZOrderOnTop(true);
localSurfaceView.setZOrderMediaOverlay(true);
FrameLayout fl_local = findViewById(R.id.fl_local);
fl_local.addView(localSurfaceView, layoutParams);
mLocalVideoCanvas.view = localSurfaceView;
mAliRtcEngine.setLocalViewConfig(mLocalVideoCanvas, AliRtcVideoTrackCamera);
mAliRtcEngine.startPreview();

8、加入頻道

調用joinChannel加入頻道，如果token是單參數規則產生的，需要調用SDK單參數的joinChannel[1/3]介面，如果是多參數規則產生的，需要調用SDK多參數的joinChannel[2/3]介面。調用完加入頻道後，可以在onJoinChannelResult回調中拿到加入頻道結果，如果result為0，則表示加入頻道成功，否則需要檢查傳進來的Token是否非法。

 mAliRtcEngine.joinChannel(token, null, null, null);

9、設定遠端視圖

在初始化引擎的時候設定對應回調mAliRtcEngine.setRtcEngineNotify，需要在onRemoteTrackAvailableNotify回調中，為遠端使用者佈建遠端視圖，範例程式碼如下：

@Override
public void onRemoteTrackAvailableNotify(String uid, AliRtcEngine.AliRtcAudioTrack audioTrack, AliRtcEngine.AliRtcVideoTrack videoTrack){
    handler.post(new Runnable() {
        @Override
        public void run() {
            if(videoTrack == AliRtcVideoTrackCamera) {
                SurfaceView surfaceView = mAliRtcEngine.createRenderSurfaceView(VideoChatActivity.this);
                surfaceView.setZOrderMediaOverlay(true);
                FrameLayout fl_remote = findViewById(R.id.fl_remote);
                if (fl_remote == null) {
                    return;
                }
                fl_remote.addView(surfaceView, new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
                AliRtcEngine.AliRtcVideoCanvas remoteVideoCanvas = new AliRtcEngine.AliRtcVideoCanvas();
                remoteVideoCanvas.view = surfaceView;
                mAliRtcEngine.setRemoteViewConfig(remoteVideoCanvas, uid, AliRtcVideoTrackCamera);
            } else if(videoTrack == AliRtcVideoTrackNo) {
                FrameLayout fl_remote = findViewById(R.id.fl_remote);
                fl_remote.removeAllViews();
                mAliRtcEngine.setRemoteViewConfig(null, uid, AliRtcVideoTrackCamera);
            }
        }
    });
}

10、離開房間並銷毀引擎

音視頻互動結束，需要離開房間並銷毀引擎，按照下列步驟結束音視頻互動

1. 調用 stopPreview 停止視頻預覽。

2. 調用leaveChannel離會。

3. 調用destroy銷毀引擎，並釋放相關資源。

private void destroyRtcEngine() {
    mAliRtcEngine.stopPreview();
    mAliRtcEngine.setLocalViewConfig(null, AliRtcVideoTrackCamera);
    mAliRtcEngine.leaveChannel();
    mAliRtcEngine.destroy();
    mAliRtcEngine = null;
}

11、效果示範