ApsaraVideo VOD:Préparation à l'intégration

Environnement de développement

Licence

Vous devez disposer d'un certificat de licence de lecteur et d'une clé de licence pour le SDK ApsaraVideo Player. Pour plus de détails, consultez la rubrique Gérer la licence.

Étape 1 : Copier le module dans votre projet

Copiez le répertoire PlayerKit/ dans le répertoire de votre projet (au même niveau que votre Podfile ou dans un sous-répertoire approprié) :

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

Étape 2 : Configurer le Podfile

Dans votre Podfile, référencez PlayerKit en utilisant son chemin 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

Étape 3 : Installer les dépendances

pod install
open YourApp.xcworkspace

Étape 4 : Configurer la licence

Le SDK de lecteur nécessite une licence valide pour fonctionner. Consultez la rubrique Gérer la licence pour obtenir et configurer votre licence.

Étape 5 : Initialisation globale

N'appelez cette méthode qu'une seule fois au cours du cycle de vie de l'application :

#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
}

Étape 6 : Vérifier l'intégration

Utilisez la liste de contrôle suivante pour vérifier l'intégration :

• pod install se termine avec succès sans conflits de dépendances.

• La licence est configurée correctement.

• [AliPlayerKit setup] est appelé dans AppDelegate.

• Le projet se compile avec succès (Cmd + B) sans erreurs de l'éditeur de liens.

Étape 1 : Copier le module dans votre projet

Copiez le répertoire PlayerKitScenes/ dans votre projet, au même niveau que PlayerKit/ :

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

Étape 2 : Configurer le Podfile

Dans votre Podfile, référencez PlayerKitScenes en utilisant son chemin 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

Descriptions des modules de scène :

Étape 3 : Installer et vérifier

pod install

Si votre projet se compile avec succès, l'intégration au niveau des scènes est terminée.

Informations sur la version

• Au moment de l'exécution, appelez [AliPlayerKit getSdkVersion] pour obtenir le numéro de version du SDK sous-jacent.

• Appelez [AliPlayerKit getPlayerKitVersion] pour obtenir le numéro de version du composant AliPlayerKit.

• Consultez les rubriques Télécharger le SDK Player et Historique des versions du SDK iOS.

Étapes de mise à niveau

1. Confirmez la compatibilité des versions.

   Avant la mise à niveau, examinez l'historique des versions du SDK et le journal des modifications pour vérifier si la version cible contient des changements incompatibles.

2. Modifiez le numéro de version dans votre 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. Exécutez la commande de mise à jour.

   pod update AliPlayerSDK_iOS

4. Vérifiez la mise à niveau.

   • Le projet se compile avec succès sans erreurs de l'éditeur de liens.

   • Vérifiez les fonctions de lecture principales : lecture, pause, recherche, vitesse de lecture, etc.

   • Vérifiez les scénarios de lecture spécifiques, tels que le streaming en direct à ultra-faible latence avec RTS.

Problèmes de licence

Problème : Le lecteur signale une erreur de licence ou affiche un écran noir.

Les causes courantes incluent un fichier de certificat ajouté incorrectement, une clé de licence non correspondante, un ID de bundle incohérent avec celui lié à la licence ou une licence expirée. Pour plus de détails, consultez la rubrique Gérer la licence.

Conflits de dépendances

Problème : pod install échoue avec un conflit de dépendances.

Étapes de dépannage : ce conflit peut survenir si votre projet et PlayerKit dépendent de versions différentes de SDWebImage. Essayez d'exécuter pod update pour résoudre le conflit. Si le problème persiste, exécutez pod repo update pour actualiser l'index de votre référentiel local avant de réessayer.

Problèmes d'initialisation

Problème : La lecture ne fonctionne pas correctement après avoir appelé [AliPlayerKit setup].

Étapes de dépannage :

1. Assurez-vous que l'appel est effectué dans application:didFinishLaunchingWithOptions: au sein de AppDelegate.

2. Confirmez que la licence est configurée correctement. Pour plus de détails, consultez la rubrique Gérer la licence.

3. Appelez [AliPlayerKit isInitialized] pour confirmer que l'initialisation a réussi.

4. La méthode setup est idempotente (en utilisant dispatch_once). Les appels répétés sont sûrs et ne génèrent pas d'exceptions.

5. Si vous devez injecter des configurations globales du SDK, confirmez que setOnGlobalInitBlock: est défini avant l'appel de setup.

Débogage avec les journaux

Si vous rencontrez des problèmes de lecture, activez les journaux de débogage pour faciliter le dépannage :

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

Pour plus de détails sur l'utilisation du système de journalisation, consultez la rubrique Système de journalisation.