Quickly integrate ApsaraVideo Player SDK for iOS - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Requisitos

Sistema operacional: iOS 8.0 ou superior.
Ferramenta de desenvolvimento: recomenda-se o Xcode. Este tópico utiliza o Xcode. Baixe em: ‎Xcode.
O ApsaraVideo Player SDK for iOS não é compatível com simuladores. Execute os aplicativos em um dispositivo real.

Pré-requisitos

Obtenha um arquivo de licença para autorização do player, como AliVideoCert-********.crt. Para mais informações, consulte Obtain a license.
Para integração manual, baixe o pacote mais recente do ApsaraVideo Player SDK for iOS. Consulte download.

Observações de uso

Ao empacotar o aplicativo, o arquivo dSYM é usado para simbolizar relatórios de crash.
O ApsaraVideo Player SDK for iOS requer os frameworks AlivcFFmpeg e AliyunPlayer. Os arquivos de cabeçalho do player estão em AliyunPlayer.
Ao integrar o player SDK junto com o short video SDK, verifique a compatibilidade de versões entre o short video SDK, o player SDK e o AlivcFFmpeg. Versões incompatíveis podem causar falhas de funcionalidade. Para mais informações, consulte AlivcFFmpeg dependencies.
O pacote do ApsaraVideo Player SDK for iOS inclui arquiteturas de simulador. Remova-as antes de enviar o aplicativo para a 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 --version no terminal para verificar a instalação.
```
xxx@ ~ % pod --version
1.16.2
```

Crie um Podfile.

No terminal, acesse o diretório do projeto e execute pod init para criar 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 player SDK.
Nota
- Para integrar o player SDK junto com o short video SDK, substitua AliPlayerSDK_iOS no código abaixo por AliPlayerPartSDK_iOS. O AliPlayerPartSDK_iOS não inclui FFmpeg, o que evita conflitos com o FFmpeg do short video SDK.
- Insira o número de versão correto do player SDK; caso contrário, a importação falhará e retornará um erro. Para consultar as versões do player SDK, acesse ApsaraVideo Player SDK for iOS Release Notes.
```
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 em uma versão específica do player SDK.

source 'https://github.com/CocoaPods/Specs.git'
platform:ios, '8.0'

player_sdk_version = '7.18.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 install

A saída a seguir indica que a instalação foi concluída com êxito.

xxx@ yourProject % pod install
Analyzing dependencies
Downloading dependencies
Installing AliPlayerSDK_iOS (7.18.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 player SDK.

pod update AliPlayerSDK_iOS

Integração manual

Nota

Ao integrar o player SDK junto com o short video SDK, importe apenas um framework AlivcFFmpeg e certifique-se de usar a versão correta.

Baixe 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 subjacente do player.
- AliyunMediaDownloader.framework: usado para download offline.
- AliyunPlayer.framework: framework do player.
Clique em Build Settings.
Na seção Search Paths, defina Framework Search Paths como o diretório local do framework.

(Opcional) Integração do RTS (CocoaPods)

Para integrar o componente Real-Time Streaming (RTS), consulte Implement RTS-based stream pulling on iOS.

Etapa 2: Configurar a licença

Importante

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 chamar qualquer outra API do player.

Método 1: Chame a API a seguir 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 as versões 7.6.0 e posteriores do player SDK, configure o ambiente do site internacional no arquivo Info.plist.

Abra o arquivo Info.plist e altere o valor de AlivcEnv para SEA.
```
// 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 cliente iOS, consulte Configure a license on iOS.

Etapa 3: Ativar o logging (Opcional)

Ative o logging para facilitar a resolução de problemas. Para saber como obter logs, consulte Obtain SDK logs.

// 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 subjacente do player. Obrigatório.
AliyunMediaDownloader.framework	Usado para download offline. Opcional.
AliyunPlayer.framework	Framework do player. Obrigatório.
artcSource.framework	Compatível com o protocolo ARTC. Opcional. Nota Para usar o protocolo ARTC, adicione também o RtsSDK.framework. Para detalhes de integração, consulte Implement RTS-based stream pulling on iOS.
aemFilter.framework	Habilita o aprimoramento de áudio. Opcional.
libPluginSR.framework	Habilita a super-resolução. Opcional.
normalsrFilter.framework	Habilita a super-resolução. Opcional.
srFilter.framework	Habilita a super-resolução. Opcional.
vfiFilter.framework	Habilita a inserção de frames de vídeo. Opcional.
vvcCodecPlugin.framework	Plugin de decodificação H.266. Opcional.

Perguntas frequentes

Uso do CocoaPods

// Deintegrate your project from CocoaPods dependencies.
pod deintegrate 

// Update the index of your local CocoaPods source repositories.
// Use case:
// - When you add a new dependency, this ensures you can fetch the latest available version.
// - When a specific library version is unavailable or you know a new version exists but does not appear in your project, use this command to update.
pod repo update

// Update the project's Pods.
// Use case:
// - Use this when you want to update all pods in your project to the latest supported versions allowed by your Podfile.
pod update

// Performs the same function as 'pod install' but forces an update of the local CocoaPods repository index before installing.
// Use case:
// - This is a good command to use when you add new libraries or want to use the latest version of a library specified in your Podfile, especially if you see an error message indicating that a required library version is unavailable.
pod install --repo-update

// Clear the Pods cache.
// Note:
// 1. Clearing the cache does not modify your Podfile.lock or Podfile. When you run 'pod install' or 'pod update', CocoaPods re-downloads the required libraries based on your manifest and lockfile.
// 2. Clearing the cache is not a regular step and should only be used to resolve specific issues. Normally, CocoaPods manages its cache well.
pod cache clean --all

Conflitos de símbolos com AlivcFFmpeg

Solução:

Ao encontrar conflitos de símbolos com AlivcFFmpeg, remova a dependência redundante. Mantenha a versão fornecida com o ApsaraVideo Player SDK for iOS e remova a de terceiros. Isso pode afetar a funcionalidade de players de terceiros.

Erro de sandbox

Problema:
Solução:

Em UserSetting, defina User Script SandBoxing como NO.

Integração do short video SDK

Para integrar o ApsaraVideo Player SDK for iOS junto com o short video SDK, utilize all-in-one SDK for iOS para evitar problemas de classes duplicadas e falhas de compilação.

Para outros problemas e soluções relacionados ao player, consulte FAQ about ApsaraVideo Player.

Referências

Basic features

Advanced features