Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Integrar o SDK

Última atualização: Jun 27, 2026

Integre rapidamente o ApsaraVideo Player SDK for iOS ao seu projeto.

Requisitos

  • Sistema operacional: iOS 8.0 ou posterior.

  • Ferramenta de desenvolvimento: recomenda-se o Xcode. Este tópico usa o Xcode. Baixe em: ‎Xcode.

  • O ApsaraVideo Player SDK for iOS não oferece suporte a simuladores. Execute os aplicativos em um dispositivo físico.

Pré-requisitos

  • Obtenha um arquivo de licença para autorização do player, como AliVideoCert-********.crt. Para mais informações, consulte Obter uma licença.

  • Para integração manual, baixe o pacote mais recente do ApsaraVideo Player SDK for iOS. Consulte baixe.

Observações de uso

  • Ao empacotar seu aplicativo, use o arquivo dSYM para simbolizar relatórios de falha.

  • O ApsaraVideo Player SDK for iOS requer os frameworks AlivcFFmpeg e AliyunPlayer. Os arquivos de cabeçalho do player estão no AliyunPlayer.

  • Se você integrar o SDK do player e o SDK de vídeo curto, garanta a compatibilidade de versões entre o SDK de vídeo curto, o SDK do player e o AlivcFFmpeg. Versões incompatíveis podem causar falhas nos recursos. Para mais informações, consulte Dependências do AlivcFFmpeg.

  • O pacote do ApsaraVideo Player SDK for iOS inclui arquiteturas de simulador. Remova-as antes de enviar seu aplicativo à App Store para evitar rejeição.

Tutorial em vídeo

Etapa 1: Integrar o SDK

Integração via CocoaPods

  1. Instale o CocoaPods. É necessário um ambiente Ruby.

    // In Terminal, run the following command:
    sudo gem install cocoapods
  2. Verifique a instalação do CocoaPods.

    Execute pod --version no terminal para confirmar a instalação.

    xxx@ ~ % pod --version
    1.16.2
  3. Crie um Podfile.

    No terminal, acesse o diretório do projeto e execute pod init para gerar um Podfile.

    // Go to your project directory.
    xxx@ ~ %  cd /path/yourProject
    // Generate the Podfile.
    xxx@ yourProject % pod init
  4. Edite o Podfile para adicionar a dependência do SDK do player.

    Nota
    • Para integrar o SDK do player e o SDK de vídeo curto, substitua AliPlayerSDK_iOS no código abaixo por AliPlayerPartSDK_iOS. O AliPlayerPartSDK_iOS não inclui o FFmpeg, o que evita conflitos com o FFmpeg presente no SDK de vídeo curto.

    • Insira o número de versão correto do SDK do player. Caso contrário, a importação falhará e retornará um erro. Para verificar as versões do SDK do player, consulte Notas de lançamento do ApsaraVideo Player SDK for iOS.

    source 'https://github.com/CocoaPods/Specs.git'
    platform:ios, '8.0'
    
    target 'yourProject' do
        # Player SDK. We recommend that you use the latest version.
        pod 'AliPlayerSDK_iOS'
    end
  5. (Opcional) Adicione uma dependência para uma versão específica do SDK do player.

    source 'https://github.com/CocoaPods/Specs.git'
    platform:ios, '8.0'
    
    player_sdk_version = '7.15.0'
    
    target 'yourProject' do
        # Player SDK. We recommend that you use the latest version.
        pod 'AliPlayerSDK_iOS' , player_sdk_version
    end
  6. Instale as dependências.

    Execute o comando a seguir para instalar as dependências.

    pod install

    A saída abaixo indica que a instalação foi bem-sucedida.

    xxx@ yourProject % pod install
    Analyzing dependencies
    Downloading dependencies
    Installing AliPlayerSDK_iOS (7.15.0)
    Generating Pods project
    Integrating client project
    Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

    Execute o comando a seguir para atualizar o SDK do player.

    pod update AliPlayerSDK_iOS

Integração manual

Nota

Se você integrar o SDK do player e o SDK de vídeo curto, importe apenas um framework AlivcFFmpeg e certifique-se de usar a versão correta.

  1. Baixe o ApsaraVideo Player SDK for iOS.

  2. Adicione os frameworks do player em Frameworks, Libraries, and Embedded Content e defina Embed como Embed & Sign.

    • alivcffmpeg.framework: framework base do player.

    • AliyunMediaDownloader.framework: usado para download offline.

    • AliyunPlayer.framework: framework do player.

      本地集成

  3. Clique em na aba Build Settings.

  4. Na seção Search Paths, defina Framework Search Paths para o diretório local dos seus frameworks.

(Opcional) Integração RTS (CocoaPods)

Para integrar o componente Real-Time Streaming (RTS), consulte Implementar pull de stream baseado em RTS no iOS.

Etapa 2: Configurar a licença

Importante

Ao usar o player em regiões fora da China continental, Hong Kong e Macau (site internacional), chame a API a seguir para definir o ambiente antes de invocar qualquer outra API do player.

  1. Método 1: Chame a API abaixo para atualizar a configuração padrão para o ambiente do site internacional.

    // For the international site, you must call this API before any other player APIs
    // to set the environment. This setting cannot be changed at runtime.
    AlivcBase.EnvironmentManager.globalEnvironment = ENV_SEA;
  2. Método 2 (Recomendado): Para versões do SDK do player 7.6.0 e posteriores, configure o ambiente do site internacional no arquivo Info.plist.

    Abra o arquivo Info.plist e altere o valor de AlivcEnv para SEA.

    // Configure the current environment as the international site.
    <key>AlivcEnv</key>
    <string>SEA</string>

    A figura a seguir mostra um exemplo de configuração: 1754557498401-1d235342-3c0b-4c83-bcee-ae7656e8ff23

Para configurar a licença no seu cliente iOS, consulte Configurar uma licença no iOS.

Etapa 3: Ativar logs (Opcional)

Ative os logs para facilitar a solução de problemas. Para obter instruções sobre como acessar os logs, consulte Obter logs do SDK.

// Enable logging.
[AliPlayer setEnableLog:YES];
// Set the log level. The default is LOG_LEVEL_INFO. For troubleshooting, set it to LOG_LEVEL_TRACE.
[AliPlayer setLogCallbackInfo:LOG_LEVEL_INFO callbackBlock:nil];

Estrutura do projeto

Framework

Descrição

alivcffmpeg.framework

Framework base do player. Obrigatório.

AliyunMediaDownloader.framework

Usado para download offline. Opcional.

AliyunPlayer.framework

Framework do player. Obrigatório.

artcSource.framework

Oferece suporte ao protocolo ARTC. Opcional.

Nota

Para oferecer suporte ao protocolo ARTC, adicione também o RtsSDK.framework. Para detalhes de integração, consulte Implementar pull de stream baseado em RTS no iOS.

aemFilter.framework

Habilita aprimoramento de áudio. Opcional.

libPluginSR.framework

Habilita super-resolução. Opcional.

normalsrFilter.framework

Habilita super-resolução. Opcional.

srFilter.framework

Habilita super-resolução. Opcional.

vfiFilter.framework

Habilita inserção de quadros de vídeo. Opcional.

vvcCodecPlugin.framework

Plugin de decodificação H.266. Opcional.

Perguntas frequentes

Uso do CocoaPods

// Deintegrate your project from CocoaPods dependencies.
pod deintegrate 

// Update the index of your local CocoaPods source repositories.
// Use case:
// - When you add a new dependency, this ensures you can fetch the latest available version.
// - When a specific library version is unavailable or you know a new version exists but does not appear in your project, use this command to update.
pod repo update

// Update the project's Pods.
// Use case:
// - Use this when you want to update all pods in your project to the latest supported versions allowed by your Podfile.
pod update

// Performs the same function as 'pod install' but forces an update of the local CocoaPods repository index before installing.
// Use case:
// - This is a good command to use when you add new libraries or want to use the latest version of a library specified in your Podfile, especially if you see an error message indicating that a required library version is unavailable.
pod install --repo-update

// Clear the Pods cache.
// Note:
// 1. Clearing the cache does not modify your Podfile.lock or Podfile. When you run 'pod install' or 'pod update', CocoaPods re-downloads the required libraries based on your manifest and lockfile.
// 2. Clearing the cache is not a regular step and should only be used to resolve specific issues. Normally, CocoaPods manages its cache well.
pod cache clean --all

Conflitos de símbolos com AlivcFFmpeg

Solução:

  • Se encontrar conflitos de símbolos com o AlivcFFmpeg, remova a dependência redundante. Mantenha a versão fornecida com o ApsaraVideo Player SDK for iOS e remova a versão de terceiros. Isso pode afetar a funcionalidade do player de terceiros.

Erro de sandbox

  • Problema:

    截屏2024-12-06 16

  • Solução:

    Em UserSetting, defina User Script SandBoxing como NO.

    1735888658101-5633103e-468d-4341-adaa-f5f52814aa36

Integração com SDK de vídeo curto

Para integrar o ApsaraVideo Player SDK for iOS e o SDK de vídeo curto, use o SDK tudo-em-um para iOS para evitar problemas de classes duplicadas e falhas de compilação.

Para mais problemas e soluções relacionados ao player, consulte Perguntas frequentes sobre o ApsaraVideo Player.

Referências

Recursos básicos

Recursos avançados