voltmx.push Namespace

The voltmx.push namespace provides the following API elements.

Functions

The voltmx.push namespace contains the following functions.

voltmx.push.deRegister

This API allows an application on a device to deregister from Push Notifications. This API takes an empty object as the parameter.

If the deregistration is successful, the platform invokes the onsuccessfulderegistration function. If the deregistration is a failure, the platform invokes the onfailurederegistration function.

Syntax

voltmx.push.deRegister(emptyObject)

Input Parameters

Example

To deregister from Push Notifications, use the following code snippet:

/**
 * Name		:	deRegisterMyPush
 * Author	:	VoltMX
 * Purpose	:	This function helps to de-register from push notifications.
 **/
function deRegisterMyPush() {
    var myhash = new Hash();
    voltmx.push.deRegister(myhash);
}

Return Values

None

Exceptions

The following error codes are applicable to onfailureregistration and onfailurederegistration functions:

• 1402 - Unable to connect to push service - PNS service is not available
• 1403 - Registration failed by PNS - Account related or device restrictions (thrown by push.register() API during an onfailureregistration callback).
• 1404 - Deregistration failed - Unable to close channel or PNS internal error while deregistration (thrown by push.deregister() API during an onfailurederegistration callback).
• 1405 - Duplicate Registration - Actual registration details should be provided? (thrown by voltmx. push.register() API during an onfailureregistration callback)
• 1406 - Platform-specific issue. Full details are available in the errormessage. For example, received payload but payload is in incorrect format.
• An error is thrown if input type is invalid or does not follow the expected structure.
  • 102-Invalid input error

API Usage

You must use this API to deregister the application and the device from the Push Notifications service.

Platform Availability

• Android
• iOS
• Windows
• Desktop Web

voltmx.push.register

This API allows you to register the application and the mobile device for Push Notifications. This API takes an object as a parameter (the values in the table differ across platforms).

If the registration is successful, the platform invokes the onsuccessfulregistration function. If the registration is a failure, the platform invokes the onfailureregistration function.

Syntax

voltmx.push.register(configObject)(iOS/Android/Desktop Web/Windows)

Input Parameters

Example

The following are the examples of this API on various platforms:

Android

The following code snippet uses the senderid to register for Push Notifications:

/**
 * Name		:	registerMyAndroidPush
 * Author	:	VoltMX
 * Purpose	:	This function registers the senderID on the Google cloud.
 **/

function registerMyAndroidPush() {
    var config = {
        senderid: "4815162342"
    };
    voltmx.push.register(config);
}	

iOS

The following code snippet uses the notification types to register for Push Notifications:

/**
 * Name		:	registeriPhonePush
 * Author	:	VoltMX
 * Purpose	:	This function register the senderID on the Google cloud.
 **/
function registeriPhonePush() {
    var config = [0, 1, 2];
    voltmx.push.register(config);
}

Desktop Web

/**		
 * Name		:	registerDesktopWebPush
 * Author	:	VoltMX
 * Purpose	:	This function registers the senderID on the Google cloud.
 **/
function registerDesktopWebPush() {
    var configRegister = {
        messagingSenderId: "88888888888",
        publicKey: "BKf0xO2plAvCNtblOcgeTeyMleGcOnhetKe3Birx4aqhR-Wh3-D8Px7kPYa1YyMBIECg_tKz7droMbGNjFwyUMw"
    };
    voltmx.push.register(configRegister);
}

Windows

/**		
 * Name		:	registerWindowsPush
 * Author	:	VoltMX
 * Purpose	:	This function registers the senderID on the Google cloud.
 **/

function registerWindowsPush() {
    var config = {
        enableraw: true,
        enabletile: true,
        enabletoast: true,
    };
    voltmx.push.register(config);
}	

Note: Only network URLs are allowed. MPNS allows only images from trusted domains (registered to MPNS) to be displayed to avoid image policies. There is no such restriction on local images.

Exceptions

The following error codes are applicable to onfailureregistration and onfailurederegistration functions:

• 1402 - Unable to connect to push service - PNS service is not available
• 1403 - Registration failed by PNS - Account related or device restrictions (thrown by push.register() API during an onfailureregistration callback).
• 1405 - Duplicate Registration - Actual registration details should be provided? (thrown by voltmx. push.register() API during an onfailureregistration callback)
• 1406 - Platform-specific issue. Full details are available in the errormessage. For example, received payload but payload is in incorrect format.
• An error is thrown if input type is invalid or does not follow the expected structure.
  • 102-Invalid input error

API Usage

You must use this API to register the application and the device for Push Notifications with the Push Notifications service provider.

Platform Availability

• Android
• iOS
• Windows
• Desktop Web

voltmx.push.setCallbacks

When an application on a device registers or deregisters for Push Notifications, or if the device receives a notification, the device executes the function of your choice.
You can specify the functions to be executed for Push Notification in an object of the voltmx.push.setCallbacks API.

Syntax

voltmx.push.setCallbacks(Object)

Input Parameters

Object [Object] - Mandatory

A Hash table has the following key-value pairs:

Example

/**
 * Name		:	regSuccessAndroidCallback
 * Author	:	VoltMX
 * Purpose	:	This function is the callback for the successful registration of the device to the FCM server. It returns the callerID.
 **/

function regSuccessAndroidCallback(regId) {
    voltmx.print("** JavaScript regSuccessCallback() called **");
    voltmx.print(regId);
}

/**
 * Name		:	regFailureAndroidCallback
 * Author	:	VoltMX
 * Purpose	:	This function is the callback for the registration failure to the FCM server.
 **/

function regFailureAndroidCallback(errormsg) {
    voltmx.print("* JavaScript regFailureCallback() called *");
    voltmx.print(errormsg.failurereason);
voltmx.print(errormsg.description);
}
  
/**
 * Name		:	onlinePushNotificationAndroidCallback
 * Author	:	VoltMX
 * Purpose	:	This function is the callback for the registration failure to the FCM server.
 **/  
  
function onlinePushNotificationAndroidCallback(msg) {
    voltmx.print("* JavaScript onlinePushNotificationCallback() called *");
    voltmx.print(msg);
    voltmx.print(msg.message);
}

/**
 * Name		:	offlinePushNotificationAndroidCallback
 * Author	:	VoltMX
 * Purpose	:	This function is the callback for the received push msg event while offline.
 **/

function offlinePushNotificationAndroidCallback(msg) {
    voltmx.print("* JavaScript offlinePushNotificationCallback() called *");
    voltmx.print(msg);
}

/**
 * Name		:	unregSuccessAndroidCallback
 * Author	:	VoltMX
 * Purpose	:	This is the callback for the successful unregistration from the FCM server.
 **/

function unregSuccessAndroidCallback() {
    voltmx.print("* JavaScript unregSuccessCallback() called *");
}

/**
 * Name		:	unregFailureAndroidCallback
 * Author	:	VoltMX
 * Purpose	:	This is the callback for the unsuccessful deregistration from the FCM server.
 **/

function unregFailureAndroidCallback(errormsg) {
    voltmx.print("* JavaScript unregFailureCallback() called *");
    voltmx.print(errormsg.errorcode);
    voltmx.print(errormsg.errormessage);
}


/**
 * Name		:	callbackAndroidSetCallbacks
 * Author	:	VoltMX
 * Purpose	:	This function sets the callback for registration, deregistration, and pushnotification events.
 **/

function callbackAndroidSetCallbacks() {
    voltmx.push.setCallbacks({
        onsuccessfulregistration: regSuccessAndroidCallback,
        onfailureregistration: regFailureAndroidCallback,
        onlinenotification: onlinePushNotificationAndroidCallback,
        offlinenotification: offlinePushNotificationAndroidCallback,
        onsuccessfulderegistration: unregSuccessAndroidCallback,
        onfailurederegistration: unregFailureAndroidCallback
    });
}

Properties

The voltmx.push.setCallbacks API contains the following property:

defaultRemoteNotificationCallbackBehaviour

This property is used to trigger online and offline notification callbacks based on whether your application is in the background, foreground, or is in an unused (dead) state. The default value of this property is false, and it is available only for the iOS platform.

The following table illustrates when online and offline notification callbacks are triggered depending on the value of the defaultRemoteNotificationCallbackBehaviour property.

Return Values

None

Exceptions

The following error codes are applicable to onfailureregistration and onfailurederegistration functions:

• 1403 - Registration failed by PNS - Account related or device restrictions (thrown by push.register() API during an onfailureregistration callback).
• 1404 - Deregistration failed - Unable to close channel or PNS internal error while deregistration (thrown by push.deregister() API during an onfailurederegistration callback).

API Usage

You must call this API after the application is launched as this API will not be explicitly called by the user.

Implementation Details

The following are the implementation details of this API:

Based on the status of the registration or deregistration attempt (success or failure) and the state of the application on the device (active or inactive) when the Push Notifications arrive, use the following snippet to call the associated functions:

object = {
    onsuccessfulregistration: onsuccess,
    onfailureregistration: onfailure,
    onlinenotification: onlineCallback,
    offlinenotification: offineCallback,
    onsuccessfulderegistration: onderegsuccess,
    onfailurederegistration: onderegfailure
};
voltmx.push.setCallbacks(object);

onsuccessfulregistration

If the registration for Push Notifications is successful, this callback is executed by the underlying platform.

The callback takes string as the parameter.

The following code snippet is an example of the onsuccessfulregistration callback.

function onsuccess(identifier) {
    voltmx.print("Registered SUCCESSFULLY :" + identifier);
    //Send the identifier to the Push Notifications Sender.
}

Note: If there are spaces in the identifier (device token), you must replace the spaces with an empty string to successfully communicate with the APNS Server.

onfailureregistration

If the registration for Push Notifications is a failure, this callback is executed by the underlying platform.

The callback takes an Object as the parameter.

The following code snippet is an example of the onfailureregistration callback:

function onfailure(errortable) {
    voltmx.print("Registration Failed");

    voltmx.print(errortable.errorcode + errortable.errormessage);
}

onlinenotification

If the device receives a message when the application is running, this callback is executed by the underlying platform.

This callback can be used for silent push notifications, as described in the overview Silent Push Notifications. With silent push notifications, your app can perform operations in the background, such as downloading data from across the Internet, and not interrupt users by displaying notifications about the download.

The callback takes an Object as the parameter.

The following code snippet is an example of the onlinenotification callback:

function onlineNotification(payload) {
    /*payload is an Object that contains a set of key-value pairs provided by the respective Push Notification Server*/
}

offlinenotification

If the device receives a message when the application is not running, this callback is executed by the underlying platform.

The callback takes an Object as the parameter.

The following code snippet is an example of the offlinenotification callback:

function offlineNotification(payload) {
    /*payload is an Object that contains a set of key-value pairs provided by the respective Push Notification Server*/
}  

onsuccessfulderegistration

If the deregistration for Push Notifications is successful, this callback is executed by the underlying platform.

The callback takes string as the parameter.

The following code snippet is an example of the onsuccessfulderegistration callback:

function onderegsuccess() {
    voltmx.print("Deregistered Successfully :");
}  

onfailurederegistration

If the deregistration for Push Notifications is a failure, this callback is executed by the underlying platform.

The callback takes an Object as the parameter.

Note: This function is not applicable on iOS platform.

The following code snippet is an example of the onfailurederegistration callback:

function onderegfailure(errortable) {
    voltmx.print("Deregistration Failed");
    voltmx.ui.Alert("Message : " + errortable["errorcode"] + errortable["errormessage"], null, "info", null, , "Info");
}  

Callback

permissionStatusCallback

Specifies the permission status of the resource authorization.

Syntax

permissionStatusCallback(response)

Parameters

Registering the Callback in voltmx.push.setCallbacks API

VoltMX.push.setCallbacks({authorizationCallback:permissionStatusCallback, : : : : : : : : });

Example

function permissionStatusCallback(response) {
    if (response.status == voltmx.application.PERMISSION_GRANTED) {
        //PERMISSION_GRANTED Logic
    } else if (response.status == voltmx.application.PERMISSION_DENIED) {
        //User-defined PERMISSION_DENIED Logic
    }
}

Note: This callback is called when you invoke the voltmx.push.register(notificationtypes) API.

Platform Availability

• Android
• iOS
• Windows
• Desktop Web