ApsaraVideo Live:SDK integration

Ambiente de integração

Baixe o pacote do SDK

Integre o Push SDK

Após integrar o Push SDK manualmente ou via pod, solicite as permissões necessárias e desative o Bitcode.

Para integração manual, siga as etapas correspondentes. Caso prefira usar pod, siga as etapas de integração via pod.

1. Integração manual:

   1. Crie um projeto de teste do SDK: App > DemoPush.

   2. Arraste os seguintes arquivos para o projeto no Xcode:

      • AlivcLibReplayKitExt.framework

      • AlivcLivePusher.framework

      Para usar recursos de retoque e adesivos, arraste também estes arquivos:

      • queen.framework

      • openvc2.framework

      • MNN.framework

      • AliyunQueenUIKit.framework

      Se houver dependência de alguma versão do ApsaraVideo Player SDK, inclua ainda os seguintes arquivos:

      • RtsSDK.framework

      • AliyunPlayer.framework

      • artcSource.framework

      • alivcffmpeg.framework

      No projeto do Xcode, acesse General > Frameworks, Libraries, and Embedded Content e configure o método de incorporação de cada framework dependente conforme abaixo:

      • Embed & Sign: alivcffmpeg.framework, AlivcLibReplayKitExt.framework, AlivcLibRtmp.framework, AlivcLivePusher.framework, AliyunPlayer.framework, artcSource.framework, opencv2.framework

      • Embed Without Signing: AlivcLiveBroadcast.appex

      • Do Not Embed: Accelerate.framework, CoreGraphics.framework, CoreImage.framework, CoreMedia.framework, CoreMotion.framework, CoreVideo.framework, Face3D.framework, FaceDetection.framework, Foundation.framework, Metal.framework, MNN.framework, OpenGLES.framework, pixelai.framework, QuartzCore.framework, queen.framework

   3. Selecione Copy items if needed e clique em Finish.

   4. Após importar o SDK, adicione as dependências em Xcode > General > Frameworks, Libraries, and Embedded Content. Em Frameworks, Libraries, and Embedded Content, defina o método de incorporação dos frameworks de terceiros (como alivcffmpeg.framework, AlivcLibRtmp.framework, AlivcLivePusher.framework, AliyunPlayer.framework, artcSource.framework, RtsSDK.framework e opencv2.framework) como Embed & Sign. Mantenha os frameworks do sistema (como Accelerate, CoreGraphics e CoreMedia) configurados como Do Not Embed. Defina AlivcLiveBroadcast.appex como Embed Without Signing.

2. Integração via Pod:

   1. Em uma janela de terminal, insira o comando abaixo para instalar o CocoaPods.

      Importante

      Antes de instalar o CocoaPods, verifique se o ambiente Ruby está instalado no Mac.

      sudo gem install cocoapods

   2. Navegue até o caminho do projeto e execute o seguinte comando no terminal para criar um arquivo Podfile.

      pod init

   3. Edite o arquivo Podfile para adicionar a dependência do Push SDK. Se precisar de reprodução ao vivo, adicione também a dependência do ApsaraVideo Player SDK.

      # Push SDK Basic Edition
      pod 'AlivcLivePusher', '~> x.y.z'

      Nota

      • x.y.z representa o número da versão do Push SDK. Substitua este marcador pela versão mais recente disponível na página de Downloads do SDK, como 7.4.0.

      • O Push SDK não pode ser integrado juntamente com o Player SDK (AliyunPlayer). Para usar ambos, utilize o All-in-One Media SDK. Para mais detalhes, consulte os tópicos Cenários e Integração do All-in-One Media SDK.

   4. Execute o comando abaixo na janela de terminal. Após a execução do comando pod, um arquivo de projeto com a extensão .xcworkspace será gerado contendo o SDK integrado. Dê um duplo clique nesse arquivo para atualizar e instalar o SDK.

      pod install

      ou

      pod update

3. Solicite as permissões.

   Nota

   Adicione as permissões de acesso à câmera e ao microfone.

   No arquivo Info.plist, adicione as permissões Privacy - Camera Usage Description e Privacy - Microphone Usage Description para câmera e microfone. Caso o aplicativo precise continuar a ingestão de streams em segundo plano, ative o modo de captura de áudio em background. Para isso, na aba Capabilities do projeto no Xcode, defina Background Modes como ON e selecione Audio, AirPlay, and Picture in Picture na lista expandida de modos.

4. Desative o Bitcode.

   O SDK não oferece suporte a Bitcode. Desative essa opção no projeto. Em Build Settings do Xcode, pesquise por bitcode e defina Enable Bitcode, em Build Options, como No.

5. Configure a licença.

   Para instruções detalhadas, consulte Integrar uma licença.

Observações de uso

• Para informações detalhadas sobre a API, consulte a Referência da API para a Basic Edition.

• Para exemplos de código da API, acesse o tópico Uso de recursos.

Perguntas frequentes

Erro de compilação

Caso encontre o erro de compilação Building for iOS, but the linked and embedded framework XXX.framework' was built for iOS + iOS Simulator, siga estas etapas:

1. Clique em no menu Xcode.

2. Escolha File > Workspace Settings para abrir a caixa de diálogo de configurações.

3. Altere Build System para Legacy Build System.

Bibliotecas de dependência do Queen ausentes durante a compilação

Se as bibliotecas de dependência do Queen estiverem faltando durante a integração manual, consulte a documentação do Queen_SDK_iOS para adicionar as bibliotecas necessárias.