Todos os produtos
Search

Este produto

    Apsara Video SDK:Primeiros passos no iOS

    Central de documentação

    Apsara Video SDK:Primeiros passos no iOS

    Última atualização: Jul 08, 2026

    Este tópico descreve como integrar rapidamente o ApsaraVideo MediaBox SDK para iOS em diferentes cenários de negócios.

    Importante

    Ao atualizar da versão 6.6.0 ou anterior do SDK para a versão 6.7.0 ou posterior, consulte as Atualizações sobre os efeitos de retoque integrados do ApsaraVideo MediaBox SDK V6.7.0.

    Requisitos

    Item

    Descrição

    macOS

    macOS High Sierra 10.13 ou posterior.

    Xcode

    Os procedimentos deste tópico utilizam o Xcode. Baixe o Xcode na App Store.

    Versão do iOS

    iOS 9.0 ou posterior.

    Etapa 1: Integrar o SDK

    Integração via CocoaPods

    1. No diretório do projeto, execute o comando pod init para crie um Podfile.

    2. Modifique o Podfile para adicionar a dependência do SDK.

      A versão do SDK no código abaixo serve apenas como referência. Para obter a versão mais recente, consulte os SDKs específicos por cenário.

      # Choose one of the following four scenario-specific SDKs.

# 1. Standard SDK: player + real-time streaming (RTS) + live stream ingest + short video + RTC co-streaming + basic retouching
pod 'AliVCSDK_Standard', '7.11.0'
# 2. Basic Live SDK: player + live stream ingest + basic retouching + real-time streaming (RTS)
pod 'AliVCSDK_BasicLive', '7.11.0'   
# 3. Short Video SDK: player + short video + basic retouching
pod 'AliVCSDK_UGC', '7.11.0'  
# 4. Interactive Live SDK: player + real-time streaming (RTS) + live stream ingest + RTC co-streaming + basic retouching
pod 'AliVCSDK_InteractiveLive', '7.11.0'

    3. Execute o comando pod install para instale o SDK.

      Após a conclusão do comando, um arquivo .xcworkspace será gerado no diretório do projeto. Esse arquivo indica que a integração do SDK foi concluída.

    Integração manual

    Nota

    • Ao enviar o aplicativo para a App Store, remova as arquiteturas de simulador (como x86_64) do framework dinâmico. Caso contrário, o aplicativo será rejeitado. A integração via CocoaPods executa essa etapa automaticamente.

    • Se ocorrer um erro de compilação, no projeto Xcode, defina Targets > Build Settings > Apple Clang - Language > Compile Sources As como Objective-C++.

    1. Baixe e descompacte o SDK específico por cenário necessário para iOS.

    2. Adicione as dependências do SDK.

      No projeto Xcode, em Targets > General > Frameworks, Libraries, and Embedded Content, importe as dependências AliVCSDK_***.framework e alivcffmpeg.framework. Importe outras dependências do pacote do SDK conforme necessário. Em seguida, defina a opção Embed de cada dependência como Embed & Sign.

    3. Inclua outras dependências de biblioteca.

      No projeto Xcode, em Targets > General > Frameworks, Libraries, and Embedded Content, adicione as dependências MobileCoreServices.framework, SystemConfiguration.framework, CoreTelephony.framework, CoreMedia.framework, VideoToolbox.framework, AVFoundation.framework e libresolv.tbd.

    4. Caso o pacote do SDK inclua um resource bundle, adicione-o ao projeto.

      Importe a dependência AliyunVideoSDKPro.bundle para o projeto.

    Etapa 2: Configurar a licença

    Ao integrar o SDK pela primeira vez, você deve gerencie e configure a licença.

    Etapa 3: Configurar permissões do aplicativo

    1. No projeto Xcode, acesse Targets > Build Settings > Linking > Other Linker Flags e adicione a flag de linker -ObjC.

    2. No projeto Xcode, defina Targets > Build Settings > Build Options > Enable Bitcode como NO.

    3. Adicione as seguintes chaves de permissão de aplicativo ao arquivo Info.plist.

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

    Perguntas frequentes

    Para soluções de problemas comuns, consulte as seções específicas por recurso nas Perguntas frequentes.