Integração rápida do ApsaraVideo MediaBox SDK para Android - Apsara Video SDK: Central de Documentação do Alibaba Cloud

Integre rapidamente o ApsaraVideo MediaBox SDK ao seu aplicativo Android.

Importante

Se você atualizar da versão 6.6.0 ou anterior do SDK para a versão 6.7.0 ou posterior, consulte as Atualizações sobre os efeitos de retoque integrados do ApsaraVideo MediaBox SDK V6.7.0.

Requisitos de ambiente

Item	Descrição
Ferramenta de desenvolvimento	Android Studio (recomendado).
Versão do Android	Android 5.0 (API level 21) ou superior.

Etapa 1: Integrar o SDK

Integração via Maven (recomendada)

No arquivo build.gradle no nível do projeto, adicione a URL do repositório Maven.
```
maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
```

No arquivo build.gradle no nível do aplicativo, adicione a dependência do SDK ao nó dependencies.

A versão exibida serve apenas como referência. Obtenha a versão mais recente em Selecionar e baixar SDKs.

// Choose one of the following four scenario-based SDKs based on your business requirements.

// 1. All-in-one SDK: Includes playback, real-time streaming, standard live streaming, short video, RTC co-streaming, and basic retouching.
implementation 'com.aliyun.aio:AliVCSDK_Standard:7.11.0'
// 2. Basic live streaming SDK: Includes playback, live stream ingest, basic retouching, and real-time streaming.
implementation 'com.aliyun.aio:AliVCSDK_BasicLive:7.11.0'
// 3. Short video SDK: Includes playback, short video, and basic retouching.
implementation 'com.aliyun.aio:AliVCSDK_UGC:7.11.0'
// 4. Interactive streaming SDK: Includes playback, real-time streaming, live stream ingest, RTC co-streaming, and basic retouching.
implementation 'com.aliyun.aio:AliVCSDK_InteractiveLive:7.11.0'

Integração manual

Baixe um SDK baseado em cenário para Android.
Copie o arquivo .aar do SDK para o diretório libs do módulo do seu aplicativo.
No arquivo build.gradle no nível do projeto, adicione a configuração flatDir ao nó repositories dentro do bloco allprojects.
```
flatDir {
   dirs 'libs'
}
```
No arquivo build.gradle no nível do aplicativo, adicione a referência ao AAR no bloco dependencies.
```
dependencies {
      implementation fileTree(dir: 'libs', include: ['*.aar'])
}
```

Etapa 2: Configurar a licença do SDK

Antes da primeira integração, adquira uma licença e vincule-a ao seu aplicativo.

Etapa 3: Configurar permissões do aplicativo

Adicione as permissões necessárias ao arquivo src/main/AndroidManifest.xml.

<!-- Permissions for short video -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-permission android:name="android.permission.RECORD_VIDEO" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- Permissions for standard live streaming -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.REORDER_TASKS" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />  <!-- Add the microphone permission-->
<uses-permission android:name="android.permission.CAMERA" />  <!-- Add the camera permission-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

Etapa 4: Configurar regras de ofuscação

Adicione as seguintes regras ao arquivo proguard-rules.pro.

###################### Obfuscation rules for playback #########################
-keep class com.alivc.**{*;}
-keep class com.aliyun.**{*;}
-keep class com.cicada.**{*;}
-dontwarn com.alivc.**
-dontwarn com.aliyun.**
-dontwarn com.cicada.**

###################### Obfuscation rules for short video #########################
-keep class com.aliyun.**{*;}
-keep class com.duanqu.**{*;}
-keep class com.qu.**{*;}
-keep class com.alibaba.**{*;}
-keep class component.alivc.**{*;}
-keep class com.alivc.**{*;}
-keep class org.webrtc.**{*;}
-keep class org.ugsv.**{*;}

###################### Obfuscation rules for standard live streaming #########################
-keep class com.alivc.** { *;}
-keep class com.aliyun.rts.network.* { *;}
-keep class org.webrtc.ali.** {*;}
-keep class org.webrtc.utils.** {*;}

Perguntas frequentes

As Perguntas frequentes abordam dúvidas específicas sobre recursos.