ApsaraVideo VOD:Preparação para integração

Configure seu ambiente de desenvolvimento

Antes de usar o AliPlayerKit, verifique se seu ambiente de desenvolvimento atende aos seguintes requisitos:

• JDK 11

  • Configure o JDK em Preferences → Build, Execution, Deployment → Build Tools → Gradle → Gradle JDK.

  • Selecione a versão 11. Caso a versão 11 não esteja disponível, atualize o Android Studio.

• Ambiente de desenvolvimento Android

  • Instale a versão mais recente do Android Studio.

  • Configure o Android SDK. O nível mínimo de API compatível é 21 (Android 5.0).

  • Recomendamos usar compileSdkVersion 31 ou superior.

  • Use Gradle versão 7,0 ou superior.

Prepare sua licença

Obtenha o certificado e a chave de licença do player para o ApsaraVideo Player SDK. Para mais informações, consulte Gerencie Licenças.

Etapa 1: Copie o módulo de componente

Copie o diretório do módulo principal playerkit (biblioteca) para o seu projeto:

# Copy the playerkit core module to your project root directory
# Note: Copy only the playerkit directory—not the entire project or example modules such as playerkit-examples or playerkit-scenes
cp -r playerkit /path/to/your/project/

Etapa 2: Configure seu projeto Gradle

repositories {
    // aliyun maven
    maven { url "https://maven.aliyun.com/repository/releases" }
}

repositories {
    // aliyun maven
    maven("https://maven.aliyun.com/repository/releases")
}

include ':playerkit'

include(":playerkit")

dependencies {
    // AliPlayerKit core module: Provides an out-of-the-box, configurable player UI component. Supports basic playback and common interactions.
    implementation project(':playerkit')
}

dependencies {
    // AliPlayerKit core module: Provides an out-of-the-box, configurable player UI component. Supports basic playback and common interactions.
    implementation(project(":playerkit"))
}

Etapa 3: Configure sua licença

<meta-data
    android:name="com.aliyun.alivc_license.licensekey"
    android:value="Your License Key" />
<meta-data
    android:name="com.aliyun.alivc_license.licensefile"
    android:value="assets/cert/license.crt" />          

Etapa 4: Verifique a integração

./gradlew clean assemble --stacktrace --info

git add .
git commit -m "feat: integrate AliPlayerKit module (source commit: 2c30d92)"            

Etapa 1: Copie os módulos de cenário

Copie os módulos de cenário necessários para o seu projeto conforme suas necessidades de negócios:

# scene-common includes sample video constants. Skip it if you implement your own video source.
cp -r playerkit-scenes/scene-common /path/to/your/project/

# Choose other scenario modules as needed.
cp -r playerkit-scenes/scene-longvideo /path/to/your/project/
cp -r playerkit-scenes/scene-live /path/to/your/project/
# ...         

Etapa 2 (Opcional): Resolva as dependências do módulo

Os arquivos build.gradle dos módulos de cenário dependem de demo-settings e scene-common. Ajuste essas dependências conforme suas necessidades:

dependencies {
    // ...
    // Delete this line: demo-settings is used only for demos.
    // implementation project(':demo-settings')
}          

dependencies {
    // ...
    // Comment out or delete this line if you implement your own video source.
    // implementation project(':scene-common')
}          

// ===== Original code (uses demo-settings / scene-common)=====
import com.aliyun.playerkit.example.settings.link.LinkConstants;
import com.aliyun.playerkit.example.settings.storage.SPManager;
import com.aliyun.playerkit.scenes.common.SceneConstants;

private String getVideoVid() {
    String savedVid = SPManager.getInstance().getString(LinkConstants.KEY_VIDEO_VID);
    return StringUtil.isNotEmpty(savedVid) ? savedVid : SceneConstants.LANDSCAPE_SAMPLE_VID;
}

// ===== Updated (use your video source)=====
private String getVideoVid() {
    return "Your video Vid";  // Or fetch it from your business API.
}

private String getVideoPlayAuth() {
    return "Your PlayAuth";  // Or fetch it from your business API.
}           

Etapa 3: Configure seu projeto Gradle

include ':scene-common'
include ':scene-longvideo'
// Add other scenario modules as needed...

include(":scene-common")
include(":scene-longvideo")
// Add other scenario modules as needed...

dependencies {
    // AliPlayerKit scenario modules: Built on the AliPlayerKit core component. Provide out-of-the-box standard playback solutions.
    // Long-form video scenario module: Provides a complete solution for long-form video playback.
    implementation project(':scene-longvideo')
}

dependencies {
    // AliPlayerKit scenario modules: Built on the AliPlayerKit core component. Provide out-of-the-box standard playback solutions.
    // Long-form video scenario module: Provides a complete solution for long-form video playback.
    implementation(project(":scene-longvideo"))
}

Etapa 4: Verifique a integração

Sincronize o Gradle e compile o projeto para confirmar se as dependências e configurações do módulo estão corretas:

./gradlew clean assemble --stacktrace --info       

Visualize as informações de versão

As versões atuais do SDK das quais o AliPlayerKit depende estão definidas no arquivo playerkit/build.gradle.

Consulte as versões mais recentes e a documentação dos SDKs relacionados nestes links:

• Baixe o Player SDK.

• Android SDK Release History.

• Implement RTS Stream Pulling on Android.

Etapas de atualização

1. Verifique a compatibilidade de versões

   Antes de atualizar, revise o histórico de lançamentos e o log de atualizações do SDK. Verifique se a versão alvo introduz alterações disruptivas ou outros ajustes de compatibilidade.

2. Atualize o número da versão

   No arquivo playerkit/build.gradle, atualize os números de versão do SDK:

   def player_sdk_version = "x.x.x"  // Replace with your target version
   api "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full"
   
   // RtsSDK version must match the player SDK version.
   def rts_sdk_version = "x.x.x"  // Replace with your target version
   api "com.aliyun.rts.android:RtsSDK:$rts_sdk_version"            

3. Verifique a atualização:

   • Limpe e recompile seu projeto:

     ./gradlew clean assemble --stacktrace --info                

   • Teste as funções principais de reprodução: play, pause, seek e velocidade de reprodução.

   • Teste cenários específicos de reprodução, como a transmissão ao vivo de Real-Time Streaming (RTS) com latência ultrabaixa.

Problemas de licença

Problema: O player exibe um erro de licença.

Solução:

1. Confirme se o certificado de licença e a chave foram configurados corretamente.

2. Verifique se a licença expirou.

3. Certifique-se de que o nome do pacote do aplicativo corresponde ao nome do pacote vinculado à licença.

4. Sem a configuração correta da licença, a reprodução falhará após a integração. Pode ocorrer tela preta ou outro comportamento anormal.

Conflitos de dependência

Problema: A sincronização do Gradle falha com um erro de conflito de dependência.

Solução:

1. Verifique se o projeto já contém versões diferentes da mesma dependência.

2. Use exclude para remover dependências conflitantes.

3. Padronize as versões das dependências em todo o projeto.

4. Caso o projeto já use a mesma biblioteca de terceiros, ajuste o número da versão no módulo playerkit para garantir compatibilidade e evitar conflitos.

Falha na inicialização

Problema: A chamada de AliPlayerKit.init() gera uma exceção.

Solução:

1. Confirme se o Context não é nulo.

2. Chame o método em Application.onCreate().

3. Verifique se há chamadas duplicadas. Chamadas duplicadas são ignoradas e não geram exceções.

Problemas de configuração de versão do SDK

Problema: A compilação falha com um erro de incompatibilidade de versão do SDK.

Solução:

Garanta que as configurações do módulo playerkit, como compileSdkVersion, buildToolsVersion, minSdkVersion e targetSdkVersion, correspondam às definições do seu projeto.

Problemas de namespace

Problema: Após copiar os módulos, a compilação falha com erros relacionados ao namespace.

Solução:

O arquivo build.gradle de cada módulo declara um namespace por padrão para oferecer suporte ao Android Gradle Plugin (AGP) 7.x e superior. Ajuste essa configuração conforme a versão do seu AGP:

Local da configuração: Dentro do bloco android {} no arquivo build.gradle de cada módulo.

android {
    /// Integration FAQ
    /// Notes about namespace declaration:
    /// - AGP version ≥ 8.0 (for example, 8.3.2): namespace must be declared.
    /// - AGP version < 7.0 (for example, 4.0.1): remove namespace declaration. Use the package attribute in AndroidManifest.xml.
    /// - AGP version 7.x: namespace declaration is optional. We recommend declaring it to support future upgrades.
    namespace = "com.aliyun.playerkit"
    // ...
}  

Emulador não suportado

Problema: Ocorre um erro ao executar em um emulador.

Solução:

O ApsaraVideo Player SDK não suporta emuladores. Teste em um dispositivo físico após a integração.

Conflito de prioridade de repositório

Problema: O Gradle relata um conflito ao resolver prioridades de repositório.

Solução:

Para resolver isso, declare os repositórios no seu arquivo settings.gradle.