Tag-based notifications in native Windows 8 applications
OverviewTag notifications are notification messages that are targeted to all the devices that are subscribed to a particular tag. Tags represent topics of interest to the user and provide the ability to receive notifications according to the chosen interest.
Setting up tagsTags are defined in the
Tag-based notifications API methods
Client-side API methods
WLPush.subscribeTag(tagName,options)- Subscribes the device to the specified tag name.
WLPush.unsubscribeTag(tagName,options)- Unsubscribes the device from the specified tag name.
WLPush.isTagSubscribed(tagName)- Returns whether the device is subscribed to a specified tag name.
Common API methods for tag-based and broadcast notifications
WLNotificationListenerDefines the callback method to be notified when the notification arrives.
WLPush.notificationListener = new MyNotificationListener();Sets the implementation class of the
WLPush.onReadyToSubscribeListenerThis method registers a listener to be used for push notifications. This listener should implement the
WLNotificationListeneris called when a push notification is received by the device.
- props - A JSON block that contains the notifications properties of the platform.
- payload - A JSON block that contains other data that is sent from MobileFirst Server. The JSON block also contains the tag name for tag-based or broadcast notification. The tag name appears in the "tag" element. For broadcast notification, the default tag name is
Server-side APIThis method submits a notification that is based on the specified target parameters.
applicationId- (mandatory) The name of the MobileFirst application
notificationOptions- (mandatory) A JSON block containing message properties
For a full list of message properties, see the
WL.Server.sendMessageAPI in the API reference of the user documentation.
Sample applicationBefore running the application, check the adapter's
PushAdapter-impl.jsfile and verify that the
WL.Server.sendMessage()method uses the correct application name. The correct application name can be determined from the
application-descriptor.xml. Click to download the Studio project. Click to download the Native project. ▲
Last modified on November 09, 2016