Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Integrar o SDK

Última atualização: Jun 27, 2026

Conheça os requisitos e limites para integrar o ApsaraVideo Player SDK for Flutter ao seu projeto.

Requisitos de ambiente

Categoria

Descrição

Versão do Flutter

Compatível com Flutter 3.22.2, canal stable.

Versão do Dart

Compatível com Dart 3.4.3

Versão do SO

Android 6.0+

Chip do telefone

Arquiteturas obrigatórias: armeabi-v7a, arm64-v8a

Ferramentas de desenvolvimento

Utilize o Android Studio ou o Visual Studio Code.

Downloads do SDK

Nota

O ApsaraVideo Player SDK for Flutter deve corresponder à versão do seu Flutter SDK. Por exemplo, o Player SDK 5.4.0 exige o Flutter SDK 2.0+. Consulte o Histórico de versões do Flutter SDK para obter detalhes sobre compatibilidade.

Descrição do projeto

O SDK do player para Flutter encapsula os SDKs nativos do ApsaraVideo Player para Android e iOS. O demo fornece o código-fonte como uma dependência que você pode adicionar ao seu projeto.

Estrutura de pastas do projeto:Flutter directory structure

Detalhes das pastas:

Nome do arquivo

Descrição

Obrigatório

android

Código nativo Android e SDK do player.

Sim

ios

Código nativo iOS e SDK do player.

Sim

lib

Código da API Flutter.

Sim

example

Demo do player Flutter.

Não

O SDK oferece suporte tanto a transmissão ao vivo quanto a reprodução. Para usar apenas a reprodução, alterne o kernel do SDK da versão completa para a versão exclusiva de reprodução. Os exemplos a seguir utilizam o projeto de demonstração.

Android

  1. Adicione o repositório Maven do Alibaba Cloud ao arquivo build.gradle no nível do projeto.

    maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
  2. Substitua o ApsaraVideo for MediaBox SDK (stream interativo) pelo ApsaraVideo Player SDK.

    Defina a variável useAIOFramework no arquivo android/build.gradle.

    Se useAIOFramework = false, serão utilizados o SDK exclusivo de reprodução e o Pulling de stream RTS para Android. Se useAIOFramework = true, será usada a versão Android (stream interativo), que suporta ingestão de streams para transmissões ao vivo, incluindo Real-Time Streaming (RTS) e co-streaming baseado em RTC, além de reprodução.

    Importante

    Atualize a versão do SDK do kernel conforme necessário. Versões mais recentes: ApsaraVideo for MediaBox SDK, ApsaraVideo Player SDK e RTS Stream Pulling.

    dependencies {
        // Define the SDK kernel.
        def useAIOFramework = false
    
        def aio_sdk_version = "x.x.x" // Latest version of ApsaraVideo for MediaBox SDK (interactive stream).
        def player_sdk_version = "x.x.x" // Latest version of ApsaraVideo Player SDK.
        def rts_sdk_version = "x.x.x" // Latest version of the RTS component.
    
        // Select the SDK based on the value of useAIOFramework.
        if (useAIOFramework) {
            // ApsaraVideo for MediaBox SDK (interactive stream): Supports stream ingest for live streaming (including RTS and RTC-based co-streaming) and playback.
            implementation "com.aliyun.aio:AliVCSDK_InteractiveLive:$aio_sdk_version"
        } else {
            // ApsaraVideo Player SDK.
            implementation "com.aliyun.sdk.android:AliyunPlayer:$player_sdk_version-full"
            // (Optional) RTS component SDK.
            implementation "com.aliyun.rts.android:RtsSDK:$rts_sdk_version"
            // (Optional) The AlivcArtc bridge layer between the player and RTS. The version number must be the same as the player SDK version. This layer must be integrated together with the RTS component.
            implementation "com.aliyun.sdk.android:AlivcArtc:$player_sdk_version" 
        }
    }

iOS

Defina a variável useAIOFramework no arquivo flutter_aliplayer.podspec.

Se useAIOFramework = false, serão utilizados o SDK exclusivo de reprodução e o Pulling de stream RTS para iOS.

Se useAIOFramework = true, será usada a versão iOS (stream interativo), que suporta ingestão de streams para transmissões ao vivo, incluindo Real-Time Streaming (RTS) e co-streaming baseado em RTC, além de reprodução.

Importante

Atualize a versão do SDK do kernel conforme necessário. Versões mais recentes: ApsaraVideo for MediaBox SDK, ApsaraVideo Player SDK e RTS Stream Pulling.

   # Define the SDK kernel.
  useAIOFramework = false

  # Define the SDK versions.
  aio_sdk_version = 'x.x.x'
  player_sdk_version = 'x.x.x'
  rts_sdk_version = 'x.x.x'

  # Select the SDK based on the value of useAIOFramework.
  if useAIOFramework
    s.subspec 'AliVCSDKFrameworks' do |ss|
    # ApsaraVideo for MediaBox SDK (interactive stream): Supports stream ingest for live streaming (including RTS and RTC-based co-streaming) and playback.
    ss.dependency 'AliVCSDK_InteractiveLive', aio_sdk_version
  end
  else
  s.subspec 'AliPlayerSDKFrameworks' do |ss|
    # Standalone ApsaraVideo Player SDK for iOS.
    ss.dependency 'AliPlayerSDK_iOS', player_sdk_version
    ss.dependency 'AliPlayerSDK_iOS_ARTC', player_sdk_version
    ss.dependency 'RtsSDK', rts_sdk_version
    end
  end

Limites

O ApsaraVideo Player SDK para Android não oferece suporte a emuladores. Utilize um dispositivo físico para testes.

Procedimento de integração

Nota

Estas etapas usam o VS Code 1.65.2 como exemplo. O procedimento é semelhante para outras IDEs.

  1. Inicie o VS Code.

  2. Escolha View > Command Palette…

  3. Insira flutter e escolha Flutter: New Project.

  4. Insira um nome para o projeto, como myapp, e pressione Enter.

  5. Após especificar o local do projeto, clique em OK.

    O projeto estará pronto quando o arquivo main.dart aparecer.

  6. Integre o ApsaraVideo Player SDK for Flutter.

    Adicione a dependência flutter_aliplayer ao arquivo pubspec.yaml:

    dependencies:
      flutter_aliplayer: ^7.0.0
    # The version is the version number of the ApsaraVideo Player SDK for Flutter, for example, 7.0.0. Change the version number as needed.
  7. Opcional: Se o seu negócio exigir suporte para RTS, adicione a dependência necessária. Consulte ApsaraVideo Player para Flutter.