Todos os produtos
Search

Este produto

    Apsara Video SDK:Integre o SDK para iOS

    Central de documentação

    Apsara Video SDK:Integre o SDK para iOS

    Última atualização: Sep 22, 2026

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

    Importante

    Se você estiver atualizando do SDK v6.6.0 ou anterior para a v6.7.0 ou posterior, consulte Updates on the integrated retouching effects of ApsaraVideo MediaBox SDK V6.7.0.

    Pré-requisitos

    Item

    Descrição

    macOS

    macOS High Sierra 10.13 ou posterior.

    Xcode

    As etapas neste tópico utilizam o Xcode. Baixe-o em Xcode.

    Versão do iOS

    iOS 9.0 ou posterior.

    Etapa 1: Integre o SDK

    pod integration (Recommended)

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

    2. Adicione a dependência do SDK ao Podfile.

      A versão do SDK no código a seguir é apenas um exemplo. Para obter a versão mais recente, consulte scenario SDKs.

      # Integrate one of the following four SDKs based on your business scenario.

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

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

      Após a execução do comando, um arquivo .xcworkspace é gerado. A presença desse arquivo indica que a integração do SDK foi concluída.

    Manual integration

    Nota

    • Antes de envie seu app à App Store, remova a arquitetura x86 de simuladores dos frameworks dinâmicos. Caso contrário, a submissão será rejeitada. A integração via pod realiza esse processo automaticamente.

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

    1. Baixe e descompacte o scenario SDK necessário para iOS.

    2. Adicione as dependências do SDK.

      No seu projeto Xcode, acesse TARGETS > General > Frameworks, Libraries, and Embedded Content. Adicione o AliVCSDK_***.framework, o alivcffmpeg.framework e outras dependências necessárias do pacote do SDK. Para cada dependência importada, defina a opção Embed como Embed & Sign.

    3. Adicione outras dependências de biblioteca.

      No seu projeto Xcode, acesse TARGETS > General > Frameworks, Libraries, and Embedded Content. Importe as dependências MobileCoreServices.framework, SystemConfiguration.framework, CoreTelephony.framework, CoreMedia.framework, VideoToolbox.framework, AVFoundation.framework e libresolv.tbd.

    4. Adicione o bundle de recursos (caso esteja incluído no pacote do SDK).

      Adicione o bundle de recursos AliyunVideoSDKPro.bundle ao seu projeto.

    Etapa 2: Configure a autorização de licença

    Na primeira integração do SDK, é necessário gerencie the license e configure license authorization.

    Etapa 3: Configure as permissões do app

    1. No seu projeto Xcode, acesse TARGETS > Build Settings > Linking. No campo Other Linker Flags, adicione a opção -ObjC.

    2. No seu projeto Xcode, acesse TARGETS > Build Settings > Build Options e defina ative Bitcode como NO.

    3. Modifique o arquivo Info.plist para configure as permissões do app.

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

    Perguntas frequentes

    Para solução de problemas, consulte as seções específicas de cada recurso em FAQ.