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
Conditions préalables à l'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

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

Opérations de transfert de données, telles que :

  • Importation ou téléchargement de données
  • Opérations de sauvegarde et restauration
  • Opérations d'importation ou d'exportation
  • Extraction de données
  • Traitement des fichiers en local
  • Transfert de données d'un appareil vers le cloud via un réseau
Autres solutions

Pour en savoir plus, consultez Alternatives aux services de premier plan de synchronisation des données.

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

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

L'utilisateur doit avoir activé les services de localisation, et l'application doit disposer d'au moins l'une des autorisations d'exécution suivantes:

Description

Cas d'utilisation de longue durée nécessitant un accès à la position, tels que la navigation et le partage de position.

Autres solutions

Si votre application doit être déclenchée lorsque l'utilisateur atteint des emplacements spécifiques, envisagez plutôt d'utiliser l'API Geofence.

Contenus multimédias

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

Poursuivez la lecture audio ou vidéo en arrière-plan. Prend en charge la fonctionnalité d'enregistrement vidéo numérique (DVR) sur Android TV.

Autres solutions

Si vous diffusez une vidéo en mode Picture-in-picture, utilisez Mode Picture-in-picture.

Traitement multimédia

Foreground service type to declare in manifest under
android:foregroundServiceType
mediaProcessing
Permission to declare in your manifest
FOREGROUND_SERVICE_MEDIA_PROCESSING
Constant to pass to startForeground()
FOREGROUND_SERVICE_TYPE_MEDIA_PROCESSING
Runtime prerequisites
None
Description

Service for performing time-consuming operations on media assets, like converting media to different formats. The system allows this service a limited time to run; under normal circumstances, this time limit would be 6 hours out of every 24. (This limit is shared by all of an app's mediaProcessing foreground services.)

Your app should manually stop the media processing service in the following scenario:

If the timeout period is reached, the system calls the service's Service.onTimeout(int, int) method. At this time, the service has a few seconds to call Service.stopSelf(). If the service does not call Service.stopSelf(), an ANR will occur with this error message: "A foreground service of <fgs_type> did not stop within its timeout: <component_name>".

Note: Service.onTimeout(int, int) is not available on Android 14 or lower. On devices running those versions, if a media processing service reaches the timeout period, the system immediately caches the app. For this reason, your app shouldn't wait to get a timeout notification. Instead, it should terminate the foreground service or change it to a background service as soon as appropriate.

Projection multimédia

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

Appelez la méthode createScreenCaptureIntent() avant de démarrer le service de premier plan. Une notification d'autorisation s'affiche alors pour l'utilisateur, qui doit l'accorder avant que vous puissiez créer le service.

Une fois le service de premier plan créé, vous pouvez appeler MediaProjectionManager.getMediaProjection().

Description

Projetez du contenu sur un écran externe ou un appareil externe à l'aide des API MediaProjection. Il ne doit pas nécessairement s'agir de contenu exclusivement multimédia.

Autres solutions

Pour diffuser des contenus multimédias en streaming sur un autre appareil, utilisez le SDK Google Cast.

Micro

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

Demandez et obtenez l'autorisation d'exécution RECORD_AUDIO.

Description

Continuez à utiliser le micro en arrière-plan, par exemple pour un enregistreur vocal ou une application de communication.

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 via le 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

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

Recouvre les cas d'utilisation de services de premier plan valides qui ne sont pas couverts par les autres types de services de premier plan.

En plus de déclarer le type de service de premier plan FOREGROUND_SERVICE_TYPE_SPECIAL_USE, les développeurs doivent déclarer les cas d'utilisation dans le fichier manifeste. Pour ce faire, ils doivent spécifier l'élément <property> dans l'élément <service>. Ces valeurs et les cas d'utilisation correspondants sont examinés lorsque vous envoyez votre application dans la Google Play Console. Les cas d'utilisation que vous fournissez sont libres et vous devez vous assurer de fournir suffisamment d'informations pour permettre à l'examinateur de voir pourquoi vous devez utiliser le type specialUse.

<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é

Foreground service type to declare in manifest under
android:foregroundServiceType
systemExempted
Permission to declare in your manifest
FOREGROUND_SERVICE_SYSTEM_EXEMPTED
Constant to pass to startForeground()
FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED
Runtime prerequisites
None
Description

Reserved for system applications and specific system integrations, to continue to use foreground services.

To use this type, an app must meet at least one of the following criteria:

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.