JobScheduler Klasse
Definition
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.
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird.
[Android.Runtime.Register("android/app/job/JobScheduler", DoNotGenerateAcw=true)]
public abstract class JobScheduler : Java.Lang.Object[<Android.Runtime.Register("android/app/job/JobScheduler", DoNotGenerateAcw=true)>]
type JobScheduler = class
inherit Object- Vererbung
- Attribute
Hinweise
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird.
Weitere android.app.job.JobInfo Informationen zu den Arten von Aufträgen, die ausgeführt werden können und wie sie erstellt werden können. Sie erstellen diese JobInfo-Objekte und übergeben sie an den JobScheduler mit #schedule(JobInfo). Wenn die deklarierten Kriterien erfüllt sind, führt das System diesen Auftrag für die Anwendung aus android.app.job.JobService. Sie identifizieren die Dienstkomponente, die die Logik für Ihren Auftrag implementiert, wenn Sie die JobInfo mit android.app.job.JobInfo.Builder#Builder(int,android.content.ComponentName).
Das Framework ist intelligent darüber, wann Aufträge ausgeführt werden, und versucht, sie so weit wie möglich zu stapeln und zu verzögern. Wenn Sie in der Regel keinen Stichtag für einen Auftrag angeben, kann er in Abhängigkeit vom aktuellen Status der internen Warteschlange des AuftragsSchedulers jederzeit ausgeführt werden.
Ab Android-Version android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKEkann JobScheduler versuchen, die Auftragsausführung zu optimieren, indem die Ausführung auf Zeiten mit mehr verfügbaren Systemressourcen verschoben wird, um die Auswirkungen des Benutzers zu verringern. Zu den Faktoren der Systemintegrität gehören ausreichend Akku, Leerlauf, Ladevorgang und Zugriff auf ein nicht getaktetes Netzwerk. Arbeitsplätze werden zunächst so behandelt, als hätten sie all diese Anforderungen, aber da ihre Fristen angehen, werden Einschränkungen weniger streng. Die angeforderten Anforderungen sind von dieser Änderung nicht betroffen.
android.app.job.JobInfo.Builder#setRequiresBatteryNotLow(boolean)
android.app.job.JobInfo.Builder#setRequiresDeviceIdle(boolean)
android.app.job.JobInfo.Builder#setRequiresCharging(boolean)
android.app.job.JobInfo.Builder#setRequiredNetworkType(int)
Während ein Auftrag ausgeführt wird, hält das System ein Wakelock im Auftrag Ihrer App. Aus diesem Grund müssen Sie keine Maßnahmen ergreifen, um sicherzustellen, dass das Gerät für die Dauer des Auftrags wach bleibt.
Sie instanziieren diese Klasse nicht direkt; Rufen Sie sie stattdessen durch android.content.Context#getSystemService Context.getSystemService(Context.JOB_SCHEDULER_SERVICE).
Vor der Android-Version android.os.Build.VERSION_CODES#Skonnten Aufträge nur maximal 100 Aufträge gleichzeitig geplant haben. Ab Android-Version android.os.Build.VERSION_CODES#Swurde dieser Grenzwert auf 150 erhöht. Beschleunigte Aufträge zählen auch zum Grenzwert.
In Der Android-Version android.os.Build.VERSION_CODES#LOLLIPOPhatten Aufträge eine maximale Ausführungszeit von einer Minute. Ab Android-Version android.os.Build.VERSION_CODES#M und Ende mit Der Android-Version android.os.Build.VERSION_CODES#Rhatten Aufträge eine maximale Ausführungszeit von 10 Minuten. Ab Android-Version android.os.Build.VERSION_CODES#Swerden Aufträge nach 10 Minuten noch beendet, wenn das System ausgelastet ist oder die Ressourcen benötigt. Andernfalls werden Aufträge möglicherweise länger als 10 Minuten ausgeführt.
<strong>Hinweis:</strong> Ab API 30 (android.os.Build.VERSION_CODES#R), JobScheduler drosselt Runaway-Anwendungen. Das Aufrufen #schedule(JobInfo) und andere solche Methoden mit sehr hoher Häufigkeit können hohe Kosten haben. Um sicherzustellen, dass das System nicht überfordert wird, beginnt JobScheduler, Apps zu drosseln, unabhängig von der Ziel-SDK-Version.
Java Dokumentation für android.app.job.JobScheduler.
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.
Konstruktoren
| Name | Beschreibung |
|---|---|
| JobScheduler() | |
| JobScheduler(IntPtr, JniHandleOwnership) |
Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen. |
Felder
| Name | Beschreibung |
|---|---|
| PendingJobReasonApp |
Veraltet.
Die App befindet sich in einem Zustand, der die Ausführung des Auftrags verhindert (z. B. |
| PendingJobReasonAppStandby |
Veraltet.
Der aktuelle Standby-Bucket verhindert, dass der Auftrag ausgeführt wird. |
| PendingJobReasonBackgroundRestriction |
Veraltet.
Die App ist auf die Ausführung im Hintergrund beschränkt. |
| PendingJobReasonConstraintBatteryNotLow |
Veraltet.
Die angeforderte akkufreie Einschränkung ist nicht erfüllt. |
| PendingJobReasonConstraintCharging |
Veraltet.
Die angeforderte Ladeeinschränkung ist nicht erfüllt. |
| PendingJobReasonConstraintConnectivity |
Veraltet.
Die angeforderte Konnektivitätseinschränkung ist nicht erfüllt. |
| PendingJobReasonConstraintContentTrigger |
Veraltet.
Die einschränkung für den angeforderten Inhaltsauslöser ist nicht erfüllt. |
| PendingJobReasonConstraintDeadline |
Veraltet.
Die Außerkraftsetzungsfrist wurde nicht überschritten. |
| PendingJobReasonConstraintDeviceIdle |
Veraltet.
Die angeforderte Leerlaufeinschränkung ist nicht erfüllt. |
| PendingJobReasonConstraintMinimumLatency |
Veraltet.
Die minimale Latenz ist nicht transpiriert. |
| PendingJobReasonConstraintPrefetch |
Veraltet.
Die Schätzung des Systems, wann die App gestartet wird, ist weit genug, um eine Verzögerung dieses Auftrags zu gewährleisten. |
| PendingJobReasonConstraintStorageNotLow |
Veraltet.
Die angeforderte Einschränkung "Speicher nicht niedrig" ist nicht erfüllt. |
| PendingJobReasonDeviceState |
Veraltet.
Der Auftrag wird aufgrund des Gerätezustands zurückgestellt (z. B. |
| PendingJobReasonExecuting |
Veraltet.
Der Auftrag wird derzeit ausgeführt und steht daher nicht aus. |
| PendingJobReasonInvalidJobId |
Veraltet.
Der Auftrag ist nicht vorhanden. |
| PendingJobReasonJobSchedulerOptimization |
Veraltet.
JobScheduler glaubt, dass er diesen Auftrag auf eine optimale Laufzeit zurückstellen kann. |
| PendingJobReasonQuota |
Veraltet.
Die App hat das aktuelle Kontingent verbraucht. |
| PendingJobReasonUndefined |
Veraltet.
Es gibt keinen bekannten Grund, warum der Auftrag aussteht. |
| PendingJobReasonUser |
Veraltet.
JobScheduler respektiert eine der Aktionen des Benutzers (z. B. |
| ResultFailure |
Wird zurückgegeben |
| ResultSuccess |
Wird zurückgegeben |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AllPendingJobs | |
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| JniIdentityHashCode |
Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object) |
| JniManagedPeerState |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
| JniPeerMembers |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. |
| Namespace |
Rufen Sie den Namespace ab, in dem diese JobScheduler-Instanz ausgeführt wird. |
| PeerReference |
Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object) |
| PendingJobsInAllNamespaces |
Rufen Sie alle Aufträge ab, die von der aufrufenden Anwendung im aktuellen Namespace geplant wurden. |
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. |
Methoden
| Name | Beschreibung |
|---|---|
| Cancel(Int32) |
Abbrechen des angegebenen Auftrags. |
| CancelAll() |
Abbrechen aller Aufträge, die im aktuellen Namespace durch die aufrufende Anwendung geplant wurden. |
| CancelInAllNamespaces() |
Abbrechen sie <alle></em-Aufträge>, die von der aufrufenden Anwendung geplant wurden, unabhängig vom Namespace. |
| CanRunUserInitiatedJobs() |
Gibt zurück |
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
| Dispose() |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| Dispose(Boolean) |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| DisposeUnlessReferenced() |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
| Enqueue(JobInfo, JobWorkItem) |
Ähnlich wie |
| Equals(Object) |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| ForNamespace(String) |
Rufen Sie eine JobScheduler-Instanz ab, die einem bestimmten Namespace zugeordnet ist. |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| GetPendingJob(Int32) |
Suchen Sie nach der Beschreibung eines geplanten Auftrags. |
| GetPendingJobReason(Int32) |
Gibt einen Grund zurück, warum der Auftrag aussteht und derzeit nicht ausgeführt wird. |
| GetPendingJobReasons(Int32) |
Gibt mögliche Gründe zurück, warum der Auftrag mit dem angegebenen |
| GetPendingJobReasonsHistory(Int32) |
Gibt für den gegebenen |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| Schedule(JobInfo) |
Planen Sie einen Auftrag, der ausgeführt werden soll. |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
| ToArray<T>() |
Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object) |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IJavaPeerable.Disposed() |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
| IJavaPeerable.Finalized() |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. (Geerbt von JavaObject) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Dies ist eine API zum Planen verschiedener Arten von Aufträgen für das Framework, das im eigenen Prozess Ihrer Anwendung ausgeführt wird. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |