Context.StartForegroundService(Intent) Methode

Definition

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

[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.ComponentName

Parameter

service: Intent

Gibt den Dienst an, der gestartet werden soll. Die Absicht muss vollständig explizit sein (Geben Sie einen Komponentennamen an). Zusätzliche Werte können in den Intent-Extras enthalten sein, um Argumente zusammen mit diesem spezifischen Startaufruf zu liefern.

Gibt zurück

ComponentName

Wenn der Dienst gestartet wird oder bereits ausgeführt wird, wird der ComponentName tatsächliche Dienst zurückgegeben, der gestartet wurde. Andernfalls wird null zurückgegeben, wenn der Dienst nicht vorhanden ist.

Attribute: RegisterAttribute

Hinweise

Ähnlich wie #startService(Intent), aber mit einer impliziten Zusage, dass der Dienst aufgerufen android.app.Service#startForeground(int, android.app.Notification) startForeground(int, android.app.Notification) wird, sobald er ausgeführt wird. Der Dienst erhält eine Zeit, die mit dem ANR-Intervall vergleichbar ist. Andernfalls stürzt das System den Prozess automatisch ab. In diesem Fall wird eine interne Ausnahme ForegroundServiceDidNotStartInTimeException auf Geräten protokolliert, auf denen DIE SDK-Version android.os.Build.VERSION_CODES#S oder höher ausgeführt wird. In älteren Android-Versionen wird stattdessen eine interne Ausnahme RemoteServiceException mit einer entsprechenden Meldung protokolliert.

Im Gegensatz zur gewöhnlichen #startService(Intent)Methode kann diese Methode jederzeit verwendet werden, unabhängig davon, ob sich die App, die den Dienst hostet, im Vordergrundzustand befindet.

<strong>Note:</strong> Beginning with SDK Version android.os.Build.VERSION_CODES#S, apps targeting SDK Version android.os.Build.VERSION_CODES#S or higher are not allowed to start foreground services from the background. Siehe

Verhaltensänderungen: Apps für Android 12

finden Sie weitere Details. </div>

Java Dokumentation für android.content.Context.startForegroundService(android.content.Intent).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: