Cara mengintegrasikan Push SDK untuk Android - ApsaraVideo Live

Topik ini menjelaskan cara mengintegrasikan Push SDK untuk Android.

Persyaratan lingkungan

Item	Deskripsi
Alat pengembangan	Android Studio direkomendasikan.
Versi Android	Android 5.0 atau yang lebih baru diperlukan.

Langkah 1: Integrasi SDK

(Direkomendasikan) Integrasi SDK menggunakan Maven

Tambahkan URL repositori Maven ke file `build.gradle` proyek Anda.

maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }

Tambahkan dependensi SDK ke node dependencies di file `build.gradle` aplikasi Anda.
```
// Edisi Dasar dari Push SDK
implementation 'com.alivc.pusher:AlivcLivePusher:x.y.z'
```
Catatan
- x.y.z adalah nomor versi dari Push SDK. Ganti `x.y.z` dengan nomor versi terbaru dari Unduhan SDK, seperti 7.4.0.
- Push SDK dan Player SDK (AliyunPlayer) tidak dapat diintegrasikan secara bersamaan. Untuk mengintegrasikan kedua SDK tersebut, Anda harus menggunakan ApsaraVideo MediaBox SDK. Untuk informasi lebih lanjut, lihat Skenario dan Integrasi ApsaraVideo MediaBox SDK.
Tambahkan arsitektur CPU untuk aplikasi Anda ke file `build.gradle` aplikasi Anda.
```
defaultConfig {
 ndk {
 abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
 }
}
```

Integrasi manual SDK

Unduh dan ekstrak Push SDK.
Salin file `*.aar` dari SDK ke folder `libs` modul aplikasi Anda.
Di file `build.gradle` proyek Anda, tambahkan konfigurasi flatDir ke node repositories blok allprojects.
```
flatDir {
 dirs 'libs'
}
```

Tambahkan referensi ke file AAR di node dependencies file `build.gradle` aplikasi Anda.

dependencies {
 implementation fileTree(dir: 'libs', include the following: ['*.aar'])
}

Langkah 2: Konfigurasikan lisensi

Untuk instruksi, lihat Panduan Integrasi Lisensi.

Langkah 3: Konfigurasikan izin aplikasi

Konfigurasikan izin yang diperlukan di file `src/main/AndroidManifest.xml` aplikasi Anda.

<!-- Digunakan untuk fitur jaringan -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- Untuk memeriksa status koneksi jaringan perangkat, Anda perlu menambahkan izin ACCESS_NETWORK_STATE. -->
<!-- Izin ini tidak memerlukan persetujuan pengguna pada waktu proses, tetapi harus dideklarasikan di AndroidManifest.xml aplikasi. -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- Jika aplikasi perlu merekam audio, Anda perlu mendeklarasikan izin RECORD_AUDIO dan meminta izin ini pada waktu proses -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<!-- Aplikasi perlu mengakses kamera perangkat -->
<uses-permission android:name="android.permission.CAMERA" />

<!-- Minta izin Bluetooth lama pada perangkat yang lebih tua. -->
<uses-permission
  android:name="android.permission.BLUETOOTH"
  android:maxSdkVersion="30" />
<uses-permission
  android:name="android.permission.BLUETOOTH_ADMIN"
  android:maxSdkVersion="30" />
<!-- Dibutuhkan hanya jika aplikasi Anda berkomunikasi dengan perangkat Bluetooth yang sudah dipasangkan. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

<!-- Hanya digunakan oleh Demo untuk mengakses file penyimpanan -->
<!-- Izin penyimpanan -->
<uses-permission
  android:name="android.permission.READ_EXTERNAL_STORAGE"
  android:maxSdkVersion="32" />
<!-- Akses file gambar -->
<uses-permission
  android:name="android.permission.READ_MEDIA_IMAGES"
  android:minSdkVersion="33" />
<!-- Tulis file audio -->
<uses-permission
  android:name="android.permission.READ_MEDIA_AUDIO"
  android:minSdkVersion="33" />
<!-- Tulis file video -->
<uses-permission
  android:name="android.permission.READ_MEDIA_VIDEO"
  android:minSdkVersion="33" />

<!-- Hanya digunakan oleh Demo untuk perekaman layar dan streaming -->
<!-- Digunakan untuk membuat tugas latar belakang, tidak diperlukan oleh SDK -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- Meminta izin untuk membuat jendela overlay sistem -->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

<!-- Hanya digunakan oleh Demo untuk membisukan -->
<!-- Jika izin ini tidak dideklarasikan, fitur membisukan aliran otomatis selama panggilan telepon tidak akan berfungsi -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Langkah 4: Konfigurasikan aturan obfuscation

Tambahkan aturan obfuscation ke file `proguard-rules.pro` aplikasi Anda.

-keep class org.webrtc.** { *; }
-keep class com.alivc.** { *; }
-keep class com.aliyun.** { *; }
-keep class com.cicada.** { *; }

Catatan penggunaan

Untuk informasi API terperinci, lihat Referensi API untuk Edisi Dasar.
Untuk contoh kode tentang cara menggunakan API, lihat Gunakan Fitur.