ApsaraVideo Live:Panggilan audio dan video di Android

Langkah 1: Impor SDK

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // Tambahkan repositori Maven untuk ARTC SDK
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

allprojects {
    repositories {
        ...
        // Tambahkan repositori Maven untuk ARTC SDK
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

dependencies {
    // Tambahkan dependensi untuk SDK audio dan video real-time// Ganti ${latest_version} dengan nomor versi tertentu
    implementation 'com.aliyun.aio:AliVCSDK_ARTC:${latest_version}'// Untuk versi 7.4.0 dan sebelumnya, Anda harus menambahkan dependensi keep// implementation 'com.aliyun.aio.keep:keep:1.0.1'
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // Tambahkan jalur relatif ke direktori tempat SDK ARTC berada
        flatDir {
            dir 'app/libs'
        }
    }
}

allprojects {
    repositories {
        ...
        // Tambahkan jalur relatif ke direktori tempat SDK ARTC berada
        flatDir {
            dir 'app/libs'
        }
    }
}

// Ganti x.y.z dengan nomor versi yang sesuai
implementation(name:'AliVCSDK_ARTC', version: 'x.y.z', ext:'aar')

Langkah 2: Tentukan arsitektur CPU yang didukung

Buka file app/build.gradle dan tentukan arsitektur CPU yang didukung di blok defaultConfig. Arsitektur yang tersedia mencakup armeabi-v7a, arm64-v8a, x86, dan x86_64. Pilih arsitektur yang Anda butuhkan.

android {
    defaultConfig {
        // ...konfigurasi default lainnya// Dukungan untuk arsitektur armeabi-v7a dan arm64-v8a
        ndk {
             abiFilters "armeabi-v7a", "arm64-v8a"
        }
    }
}	

Langkah 3: Atur izin

Atur izin yang dibutuhkan aplikasi Anda.

Buka direktori app/src/main, buka file AndroidManifest.xml, dan tambahkan izin yang diperlukan.

<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" /><!-- Minta izin Bluetooth lawas pada perangkat lama. --><uses-permissionandroid:name="android.permission.BLUETOOTH"android:maxSdkVersion="30" /><uses-permissionandroid:name="android.permission.BLUETOOTH_ADMIN"android:maxSdkVersion="30" /><!-- Hanya diperlukan jika aplikasi Anda berkomunikasi dengan perangkat Bluetooth yang sudah dipasangkan. --><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"/>

<!-- Deklarasikan izin Bluetooth --><uses-permission android:name="android.permission.BLUETOOTH" /><!-- Timpa dan hapus izin untuk API 31+ --><uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- Deklarasikan izin Bluetooth dan atur android:maxSdkVersion ke 30 untuk kompatibilitas dengan perangkat lama --><uses-permission android:name="android.permission.BLUETOOTH"/><!-- Deklarasikan izin Bluetooth untuk API 31+ --><uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/><!-- Izin Bluetooth lainnya -->

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

<!-- Timpa dan hapus deklarasi izin Bluetooth dari ARTC SDK --><uses-permission android:name="android.permission.BLUETOOTH" tools:node="remove" /><uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

Langkah 4: Cegah obfuscation kode (opsional)

Di file app/proguard-rules.pro, tambahkan aturan ProGuard berikut untuk mencegah antarmuka publik SDK di-obfuscate.

-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.** {*;}

FAQ

<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" />

Bagian ini menjelaskan cara menggunakan ARTC SDK untuk membangun aplikasi audio dan video real-time dasar. Salin contoh kode untuk pengujian cepat, lalu ikuti langkah-langkah untuk memahami pemanggilan API inti.

Diagram berikut menunjukkan alur kerja dasar untuk panggilan audio dan video real-time:

1. Minta izin

Sebelum memulai panggilan video, verifikasi bahwa aplikasi Anda memiliki izin yang diperlukan:

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. Dapatkan token otentikasi

Bergabung ke channel ARTC memerlukan token otentikasi. Untuk detail cara menghasilkan token, lihat Otentikasi berbasis token. Metode pembuatan token (parameter tunggal atau multiparameter) menentukan API joinChannel mana yang harus dipanggil.

Lingkungan produksi:

Menghasilkan token memerlukan AppKey Anda. Menyematkan AppKey secara langsung di sisi klien merupakan risiko keamanan, sehingga kami sangat menyarankan menghasilkan token di App Server Anda dan mengirimkannya ke klien.

Pengembangan dan debugging:

Saat pengembangan, jika App Server Anda belum dapat menghasilkan token, gunakan contoh berikut untuk membuat token sementara:

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

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

    /**
     * Hasilkan token rapat parameter tunggal berdasarkan channelId, userId, dan 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;
    }

    /**
     * Hasilkan token rapat parameter tunggal berdasarkan channelId, userId, dan 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) {
            // Pertimbangkan untuk mencatat exception dan/atau melemparkannya kembali sebagai 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) {
                // Gunakan tanda kutip tunggal untuk char
                stringBuilder.append('0');
            }
            stringBuilder.append(hex);
        }
        return stringBuilder.toString();
    }

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

3. Impor kelas ARTC SDK

Impor kelas dan antarmuka ARTC SDK:

// Impor kelas ARTC
import com.alivc.rtc.AliRtcEngine;
import com.alivc.rtc.AliRtcEngineEventListener;
import com.alivc.rtc.AliRtcEngineNotify;

4. Buat dan inisialisasi engine

• Buat engine RTC

  Panggil metode getInstance[1/2] untuk membuat instans AliRTCEngine.

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

• Inisialisasi mesin

  • Panggil setChannelProfile untuk mengatur profil channel ke AliRTCSdkInteractiveLive (mode interaktif).

    Pilih antara mode interaktif untuk hiburan dan mode komunikasi untuk panggilan. Memilih mode yang tepat memastikan pengalaman pengguna yang lancar dan penggunaan jaringan yang efisien.

    Mode	Penerbitan	Berlangganan	Deskripsi
    Mode interaktif	Berlaku batasan berbasis peran. Hanya pengguna dengan peran host yang dapat memublikasikan aliran. Partisipan dapat mengganti peran kapan saja selama sesi.	Tidak ada batasan peran. Semua partisipan memiliki izin untuk berlangganan aliran.	Dalam mode interaktif, event seperti host bergabung atau keluar dikirim ke viewer. Aktivitas viewer tidak dikirim ke host, sehingga memastikan pengalaman host tidak terganggu. Jika Anda memperkirakan bahwa viewer mungkin perlu berinteraksi di masa depan, kami menyarankan menggunakan mode interaktif. Fleksibilitasnya memungkinkan Anda menyesuaikan peran pengguna untuk memenuhi kebutuhan interaksi yang berbeda.
    Mode komunikasi	Tidak ada batasan peran. Semua partisipan memiliki izin untuk memublikasikan aliran.	Tidak ada batasan peran. Semua partisipan memiliki izin untuk berlangganan aliran.	Dalam mode komunikasi, partisipan saling mengetahui keberadaan satu sama lain dalam sesi. Meskipun mode ini tidak membedakan peran pengguna, fungsinya setara dengan peran host dalam mode interaktif. Hal ini menyederhanakan operasi, memungkinkan pengguna mencapai fungsionalitas yang diinginkan dengan lebih sedikit pemanggilan API.

  • Panggil setClientRole untuk mengatur peran pengguna menjadi AliRTCSdkInteractive (host) atau AliRTCSdkLive (viewer). Catatan: Peran host secara default memublikasikan dan berlangganan. Peran viewer secara default hanya berlangganan, dengan pratinjau dan penerbitan dinonaktifkan.

    Catatan

    Saat pengguna mengganti peran di dalam channel, sistem menyesuaikan status penerbitan aliran audio dan video sebagai berikut:

    • Beralih dari host ke viewer: Sistem menghentikan penerbitan aliran audio dan video lokal. Aliran jarak jauh yang berlangganan tidak terpengaruh, dan pengguna dapat terus menonton partisipan lain.

    • Beralih dari viewer ke host: Sistem mulai memublikasikan aliran audio dan video lokal. Aliran jarak jauh yang berlangganan tetap tidak berubah, dan pengguna dapat terus menonton partisipan lain.

    // Atur profil channel ke mode interaktif. Di RTC, selalu gunakan AliRTCSdkInteractiveLive.
    mAliRtcEngine.setChannelProfile(AliRtcEngine.AliRTCSdkChannelProfile.AliRTCSdkInteractiveLive);
    // Atur peran pengguna. Gunakan AliRTCSdkInteractive untuk memublikasikan dan berlangganan aliran, atau AliRTCSdkLive hanya untuk berlangganan.
    mAliRtcEngine.setClientRole(AliRtcEngine.AliRTCSdkClientRole.AliRTCSdkInteractive);

• Atur callback umum

  Saat SDK mengalami masalah, SDK terlebih dahulu mencoba pemulihan otomatis. Untuk error yang tidak dapat diselesaikan, SDK memberi tahu aplikasi Anda melalui callback.

  Berikut adalah callback utama untuk masalah yang tidak dapat dipulihkan yang harus ditangani aplikasi Anda:

  Penyebab exception	Callback dan parameter	Solusi	Deskripsi
  Otentikasi gagal	Parameter result dari callback onJoinChannelResult adalah AliRtcErrJoinBadToken.	Aplikasi Anda harus memeriksa apakah token benar.	Jika otentikasi gagal saat pengguna memanggil API, callback mengembalikan error kegagalan otentikasi.
  Token akan segera kedaluwarsa	onAuthInfoWillExpire	Dapatkan token baru dan panggil refreshAuthInfo untuk memperbarui informasi otentikasi.	Error kedaluwarsa token dapat terjadi baik saat API dipanggil maupun selama runtime. Error dilaporkan melalui callback API atau callback error terpisah.
  Token kedaluwarsa	onAuthInfoExpired	Aplikasi Anda harus bergabung kembali ke channel.	Error kedaluwarsa token dapat terjadi baik saat API dipanggil maupun selama runtime. Error dilaporkan melalui callback API atau callback error terpisah.
  Masalah koneksi jaringan	Callback onConnectionStatusChange mengembalikan AliRtcConnectionStatusFailed.	Aplikasi Anda harus bergabung kembali ke channel.	SDK secara otomatis memulihkan diri dari gangguan koneksi jaringan singkat. Jika gangguan melebihi ambang batas yang telah ditentukan, terjadi timeout dan koneksi terputus. Aplikasi Anda harus memeriksa status jaringan dan meminta pengguna untuk bergabung kembali ke channel.
  Dikeluarkan dari channel	onBye	AliRtcOnByeUserReplaced: Periksa apakah pengguna lain telah bergabung dengan userId yang sama. AliRtcOnByeBeKickedOut: Pengguna dikeluarkan dari channel oleh App Server dan harus bergabung kembali. AliRtcOnByeChannelTerminated: Channel dihentikan, dan pengguna harus bergabung kembali.	Layanan RTC memungkinkan administrator menghapus partisipan.
  Exception perangkat lokal	onLocalDeviceException	Aplikasi Anda harus memeriksa izin dan apakah perangkat keras berfungsi dengan benar.	Layanan RTC mendukung pendeteksian perangkat dan diagnostik. Saat terjadi exception perangkat lokal yang tidak dapat diselesaikan SDK, SDK memberi tahu aplikasi Anda melalui callback. Aplikasi Anda kemudian harus memeriksa status perangkat.

  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: Callback ini harus ditangani. Ini dipicu hanya setelah strategi pemulihan internal SDK gagal. Kami menyarankan memberi tahu pengguna. */
                      ToastHelper.showToast(VideoChatActivity.this, R.string.video_chat_connection_failed, Toast.LENGTH_SHORT);
                  } else {
                      /* TODO: Opsional. Tambahkan logika bisnis di sini, seperti untuk analitik data atau pembaruan UI. */
                  }
              }
          });
      }
      @Override
      public void onLocalDeviceException(AliRtcEngine.AliRtcEngineLocalDeviceType deviceType, AliRtcEngine.AliRtcEngineLocalDeviceExceptionType exceptionType, String msg){
          super.onLocalDeviceException(deviceType, exceptionType, msg);
          /* TODO: Callback ini harus ditangani. Ini dipicu hanya setelah strategi pemulihan internal SDK gagal. Kami menyarankan memberi tahu pengguna tentang error perangkat. */
          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: Ini harus ditangani. Token akan segera kedaluwarsa. Aplikasi Anda harus mendapatkan token otentikasi baru untuk channel dan pengguna saat ini, lalu memanggil refreshAuthInfo. */
      }
  
      @Override
      public void onRemoteUserOnLineNotify(String uid, int elapsed){
          super.onRemoteUserOnLineNotify(uid, elapsed);
      }
  
      // Di callback onRemoteUserOffLineNotify, lepaskan renderer untuk aliran video jarak jauh.
      @Override
      public void onRemoteUserOffLineNotify(String uid, AliRtcEngine.AliRtcUserOfflineReason reason){
          super.onRemoteUserOffLineNotify(uid, reason);
      }
  
      // Di callback onRemoteTrackAvailableNotify, siapkan renderer untuk aliran video jarak jauh.
      @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);
                          }
                      }
                  }
              }
          });
      }
  
      /* Aplikasi Anda harus menangani kasus di mana beberapa perangkat mencoba bergabung dengan userId yang sama. */
      @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. Atur properti audio dan video

• Atur properti audio

  Panggil setAudioProfile untuk mengatur mode pengkodean audio dan skenario audio.

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

• Atur properti video

  Atur properti untuk aliran video yang dipublikasikan, seperti resolusi, bitrate, dan laju frame.

  // Atur parameter pengkodean video.
  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. Atur properti penerbitan dan berlangganan

Konfigurasikan penerbitan aliran dan perilaku berlangganan default:

• Panggil publishLocalAudioStream untuk memublikasikan aliran audio.

• Panggil publishLocalVideoStream untuk memublikasikan aliran video. Untuk panggilan hanya audio, atur nilai ini menjadi false.

// SDK memublikasikan audio secara default, sehingga Anda tidak perlu memanggil publishLocalAudioStream.
mAliRtcEngine.publishLocalAudioStream(true);
// Untuk panggilan video, Anda tidak perlu memanggil publishLocalVideoStream(true) karena SDK memublikasikan video secara default.
// Untuk panggilan hanya audio, Anda harus memanggil publishLocalVideoStream(false) untuk menonaktifkan publikasi video.
mAliRtcEngine.publishLocalVideoStream(true);

// Atur default untuk berlangganan aliran audio dan video jarak jauh.
mAliRtcEngine.setDefaultSubscribeAllRemoteAudioStreams(true);
mAliRtcEngine.subscribeAllRemoteAudioStreams(true);
mAliRtcEngine.setDefaultSubscribeAllRemoteVideoStreams(true);
mAliRtcEngine.subscribeAllRemoteVideoStreams(true);

7. Mulai pratinjau lokal

• Panggil setLocalViewConfig untuk mengonfigurasi tampilan pratinjau lokal. Ini memerlukan objek AliRtcVideoCanvas.

• Panggil metode startPreview untuk memulai pratinjau video lokal.

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. Bergabung dengan saluran

Panggil joinChannel untuk bergabung ke channel. Jika token dihasilkan berdasarkan aturan parameter tunggal, panggil antarmuka joinChannel[1/3] parameter tunggal SDK. Jika token dihasilkan berdasarkan aturan multiparameter, panggil antarmuka joinChannel[2/3] multiparameter SDK. Setelah Anda bergabung ke channel, callback onJoinChannelResult memberikan hasilnya. Jika result bernilai 0, Anda telah berhasil bergabung ke channel. Jika tidak, periksa apakah token yang diberikan tidak valid.

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

9. Atur tampilan jarak jauh

Saat inisialisasi engine, atur callback mAliRtcEngine.setRtcEngineNotify. Di callback onRemoteTrackAvailableNotify, konfigurasikan tampilan jarak jauh untuk setiap pengguna jarak jauh:

@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. Tinggalkan channel dan hancurkan engine

Saat sesi audio dan video berakhir, tinggalkan channel dan hancurkan engine:

1. Panggil stopPreview untuk menghentikan pratinjau video.

2. Panggil leaveChannel untuk meninggalkan channel.

3. Panggil destroy untuk menghancurkan engine dan melepaskan sumber dayanya.

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

11. Demonstrasi