Types de services de premier plan

À partir d'Android 14 (niveau d'API 34), vous devez déclarer un type de service approprié pour chaque service de premier plan. Cela signifie que vous devez déclarer le type de service dans le fichier manifeste de votre application et demander l'autorisation de service de premier plan appropriée pour ce type (en plus de demander l'autorisation FOREGROUND_SERVICE). De plus, selon le type de service de premier plan, vous devrez peut-être demander des autorisations d'exécution avant de lancer le service.

Appareil photo

Type de service de premier plan à déclarer dans le fichier manifeste sous android:foregroundServiceType
camera
Autorisation à déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_CAMERA
Constante à transmettre à startForeground()
FOREGROUND_SERVICE_TYPE_CAMERA
Prérequis d'exécution

Demander et obtenir l'autorisation d'exécution CAMERA

Description

Continuez à avoir accès à la caméra en arrière-plan, pour les applications de chat vidéo permettant d'effectuer plusieurs tâches en même temps, par exemple.

Appareil connecté

Foreground service type to declare in manifest under
android:foregroundServiceType
connectedDevice
Permission to declare in your manifest
FOREGROUND_SERVICE_CONNECTED_DEVICE
Constant to pass to startForeground()
FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE
Runtime prerequisites

At least one of the following conditions must be true:

Description

Interactions with external devices that require a Bluetooth, NFC, IR, USB, or network connection.

Alternatives

If your app needs to do continuous data transfer to an external device, consider using the companion device manager instead. Use the companion device presence API to help your app stay running while the companion device is in range.

If your app needs to scan for bluetooth devices, consider using the Bluetooth scan API instead.

Synchroniser les données

Foreground service type to declare in manifest under
android:foregroundServiceType
dataSync
Permission to declare in your manifest
FOREGROUND_SERVICE_DATA_SYNC
Constant to pass to startForeground()
FOREGROUND_SERVICE_TYPE_DATA_SYNC
Runtime prerequisites
None
Description

Data transfer operations, such as the following:

  • Data upload or download
  • Backup-and-restore operations
  • Import or export operations
  • Fetch data
  • Local file processing
  • Transfer data between a device and the cloud over a network
Alternatives

See Alternatives to data sync foreground services for detailed information.

Santé

Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
health
Autorisation à déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_HEALTH
Constante à transmettre à startForeground()
FOREGROUND_SERVICE_TYPE_HEALTH
Conditions préalables d'exécution

Vous devez remplir l'une des conditions suivantes :

Description

Tous les cas d'utilisation de longue durée pour prendre en charge les applications de la catégorie "Remise en forme", tels que les coachs électroniques d'entraînement.

Localisation

Foreground service type to declare in manifest under
android:foregroundServiceType
location
Permission to declare in your manifest
FOREGROUND_SERVICE_LOCATION
Constant to pass to startForeground()
FOREGROUND_SERVICE_TYPE_LOCATION
Runtime prerequisites

The user must have enabled location services and the app must be granted at least one of the following runtime permissions:

Description

Long-running use cases that require location access, such as navigation and location sharing.

Alternatives

If your app needs to be triggered when the user reaches specific locations, consider using the geofence API instead.

Contenus multimédias

Foreground service type to declare in manifest under
android:foregroundServiceType
mediaPlayback
Permission to declare in your manifest
FOREGROUND_SERVICE_MEDIA_PLAYBACK
Constant to pass to startForeground()
FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
Runtime prerequisites
None
Description

Continue audio or video playback from the background. Support Digital Video Recording (DVR) functionality on Android TV.

Alternatives

If you're showing picture-in-picture video, use Picture-in-Picture mode.

Traitement multimédia

Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
mediaProcessing
Autorisation à déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_MEDIA_PROCESSING
Constante à transmettre à startForeground()
FOREGROUND_SERVICE_TYPE_MEDIA_PROCESSING
Conditions préalables d'exécution
Aucune
Description

Service permettant d'effectuer des opérations chronophages sur des composants multimédias, comme la conversion de contenus multimédias en différents formats. Le système autorise ce service à s'exécuter pendant une durée limitée. Dans des conditions normales, cette limite de temps est de six heures sur 24. (Cette limite est partagée par tous les services de premier plan mediaProcessing d'une application.)

Votre application doit arrêter manuellement le service de traitement multimédia dans le scénario suivant:

Si le délai avant expiration est atteint, le système appelle la méthode Service.onTimeout(int, int) du service. À ce stade, le service dispose de quelques secondes pour appeler Service.stopSelf(). Si le service n'appelle pas Service.stopSelf(), une erreur ANR se produit avec le message d'erreur suivant: "Un service de premier plan de <fgs_type> ne s'est pas arrêté dans le délai avant expiration: <component_name>".

Remarque: Service.onTimeout(int, int) n'est pas disponible sur Android 14 ou version antérieure. Sur les appareils exécutant ces versions, si un service de traitement multimédia atteint la période d'expiration, le système met immédiatement en cache l'application. Pour cette raison, votre application ne doit pas attendre de recevoir une notification d'expiration. Au lieu de cela, il doit arrêter le service de premier plan ou le convertir en service en arrière-plan dès que cela est approprié.

Projection multimédia

Foreground service type to declare in manifest under
android:foregroundServiceType
mediaProjection
Permission to declare in your manifest
FOREGROUND_SERVICE_MEDIA_PROJECTION
Constant to pass to startForeground()
FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
Runtime prerequisites

Call the createScreenCaptureIntent() method before starting the foreground service. Doing so shows a permission notification to the user; the user must grant the permission before you can create the service.

After you have created the foreground service, you can call MediaProjectionManager.getMediaProjection().

Description

Project content to non-primary display or external device using the MediaProjection APIs. This content doesn't have to be exclusively media content.

Alternatives

To stream media to another device, use the Google Cast SDK.

Micro

Foreground service type to declare in manifest under
android:foregroundServiceType
microphone
Permission to declare in your manifest
FOREGROUND_SERVICE_MICROPHONE
Constant to pass to startForeground()
FOREGROUND_SERVICE_TYPE_MICROPHONE
Runtime prerequisites

Request and be granted the RECORD_AUDIO runtime permission.

Description

Continue microphone capture from the background, such as voice recorders or communication apps.

Appel téléphonique

Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
phoneCall
Autorisation à déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_PHONE_CALL
Constante à transmettre à startForeground()
FOREGROUND_SERVICE_TYPE_PHONE_CALL
Conditions préalables à l'exécution

Au moins l'une des conditions suivantes doit être remplie :

  • L'application a déclaré l'autorisation MANAGE_OWN_CALLS dans son fichier manifeste.
  • L'application est l'application de téléphone par défaut grâce au rôle ROLE_DIALER.
Description

Poursuivez un appel en cours à l'aide des API ConnectionService.

Autres solutions

Si vous devez passer des appels téléphoniques, vidéo ou VoIP, pensez à utiliser la bibliothèque android.telecom.

Envisagez d'utiliser CallScreeningService pour filtrer les appels.

Messagerie à distance

Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
remoteMessaging
Autorisation à déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_REMOTE_MESSAGING
Constante à transmettre à startForeground()
FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING
Conditions préalables d'exécution
Aucune
Description
Transférez des messages d'un appareil à un autre. Contribue à la continuité des tâches de messagerie d'un utilisateur lorsqu'il change d'appareil.

Service court

Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
shortService
Autorisation à déclarer dans votre fichier manifeste
Aucune
Constante à transmettre à startForeground()
FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
Conditions préalables d'exécution
Aucune
Description

Finalisez rapidement les tâches essentielles qui ne peuvent pas être interrompues ni reportées.

Ce type présente des caractéristiques uniques :

  • Il ne peut être exécuté que sur une courte période (environ trois minutes).
  • Il est incompatible avec les services de premier plan persistants.
  • Il ne peut démarrer d'autres services de premier plan.
  • Il ne nécessite pas d'autorisation spécifique à un type, bien que l'autorisation FOREGROUND_SERVICE reste nécessaire.
  • Un shortService ne peut passer à un autre type de service que si l'application est actuellement éligible au démarrage d'un nouveau service de premier plan.
  • Un service de premier plan peut modifier son type en shortService à tout moment, à partir de quoi le délai avant expiration commence.

Le délai d'inactivité pour shortService commence à partir du moment où Service.startForeground() est appelé. L'application doit appeler Service.stopSelf() ou Service.stopForeground() avant l'expiration du délai. Sinon, le nouveau Service.onTimeout() est appelé, ce qui permet aux applications d'appeler brièvement stopSelf() ou stopForeground() pour arrêter leur service.

Peu après l'appel de Service.onTimeout(), l'application passe dans un état mis en cache et n'est plus considérée comme étant de premier plan, sauf si l'utilisateur interagit activement avec elle. Peu de temps après la mise en cache de l'application et l'arrêt du service, celle-ci reçoit une erreur ANR. Le message ANR mentionne FOREGROUND_SERVICE_TYPE_SHORT_SERVICE. Pour ces raisons, il est recommandé d'implémenter le rappel Service.onTimeout().

Le rappel Service.onTimeout() n'existe pas sur Android 13 ou version antérieure. Si le même service s'exécute sur ces appareils, il ne reçoit pas de délai d'inactivité ni d'erreur ANR. Assurez-vous que votre service s'arrête dès la fin de la tâche de traitement, même s'il n'a pas encore reçu le rappel Service.onTimeout().

Notez que si le délai d'expiration de shortService n'est pas respecté, l'application sera ANR, même si d'autres services de premier plan valides ou d'autres processus de cycle de vie de l'application sont en cours d'exécution.

Si une application est visible par l'utilisateur ou qu'elle satisfait l'une des exceptions permettant de démarrer les services de premier plan en arrière-plan, appeler à nouveau Service.StartForeground() avec le paramètre FOREGROUND_SERVICE_TYPE_SHORT_SERVICE prolonge le délai avant expiration de trois minutes. Si l'application n'est pas visible par l'utilisateur et qu'elle ne satisfait pas l'une des exceptions, toute tentative de démarrage d'un autre service de premier plan, quel que soit son type, entraîne une ForegroundServiceStartNotAllowedException

Si un utilisateur désactive l'optimisation de la batterie pour votre application, cette dernière sera toujours affectée par le délai d'inactivité du shortService du service de premier plan.

Si vous démarrez un service de premier plan qui inclut le type shortService et un autre type de service de premier plan, le système ignore la déclaration du type shortService. Toutefois, le service doit toujours respecter les conditions préalables des autres types déclarés. Pour en savoir plus, consultez la documentation sur les services de premier plan.

Utilisation spéciale

Foreground service type to declare in manifest under
android:foregroundServiceType
specialUse
Permission to declare in your manifest
FOREGROUND_SERVICE_SPECIAL_USE
Constant to pass to startForeground()
FOREGROUND_SERVICE_TYPE_SPECIAL_USE
Runtime prerequisites
None
Description

Covers any valid foreground service use cases that aren't covered by the other foreground service types.

In addition to declaring the FOREGROUND_SERVICE_TYPE_SPECIAL_USE foreground service type, developers should declare use cases in the manifest. To do so, they specify the <property> element within the <service> element. These values and corresponding use cases are reviewed when you submit your app in the Google Play Console. The use cases you provide are free-form, and you should make sure to provide enough information to let the reviewer see why you need to use the specialUse type.

<service android:name="fooService" android:foregroundServiceType="specialUse">
  <property android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE"
      android:value="explanation_for_special_use"/>
</service>

Système exempté

Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
systemExempted
Autorisation de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_SYSTEM_EXEMPTED
Constante à transmettre à startForeground()
FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED
Conditions requises pour l'environnement d'exécution
Aucune
Description

Réservé pour les applications système et les intégrations système spécifiques, afin de continuer à utiliser les services de premier plan.

Pour utiliser ce type, une application doit correspondre à au moins un des critères suivants :

  • L'appareil est en mode démo
  • L'application est un Device Owner
  • L'application est un Profiler Owner
  • Les applications de sécurité ayant le rôle ROLE_EMERGENCY
  • Les applications Device Admin
  • Applications disposant de l'autorisation SCHEDULE_EXACT_ALARM ou USE_EXACT_ALARM

  • Applications VPN (configurées sous Paramètres > Réseau et Internet > VPN)

    Autrement, le fait de déclarer ce type renvoie une exception ForegroundServiceTypeNotAllowedException.

Application des règles Google Play pour l'utilisation des types de services de premier plan

Si votre application cible Android 14 ou une version ultérieure, vous devez déclarer les types de services de premier plan de votre application sur la page "Contenu de l'application" de la Play Console (Règles > Contenu de l'application). Pour en savoir plus sur la déclaration de vos types de services de premier plan dans la Play Console, consultez Comprendre les exigences liées aux services de premier plan et à l'intent plein écran.