Todos os produtos
Search
Central de documentação

ApsaraVideo Live:Integração do SDK

Última atualização: Jun 30, 2026

Este tópico descreve como integrar o Push SDK para Android.

Requisitos de ambiente

Item

Descrição

Ferramenta de desenvolvimento

Recomendamos o Android Studio.

Versão do Android

Requer Android 5.0 ou superior.

Etapa 1: Integrar o Push SDK para Android

(Recomendado) Integrar o SDK via Maven

  1. Especifique a URL do repositório Maven no arquivo build.gradle do projeto.

    maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
  2. Adicione a dependência do SDK ao bloco dependencies no arquivo build.gradle do módulo do aplicativo.

    // Push SDK basic edition
    implementation 'com.alivc.pusher:AlivcLivePusher:x.y.z'
    Nota
    • O valor x.y.z representa a versão do Push SDK para Android. Substitua-o pela versão real, como 7.4.0. Para obter informações sobre a versão mais recente, consulte Baixe o SDK.

    • Não é possível integrar o Push SDK e o Player SDK (AliyunPlayer) simultaneamente. Caso precise de ambos, use o ApsaraVideo MediaBox SDK. Para mais detalhes, consulte Baixar SDKs tudo-em-um e Integração rápida.

  3. Defina a arquitetura de CPU do aplicativo no arquivo build.gradle do módulo do aplicativo.

    defaultConfig {
     ndk {
     abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
     }
    }

Integrar o SDK manualmente

  1. Baixe e descompacte o pacote do Push SDK para Android.

  2. Copie o arquivo AAR para a pasta libs do módulo do aplicativo.

  3. No arquivo build.gradle do projeto, adicione a configuração flatDir na seção repositories do bloco allprojects.

    flatDir {
     dirs 'libs'
    }
  4. Inclua a referência ao arquivo AAR no bloco dependencies do arquivo build.gradle do módulo do aplicativo.

    dependencies {
     implementation fileTree(dir: 'libs', include: ['*.aar'])
    }

Etapa 2: Configure uma licença

Para saber como configure uma licença para o SDK, consulte Integrar uma licença do Push SDK.

Etapa 3: Configure permissões do aplicativo

Configure as permissões necessárias no arquivo src/main/AndroidManifest.xml do módulo do aplicativo.

<!--  Used for network features  -->
<uses-permission android:name="android.permission.INTERNET" />
<!--  To check the network connection state of the device, you'll need to add the ACCESS_NETWORK_STATE permission.  -->
<!--  This permission does not require user consent at runtime, but needs to be declared in the app's AndroidManifest.xml.  -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!--  If the app needs to record audio, you need to declare the RECORD_AUDIO permission and request this permission at runtime  -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<!--  The application needs to access the device's camera  -->
<uses-permission android:name="android.permission.CAMERA" />

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

<!-- Only used by Demo for accessing storage files  -->
<!--  Storage permissions  -->
<uses-permission
  android:name="android.permission.READ_EXTERNAL_STORAGE"
  android:maxSdkVersion="32" />
<!-- Access image files -->
<uses-permission
  android:name="android.permission.READ_MEDIA_IMAGES"
  android:minSdkVersion="33" />
<!-- Write audio files -->
<uses-permission
  android:name="android.permission.READ_MEDIA_AUDIO"
  android:minSdkVersion="33" />
<!-- Write video files -->
<uses-permission
  android:name="android.permission.READ_MEDIA_VIDEO"
  android:minSdkVersion="33" />

<!-- Only used by Demo for screen recording and streaming  -->
<!-- Used for creating background tasks, not required by SDK -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- Requesting permission to create system overlay windows -->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

<!-- Only used by Demo for muting  -->
<!-- If this permission is not declared, the feature of automatically muting the stream during a phone call will not work -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Etapa 4: Configure regras de ofuscação

Adicione regras de ofuscação ao arquivo proguard-rules.pro do módulo do aplicativo.

-keep class org.webrtc.** { *; }
-keep class com.alivc.** { *; }
-keep class com.aliyun.** { *; }
-keep class com.cicada.** { *; }

Observações de uso