ApsaraVideo Live:Android での音声・ビデオ通話

ステップ 1: 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')

ステップ 2: サポートされる CPU アーキテクチャの指定

 app/build.gradle ファイルを開き、サポートされる CPU アーキテクチャを defaultConfig ブロックで指定します。利用可能なアーキテクチャには armeabi-v7a、arm64-v8a、x86、x86_64 があります。必要なアーキテクチャを選択してください。

android {
    defaultConfig {
        // ...その他のデフォルト設定// armeabi-v7a および arm64-v8a アーキテクチャのサポート
        ndk {
             abiFilters "armeabi-v7a", "arm64-v8a"
        }
    }
}	

ステップ 3: 権限の設定

アプリに必要な権限を設定します。

 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" /><!-- 古いデバイスでレガシー Bluetooth 権限をリクエストします。 --><uses-permissionandroid:name="android.permission.BLUETOOTH"android:maxSdkVersion="30" /><uses-permissionandroid:name="android.permission.BLUETOOTH_ADMIN"android:maxSdkVersion="30" /><!-- アプリがペアリング済みの Bluetooth デバイスと通信する場合にのみ必要です。 --><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"/>

<!-- Bluetooth 権限を宣言します --><uses-permission android:name="android.permission.BLUETOOTH" /><!-- API 31+ の権限をオーバーライドして削除します --><uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- Bluetooth 権限を宣言し、古いデバイスとの互換性のために android:maxSdkVersion を 30 に設定します --><uses-permission android:name="android.permission.BLUETOOTH"/><!-- API 31+ の Bluetooth 権限を宣言します --><uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/><!-- その他の Bluetooth 権限 -->

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

<!-- ARTC SDK からの Bluetooth 権限宣言をオーバーライドして削除します --><uses-permission android:name="android.permission.BLUETOOTH" tools:node="remove" /><uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

ステップ 4: コードの難読化の防止 (任意)

 app/proguard-rules.pro ファイルに、以下の ProGuard ルールを追加して、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. 権限のリクエスト

ビデオ通話を開始する前に、アプリが必要な権限を持っていることを確認してください：

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. 認証トークンの取得

ARTC チャンネルに参加するには認証トークンが必要です。トークンの生成方法の詳細については、「トークンベースの認証」をご参照ください。トークン生成方法 (単一パラメーターまたは複数パラメーター) によって、呼び出す joinChannel API が決まります。

本番環境：

トークンの生成には AppKey が必要です。クライアント側に AppKey をハードコーディングすることはセキュリティリスクがあるため、App Server でトークンを生成し、クライアントに送信することを強く推奨します。

開発とデバッグ：

開発中に App Server がまだトークンを生成できない場合は、以下のサンプルを使用して一時的なトークンを作成してください：

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

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

    /**
     * channelId、userId、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 に基づいて単一パラメーターの会議トークンを生成します
     */
    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) {
            // 例外をログに記録するか、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) {
                // 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 はコールバックを通じてアプリに通知します。

  以下は、アプリケーションが処理する必要がある回復不能な問題に関する主要なコールバックです：

  例外の原因	コールバックとパラメーター	ソリューション	説明
  認証失敗	onJoinChannelResult コールバックの result パラメーターが AliRtcErrJoinBadToken です。	アプリはトークンが正しいかどうかを確認する必要があります。	ユーザーが API を呼び出す際に認証が失敗すると、コールバックは認証失敗エラーを返します。
  トークンの有効期限が近い	onAuthInfoWillExpire	新しいトークンを取得し、refreshAuthInfo を呼び出して認証情報を更新します。	トークンの有効期限エラーは、API 呼び出し時またはランタイム中に発生する可能性があります。エラーは API コールバックまたは別のエラーコールバックを通じて報告されます。
  トークンの有効期限切れ	onAuthInfoExpired	アプリはチャンネルに再参加する必要があります。	トークンの有効期限エラーは、API 呼び出し時またはランタイム中に発生する可能性があります。エラーは API コールバックまたは別のエラーコールバックを通じて報告されます。
  ネットワーク接続の問題	onConnectionStatusChange コールバックは AliRtcConnectionStatusFailed を返します。	アプリはチャンネルに再参加する必要があります。	SDK は短いネットワーク切断から自動的に回復します。切断が事前に設定されたしきい値を超えると、タイムアウトが発生し、接続が切断されます。アプリはネットワーク状態を確認し、ユーザーにチャンネルへの再参加を促す必要があります。
  チャンネルからキックされる	onBye	AliRtcOnByeUserReplaced：別のユーザーが同じ userId で参加したかどうかを確認します。 AliRtcOnByeBeKickedOut：ユーザーは App Server によってチャンネルからキックされたため、再参加する必要があります。 AliRtcOnByeChannelTerminated：チャンネルが終了したため、ユーザーは再参加する必要があります。	RTC サービスでは、管理者が参加者を削除できます。
  ローカルデバイスの例外	onLocalDeviceException	アプリは権限とハードウェアが正しく動作しているかを確認する必要があります。	RTC サービスはデバイスの検出と診断をサポートしています。SDK が解決できないローカルデバイスの例外が発生した場合、コールバックを通じてアプリに通知します。アプリはデバイスの状態を確認する必要があります。

  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: これは必ず処理する必要があります。トークンの有効期限がまもなく切れます。アプリは現在のチャンネルとユーザーの新しい認証トークンを取得し、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 はデフォルトで音声を公開するため、publishLocalAudioStream を呼び出す必要はありません。
mAliRtcEngine.publishLocalAudioStream(true);
// ビデオ通話の場合、SDK はデフォルトでビデオを公開するため、publishLocalVideoStream(true) を呼び出す必要はありません。
// 音声のみの通話の場合、ビデオ公開を無効にするために publishLocalVideoStream(false) を呼び出す必要があります。
mAliRtcEngine.publishLocalVideoStream(true);

// デフォルトでリモートの音声・ビデオストリームをサブスクライブするように設定します。
mAliRtcEngine.setDefaultSubscribeAllRemoteAudioStreams(true);
mAliRtcEngine.subscribeAllRemoteAudioStreams(true);
mAliRtcEngine.setDefaultSubscribeAllRemoteVideoStreams(true);
mAliRtcEngine.subscribeAllRemoteVideoStreams(true);

7. ローカルプレビューの開始

• setLocalViewConfig を呼び出してローカルプレビュービューを設定します。これには AliRtcVideoCanvas オブジェクトが必要です。

• 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 を呼び出してチャンネルに参加します。トークンが単一パラメーターのルールに基づいて生成された場合は、SDK の単一パラメーター joinChannel[1/3] インターフェースを呼び出します。トークンが複数パラメーターのルールに基づいて生成された場合は、SDK の複数パラメーター joinChannel[2/3] インターフェースを呼び出します。チャンネルに参加すると、onJoinChannelResult コールバックが結果を提供します。result が 0 の場合、チャンネルへの参加に成功しています。それ以外の場合は、提供されたトークンが無効でないか確認してください。

 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. デモンストレーション