ApsaraVideo Live：SDK下載/整合

藍芽許可權動態申請說明

ARTC SDK 內部 AndroidManifest.xml 中內建了部分許可權的聲明（對於動態許可權內部沒有申請的邏輯），其中 BLUETOOTH_CONNECT 許可權為 Android 12 開始引入的動態許可權。匯入 ARTC SDK 後下面的許可權會自動引入到 APK 中，但是仍推薦根據您的業務情境自行申請許可權。

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

根據您的業務情境，如果不需要下面的某項許可權，可以在您的主專案 AndroidManifest.xml 檔案中聲明移除：

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

特別針對藍芽許可權：

<!-- 聲明藍芽許可權 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<!-- 覆蓋移除高版本API 31+ 許可權 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- 聲明藍芽許可權並設定android:maxSdkVersion為30以相容更低版本裝置 -->
<uses-permission android:name="android.permission.BLUETOOTH"/>
<!-- 聲明高版本API 31+ 藍芽許可權 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<!-- 其他藍芽許可權 -->

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

<!-- 覆蓋移除ARTC SDK中內建的藍芽許可權聲明 -->
<uses-permission android:name="android.permission.BLUETOOTH" tools:node="remove" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

其他許可權動態申請說明

Android 6.0（API 23）之後危險許可權需要動態申請，除了在AndroidManifest.xml檔案中靜態申請外，還需要在代碼運行時請求許可權。

其中部分許可權需要動態申請, 需要動態申請的許可權包含：

• Manifest.permission.CAMERA

• Manifest.permission.WRITE_EXTERNAL_STORAGE

• Manifest.permission.RECORD_AUDIO

• Manifest.permission.READ_EXTERNAL_STORAGE

• Manifest.permission.READ_PHONE_STATE

當Android系統版本>=12(API_LEVEL>=31) 時, 需要額外動態申請以下許可權：

• Manifest.permission.BLUETOOTH_CONNECT

可能涉及到的部分許可權說明如下：

ARTC SDK 是否會引入額外許可權？

匯入 ARTC SDK 後，會自動聲明以下 Android 許可權（具體列表可能因 SDK 版本而異，請以所整合的 .aar 檔案中 AndroidManifest.xml 的內容為準）：

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

這些許可權主要用於支援網路狀態檢測、Wi-Fi 資訊擷取、藍芽串連及音頻路由等功能。

如何處理 SDK 許可權與現有代碼的相容性或衝突問題？

儘管 ARTC SDK 內部已對許可權進行了 Android 版本適配（例如針對 BLUETOOTH_CONNECT 在 Android 12+ （API 31）的運行時許可權要求），通常不會導致編譯錯誤，但仍可能在以下情境中引發問題：

• 運行時行為異常：如Manifest 合并失敗；

• Google Play 審核風險：若應用實際未使用某項功能卻聲明了相關許可權（如藍芽），可能違反最小許可權原則，導致上架被拒。

建議採取以下措施進行相容性處理：

1. 評估許可權必要性
   首先評估你的應用是否確實需要 SDK 聲明的所有許可權。若某些功能（如藍芽）未被使用，可考慮移除對應許可權聲明，例如您的程式僅在 Android API 30 及以下裝置上運行（targetSdk 版本為 30 以下時，可以移除BLUETOOTH_CONNECT許可權的聲明）。
   

2. 通過 Manifest 合并指令解決衝突
   若多個模組對同一許可權聲明了不同屬性（例如 maxSdkVersion 不一致），可在主 AndroidManifest.xml 中使用 tools 命名空間進行幹預：
   

   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:tools="http://schemas.android.com/tools">
       
       <!-- 樣本：移除 SDK 中聲明但應用不需要的許可權 -->
       <uses-permission 
           android:name="android.permission.BLUETOOTH_CONNECT"
           tools:node="remove" />
           
       <!-- 樣本：覆蓋許可權屬性 -->
       <uses-permission
           android:name="android.permission.BLUETOOTH"
           android:maxSdkVersion="30"
           tools:replace="android:maxSdkVersion" />
   </manifest>