ApsaraVideo Live：Unduh dan integrasikan ARTC SDK

Langkah 1: Impor SDK

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

allprojects {
    repositories {
        ...
        // Add the Maven repository for the ARTC SDK
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
}

dependencies {
    // Add the dependencies for the ARTC SDK
    // Replace ${latest_version} with the specific version number.
    implementation 'com.aliyun.aio:AliVCSDK_ARTC:${latest_version}'
    // For versions 7.4.0 and below, add the keep dependency
    // implementation 'com.aliyun.aio.keep:keep:1.0.1'
}   

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // Add the relative directory where the ARTC SDK is located
        flatDir {
            dir 'app/libs'
        }
    }
}

allprojects {
    repositories {
        ...
        // Add the relative directory where the ARTC SDK is located
        flatDir {
            dir 'app/libs'
        }
    }
}

// Replace x.y.z with the specific version number.
implementation(name:'AliVCSDK_ARTC', version: 'x.y.z', ext:'aar')

Langkah 2: Konfigurasikan arsitektur CPU yang didukung

Buka file app/build.gradle dan tentukan arsitektur CPU yang didukung oleh proyek Anda di defaultConfig, seperti pada contoh berikut. Arsitektur yang tersedia meliputi armeabi-v7a, arm64-v8a, x86, dan x86_64.

android {
    defaultConfig {
        // ...other default configurations
        // Support armeabi-v7a and arm64-v8a architectures
        ndk {
             abiFilters "armeabi-v7a", "arm64-v8a"
        }
    }
}	

Langkah 3: Konfigurasikan izin

Konfigurasikan izin yang diperlukan oleh 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" />
<!-- 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"/>

<!-- Declare the legacy Bluetooth permission -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<!-- Override and remove the newer permission for API 31+ -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- Declare the legacy Bluetooth permission and set maxSdkVersion for older devices -->
<uses-permission android:name="android.permission.BLUETOOTH"/>
<!-- Declare the new Bluetooth permission for API 31+ -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<!-- Other Bluetooth permissions as needed -->

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

<!-- Override and remove Bluetooth permissions from the 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, konfigurasikan aturan untuk SDK guna mencegah antarmuka yang disediakan SDK di-obfuscate, yang dapat menyebabkan pemanggilan fungsi tidak berjalan semestinya.

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

Apakah ARTC SDK menambahkan izin tambahan?

Ya. Mengimpor ARTC SDK akan secara otomatis menambahkan izin Android berikut ke manifes aplikasi Anda. Daftar pasti dapat berbeda tergantung versi SDK. Untuk daftar definitif, lihat file AndroidManifest.xml di dalam library .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 terutama digunakan untuk fitur seperti deteksi status jaringan, akses informasi Wi-Fi, konektivitas Bluetooth, dan routing audio.

Bagaimana cara menangani konflik izin atau masalah kompatibilitas?

Meskipun ARTC SDK mencakup logika internal untuk menangani kompatibilitas versi Android (seperti persyaratan izin runtime untuk BLUETOOTH_CONNECT di Android 12+), masalah tetap dapat muncul dalam skenario tertentu:

• Masalah runtime: Aplikasi Anda mungkin mengalami perilaku tak terduga, seperti kegagalan penggabungan manifes selama proses build.

• Risiko peninjauan Google Play: Jika aplikasi Anda mendeklarasikan izin untuk fitur yang tidak digunakan (seperti Bluetooth), hal ini dapat melanggar prinsip hak istimewa minimal dan menyebabkan aplikasi Anda ditolak dari Play Store.

Untuk mengatasi masalah ini, kami menyarankan langkah-langkah berikut:

1. Evaluasi kebutuhan izin
   Pertama, evaluasi apakah aplikasi Anda memerlukan semua izin yang dideklarasikan oleh SDK. Jika suatu fitur (seperti Bluetooth) tidak digunakan, hapus deklarasi izinnya. Misalnya, jika targetSdkVersion aplikasi Anda 30 atau lebih rendah, Anda tidak memerlukan izin BLUETOOTH_CONNECT.

2. Gunakan aturan penggabungan manifes untuk menyelesaikan konflik
   Jika beberapa modul library mendeklarasikan izin yang sama dengan atribut yang bertentangan (seperti maxSdkVersion yang berbeda), Anda dapat menggunakan namespace tools di file AndroidManifest.xml utama aplikasi Anda untuk mengganti perilaku tersebut.

   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:tools="http://schemas.android.com/tools">
       
       <!-- Example: Remove a permission declared by the SDK but not needed by the app -->
       <uses-permission 
           android:name="android.permission.BLUETOOTH_CONNECT"
           tools:node="remove" />
           
       <!-- Example: Override a permission attribute -->
       <uses-permission
           android:name="android.permission.BLUETOOTH"
           android:maxSdkVersion="30"
           tools:replace="android:maxSdkVersion" />
   </manifest>
   

Langkah 1: Impor SDK

sudo gem install cocoapods

pod init

target 'MyApp' do
  use_frameworks!
  # Replace ${latest version} with a specific version number.
  pod 'AliVCSDK_ARTC', '~> ${latest version}'
end

pod install

Langkah 2: Konfigurasikan izin

• Anda harus menambahkan izin perekaman dan kamera

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

• Aktifkan mode latar belakang audio (opsional).

Seperti yang ditunjukkan pada gambar, centang Audio, AirPlay, and Picture in Picture.