NotificationManager.SetAutomaticZenRuleState(String, Condition) Methode

Definition

Namespace:: Android.App

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.

Informiert den Benachrichtigungs-Manager darüber, dass sich der Status eines AutomaticZenRule geändert hat.

[Android.Runtime.Register("setAutomaticZenRuleState", "(Ljava/lang/String;Landroid/service/notification/Condition;)V", "GetSetAutomaticZenRuleState_Ljava_lang_String_Landroid_service_notification_Condition_Handler", ApiSince=29)]
public virtual void SetAutomaticZenRuleState(string id, Android.Service.Notification.Condition condition);

[<Android.Runtime.Register("setAutomaticZenRuleState", "(Ljava/lang/String;Landroid/service/notification/Condition;)V", "GetSetAutomaticZenRuleState_Ljava_lang_String_Landroid_service_notification_Condition_Handler", ApiSince=29)>]
abstract member SetAutomaticZenRuleState : string * Android.Service.Notification.Condition -> unit
override this.SetAutomaticZenRuleState : string * Android.Service.Notification.Condition -> unit

Parameter

id: String

Zeichenfolge: Die ID der Regel, deren Status geändert werden soll. Dieser Wert darf nicht NULL sein.

condition: Condition

Bedingung: Der neue Zustand dieser Regel. Dieser Wert darf nicht NULL sein.

Attribute: RegisterAttribute

Hinweise

Informiert den Benachrichtigungs-Manager darüber, dass sich der Status eines AutomaticZenRule geändert hat. Verwenden Sie diese Methode, um das System in den Modus "Nicht stören" zu versetzen oder den Modus "Nicht stören" zu beenden. Die aufrufende App muss über die bereitgestellte AutomaticZenRule verfügen. Diese Methode kann in Verbindung mit oder als Ersatz für android.service.notification.ConditionProviderService.notifyCondition(Condition) verwendet werden. Die Bedingungsänderung kann ignoriert werden, wenn der Benutzer die Regel manuell aktiviert oder deaktiviert hat – der Benutzer kann die Regel dieses Mal außer Kraft setzen, wobei die Regel für den nächsten Zyklus fortgesetzt wird. Wenn dies geschehen ist, wird die angegebene Bedingung nur angewendet, wenn der automatische Zustand mit dem vom Benutzer bereitgestellten Zustand einverstanden ist. Angenommen, die AutomaticZenRule entspricht einem "Fahrmodus" mit automatischer Fahrerkennung. Die App erkennt das Fahren und benachrichtigt das System, dass die Regel aktiv sein soll, und ruft diese Methode mit einer Bedingung mit Condition.STATE_TRUE auf). Der Benutzer deaktiviert ("snoozes") die Regel aus irgendeinem Grund. Dadurch wird der Zustand der app-bereitgestellten Bedingung außer Kraft gesetzt. Die App erkennt weiterhin das Fahren, also erneut Aufrufe mit Condition.STATE_TRUE. Dies wird vom System ignoriert, da die Außerkraftsetzung des Benutzers vorherrscht. Einige Zeit später erkennt die App, dass das Fahren beendet wurde, sodass die Regel inaktiv sein sollte, und Aufrufe mit Condition.STATE_FALSE). Dies ändert nicht den tatsächlichen Regelzustand (er war aufgrund der Außerkraftsetzung des Benutzers bereits inaktiv), löscht jedoch die Außerkraftsetzung. Einige Zeit später erkennt die App, dass das Fahren erneut gestartet wurde, und benachrichtigt, dass die Regel aktiv sein soll (aufrufen mit Condition.STATE_TRUE erneut). Die Regel wird aktiviert. Beachten Sie, dass sich das Verhalten bei Schritt 3 unterscheidet, wenn die App auch Condition.SOURCE_USER_ACTION als Bedingung.source angibt– Regelstatusaktualisierungen, die von Benutzeraktionen stammen, werden nicht ignoriert.

Android-Referenz für android.app.NotificationManager.setAutomaticZenRuleState.

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: