视频直播：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>