Freigeben über


com.microsoft.connecteddevices.userdata.usernotifications

Der UserNotifications-Namespace enthält APIs, mit denen eine App benutzerorientierte Benachrichtigungen empfangen und verwalten kann, die von Ihrem App-Server über Microsoft Graph-Benachrichtigungen veröffentlicht wurden, um benutzerorientierte, geräteübergreifende Benachrichtigungen zu ermöglichen.

**Wichtig**: Dieser Namespace ist noch nicht für Drittanbieter-App-Entwickler verfügbar. Wenn Sie eine Warteliste erstellen möchten, um frühzeitigen Zugriff zu erhalten, senden Sie uns eine E-Mail an ProjectRomeTeam@microsoft.com.

Klassen

UserNotification

Diese Klasse stellt eine einzelne Benutzerbenachrichtigungsinstanz dar. Eine Benutzerbenachrichtigung wird von Ihrem App-Server erstellt und veröffentlicht, der auf einen Benutzer ausgerichtet ist und an alle Geräteendpunkte desselben angemeldeten Benutzers verteilt wird.

UserNotificationChannel

Diese Klasse stellt den Benachrichtigungsänderungsleser bereit, der den Empfang und die Verwaltung von Benutzerbenachrichtigungen für die Anwendung behandelt.

UserNotificationReader

Diese Klasse stellt neue Benachrichtigungen für eingehende Benutzer und Aktualisierungen von Benutzerbenachrichtigungen bereit. Außerdem bietet sie Zugriff auf die Sammlung von Benutzerbenachrichtigungen, die in der verbundenen Geräteplattform gespeichert sind.

UserNotificationReaderDataChangedEventArgs

EventArgs-Klasse für die Änderung der Daten im UserNotificationReader

UserNotificationReaderOptions

Mit dieser Klasse kann die App Optionen für den Benachrichtigungsleser bereitstellen, z. B. nur neue Benutzerbenachrichtigungen empfangen und keine vorhandenen Benachrichtigungsupdates.

UserNotificationUpdateResult

Diese Klasse stellt den Erfolgs- und Fehlerstatus für Versuche bereit, den Status einer Benachrichtigung zu aktualisieren.

Enumerationen

UserNotificationPriority

Enthält Werte, die die Priorität einer Benachrichtigung beschreiben.

UserNotificationReaderStartPosition

Enthält Werte, die die Position bestimmen, an der eine neue Änderung des Readers beginnt – neue Benachrichtigung für eingehende Benutzer oder neue Aktualisierungen des eingehenden Zustands.

UserNotificationReadState

Enthält Werte, die den Lesestatus jeder UserNotification bestimmen. Benachrichtigungen können von der App als gelesen oder ungelesen markiert werden. Die App definiert die entsprechende Benutzeroberfläche.

UserNotificationReadStateFilter

Enthält Werte, die beim Erstellen eines Benachrichtigungslesers einen Lesestatusfilter angeben. Dadurch wird bestimmt, ob die App alle Benachrichtigungen empfangen, nur gelesen oder nur ungelesen werden soll.

UserNotificationStatus

Enthält Werte, die bestimmen, ob die Benachrichtigung gelöscht wird oder nicht. Gelöschte Benachrichtigungen befinden sich weiterhin im Benachrichtigungsspeicher und werden vom Leser zurückgegeben, bevor die Plattformbereinigung erfolgt. Ein entsprechender Lesefilter *UserNotificationStatusFilter* kann angewendet werden, um zu verhindern, dass diese Benachrichtigungen im Benachrichtigungsleser angezeigt werden.

UserNotificationStatusFilter

Enthält Werte, die beim Erstellen eines Benachrichtigungslesers einen Statusfilter angibt. Dadurch wird bestimmt, ob die App alle Benachrichtigungen, nur aktive oder nur gelöschte Benachrichtigungen empfangen möchte.

UserNotificationUserActionState

Enthält Werte, die den Benutzeraktionsstatus jeder UserNotification bestimmen. Benachrichtigungen können von der App als aktiviert, geschlossen oder Snoozed gekennzeichnet werden. Die App definiert die entsprechende Benutzeroberfläche.

UserNotificationUserActionStateFilter

Enthält Werte, die beim Erstellen eines Benachrichtigungslesers einen Benutzeraktionsstatusfilter angeben. Dadurch wird bestimmt, ob die App alle Benachrichtigungen empfangen, nur geschlossen, nur aktiviert oder usw.