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
-
Instale o CocoaPods. É necessário um ambiente Ruby.
// In Terminal, run the following command: sudo gem install cocoapods -
Verifique a instalação do CocoaPods.
Execute
pod --versionno terminal para confirmar a instalação.xxx@ ~ % pod --version 1.16.2 -
Crie um Podfile.
No terminal, acesse o diretório do projeto e execute
pod initpara gerar um Podfile.// Go to your project directory. xxx@ ~ % cd /path/yourProject // Generate the Podfile. xxx@ yourProject % pod init -
Edite o Podfile para adicionar a dependência do SDK do player.
NotaPara integrar o SDK do player e o SDK de vídeo curto, substitua
AliPlayerSDK_iOSno código abaixo porAliPlayerPartSDK_iOS. OAliPlayerPartSDK_iOSnã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 -
(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 -
Instale as dependências.
Execute o comando a seguir para instalar as dependências.
pod installA 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
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.
Baixe o ApsaraVideo Player SDK for iOS.
-
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.

Clique em na aba Build Settings.
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
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.
-
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; -
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.pliste altere o valor deAlivcEnvparaSEA.// Configure the current environment as the international site. <key>AlivcEnv</key> <string>SEA</string>A figura a seguir mostra um exemplo de configuração:

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
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:

-
Solução:
Em UserSetting, defina User Script SandBoxing como NO.

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.