À 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 de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_CAMERA
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_CAMERA
- Conditions requises pour l'environnement d'exécution
Demander et obtenir l'autorisation d'exécution
CAMERA
Remarque:L'autorisation d'exécution
CAMERA
est soumise à des restrictions d'utilisation. Pour cette raison, vous ne pouvez pas créer de service de premier plancamera
lorsque votre application est en arrière-plan, à quelques exceptions près. Pour en savoir plus, consultez la section Restrictions au démarrage de services de premier plan nécessitant des autorisations en cours d'utilisation.- Description
continuer à accéder à la caméra en arrière-plan (applications de chat vidéo permettant le multitâche, par exemple).
Appareil connecté
- Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
connectedDevice
- Autorisation de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_CONNECTED_DEVICE
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE
- Conditions requises pour l'environnement d'exécution
Vous devez remplir l'une des conditions suivantes :
Déclarez au moins l'une des autorisations suivantes dans votre fichier manifeste :
Demandez et recevez au moins l'une des autorisations d'exécution suivantes:
Appeler
UsbManager.requestPermission()
- Description
Interactions avec des appareils externes nécessitant une connexion Bluetooth, NFC, IR, USB ou réseau.
- Autres solutions
Si votre application doit effectuer un transfert de données continu vers un appareil externe, envisagez plutôt d'utiliser le gestionnaire d'appareils associés. Utilisez l'API de présence d'appareil associé pour permettre à votre application de rester exécutée lorsque l'appareil associé est à portée.
Si votre application doit rechercher des appareils Bluetooth, envisagez plutôt d'utiliser l'API Bluetooth Scan.
Synchroniser les données
- Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
dataSync
- Autorisation de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_DATA_SYNC
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_DATA_SYNC
- Conditions requises pour l'environnement d'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 de données.
Santé
- Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
health
- Autorisation de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_HEALTH
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_HEALTH
- Conditions requises pour l'environnement d'exécution
Vous devez remplir l'une des conditions suivantes :
Déclarez l'autorisation
HIGH_SAMPLING_RATE_SENSORS
dans votre fichier manifeste.Demandez et recevez au moins l'une des autorisations d'exécution suivantes:
Remarque:L'autorisation d'exécution
BODY_SENSORS
est soumise à des restrictions d'utilisation. Pour cette raison, vous ne pouvez pas créer de service de premier planhealth
qui utilise des capteurs corporels lorsque votre application est exécutée en arrière-plan, à quelques exceptions près. Pour en savoir plus, consultez la section Restrictions au démarrage de services de premier plan nécessitant des autorisations en cours d'utilisation.- 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 à l'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:
Remarque:Pour vérifier que l'utilisateur a activé les services de localisation et accordé l'accès aux autorisations d'exécution, utilisez
PermissionChecker#checkSelfPermission()
.Remarque:Les autorisations d'exécution d'accès à la position sont soumises à des restrictions d'utilisation. Pour cette raison, vous ne pouvez pas créer de service de premier plan
location
lorsque votre application est exécutée en arrière-plan, sauf si vous disposez de l'autorisation d'exécutionACCESS_BACKGROUND_LOCATION
. Pour en savoir plus, consultez la section Restrictions concernant le démarrage de services de premier plan qui nécessitent des autorisations en cours d'utilisation.- 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 accède à des emplacements spécifiques, envisagez plutôt d'utiliser l'API Géoreence.
Contenus multimédias
- Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
mediaPlayback
- Autorisation de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_MEDIA_PLAYBACK
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
- Conditions requises pour l'environnement d'exécution
- Aucune
- Description
- Continuez la lecture audio ou vidéo en arrière-plan. Prenez en charge la fonctionnalité d'enregistrement vidéo numérique (DVR) sur Android TV.
- Autres solutions
- Si vous diffusez une vidéo Picture-in-picture, utilisez le mode Picture-in-picture.
Projection multimédia
- Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
mediaProjection
- Autorisation de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_MEDIA_PROJECTION
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
- Conditions requises pour l'environnement d'exécution
Appelez la méthode
createScreenCaptureIntent()
avant de démarrer le service de premier plan. Une notification d'autorisation s'affiche. Celui-ci doit accorder l'autorisation pour que vous puissiez créer le service.Après avoir créé le service de premier plan, 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 du contenu multimédia 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 de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_MICROPHONE
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_MICROPHONE
- Conditions requises pour l'environnement d'exécution
Demandez et obtenez l'autorisation d'exécution
RECORD_AUDIO
.Remarque:L'autorisation d'exécution
RECORD_AUDIO
est soumise à des restrictions d'utilisation. Pour cette raison, vous ne pouvez pas créer de service de premier planmicrophone
lorsque votre application est en arrière-plan, à quelques exceptions près. Pour en savoir plus, consultez la section Restrictions au démarrage de services de premier plan nécessitant des autorisations en cours d'utilisation.- Description
Continuez la capture du micro en arrière-plan, par exemple pour les enregistreurs vocaux ou les applications de communication.
Appel téléphonique
- Type de service de premier plan à déclarer dans le fichier manifeste sous
android:foregroundServiceType
phoneCall
- Autorisation de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_PHONE_CALL
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_PHONE_CALL
- Conditions requises pour l'environnement d'exécution
Vous devez remplir au moins l'une des conditions suivantes:
- L'application a déclaré l'autorisation
MANAGE_OWN_CALLS
dans son fichier manifeste.
- L'application a déclaré l'autorisation
- Il s'agit de l'application de téléphonie par défaut via le rôle
ROLE_DIALER
.
- Il s'agit de l'application de téléphonie par défaut via le rôle
- Description
Continuez un appel en cours à l'aide des API
ConnectionService
.- Autres solutions
Si vous devez passer des appels téléphoniques, vidéo ou VoIP, envisagez d'utiliser la bibliothèque
android.telecom
.Pensez à 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 de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_REMOTE_MESSAGING
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING
- Conditions requises pour l'environnement 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 de déclarer dans votre fichier manifeste
- Aucune
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
- Conditions requises pour l'environnement 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 à démarrer un nouveau service de premier plan. - Un service de premier plan peut changer son type en
shortService
à tout moment. Le délai avant expiration commence alors.
Le délai d'inactivité pour shortService commence à partir du moment où
Service.startForeground()
est appelé. L'application doit appelerService.stopSelf()
ouService.stopForeground()
avant l'expiration du délai. Sinon, le nouveauService.onTimeout()
est appelé, ce qui permet aux applications d'appeler brièvementstopSelf()
oustopForeground()
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 mentionneFOREGROUND_SERVICE_TYPE_SHORT_SERVICE
. Pour ces raisons, il est recommandé d'implémenter le rappelService.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 rappelService.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ètreFOREGROUND_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 uneForegroundServiceStartNotAllowedException
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 typeshortService
. 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 de déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_SPECIAL_USE
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_SPECIAL_USE
- Conditions requises pour l'environnement 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 au format libre. Vous devez vous assurer de fournir suffisamment d'informations pour permettre au réviseur de comprendre pourquoi vous devez utiliser le typespecialUse
.<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 à déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_SYSTEM_EXEMPTED
- Constante à transmettre à
startForeground()
FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED
- Conditions préalables à l'exécution
- Aucune
- Description
Réservé pour les applications système et les intégrations système spécifiques, pour 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 contenant
SCHEDULE_EXACT_ALARM
ou L'autorisationUSE_EXACT_ALARM
et utilisent Service de premier plan pour continuer les alarmes en arrière-plan, y compris les alarmes haptiques uniquement. Applications de VPN (configurées en sélectionnant 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 du contenu de l'application dans la Play Console (Règles > Contenu de l'application). Pour savoir comment déclarer vos types de services de premier plan dans la Play Console, consultez la page Comprendre les exigences concernant les services de premier plan et l'intent plein écran.