ApsaraVideo VOD:Preparação para integração

Ambiente de desenvolvimento

Licença

Você deve ter um certificado de licença de player e uma License Key para o ApsaraVideo Player SDK. Para mais detalhes, consulte Gerencie License.

Etapa 1: Copie o módulo para o projeto

Copie o diretório PlayerKit/ para o diretório do projeto (no mesmo nível do Podfile ou em um subdiretório adequado):

YourProject/
├── YourApp/
├── PlayerKit/                  # ← Copy this directory
│   ├── PlayerKit.podspec
│   ├── Source/
│   └── Resources/
└── Podfile

Etapa 2: Configure o Podfile

No Podfile, referencie o PlayerKit pelo caminho local:

platform :ios, '11.0'

target 'YourApp' do
  use_frameworks!

  # Core component (required, referenced by local path)
  pod 'PlayerKit', :path => './PlayerKit'

  # Underlying player SDK (required)
  pod 'AliPlayerSDK_iOS', '~> 7.15.0'

  # RTS for ultra-low latency live streaming (optional, for live streaming scenarios only)
  # pod 'AliPlayerSDK_iOS_ARTC', '~> 7.15.0'
  # pod 'RtsSDK', '~> 7.12.0'
end

Etapa 3: Instale as dependências

pod install
open YourApp.xcworkspace

Etapa 4: Configure a licença

O SDK do player requer uma licença válida para funcionar. Consulte Gerencie License para obter e configurar sua licença.

Etapa 5: Inicialização global

Chame este método apenas uma vez durante o ciclo de vida do aplicativo:

#import <AliPlayerKit/AliPlayerKit.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // (Optional) Global SDK configuration, such as setOption
    // [AliPlayerKit setOnGlobalInitBlock:^{
    //  Global configuration is executed only once after setup
    // }];

    // Initialize AliPlayerKit
    [AliPlayerKit setup];
    return YES;
}

import AliPlayerKit

func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
    // (Optional) Global SDK configuration
    // AliPlayerKit.setOnGlobalInitBlock {
    //  Global configuration is executed only once after setup
    // }

    // Initialize AliPlayerKit
    AliPlayerKit.setup()
    return true
}

Etapa 6: Verifique a integração

Use a lista de verificação a seguir para validar a integração:

• O comando pod install foi concluído com sucesso, sem conflitos de dependência.

• A licença está configurada corretamente.

• O método [AliPlayerKit setup] é chamado no AppDelegate.

• O projeto compila com sucesso (Cmd + B), sem erros de linker.

Etapa 1: Copie o módulo para o projeto

Copie o diretório PlayerKitScenes/ para o projeto, no mesmo nível do PlayerKit/:

YourProject/
├── YourApp/
├── PlayerKit/                  # Component level (already copied)
├── PlayerKitScenes/            # ← Copy this directory
│   ├── PlayerKitScenes.podspec
│   ├── SceneCommon/
│   ├── SceneLongVideo/
│   ├── SceneShortVideo/
│   ├── SceneLive/
│   └── ScenePlaylist/
└── Podfile

Etapa 2: Configure o Podfile

No Podfile, referencie o PlayerKitScenes pelo caminho local:

target 'YourApp' do
  use_frameworks!

  # Core component (required)
  pod 'PlayerKit', :path => './PlayerKit'
  pod 'AliPlayerSDK_iOS', '~> 7.15.0'

  # Playback scene solutions (import as needed)
  pod 'PlayerKitScenes', :path => './PlayerKitScenes'

  # Or, select individual scenes as needed:
  # pod 'PlayerKitScenes/SceneLongVideo', :path => './PlayerKitScenes'
  # pod 'PlayerKitScenes/SceneShortVideo', :path => './PlayerKitScenes'
  # pod 'PlayerKitScenes/SceneLive', :path => './PlayerKitScenes'
  # pod 'PlayerKitScenes/ScenePlaylist', :path => './PlayerKitScenes'
end

Descrições dos módulos de cena:

Etapa 3: Instale e verifique

pod install

Se o projeto compilar com sucesso, a integração no nível de cena estará concluída.

Informações de versão

• Em tempo de execução, chame [AliPlayerKit getSdkVersion] para obter o número da versão do SDK subjacente.

• Chame [AliPlayerKit getPlayerKitVersion] para obter o número da versão do componente AliPlayerKit.

• Consulte Baixe Player SDK e iOS SDK Release History.

Etapas de atualização

1. Confirme a compatibilidade de versões.

   Antes de atualizar, revise o histórico de lançamentos e o changelog do SDK para verificar se a versão alvo contém alterações disruptivas.

2. Modifique o número da versão no Podfile.

   pod 'AliPlayerSDK_iOS', '~> x.x.x'  # Replace with the target version
   
   # RTS (if you use live streaming scenarios)
   # pod 'AliPlayerSDK_iOS_ARTC', '~> x.x.x'
   # pod 'RtsSDK', '~> x.x.x'

3. Execute o comando de atualização.

   pod update AliPlayerSDK_iOS

4. Verifique a atualização.

   • O projeto compila com sucesso, sem erros de linker.

   • Valide as funções principais de reprodução: play, pause, seek, velocidade de reprodução, etc.

   • Teste cenários específicos de reprodução, como transmissão ao vivo com latência ultrabaixa via RTS.

Problemas de licença

Problema: O player relata erro de licença ou exibe tela preta.

As causas comuns incluem arquivo de certificado adicionado incorretamente, License Key incompatível, Bundle ID diferente daquele vinculado à licença ou licença expirada. Para mais detalhes, consulte Gerencie License.

Conflitos de dependência

Problema: O comando pod install falha com conflito de dependência.

Solução de problemas: Esse conflito pode ocorrer se o projeto e o PlayerKit dependerem de versões diferentes do SDWebImage. Execute pod update para resolver o conflito. Se o problema persistir, execute pod repo update para atualizar o índice do repositório local antes de tentar novamente.

Problemas de inicialização

Problema: A reprodução não funciona corretamente após chamar [AliPlayerKit setup].

Solução de problemas:

1. Garanta que a chamada seja feita em application:didFinishLaunchingWithOptions: dentro do AppDelegate.

2. Confirme se a licença está configurada corretamente. Para mais detalhes, consulte Gerencie License.

3. Chame [AliPlayerKit isInitialized] para confirmar que a inicialização foi bem-sucedida.

4. O método setup é idempotente (usa dispatch_once). Chamadas repetidas são seguras e não geram exceções.

5. Se precisar injetar configurações globais do SDK, confirme se setOnGlobalInitBlock: foi definido antes da chamada de setup.

Depuração com logs

Se encontrar problemas de reprodução, ative os logs de depuração para auxiliar na solução de problemas:

// Enable debug mode
[AliPlayerKit setDebugModeEnabled:YES];
// Set the log level to Verbose for the most detailed output
[AliPlayerKit setLogLevel:LogLevelVerbose];

Para detalhes sobre como usar o sistema de logs, consulte Logging System.