Preparação para integração - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Pré-requisitos

Ambiente de desenvolvimento

Para usar o AliPlayerWidget, verifique se o ambiente de desenvolvimento atende aos seguintes requisitos:

Flutter SDK
- Versão mínima exigida: 2.10.0. Versão recomendada: 3.22.2.
- Execute flutter doctor e resolva quaisquer problemas relatados.
JDK 11

Nota
Para definir o JDK 11, acesse Preferences -> Build, Execution, Deployment -> Build Tools -> Gradle -> Gradle JDK e selecione 11. Se a versão 11 não estiver 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).
- Gradle versão 7,0 ou superior obrigatório.
Ambiente de desenvolvimento iOS
- Instale a versão mais recente do Xcode.
- Configure o CocoaPods. Versão recomendada: 1.13.0.
- Versão mínima do iOS compatível: 10,0.

Permissões

Permissões
- Ative as permissões de rede no Android e no iOS para permitir que o player carregue recursos de vídeo online.
Licença
- Verifique se você possui o certificado de licença e a License Key do SDK do player. Para mais informações, consulte Gerencie Licenças.
- Nota: Sem uma configuração de licença válida, o player não funcionará e poderá gerar uma exceção de autorização.

Para obter mais detalhes sobre a inicialização, consulte o projeto de exemplo aliplayer_widget_example.

Adicionar dependências

Geralmente, basta adicionar o aliplayer_widget, pois ele já depende do flutter_aliplayer. Caso precise usar a API subjacente diretamente (como para pré-carregamento com MediaLoader), declare também o flutter_aliplayer explicitamente como dependência.

Versão do SDK

O aliplayer_widget usa o SDK padrão do player por padrão.

Cenário	Versão recomendada	Descrição
Apenas reprodução	SDK padrão do player (Recomendado)	Use o número de versão padrão do flutter_aliplayer.
Push streaming + reprodução	Edição especial interactivelive	Recomendada apenas ao integrar capacidades de push streaming, como o flutter_livepush_plugin, e exigir consistência com o AliVCSDK subjacente.

Importante

Evite usar a edição especial interactivelive, a menos que seja estritamente necessário. Se o projeto exigir apenas funcionalidades de reprodução, fixe a versão em um número completo do SDK padrão do player. Essa prática evita a introdução desnecessária do SDK all-in-one, reduz a complexidade das dependências e previne possíveis conflitos de SDK.

Adicione as dependências usando um dos métodos abaixo:

Método 1: Usar a linha de comando

No diretório raiz do projeto, execute os seguintes comandos:

# Required
flutter pub add aliplayer_widget

# Optional: Add only if you need to use the underlying flutter_aliplayer API directly
flutter pub add flutter_aliplayer

Método 2: Adicionar manualmente

No arquivo pubspec.yaml, adicione as linhas abaixo na seção dependencies:

dependencies:
  # Required
  aliplayer_widget: <latest_version>

  # Optional: Add only if you need to use the underlying flutter_aliplayer API directly
  flutter_aliplayer: <latest_version>

Obter dependências e compilar

Após adicionar as dependências, obtenha os pacotes e compile o projeto:

Obtenha os pacotes de dependência (caso os tenha adicionado manualmente).
```
flutter pub get
```
Etapas adicionais para iOS:
```
cd ios
pod install
cd ..
```
Compile o projeto.

Gere um APK Android:
```
flutter build apk
```
Gere um aplicativo iOS:
```
flutter build ios
```
Gere um aplicativo universal:
```
flutter build
```

Após concluir essas etapas, você estará pronto para criar recursos de reprodução de vídeo com o AliPlayerWidget. Para mais detalhes, consulte Quick Start.