Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Integrar o SDK

Última atualização: Jun 27, 2026

Integre o Short Video SDK para iOS usando o CocoaPods (pod).

Pré-requisitos

O ambiente de desenvolvimento deve atender aos seguintes requisitos:

Item

Descrição

Versão do SO

iOS 9.0 ou posterior.

Versão do macOS High Sierra

macOS High Sierra 10.13 ou posterior.

Versão do Xcode

Xcode 9.0 ou posterior. Baixe Xcode.

Edições do SDK

O Short Video SDK tem três edições — Professional, Standard e Basic — que usam a biblioteca AliVCSDK_ShortVideo.framework. Obtenha uma licença para a edição adequada às suas necessidades.

  • A Basic Edition oferece suporte apenas a gravação e recorte.

  • As edições Professional e Standard incluem todos os recursos. A Standard Edition exige autorização separada para operações avançadas da API.

Nota

Consulte as notas de versão para verificar atualizações do SDK.

Integração

  • Para usar o Short Video SDK e o Player SDK simultaneamente, integre o ApsaraVideo MediaBox SDK para iOS. Esse SDK unificado evita conflitos de dependência comuns em integrações separadas.

  • Se preferir integrar o Short Video SDK e o Player SDK separadamente, use versões compatíveis de ambos os SDKs e do AlivcFFmpeg para evitar falhas nos recursos. Consulte as dependências de versão do AlivcFFmpeg.

Integração via Pod

  1. Adicione as dependências ao Podfile conforme a versão do SDK.

    Importante
    • O Short Video SDK 3.24.0 ou posterior exige o FFmpeg 4.3.0 ou posterior.

    • Verifique o acesso à rede do repositório de pods. Após executar pod install, confirme se a versão do framework corresponde à mais recente no site oficial.

    • Para enviar arquivos de mídia ao ApsaraVideo VOD com dependências mínimas, integre também o Upload SDK.

    • Para a versão V7.0.0 ou posterior

      pod 'AliVCSDK_ShortVideo', '~> 7.11.0'
    • Para a versão V6.21.0 ou anterior

      pod 'AliyunVideoSDKBasic', '~> 6.21.0' // Required for the Basic Edition
      pod 'AliyunVideoSDKStd', '~> 6.21.0'	// Required for the Standard Edition
      pod 'AliyunVideoSDKPro', '~> 6.21.0'	// Required for the Professional Edition
  2. Atualize o repositório de pods.

    pod repo update
  3. Instale o pod.

    pod install

Configuração do projeto

Após a integração, configure os seguintes itens no Xcode:

  1. Em Build Settings > Linking > Other Linker Flags, adicione a flag -ObjC.

  2. No arquivo Info.plist do projeto, adicione as seguintes permissões:

    Privacy - Camera Usage Description
    Privacy - Microphone Usage Description
    Privacy - Photo Library Usage Description

Configuração da licença

Após obter uma licença, configure o arquivo correspondente. Consulte Obter uma licença para o Short Video SDK.

Importe o arquivo de licença para o projeto do aplicativo e adicione dois pares chave-valor ao Info.plist. Defina AlivcLicenseKey como sua chave de licença e AlivcLicenseFile como o caminho do arquivo de licença relativo ao bundle principal:

Chave

Valor

AlivcLicenseKey

Sua chave de licença. Exemplo: MoCTfuQ391Z01mNqG8f8745e23c8a457a8ff8d5faedc1****

AlivcLicenseFile

O caminho do arquivo de licença incorporado relativo ao bundle principal.

Próximos passos

Inicializar o SDK

Integração do Player

Para usar o Short Video SDK e o Player SDK simultaneamente, utilize o ApsaraVideo MediaBox SDK para iOS e evite falhas de compilação por classes duplicadas.

Documentos relacionados