ApsaraVideo Live:Baixe e integre o SDK

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

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

Solicitação dinâmica de permissões de Bluetooth

O arquivo AndroidManifest.xml no SDK ARTC inclui declarações para algumas permissões, mas não contém a lógica para solicitá-las em tempo de execução. A permissão BLUETOOTH_CONNECT foi introduzida no Android 12 como permissão de tempo de execução. Após importar o SDK ARTC, as seguintes permissões são adicionadas automaticamente ao APK. Recomendamos solicitar as permissões de acordo com o cenário de negócios.

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

Se o cenário de negócios não exigir alguma das permissões acima, declare a remoção dela no arquivo AndroidManifest.xml do projeto principal.

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

As informações a seguir são específicas para permissões de Bluetooth:

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

<!-- Declare the Bluetooth permission and set android:maxSdkVersion to 30 for compatibility with earlier device versions. -->
<uses-permission android:name="android.permission.BLUETOOTH"/>
<!-- Declare the Bluetooth permission for API 31+. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<!-- Other Bluetooth permissions. -->

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 the Bluetooth permission declarations 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" />

Solicitação dinâmica de outras permissões

A partir do Android 6.0 (API 23), as permissões perigosas devem ser solicitadas em tempo de execução. Além de declará-las estaticamente no arquivo AndroidManifest.xml, solicite-as também no código durante a execução.

As seguintes permissões devem ser solicitadas dinamicamente:

• Manifest.permission.CAMERA

• Manifest.permission.WRITE_EXTERNAL_STORAGE

• Manifest.permission.RECORD_AUDIO

• Manifest.permission.READ_EXTERNAL_STORAGE

• Manifest.permission.READ_PHONE_STATE

Se a versão do Android for 12 (API level 31) ou posterior, solicite dinamicamente também a seguinte permissão:

• Manifest.permission.BLUETOOTH_CONNECT

Veja abaixo algumas das permissões que podem estar envolvidas:

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

O SDK ARTC introduz permissões extras?

Após importar o SDK ARTC, as seguintes permissões do Android são declaradas automaticamente. A lista específica pode variar dependendo da versão do SDK. Para obter a lista definitiva, consulte o conteúdo do arquivo .aar integrado no arquivo 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" />

Essas permissões servem principalmente para dar suporte a recursos como detecção de estado da rede, recuperação de informações Wi-Fi, conexão Bluetooth e roteamento de áudio.

Como lidar com problemas de compatibilidade ou conflito entre permissões do SDK e código existente?

Embora o SDK ARTC tenha sido adaptado para diferentes versões do Android em relação às permissões — como a exigência de permissão em tempo de execução para BLUETOOTH_CONNECT no Android 12 (API 31) e posteriores, o que geralmente não causa erros de compilação —, problemas ainda podem surgir nos seguintes cenários:

• Comportamento anômalo em tempo de execução, como falha na mesclagem de manifesto.

• Riscos na revisão do Google Play: Se um aplicativo declarar uma permissão para um recurso que não utiliza, como Bluetooth, isso pode violar o princípio do menor privilégio e causar a rejeição do aplicativo na loja.

Recomendamos tomar as seguintes medidas para lidar com problemas de compatibilidade:

1. Avalie a necessidade das permissões Primeiramente, avalie se o aplicativo precisa de todas as permissões declaradas pelo SDK. Se certos recursos, como Bluetooth, não forem usados, considere remover as declarações de permissão correspondentes. Por exemplo, se o aplicativo rodar apenas em dispositivos com Android API 30 ou inferior (versão targetSdk abaixo de 30), remova a declaração da permissão BLUETOOTH_CONNECT.

2. Use diretivas de mesclagem de manifesto para resolver conflitos Se vários módulos declararem a mesma permissão com atributos diferentes, como um maxSdkVersion inconsistente, utilize o namespace tools no arquivo AndroidManifest.xml principal para resolver o conflito.

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