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
-
Especifique a URL do repositório Maven no arquivo build.gradle do projeto.
maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" } -
Adicione a dependência do SDK ao bloco
dependenciesno arquivo build.gradle do módulo do aplicativo.// Push SDK basic edition implementation 'com.alivc.pusher:AlivcLivePusher:x.y.z'NotaO valor
x.y.zrepresenta 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.
-
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
Baixe e descompacte o pacote do Push SDK para Android.
Copie o arquivo AAR para a pasta libs do módulo do aplicativo.
-
No arquivo build.gradle do projeto, adicione a configuração
flatDirna seçãorepositoriesdo blocoallprojects.flatDir { dirs 'libs' } -
Inclua a referência ao arquivo AAR no bloco
dependenciesdo 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
Para obter informações detalhadas sobre a API, consulte Referência de API do Push SDK para Android (edição básica).
Para ver exemplos de código sobre como usar os recursos do SDK, consulte Usar o Push SDK para Android.