ApsaraVideo Live:SDK download and integration

Integração automática via Maven (recomendado)

1. Abra o arquivo settings.gradle na raiz do projeto. Adicione o repositório Maven do ARTC SDK em dependencyResolutionManagement/repositories:

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
           // Add the Maven repository for the ARTC SDK.
           maven { url 'https://maven.aliyun.com/repository/google' }
           maven { url 'https://maven.aliyun.com/repository/public' }
       }
   }

   Nota

   Se a versão do seu Android Gradle Plugin (AGP) for inferior a 7.1.0, o arquivo settings.gradle pode não conter o bloco dependencyResolutionManagement, conforme documentado nas Notas de lançamento do Android Gradle Plugin 7.1. Nesse caso, adote a seguinte abordagem:

   Versão do AGP inferior a 7.1.0

   Abra o arquivo build.gradle no diretório raiz do projeto. Adicione o repositório Maven em allprojects/repositories:

   allprojects {
       repositories {
           ...
           // Add the Maven repository for the ARTC SDK.
           maven { url 'https://maven.aliyun.com/repository/google' }
           maven { url 'https://maven.aliyun.com/repository/public' }
       }
   }

2. Abra o arquivo app/build.gradle. Adicione a dependência do ARTC SDK em dependencies. Substitua \${latest_version} pelo número real da versão. A versão mais recente é a 7.11.0.

   dependencies {
       // Add the ARTC SDK dependency.
       // Replace ${latest_version} with the actual version number.
       implementation 'com.aliyun.aio:AliVCSDK_ARTC:${latest_version}'
       // For version 7.4.0 and earlier, also add the keep dependency.
       // implementation 'com.aliyun.aio.keep:keep:1.0.1'
   }

   Para AGP 8.1 ou superior, considere migrar para catálogos de versões. Consulte Migrar dependências para catálogos de versões.

Integração manual por baixe do SDK

1. Baixe o arquivo AAR do ARTC SDK na seção de baixe do SDK. A versão mais recente é a 7.11.0. Formato do nome do arquivo: AliVCSDK_ARTC-x.y.z.aar.

2. Copie o arquivo AAR para o diretório do projeto (por exemplo, app/libs). Crie o diretório se necessário.

3. Abra o arquivo settings.gradle na raiz do projeto. Adicione o diretório do arquivo AAR em dependencyResolutionManagement/repositories:

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
           // Add the relative path to the ARTC SDK AAR file.
           flatDir {
               dir 'app/libs'
           }
       }
   }

   Para versões do AGP abaixo de 7.1.0, adicione o seguinte trecho em allprojects/repositories no arquivo build.gradle:

   allprojects {
       repositories {
           ...
           // Add the relative path to the ARTC SDK AAR file.
           flatDir {
               dir 'app/libs'
           }
       }
   }

4. Abra o arquivo app/build.gradle. Adicione a dependência do AAR em dependencies:

   // Replace x.y.z with the actual version number.
   implementation(name:'AliVCSDK_ARTC', version: 'x.y.z', ext:'aar')

5. Após a compilação, a dependência aparecerá em External Libraries.

   External Libraries
     > < Android API 35, extension level 13 Platform > /Users/wy/Libra...
     > < jbr-21 > /Applications/Android Studio.app/Contents/jbr/Conte...
     > Gradle: :AliVCSDK_ARTC:7.2.0@aar
     > Gradle: androidx.activity:activity:1.8.0@aar

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

Solicitar permissões de Bluetooth dinamicamente

O ARTC SDK agrupa essas permissões em seu próprio arquivo AndroidManifest.xml. A partir do Android 12, a permissão BLUETOOTH_CONNECT exige solicitação em tempo de execução:

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

Caso seu aplicativo não necessite de Bluetooth, remova a declaração do arquivo AndroidManifest.xml:

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

<!-- Declare Bluetooth permission. -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<!-- Override removal of high-version API 31+ permission. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- Declare Bluetooth permission with android:maxSdkVersion set to 30 for backward compatibility. -->
<uses-permission android:name="android.permission.BLUETOOTH"/>
<!-- Declare high-version API 31+ Bluetooth permission. -->
<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 built-in 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" />

Outras permissões dinâmicas

A partir do Android 6.0 (API 23), estas permissões também exigem solicitações em tempo de execução, além das declarações no arquivo AndroidManifest.xml:

• Manifest.permission.CAMERA

• Manifest.permission.WRITE_EXTERNAL_STORAGE

• Manifest.permission.RECORD_AUDIO

• Manifest.permission.READ_EXTERNAL_STORAGE

• Manifest.permission.READ_PHONE_STATE

Para Android 12 (API 31) e versões posteriores, solicite também esta permissão em tempo de execução:

• Manifest.permission.BLUETOOTH_CONNECT

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

Integração automática via CocoaPods (recomendado)

1. Instale o CocoaPods caso ainda não esteja instalado:

   sudo gem install cocoapods

2. Acesse a raiz do projeto e crie um Podfile:

   pod init

3. Abra o arquivo Podfile e adicione a dependência do ARTC SDK. A versão mais recente é a 7.11.0.

   target 'MyApp' do
     use_frameworks!
     # Replace ${latest version} with the actual version number.
     pod 'AliVCSDK_ARTC', '~> ${latest version}'
   end

4. Instale as dependências:

   pod install

5. Um arquivo .xcworkspace será gerado. Abra-o para iniciar o projeto no Xcode.

Após abrir o projeto, expanda a pasta Pods no navegador de projetos do Xcode à esquerda. Confirme se ela contém a subpasta AliVCSDK_ARTC, o que indica que a dependência do SDK foi integrada com sucesso.

Integração manual por baixe do SDK

1. Baixe e extraia a versão mais recente do ARTC SDK na seção de baixe do SDK.

2. Copie o arquivo de framework do SDK extraído para o diretório do projeto.

3. Abra o projeto no Xcode. Selecione File > Add Files to "xxx" para adicionar o arquivo de biblioteca do SDK ao projeto.

4. Selecione o alvo e defina o atributo do framework importado. Na seção Frameworks, Libraries, and Embedded Content, confirme se a coluna Embed para alivcffmpeg.framework e AliVCSDK_ARTC.framework está definida como Do Not Embed.

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