Prérequis
Effectuez les étapes suivantes avant d'initialiser le SDK :
Obtenez et activez une licence pour le SDK de vidéo courte. Pour plus d'informations, consultez la rubrique Obtenir une licence pour le SDK de vidéo courte.
Intégrez le SDK de vidéo courte. À partir de la version 3.29.0, vous devez configurer la licence avant d'enregistrer le SDK. Pour plus d'informations, consultez la rubrique Intégrer le SDK.
Importation des fichiers d'en-tête
Importez les fichiers d'en-tête du SDK avant d'utiliser le SDK de vidéo courte. Ces fichiers contiennent les déclarations d'API requises par le SDK.
#import <AliyunVideoSDKPro/AliyunVideoSDKPro.h>
Enregistrement du SDK
À partir de la version 3.29.0, le SDK de vidéo courte utilise un service de licence amélioré. Enregistrez le SDK après le démarrage de votre application pour activer ses fonctionnalités. Le code suivant montre comment enregistrer le SDK :
// For versions 3.30.0 and later:
NSError *error = [AliyunVideoSDKInfo registerSDK]; // If the returned error is nil, the registration is successful.
// A registration failure is usually caused by an integration error. Add an Assert statement to display the error and suggested fix during integration and debugging.
NSAssert2(error == nil, @"Failed to register the SDK! %@; %@", error.localizedDescription, error.localizedRecoverySuggestion);
// For version 3.29.0:
// Rename the obtained LicenseFile to license.crt. Add the file to your app project. Then, use the following method to get the path of the LicenseFile.
NSString *licenseFilePath = [NSBundle.mainBundle pathForResource:@"license" ofType:@"crt"];
// Use the obtained LicenseKey and LicenseFilePath to register the SDK.
[AliyunVideoSDKInfo registerSDKWithLicenseKey:LicenseKey licenseFile:licenseFilePath];
Un enregistrement réussi signifie que la licence est chargée dans le SDK, mais ne garantit pas que l'authentification a abouti.
Consultez l'état actuel de la licence à l'aide du code suivant.
AliyunVideoLicense *license = AliyunVideoLicenseManager.CurrentLicense;
Le SDK s'authentifie lorsque vous utilisez certaines fonctionnalités ou services à valeur ajoutée. En cas d'échec de l'authentification, l'appel d'API correspondant renvoie un échec. Vous pouvez également écouter les résultats d'authentification depuis un emplacement centralisé.
// For versions 3.30.0 and later
AliyunVideoLicenseManager.EventDelegate = self; // For more information, see the AliyunVideoLicenseEventDelegate protocol description.
Consultez proactivement le résultat de l'authentification à l'aide du code suivant.
AliyunVideoLicenseResultCode code = [AliyunVideoLicenseManager check];
Si vous renouvelez votre abonnement ou achetez un service à valeur ajoutée, vous pouvez mettre à jour manuellement la licence. Par défaut, le SDK vérifie les mises à jour toutes les 15 minutes.
[AliyunVideoLicenseManager Refresh:^(AliyunVideoLicenseRefreshCode code){
// Update result: code
}];
Définition du chemin d'importation du bundle de ressources
Si vous intégrez le SDK de vidéo courte via CocoaPods avec des dépendances minimales, il peut être nécessaire d'importer le bundle de ressources AliyunVideoSDKPro.bundle. Afin de réduire la taille du package de votre application, configurez-la pour télécharger ce bundle au moment de l'exécution. Une fois le téléchargement terminé, définissez le chemin du bundle pour le rendre disponible au SDK.
Téléchargez le bundle de ressources vers votre stockage cloud, tel qu'Object Storage Service (OSS).
Au démarrage de l'application, vérifiez la présence du bundle de ressources. S'il n'existe pas, téléchargez-le sur l'appareil local.
-
Une fois le bundle de ressources téléchargé ou s'il existe déjà localement, définissez le chemin d'importation du bundle de ressources dans le SDK de vidéo courte comme suit :
[AliyunVideoSDKInfo setSDKBundlePath:@"The local storage path of the resource bundle"];
Sortie des journaux
Par défaut, le SDK de vidéo courte génère uniquement les journaux d'avertissement et d'erreur (AlivcLogWarn). Définissez le niveau de journalisation pour afficher des journaux plus détaillés lors du dépannage.
// The log levels are defined as follows:
typedef NS_ENUM(NSInteger, AlivcLogLevel)
{
AlivcLogClose = 1,
AlivcLogVerbose,
AlivcLogDebug,
AlivcLogInfo,
AlivcLogWarn,
AlivcLogError,
AlivcLogFatal
};
// Set the log output level
[AliyunVideoSDKInfo setLogLevel:AlivcLogDebug];
Informations sur la version
Affichez les informations de version pour confirmer que la bonne version du SDK est importée ou pour faciliter le dépannage :
[AliyunVideoSDKInfo printSDKInfo];
Vous pouvez également afficher des champs spécifiques :
NSString *version = [AliyunVideoSDKInfo version]; // Version number
NSString *module = [AliyunVideoSDKInfo module]; // Version type
int moduleCode =[AliyunVideoSDKInfo versionCode]; // Version type code
NSString *buildId =[AliyunVideoSDKInfo videoSDKBuildId]; // Version packaging ID
NSLog(@"\n==============\nVERSION: %@\nBUILD_ID: %@\nMODULE: %@\nMODULE_CODE: %d\n==============", version, buildId, module, moduleCode);