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.
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
-
Adicione as dependências ao Podfile conforme a versão do SDK.
ImportanteO 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
-
Atualize o repositório de pods.
pod repo update -
Instale o pod.
pod install
Configuração do projeto
Após a integração, configure os seguintes itens no Xcode:
Em Build Settings > Linking > Other Linker Flags, adicione a flag -ObjC.
-
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
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.