ApsaraVideo VOD:iOS Player FAQ

Problèmes liés à la licence

Résolvez les problèmes de licence invalide ou expirée dans la rubrique Foire aux questions sur les licences.

Problèmes courants sur toutes les plateformes

• Pour les problèmes indépendants de la plateforme, consultez la rubrique Foire aux questions sur le lecteur multiplateforme.

• Les développeurs expérimentés peuvent également résoudre les erreurs de lecture de manière autonome.

Des erreurs se produisent lors de l'empaquetage d'une application avec Xcode 14 et de sa soumission à l'App Store pour examen

Erreurs liées à Bitcode

 ITMS-90482: Invalid Executable - The executable 'xxx.app/Frameworks/alivcffmpeg.framework/alivcffmpeg' contains bitcode.

xcrun bitcode_strip ${framework_path} -r -o ${framework_path}

Erreurs liées à cURL

ITMS-90338: Non-public API usage - The app references non-public symbols in Frameworks/AliyunPlayer.framework/AliyunPlayer: _curl_multi_poll, _curl_multi_wakeup. If method names in your source code match the private Apple APIs listed above, altering your method names will help prevent this app from being flagged in future submissions. In addition, note that one or more of the above APIs may be located in a static library that was included with your app. If so, they must be removed. For further information, visit the Technical Support Information at http://developer.apple.com/support/technical/

Erreurs relatives aux API non publiques

Solution : Il s'agit d'un avertissement provenant des builds Xcode 14 qui n'affecte généralement pas la publication si le projet se compile correctement. Si l'application ne peut pas être publiée, utilisez Xcode 13.

Erreurs liées aux plugins de post-traitement tels que mpf_filter.framework et vfi_filter.framework pour l'interpolation d'images et l'accentuation

Après avoir intégré le SDK ApsaraVideo Player pour iOS, puis-je déboguer et exécuter mon application sur un émulateur Xcode ?

Le SDK ApsaraVideo Player pour iOS ne prend pas en charge les émulateurs. Utilisez un iPhone physique pour déboguer et exécuter votre application.

Comment obtenir la progression actuelle de la lecture

AVPConfig *config = [self.player getConfig];
config.positionTimerIntervalMs = 100; // Change the callback interval. Unit: ms.
[self.player setConfig:config];

/**
 @brief: The callback for the current playback position.
 @param player: The player pointer.
 @param position: The current playback position.
 */
- (void)onCurrentPositionUpdate:(AliPlayer*)player position:(int64_t)position {
    // The current playback progress.
    long currentPosition = position;
}

Comment obtenir la largeur et la hauteur d'une vidéo

La barre de progression revient en arrière après une opération de recherche

Cause : Par défaut, le lecteur utilise une recherche imprécise. Après une opération de recherche, le lecteur commence la lecture à partir d'une image clé proche du point de recherche.

Solution : Basculez vers le mode de recherche précise.

Comment basculer entre les modes de recherche précise et imprécise

// Switch to inaccurate seek.
[self.player seekToTime:1000 seekMode:AVP_SEEKMODE_INACCURATE];
// Switch to accurate seek.
[self.player seekToTime:1000 seekMode:AVP_SEEKMODE_ACCURATE];

La barre de progression revient toujours en arrière après le passage au mode de recherche précise

Cause : La recherche précise prend plus de temps que la recherche imprécise. Si la distance entre le point de recherche et l'image clé la plus proche est trop grande et dépasse l'intervalle maximal pour la recherche précise, le SDK ApsaraVideo Player bascule automatiquement vers la recherche imprécise. Cela provoque un retour en arrière de la barre de progression.

// Unit: ms.
[self.player setMaxAccurateSeekDelta:10000];

Erreur lors de la mise en cache de la vidéo : encrypt check fail

La mise en cache fonctionne de la même manière que le téléchargement. Avec le téléchargement sécurisé activé, le fichier de vérification du chiffrement doit correspondre aux informations de l'application. Téléchargez le fichier depuis la rubrique Téléchargement hors ligne et ajoutez-le au SDK. Suivez les étapes décrites dans la rubrique Téléchargement de vidéos, sinon la mise en cache ou le téléchargement échouera.

Obtenir les données source audio et vidéo

// Set the rendering callback.
self.player.renderingDelegate = self;

// Listen for the rendering callback.
- (BOOL)onRenderingFrame:(CicadaFrameInfo*) frameInfo {
    if (frameInfo.frameType == Cicada_FrameType_Video) { // Underlying video data.

    } else if (frameInfo.frameType == Cicada_FrameType_Audio) { // Underlying audio data.

    }
    return NO;
}

Comment obtenir les pixels de chaque image vidéo dans le lecteur ?

SDK ApsaraVideo Player pour iOS : Vous pouvez obtenir les pixels en écoutant le rappel onRenderingFrame.

player.renderingDelegate = self;

#pragma mark CicadaRenderingDelegate
- (BOOL)onRenderingFrame:(CicadaFrameInfo*) frameInfo{
    if(frameInfo.frameType==Cicada_FrameType_Video){
        // Video
        NSLog(@"receive HW frame:%p pts:%ld foramt %d", frameInfo.video_pixelBuffer, frameInfo.pts, CVPixelBufferGetPixelFormatType(frameInfo.video_pixelBuffer));

    } else if (frameInfo.frameType==Cicada_FrameType_Audio){
        // Audio
    }
    return NO;
}

Logique de commutation adaptative du débit binaire

Logique de nouvelle tentative personnalisée

Par défaut, le SDK tente deux fois de nouveau les opérations réseau ayant échoué, avec un délai d'expiration de 15 secondes. Si toutes les tentatives échouent, le rappel Error est déclenché.

AVPConfig *config = [self.player getConfig];
config.networkRetryCount = 0; // Set the number of retries. In this example, the value is set to 0.
[self.player setConfig:config];

/**
 @brief: The callback for player events.
 @param player: The player pointer.
 @param eventWithString: The player event type.
 @param description: The description of the player event.
 @see AVPEventType
 */
-(void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
    if (eventWithString == EVENT_PLAYER_NETWORK_RETRY) { // Network error. A retry is required.
        // TODO: Add the processing logic.
    }
}

Une erreur 403 est signalée et la lecture d'un flux HLS échoue après la configuration de la mise en cache locale

Symptôme : La lecture d'un flux HLS (M3U8) avec VidAuth et la mise en cache locale activés échoue avec une erreur 403.

Cause : Si vous quittez avant que la vidéo ne soit entièrement mise en cache, le lecteur réutilise les identifiants VidAuth expirés lors de la prochaine tentative de lecture, ce qui provoque une erreur 403.

Solution : Dans le SDK V5.5.4.0 et versions ultérieures, définissez le champ AVPConfig.enableStrictAuthMode pour contrôler le mode d'authentification pour les flux HLS avec des paramètres d'authentification. La valeur par défaut est false.

• Authentification non stricte (false) : Les informations d'authentification sont mises en cache avec le contenu multimédia. Si seule une partie du média a été mise en cache précédemment, le lecteur utilise les informations d'authentification mises en cache pour demander la partie non mise en cache. Si l'authentification de l'URL a une courte période de validité ou si la lecture reprend après une longue pause, l'authentification peut expirer. Pour gérer cela, vous devez implémenter la fonctionnalité de actualisation automatique de la source.

• Authentification stricte (true) : Les informations d'authentification ne sont pas mises en cache. L'authentification a lieu au début de chaque session de lecture. Cela peut entraîner un échec de la lecture s'il n'y a pas de connexion réseau.

La préemption audio empêche le SDK ApsaraVideo Player pour iOS de lire des vidéos

Symptôme : Lorsque votre projet utilise à la fois le SDK ApsaraVideo Player et d'autres contrôles audio, des problèmes de lecture tels que l'absence de son ou des saccades vidéo se produisent.

Cause : Le AVAudioSession dans iOS est un singleton. Sans configuration unifiée entre plusieurs contrôles audio, la préemption audio peut empêcher la lecture vidéo.

[[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback withOptions:AVAudioSessionCategoryOptionMixWithOthers error:&err];

Un crash de pile pointant vers le SDK se produit lors de l'exécution du SDK ApsaraVideo Player pour iOS

Le SDK ApsaraVideo Player pour iOS prend-il en charge le téléchargement pendant la lecture ?

Non. Le SDK prend en charge la mise en cache locale, qui télécharge les vidéos pendant la lecture pour une utilisation hors ligne ultérieure. Cependant, il ne prend pas en charge la lecture des fichiers mis en cache stockés dans un répertoire de fichiers distinct.

Le SDK ApsaraVideo Player pour iOS prend-il en charge l'obtention de la progression de la mise en mémoire tampon d'une vidéo ?

Oui. Le SDK ApsaraVideo Player pour iOS permet d'obtenir la vitesse de mise en mémoire tampon, le taux de trames de rendu en temps réel, les débits binaires audio et vidéo, ainsi que le débit binaire de téléchargement réseau. Consultez la rubrique Obtenir des informations de lecture.

Un crash se produit pendant l'exécution du lecteur

Un crash lié à l'initialisation du programme ou au préchargement se produit lors de l'exécution du SDK ApsaraVideo Player V5.4.6.0

Mettez à jour le SDK ApsaraVideo Player vers une version ultérieure à la V5.4.7.1. Pour maintenir la stabilité de la V5.4.6.0, vous pouvez également utiliser la version de correctif à chaud pod 5.4.6.0-25587639.

Comment activer la lecture en plein écran

Le SDK ApsaraVideo Player pour iOS ne fournit pas d'API pour la lecture en plein écran. Vous devez implémenter cette fonctionnalité en vous basant sur le système. La démo du SDK ApsaraVideo Player pour iOS pour les versions 5.5.0.0 et ultérieures est adaptée à la méthode plein écran d'iOS 16.0 et ultérieur.

UIInterfaceOrientation orientation = UIInterfaceOrientationLandscapeLeft; // Rotate to full screen
......

// For iOS 16.0 and later
if (@available(iOS 16.0, *)) {
    @try {
            NSArray *array = [[[UIApplication sharedApplication] connectedScenes] allObjects];
      UIWindowScene *ws = (UIWindowScene *)array[0];
        Class GeometryPreferences = NSClassFromString(@"UIWindowSceneGeometryPreferencesIOS");
      id geometryPreferences = [[GeometryPreferences alloc]init];
      UIInterfaceOrientationMask orientationMask = UIInterfaceOrientationMaskLandscapeRight;
      if (orientation == UIInterfaceOrientationPortrait) {
          orientationMask = UIInterfaceOrientationMaskPortrait;
      }
      [geometryPreferences setValue:@(orientationMask) forKey:@"interfaceOrientations"];
      SEL sel_method = NSSelectorFromString(@"requestGeometryUpdateWithPreferences:errorHandler:");
      void (^ErrorBlock)(NSError *err) = ^(NSError *err){
            NSLog(@"Screen rotation error:%@", [err debugDescription]);
      };
      if ([ws respondsToSelector:sel_method]) {
          (((void (*)(id, SEL,id,id))[ws methodForSelector:sel_method])(ws, sel_method,geometryPreferences,ErrorBlock));
      }
  } @catch (NSException *exception) {
      NSLog(@"Screen rotation error:%@", exception.reason);
  } @finally {
  }
} else { // For systems earlier than iOS 16.0
  if ([[UIDevice currentDevice] respondsToSelector:@selector(setOrientation:)]) {
      SEL selector = NSSelectorFromString(@"setOrientation:");
      NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:[UIDevice instanceMethodSignatureForSelector:selector]];
      [invocation setSelector:selector];
      [invocation setTarget:[UIDevice currentDevice]];
      [invocation setArgument:&Orientation atIndex:2];
      [invocation invoke];
  }
  [[UIApplication sharedApplication]setStatusBarOrientation:orientation animated:YES];
}

Des barres noires apparaissent pendant la lecture vidéo

L'audio est lu mais aucune vidéo n'est affichée, et le journal indique « log[AFVTBDecoder] :IOS8VT: throw frame »

Des saccades et une désynchronisation audio-vidéo se produisent lors de la récupération de flux RTS sur un client iOS

Solution : Intégrez le dernier composant ultra-faible latence du lecteur. Implémenter la récupération de flux RTS sur un client iOS.

Lorsqu'une application iOS est en arrière-plan ou n'est pas démarrée, l'audio est lu mais aucune vidéo n'est affichée si l'utilisateur accède à l'application via une notification.

- (AliPlayer *)aliPlayer{
    if (!_aliPlayer && UIApplicationStateActive == [[UIApplication sharedApplication] applicationState]) {
        _aliPlayer = [[AliPlayer alloc] init];
        _aliPlayer.scalingMode =  AVP_SCALINGMODE_SCALEASPECTFIT;
        _aliPlayer.rate = 1;
        _aliPlayer.delegate = self;
        _aliPlayer.playerView = self.playerView;
    }
    return _aliPlayer;
}

Lors de la lecture d'un flux en direct, le journal signale une erreur standard : « -5, IO error (Input/Output (I/O)) »

Lorsque vous lisez un flux en direct, utilisez les valeurs par défaut pour les paramètres de mise en cache et de contrôle de la latence (startBufferDuration, highBufferDuration et maxBufferDuration dans AVPConfig). Ne personnalisez pas ces paramètres. Vérifiez votre configuration par rapport à Configurer la mise en cache et le contrôle de la latence.

Après avoir mis la lecture en pause, navigué ailleurs, puis être revenu pour reprendre la lecture, une erreur liée à l'audio est signalée dans le journal : « Deactivating an audio session that has running I/O. » ou « All I/O should be stopped or paused prior to deactivating the audio session. »

Symptôme : Sur la page de lecture vidéo, vous mettez la lecture en pause et accédez à une autre page comportant de l'audio. À votre retour, vous ne pouvez pas reprendre la lecture et une erreur liée à l'audio telle que « Deactivating an audio session that has running I/O. » ou « All I/O should be stopped or paused prior to deactivating the audio session. » est signalée dans le journal.

Solution : Vérifiez les conflits dans les paramètres audio (propriétés AudioSession). Par exemple, lorsque vous quittez une autre page avec audio, les ressources audio peuvent ne pas être libérées à temps (l'enregistrement ou la lecture audio associé n'est pas arrêté rapidement).

Une erreur se produit lors de l'utilisation d'AliListPlayer pour lire une vidéo HLS (m3u8)

Une erreur unsupported protocol se produit lors de la lecture d'un flux ARTC

Cause 1 : La couche de pont entre le lecteur et le composant RTS (AlivcArtc) ainsi que le composant RTS (RtsSDK) ne sont pas intégrés, bien que le SDK ApsaraVideo Player soit intégré.

Solution : Pour plus d'informations sur l'intégration des composants, consultez Implémenter la récupération de flux RTS sur un client iOS.

Cause 2 : La version de la couche de pont entre le lecteur et le composant RTS (AlivcArtc) est incohérente avec la version du lecteur.

Solution : La couche de pont (AlivcArtc) et le lecteur doivent avoir le même numéro de version. Implémenter la récupération de flux RTS sur un client iOS.

Si une vidéo est transcodée en plusieurs définitions, quelle définition le SDK ApsaraVideo Player lit-il par défaut ?

Le SDK lit la première définition disponible dans cet ordre : FD, LD, SD, HD, 2K, 4K, OD. Définition.

Comment spécifier la définition par défaut pour la lecture vidéo

// The following code provides an example of playback using VidSts.
AVPVidStsSource *stsSource = [[AVPVidStsSource alloc] init];
stsSource.vid = @"<vid>";
stsSource.accessKeyId = @"<accessKeyId>";
stsSource.securityToken = @"<securityToken>";
stsSource.accessKeySecret = @"<accessKeySecret>";
stsSource.quality = @""; // The expected definition for playback. Valid values: FD, LD, SD, HD, 2K, 4K, and OD.
stsSource.forceQuality = NO; // Specifies whether to forcibly play the video in the expected definition. NO: The video is not forcibly played in the expected definition. The player searches for definitions in the default order and plays the video in the first definition that it finds. YES: The video is forcibly played in the expected definition. If the expected definition is not found, the video is not played.

Si une définition comporte plusieurs flux, quel flux le SDK ApsaraVideo Player lit-il ?

Si une définition comporte plusieurs flux, le SDK ApsaraVideo Player lit le flux le plus récent.

Comment configurer une vidéo pour qu'elle soit lue sans filigrane mais téléchargée avec un filigrane ?

Transcodez la vidéo en plusieurs définitions. Lisez la définition sans filigrane et téléchargez la définition avec filigrane.

Le mode paysage ne prend pas effet

Le SDK ApsaraVideo Player pour iOS ne fournit pas de méthode pour implémenter le mode paysage. Vous devez implémenter cette fonctionnalité en vous basant sur l'API système iOS. Lorsque vous implémentez le mode paysage, assurez-vous de définir correctement le frame de aliplayer.playerView.

Comment obtenir les journaux

Soumettez les journaux lors de la demande d'assistance technique Alibaba Cloud pour accélérer la résolution des problèmes.

1. Obtenez les journaux.

   Définissez le niveau de journal sur LOG_LEVEL_TRACE avant d'obtenir les journaux. Obtenir les journaux du SDK.

2. Fournissez les journaux générés à l'assistance technique Alibaba Cloud.

   Obtenir une assistance technique.

Après l'activation du cache local, la vidéo multi-débit (HLS) manque le cache.

Phénomène du problème : Le cache local a été activé et le préchargement effectué conformément à la documentation, mais la progression de la recherche arrière vers le cache manqué pendant la lecture, ou la lecture ne peut pas continuer après la déconnexion du réseau, ou la vérification du fichier cache indique qu'il n'existe pas, ou le répertoire cache est vide après la désactivation du préchargement.

Cause du problème : Dans le scénario multi-débit (HLS), si un certain flux n'est pas explicitement sélectionné pendant la lecture, le lecteur fonctionne en mode ABR (débit adaptatif) et les données en mode ABR ne sont pas écrites sur le disque, donc aucun cache local n'est généré. Ce n'est qu'après avoir appelé explicitement selectTrack pour sélectionner un certain flux de code que les données sélectionnées seront mises en cache localement. Si selectTrack n'est pas appelé (ou si SELECT_AVPTRACK_TYPE_VIDEO_AUTO est transmis), le traitement sera effectué selon le mode ABR.

Solution : Assurez-vous que le préchargement et la lecture utilisent la même définition et la même adresse de lecture, et sélectionnez explicitement le flux de code pendant la lecture.

1. Pendant l'étape de préchargement, activez le cache local pour lancer le préchargement sur le flux de code de la définition spécifiée.

2. La phase de lecture appelle selectTrack après que onPlayerEvent ait reçu l'événement de fin de préparation (AVPEventPrepareDone), et sélectionne la même définition que le préchargement ; setUrlSource(AVPUrlSource) utilise la même adresse de lecture que le préchargement, puis prepare et start.

3. Si le débit de départ est incohérent avec le débit par défaut, la mise en mémoire tampon sera déclenchée. Il est recommandé de définir le débit de départ pour réduire les saccades lors du changement.

La lecture d'un fichier HLS (m3u8) téléchargé localement entraîne l'erreur « No such file or directory ».

Phénomène du problème : Après le téléchargement hors ligne de HLS, la lecture de l'adresse locale signale No such file or directory (fichier introuvable). Ce problème peut ne pas être systématique et est plus facile à reproduire dans des scénarios tels que le changement rapide de pages multiples (glissement rapide).

Cause du problème : Le téléchargement hors ligne de HLS ne télécharge généralement que les tranches ts et le m3u8 d'une seule des définitions (par exemple, 540p) afin d'économiser de l'espace, mais le master m3u8 enregistré localement conserve toujours les enregistrements de toutes les définitions (par exemple, 1080p/720p/540p/360p) tels quels. Pendant la lecture, si la définition téléchargée n'est pas spécifiée avant prepare, le lecteur essaiera de demander d'autres parties de définition qui n'existent pas localement selon la logique par défaut/adaptative, signalant ainsi que le fichier est introuvable. Une cause courante est l'omission d'un appel avec une clarté spécifiée, ou le timing de l'appel postérieur à prepare.

Solution :

1. setDefaultResolution est appelé avant prepare, en spécifiant la même définition que le téléchargement hors ligne.

2. Assurez-vous que tous les portails de lecture sont configurés avec une définition par défaut, y compris le glissement rapide, le multiplexage multi-instance, le changement de préchargement et autres branches, pour éviter de manquer un chemin.

3. getCurrentTrack peut être utilisé pour vérifier si la définition de démarrage réelle est la définition téléchargée.

Un décalage audio-vidéo se produit après le changement de vidéo, ou la même vidéo est lue à plusieurs reprises et manque le cache.

Phénomène du problème : Après l'activation du cache local, lors du changement de vidéos (comme le changement de numéro d'épisode), il y a un décalage du son et de l'image (l'écran affiche une nouvelle vidéo et le son correspond toujours à la vidéo précédente), ou la même vidéo est lue à plusieurs reprises sans atteindre le cache ; Après avoir vidé le cache, tout revient à la normale.

Cause du problème : Après l'activation du cache local, le lecteur utilise le Hash renvoyé par le rappel setCacheUrlHashCallback comme identifiant de cache unique pour chaque adresse de lecture (iOS implémente ce rappel via le pointeur de fonction C). Si le rappel ne garantit pas que « la même adresse de lecture renvoie toujours le même hash, un contenu différent renvoie un hash différent », cela entraînera une incompatibilité de clé de cache : un contenu différent atteint le même cache (se manifestant par un décalage audio-image), ou la même adresse génère un hash différent à chaque fois et ne peut pas atteindre le cache.

Solution :

1. Le rappel doit renvoyer de manière stable le même hash pour la même adresse de lecture, et des médias différents doivent renvoyer des hashes différents.

2. Par exemple, afin de supprimer le paramètre d'authentification pour améliorer le taux de réussite, seul le hash est calculé après la suppression du paramètre d'authentification pour l'adresse de lecture (m3u8/mp4) ; La keyURL du m3u8 chiffré n'a pas besoin d'être authentifiée, sinon les clés de différentes vidéos atteindront le même cache et provoqueront un échec de lecture - cela peut être géré différemment par nom de domaine dans le rappel.

3. Si le même fichier possède à la fois des adresses HTTP et HTTPS, le protocole peut être unifié ou le hash peut être calculé après la suppression de l'en-tête de protocole.

Pour plus de détails, reportez-vous à Fonctionnalités avancées.

Échec de l'authentification lors de la lecture d'une vidéo chiffrée privée Alibaba Cloud

Phénomène du problème : Lors de la lecture d'une vidéo chiffrée par Alibaba Cloud Video (chiffrement privé), l'authentification échoue ou la lecture est impossible.

Cause du problème : Le chiffrement vidéo Alibaba Cloud (chiffrement privé) est déchiffré par l'interaction entre le lecteur et le serveur, et la lecture doit être démarrée via la lecture vid. Si vous utilisez AVPUrlSource à la demande pour transférer directement l'adresse de lecture pour jouer (chiffrement privé courant), l'authentification et le déchiffrement ne peuvent pas être effectués, ce qui entraîne un échec.

Solution :

1. Les vidéos chiffrées privées sont lues sur iOS via AVPVidAuthSource (VidAuth) ou AVPVidStsSource (VidSts) à la demande. Si le flux de sortie est mélangé avec des flux non chiffrés privés, vous pouvez définir le type de chiffrement sur AliyunVoDEncryption pour filtrer les flux chiffrés privés.

2. Remarque : Seul le « Chiffrement privé par licence » prend en charge la lecture AVPUrlSource à la demande (MP4 doit être concaténé à la fin de l'URL etavirp_nuyila=1, HLS peut utiliser directement l'URL d'origine dans la version prise en charge correspondante), le chiffrement privé ordinaire ne s'applique pas.

Pour plus de détails, reportez-vous à Lire une vidéo chiffrée.