Lecture d'annonces audio en arrière-plan

Ce guide est destiné aux éditeurs iOS qui souhaitent ajouter la lecture d'annonces audio en arrière-plan dans leur mise en œuvre du SDK IMA. Cela permet à l'application de demander des annonces en arrière-plan. Elle permet également à l'application d'être exécutée en arrière-plan et de poursuivre la lecture de l'annonce jusqu'à la fin.

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

Conditions préalables

• une application iOS avec le SDK IMA implémenté.
• SDK IMA version 3 bêta v13 ou ultérieure.

Introductions utiles

Si vous avez encore besoin de mettre en œuvre le SDK IMA dans votre application, consultez notre guide de démarrage.

Ajouter la lecture des annonces en arrière-plan à votre application

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

1. Activez le mode en 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 AVAudioSession et définissez sa catégorie avec un AVAudioSessionCategory pouvant lire un contenu 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 que les demandes d'annonces en arrière-plan soient envoyées, votre contenu doit être en cours de lecture. Vous devrez peut-être appeler manuellement le lecteur de contenu lorsque l'application passe en arrière-plan avant d'appeler [IMAAdsLoader requestAds:].

Lorsque vous mettez une application iOS en arrière-plan, la lecture des annonces est automatiquement interrompue. 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, toutes les données audio lues par l'application s'arrêtent lorsque celle-ci passe en arrière-plan. De plus, l'application ne peut lancer aucun contenu audio en arrière-plan.