Meine Kontakte – Benachrichtigungen

Die Meine Kontakte-Benachrichtigungen bieten Nutzern eine neue Möglichkeit, mit den Menschen, die ihnen wichtig sind, durch schnelle, ausdrucksstarke Gesten in Kontakt zu treten. Dieser Artikel zeigt, wie Sie Meine Kontakte-Benachrichtigungen in Ihrer Anwendung entwerfen und implementieren. Vollständige Implementierungen finden Sie im Meine-Kontakte-Benachrichtigungs-Beispiel.

Anforderungen

• Windows 10 und Microsoft Visual Studio ab 2019. Einzelheiten zur Installation finden Sie unter Einrichten mit Visual Studio.
• Grundkenntnisse in C# oder einer ähnlichen objektorientierten Programmiersprache. Erste Schritte mit C# finden Sie unter Erstellen einer „Hello, world“-App.

Funktionsweise

Als Alternative zu den allgemeinen Popup-Benachrichtigungen können Sie jetzt Benachrichtigungen über die Funktion „Meine Kontakte“ senden, um den Nutzern ein persönlicheres Erlebnis zu bieten. Dies ist eine neue Art von Popup, der von einem Kontakt gesendet wird, der mit der Funktion „Meine Kontakte“ an die Taskleiste des Benutzers angeheftet wurde. Wenn die Benachrichtigung eingeht, wird das Kontaktbild des Absenders in der Taskleiste animiert und ein Ton ertönt, der signalisiert, dass die Benachrichtigung beginnt. Die in der Nutzlast angegebene Animation oder das Bild wird 5 Sekunden lang angezeigt (oder, wenn die Nutzlast eine Animation von weniger als 5 Sekunden Länge ist, wird sie in einer Schleife angezeigt, bis 5 Sekunden vergangen sind).

Unterstützte Bildtypen

• GIF
• Statisches Bild (JPEG, PNG)
• Spritesheet (nur vertikal)

Parameter für die Benachrichtigung

Meine Kontakte-Benachrichtigungen verwenden das Popup-Benachrichtigungs-Framework, erfordern aber einen zusätzlichen Bindungsknoten in der Popup-Nutzlast. Diese zweite Bindung muss den folgenden Parameter enthalten:

experienceType="shoulderTap"

Dies bedeutet, dass der Popup als „Meine Kontakte“-Meldung behandelt werden soll.

Der Bildknoten innerhalb der Bindung sollte die folgenden Parameter enthalten:

• src
  • URI des Assets. Dies kann entweder ein HTTP/HTTPS-Web-URI, ein msappx-URI oder ein Pfad zu einer lokalen Datei sein.
• spritesheet-src
  • URI des Assets. Dies kann entweder ein HTTP/HTTPS-Web-URI, ein msappx-URI oder ein Pfad zu einer lokalen Datei sein. Nur für Spritesheet-Animationen erforderlich.
• spritesheet-height
  • Die Rahmenhöhe (in Pixel). Nur für Spritesheet-Animationen erforderlich.
• spritesheet-fps
  • Bilder pro Sekunde (FPS). Nur für Spritesheet-Animationen erforderlich. Es werden nur die Werte 1-120 unterstützt.
• spritesheet-startingFrame
  • Die Bildnummer für den Beginn der Animation. Wird nur für Spritesheet-Animationen verwendet und standardmäßig auf 0 gesetzt, wenn keine Angaben gemacht werden.
• alt
  • Textzeichenfolge, die für die Bildschirmleser-Erzählung verwendet wird.

Darüber hinaus muss der Popup-Knoten der obersten Ebene den Parameter hint-people enthalten, um den sendenden Kontakt anzugeben. Dieser Parameter kann einen der folgenden Werte annehmen:

• E-Mail-Adresse
  • Beispiel: mailto:johndoe@mydomain.com
• Telephone number
  • Zum Beispiel 888-888-8888
• Remote-ID
  • Zum Beispiel remoteid:1234

Zusätzlich zur zweiten Bindung und Payload müssen Sie eine weitere Payload in die erste Bindung für den Fallback-Popup aufnehmen. Die Benachrichtigung verwendet dies, wenn sie gezwungen ist, zu einem regulären Popup zurückzukehren (weitere Informationen finden Sie am Ende dieses Artikels).

Erstellen der Meldung

Sie können eine Meine Kontakte-Benachrichtigungsvorlage genauso erstellen wie eine Popup-Benachrichtigung.

Das folgende Beispiel zeigt, wie Sie eine Meine Kontakte-Benachrichtigung mit einem statischen Bild erstellen:

<toast hint-people="mailto:johndoe@mydomain.com">
    <visual lang="en-US">
        <binding template="ToastGeneric">
            <text hint-style="body">Toast fallback</text>
            <text>Add your fallback toast content here</text>
        </binding>
        <binding template="ToastGeneric" experienceType="shoulderTap">
            <image src="https://learn.microsoft.com/windows/uwp/contacts-and-calendar/images/shoulder-tap-static-payload.png"/>
        </binding>
    </visual>
</toast>

Wenn Sie die Meldung starten, sollte sie wie folgt aussehen:

Hier ein Beispiel für die Erstellung einer Benachrichtigung mit einem animierten Spritesheet-Payload. Dieses Spritesheet hat eine Bildhöhe von 80 Pixeln, die wir mit 25 Bildern pro Sekunde animieren werden. Wir setzen das Startbild auf 15 und versehen es mit einem statischen Fallback-Bild im Parameter „src“. Das Fallback-Bild wird verwendet, wenn die Spritesheet-Animation nicht angezeigt werden kann.

<toast hint-people="mailto:johndoe@mydomain.com">
    <visual lang="en-US">
        <binding template="ToastGeneric">
            <text hint-style="body">Toast fallback</text>
            <text>Add your fallback toast content here</text>
        </binding>
        <binding template="ToastGeneric" experienceType="shoulderTap">
            <image src="https://learn.microsoft.com/windows/uwp/contacts-and-calendar/images/shoulder-tap-pizza-static.png"
                spritesheet-src="https://learn.microsoft.com/windows/uwp/contacts-and-calendar/images/shoulder-tap-pizza-spritesheet.png"
                spritesheet-height='80' spritesheet-fps='25' spritesheet-startingFrame='15'/>
        </binding>
    </visual>
</toast>

Wenn Sie die Meldung starten, sollte sie wie folgt aussehen:

Starten der Benachrichtigung

Um eine Meine Kontakte-Benachrichtigung zu starten, müssen wir die Popup-Vorlage in ein XmlDocument-Objekt umwandeln. Wenn Sie den Popup in einer XML-Datei (hier „content.xml“ genannt) definiert haben, können Sie ihn mit diesem Code starten:

string xmlText = File.ReadAllText("content.xml");
XmlDocument xmlContent = new XmlDocument();
xmlContent.LoadXml(xmlText);

Mit diesem Code können Sie dann den Popup erstellen und versenden:

ToastNotification notification = new ToastNotification(xmlContent);
ToastNotificationManager.CreateToastNotifier().Show(notification);

Zurückfallen auf Popup

Es gibt Fälle, in denen eine Benachrichtigung von Meine Kontakte stattdessen als normale Popup-Benachrichtigung angezeigt wird. Eine Meine Kontakte-Benachrichtigung wird unter den folgenden Bedingungen auf Popup zurückgesetzt:

• Die Meldung wird nicht angezeigt
• Meine Kontakte-Benachrichtigungen sind vom Empfänger nicht aktiviert
• Der Kontakt des Absenders ist nicht an die Taskleiste des Empfängers angeheftet

Wenn eine My-People-Benachrichtigung auf Popup zurückfällt, wird die zweite My-People-spezifische Bindung ignoriert und nur die erste Bindung zur Anzeige des Popups verwendet. Aus diesem Grund ist es wichtig, in der ersten Popupbindung eine Fallback-Nutzlast bereitzustellen.

Weitere Informationen

• Beispiel für Benachrichtigungen über meine Leute
• Unterstützung von Meine Kontakte hinzufügen
• Adaptive Popup-Benachrichtigungen
• ToastNotification Class