You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: uwp/contacts-and-calendar/my-people-notifications.md
+11-6Lines changed: 11 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,13 +10,13 @@ ms.localizationpriority: medium
10
10
> [!IMPORTANT]
11
11
> My People is no longer supported in Windows 11.
12
12
13
-
My People notifications provide a new way for users to connect with the people they care about, through quick expressive gestures. This article shows how to design and implement My People notifications in your application. For complete implementations, see the [My People Notifications Sample.](https://github.com/Microsoft/Windows-universal-samples/tree/dev/Samples/MyPeopleNotifications)
13
+
My People notifications provide a new way for users to connect with the people they care about, through quick expressive gestures. This article shows how to design and implement My People notifications in your application. For complete implementations, see the [My People Notifications Sample.](https://github.com/microsoft/Windows-universal-samples/tree/dev/archived/MyPeopleNotifications)
+ Windows 10 and Microsoft Visual Studio 2019. For installation details, see [Get set up with Visual Studio](/windows/apps/get-started/get-set-up).
19
+
+ Windows 10 and Microsoft Visual Studio 2019 or later. For installation details, see [Get set up with Visual Studio](/windows/apps/get-started/get-set-up).
20
20
+ Basic knowledge of C# or a similar object-oriented programming language. To get started with C#, see [Create a "Hello, world" app](../get-started/create-a-hello-world-app-xaml-universal.md).
21
21
22
22
## How it works
@@ -35,6 +35,7 @@ As an alternative to generic toast notifications, you can now send notifications
My People notifications use the [toast notification](/windows/apps/design/shell/tiles-and-notifications/adaptive-interactive-toasts) framework, but require an additional binding node in the toast payload. This second binding must include the following parameter:
39
40
40
41
```xml
@@ -63,11 +64,11 @@ The image node inside the binding should include the following parameters:
63
64
64
65
In addition, the top-level toast node must include the **hint-people** parameter to specify the sending contact. This parameter can have any the following values:
@@ -77,6 +78,7 @@ In addition, the top-level toast node must include the **hint-people** parameter
77
78
In addition to the second binding and payload, you must include another payload in the first binding for the fallback toast. The notification will use this if it is forced to revert to a regular toast (explained further at the [end of this article](#falling-back-to-toast)).
78
79
79
80
## Creating the notification
81
+
80
82
You can create a My People notification template just like you would a [toast notification](/windows/apps/design/shell/tiles-and-notifications/adaptive-interactive-toasts).
81
83
82
84
Here's an example of how to create a My People notification with a static image payload:
@@ -122,6 +124,7 @@ When you start the notification, it should look like this:
To start a My People notification, we need to convert the toast template into an [XmlDocument](/uwp/api/windows.data.xml.dom.xmldocument) object. When you have defined the toast in an XML file (here named "content.xml"), you can use this code to start it:
There are some cases when a My People notification will instead display as a regular toast notification. A My People notification will fall back to toast under the following conditions:
142
146
143
147
+ The notification fails to display
@@ -147,7 +151,8 @@ There are some cases when a My People notification will instead display as a reg
147
151
If a My People notification falls back to toast, the second My-People-specific binding is ignored, and only the first binding is used to display the toast. This is why it is critical to provide a fallback payload in the first toast binding.
148
152
149
153
## See also
150
-
+[My People Notifications Sample](https://github.com/Microsoft/Windows-universal-samples/tree/dev/Samples/MyPeopleNotifications)
154
+
155
+
+[My People Notifications Sample](https://github.com/microsoft/Windows-universal-samples/tree/dev/archived/MyPeopleNotifications)
0 commit comments