Lire en arrière-plan dans les annonces audio

Ce guide est destiné aux éditeurs iOS qui souhaitent ajouter la lecture d'annonces audio en arrière-plan à leur implémentation du SDK IMA. Cela permet à l'application de demander des annonces en arrière-plan. De plus, l'application peut passer en arrière-plan et poursuivre la lecture de l'annonce jusqu'à la fin.

Nous vous déconseillons de lire des annonces vidéo en arrière-plan.

Prérequis

• Application iOS intégrant le SDK IMA
• SDK IMA version 3 bêta 13 ou ultérieure.

Introductions utiles

Si vous avez encore besoin d'implémenter le SDK IMA dans votre application, consultez notre guide de démarrage.

Activer la lecture des annonces en arrière-plan dans votre application

Pour activer la lecture des annonces en arrière-plan, procédez comme suit:

1. Activez le mode d'arrière-plan Audio et AirPlay. Dans Xcode 6, sélectionnez une cible, puis sous Fonctionnalités > Modes d'arrière-plan, activez "Audio et AirPlay".

2. Activez le AVAudioSession et définissez sa catégorie avec un AVAudioSessionCategory capable de lire des contenus audio en arrière-plan, comme AVAudioSessionCategoryPlayback.

- (void)viewDidLoad {
  [super viewDidLoad];

  NSError *error;
  [[AVAudioSession sharedInstance] setActive:YES error:&error];
  if (error != nil) {
    NSLog(@"Error: %@", error.localizedDescription);
  }

  [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback error:&error];
  if (error != nil) {
    NSLog(@"Error: %@", error.localizedDescription);
  }
}

3. Créez un IMAAdsLoader en transmettant un objet IMASettings avec enableBackgroundPlayback défini sur YES.

  IMASettings *settings = [[IMASettings alloc] init];
  settings.enableBackgroundPlayback = YES;
  IMAAdsLoader *adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];

Important

Pour envoyer des demandes d'annonces en arrière-plan, votre contenu doit être en cours de lecture. Vous devrez peut-être appeler manuellement la lecture sur le lecteur de contenu lorsque l'application passe en arrière-plan avant d'appeler [IMAAdsLoader requestAds:].

La mise en arrière-plan d'une application iOS met automatiquement en pause la lecture des annonces. Si votre application est exécutée en arrière-plan pendant la lecture d'une annonce, vous devez appeler [IMAAdsManager resume] pour reprendre la lecture.

Questions fréquentes

Que se passe-t-il si je n'active pas les modes audio et AirPlay en arrière-plan dans mon application ?

Si vous ne sélectionnez pas ce mode, le contenu audio lu par l'application s'arrête lorsque l'application passe en arrière-plan. L'application ne peut pas non plus lancer de contenu audio en arrière-plan.