Context.StartForegroundService(Intent) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Similaire à #startService(Intent), mais avec une promesse implicite que le service appelle android.app.Service#startForeground(int, android.app.Notification)
startForeground(int, android.app.Notification) une fois qu’il commence à s’exécuter.
[Android.Runtime.Register("startForegroundService", "(Landroid/content/Intent;)Landroid/content/ComponentName;", "GetStartForegroundService_Landroid_content_Intent_Handler", ApiSince=26)]
public abstract Android.Content.ComponentName? StartForegroundService(Android.Content.Intent? service);[<Android.Runtime.Register("startForegroundService", "(Landroid/content/Intent;)Landroid/content/ComponentName;", "GetStartForegroundService_Landroid_content_Intent_Handler", ApiSince=26)>]
abstract member StartForegroundService : Android.Content.Intent -> Android.Content.ComponentNameParamètres
- service
- Intent
Identifie le service à démarrer. L’intention doit être entièrement explicite (en fournissant un nom de composant). Des valeurs supplémentaires peuvent être incluses dans les extras Intention pour fournir des arguments avec cet appel de début spécifique.
Retours
Si le service est démarré ou est déjà en cours d’exécution, le ComponentName service réel démarré est retourné ; sinon, si le service n’existe pas, la valeur Null est retournée.
- Attributs
Remarques
Similaire à #startService(Intent), mais avec une promesse implicite que le service appelle android.app.Service#startForeground(int, android.app.Notification) startForeground(int, android.app.Notification) une fois qu’il commence à s’exécuter. Le service reçoit une durée comparable à l’intervalle ANR pour effectuer cette opération ; sinon, le système bloque automatiquement le processus, auquel cas une exception ForegroundServiceDidNotStartInTimeException interne est enregistrée sur les appareils exécutant la version du KIT de développement logiciel (SDK) ou une version android.os.Build.VERSION_CODES#S ultérieure. Sur les versions antérieures d’Android, une exception RemoteServiceException interne est consignée à la place, avec un message correspondant.
Contrairement à l’ordinaire #startService(Intent), cette méthode peut être utilisée à tout moment, que l’application hébergeant le service soit au premier plan.
<div class="caution »>
<remarque forte>:</forte> à partir de la version android.os.Build.VERSION_CODES#Sdu SDK, les applications ciblant la version du SDK ou une version android.os.Build.VERSION_CODES#S ultérieure ne sont pas autorisées à démarrer les services de premier plan à partir de l’arrière-plan. Consultez
Changements de comportement : Applications ciblant Android 12
pour plus d’informations. <Commande /div>
Java documentation pour android.content.Context.startForegroundService(android.content.Intent).
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.