ApsaraVideo Live:Unduh dan integrasi SDK

Izin runtime Bluetooth

File AndroidManifest.xml di SDK ARTC mencakup deklarasi beberapa izin tetapi tidak berisi logika untuk memintanya saat runtime. Izin BLUETOOTH_CONNECT khususnya merupakan izin runtime yang diperkenalkan di Android 12. Setelah Anda mengimpor SDK ARTC, izin berikut secara otomatis digabungkan ke dalam manifes aplikasi Anda. Tangani permintaan izin berdasarkan kasus penggunaan spesifik aplikasi Anda.

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

Jika aplikasi Anda tidak memerlukan izin tertentu, Anda dapat secara eksplisit menghapus deklarasinya di file AndroidManifest.xml proyek utama Anda:

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove"/>

Ikuti panduan ini untuk izin Bluetooth:

<!-- Deklarasikan izin Bluetooth lama -->
<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 lama dan atur android:maxSdkVersion ke 30 untuk kompatibilitas mundur -->
<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 SDK ARTC -->
<uses-permission android:name="android.permission.BLUETOOTH" tools:node="remove" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

Izin runtime lainnya

Pada Android 6.0 (API level 23) dan versi lebih baru, Anda harus meminta izin berbahaya saat runtime. Selain mendeklarasikan izin di file AndroidManifest.xml, Anda juga harus memintanya di kode Anda saat runtime.

Izin berikut memerlukan permintaan runtime:

• Manifest.permission.CAMERA

• Manifest.permission.WRITE_EXTERNAL_STORAGE

• Manifest.permission.RECORD_AUDIO

• Manifest.permission.READ_EXTERNAL_STORAGE

• Manifest.permission.READ_PHONE_STATE

Pada Android 12 (API level 31) dan versi lebih baru, Anda juga harus meminta izin berikut saat runtime:

• Manifest.permission.BLUETOOTH_CONNECT

Tabel berikut menjelaskan izin yang relevan.

Apakah SDK ARTC memperkenalkan izin tambahan?

Setelah Anda mengimpor SDK ARTC, izin Android berikut secara otomatis dideklarasikan (Daftar spesifik dapat bervariasi tergantung versi SDK. Untuk daftar pasti, rujuk konten AndroidManifest.xml di file .aar yang diintegrasikan):

<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.

Menangani konflik izin

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

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

• 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 berisiko ditolak dari Play Store.

Untuk menyelesaikan masalah ini, gunakan langkah-langkah berikut:

1. Evaluasi kebutuhan izin
   Pertama, evaluasi apakah aplikasi Anda benar-benar memerlukan semua izin yang dideklarasikan oleh SDK. Jika fitur seperti Bluetooth tidak digunakan, Anda dapat menghapus deklarasi izin yang sesuai. Misalnya, jika aplikasi Anda hanya berjalan di perangkat dengan Android API 30 atau lebih rendah, Anda dapat menghapus deklarasi untuk izin BLUETOOTH_CONNECT karena versi targetSdk Anda adalah 30 atau lebih rendah.
   

2. Selesaikan konflik menggunakan direktif penggabungan Manifest
   Jika beberapa modul mendeklarasikan atribut berbeda untuk izin yang sama, seperti maxSdkVersion yang tidak konsisten, Anda dapat menggunakan namespace tools di file AndroidManifest.xml utama untuk menyelesaikan konflik:
   

   <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 oleh 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>