ApsaraVideo Live:Unduh dan integrasikan SDK

Prasyarat

Persyaratan:

• Android Studio 2020.3.1 atau versi lebih baru.

• Perangkat uji yang menjalankan Android 5.0 (SDK API level 21) atau versi lebih baru dengan konektivitas jaringan.

Langkah 1: Impor SDK

Langkah 2: Konfigurasikan arsitektur CPU

Dalam app/build.gradle, tentukan arsitektur CPU yang didukung dalam blok defaultConfig. Arsitektur yang tersedia: armeabi-v7a, arm64-v8a, x86, dan x86_64.

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

Langkah 3: Konfigurasikan izin

Dalam AndroidManifest.xml (app/src/main), 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 lama pada perangkat lama. -->
<uses-permission
  android:name="android.permission.BLUETOOTH"
  android:maxSdkVersion="30" />
<uses-permission
  android:name="android.permission.BLUETOOTH_ADMIN"
  android:maxSdkVersion="30" />

<!-- Diperlukan hanya 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 penghapusan izin API 31+ versi tinggi. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- Deklarasikan izin Bluetooth dengan android:maxSdkVersion diatur ke 30 untuk kompatibilitas mundur. -->
<uses-permission android:name="android.permission.BLUETOOTH"/>
<!-- Deklarasikan izin Bluetooth API 31+ versi tinggi. -->
<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 bawaan 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)

Tambahkan aturan berikut ke app/proguard-rules.pro untuk mencegah obfuscation kode 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.** {
*;
}

Prasyarat

Persyaratan:

• Xcode 14.0 atau versi lebih baru (disarankan versi stabil terbaru).

• CocoaPods 1.9.3 atau versi lebih baru.

• Perangkat fisik yang menjalankan iOS 9.0 atau versi lebih baru.

Langkah 1: Impor SDK

Langkah 2: Konfigurasikan izin

• Tambahkan izin kamera dan mikrofon ke Info.plist: Privacy - Camera Usage Description dan Privacy - Microphone Usage Description.

• (Opsional) Aktifkan audio latar belakang. Di kemampuan proyek, pilih Audio, AirPlay, and Picture in Picture.

Prasyarat

Persyaratan:

• Visual Studio 2015 atau versi lebih baru.

• Windows 7 atau versi lebih baru.

Langkah 1: Integrasikan SDK

1. Unduh ARTC SDK terbaru dari bagian unduhan SDK.

2. Ekstrak SDK dan salin semua file ke direktori proyek Anda.

3. Konfigurasikan properti proyek:

   1. Di Solution Explorer, klik kanan proyek dan pilih Properties.

   2. Tambahkan direktori include: pilih Configuration Properties > C/C++ > General, lalu tambahkan path file header di bawah Additional Include Directories.

   3. Tambahkan direktori library: pilih Linker > General, lalu tambahkan path file library (.lib), misalnya .../x64/Release, di bawah Additional Library Directories.

   4. Tentukan file library yang ditautkan: pilih Linker > Input, lalu tambahkan AliRTCSdk.lib di bawah Additional Dependencies.

Pemecahan Masalah

Isu umum dan solusinya:

Prasyarat

Persyaratan:

• Xcode 14.0 atau versi lebih baru (disarankan versi stabil terbaru).

• macOS 10.13 atau versi lebih baru.

• Koneksi jaringan yang stabil.

Langkah 1: Integrasikan SDK

ARTC SDK untuk Mac disediakan sebagai bundel library dinamis .framework (misalnya, AliRTCSdk.framework). Ini berbeda dari library bersama .so yang digunakan di Linux. Unduh paket SDK Mac dan jangan gunakan file .so dari paket Linux.

1. Unduh dan ekstrak ARTC SDK terbaru dari bagian unduhan SDK.

2. Salin bundel .framework dari paket SDK ke direktori proyek Anda. Lewati PluginAAC.framework jika Anda tidak menggunakan pengkodean audio AAC.

3. Di Xcode, tambahkan library dinamis dan atur Embed ke Embed & Sign.

Pemecahan Masalah

Isu umum dan solusinya:

Apakah ARTC SDK menambahkan izin Android tambahan?

ARTC SDK secara otomatis mendeklarasikan izin Android berikut (daftar tepatnya dapat berbeda tergantung versi; periksa AndroidManifest.xml dalam file .aar):

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

Izin ini mendukung pemantauan jaringan, deteksi Wi-Fi, konektivitas Bluetooth, dan routing audio.

Bagaimana cara menangani kompatibilitas izin atau konflik dengan kode yang sudah ada?

ARTC SDK menangani kompatibilitas izin (misalnya, BLUETOOTH_CONNECT saat runtime pada Android 12+), tetapi isu dapat terjadi:

• Anomali perilaku saat runtime, seperti kegagalan penggabungan manifest.

• Risiko peninjauan Google Play: mendeklarasikan izin yang tidak digunakan (misalnya, Bluetooth) dapat melanggar prinsip hak istimewa minimal dan menyebabkan penolakan.

Untuk mengatasi isu ini:

1. Nilai kebutuhan. Hapus izin yang tidak digunakan. Misalnya, jika targetSdk adalah 30 atau lebih rendah, hapus deklarasi BLUETOOTH_CONNECT.

2. Atasi konflik penggabungan manifest. Jika modul mendeklarasikan atribut yang bertentangan (misalnya, nilai maxSdkVersion yang tidak konsisten), gunakan namespace tools dalam AndroidManifest.xml untuk menimpa:

   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:tools="http://schemas.android.com/tools">
   
       <!-- Contoh: Hapus izin yang dideklarasikan oleh SDK tetapi tidak diperlukan aplikasi. -->
       <uses-permission
           android:name="android.permission.BLUETOOTH_CONNECT"
           tools:node="remove" />
   
       <!-- Contoh: Timpa atribut izin. -->
       <uses-permission
           android:name="android.permission.BLUETOOTH"
           android:maxSdkVersion="30"
           tools:replace="android:maxSdkVersion" />
   </manifest>

Kodek audio apa saja yang didukung oleh ARTC SDK?

ARTC SDK menggunakan Opus sebagai kodek audio default, diwariskan dari pipeline pemrosesan audio WebRTC.

Opus adalah kodek terbuka dan bebas royalti (RFC 6716) yang memberikan kualitas audio tinggi pada bitrate 6–510 kbps dengan latensi rendah. ARTC SDK menggunakan Opus untuk:

• Pengkodean dan dekode audio real-time untuk panggilan satu lawan satu dan multipihak.

• Bitrate adaptif berdasarkan kondisi jaringan.

• Supresi noise bawaan dan kontrol gain otomatis (AGC).