Utility Methods API for AngularJS SDK

The methods on this page are utility methods that don't fit into other categories.

Close PubNub

End all open requests and close the PubNub instance.

Sample code

Close pubnub.

1Pubnub.stop();

Decrypt

This function allows to decrypt the data.

Method(s)

To decrypt the data you can use the following method(s) in AngularJS SDK.

1. 1decrypt(data: string, customCipherKey: ?string)

   * required

   Parameter	Description
   data * Type: String	The data to decrypt.
   customCipherKey Type: String	If it's not provided, the cipher key from config will be used.

Sample code

Decrypt part of message

1var decrypted = Pubnub.decrypt(encrypted, 'myCipherKey');

Returns

It returns the decrypted data as an object.

Encrypt

This function allows to encrypt the data.

Method(s)

To encrypt the data you can use the following method(s) in AngularJS SDK.

1. 1encrypt(data: string, customCipherKey: ?string)

   * required

   Parameter	Description
   data * Type: String	The data to encrypt.
   customCipherKey Type: String	If it's not provided, the cipher key from config will be used.

Sample code

Encrypt part of message

1var sCypher = "testCypher";
2var msgContent = "This is the data I wish to encrypt.";
3console.log('msgContent: ' + msgContent);
4

5// Encrypt with pubnub
6var encryptedMessage = Pubnub.encrypt(JSON.stringify(msgContent), sCypher);
7console.log('encryptedMessage PN: ' + encryptedMessage);

Returns

It returns the encrypted data as string.

Reconnect

Call the reconnect method to force the SDK to try and reach out PubNub.

Method(s)

To reconnect the data you can use the following method(s) in AngularJS SDK.

1. 1reconnect()

   This method doesn't take any arguments.

Sample code

1Pubnub.reconnect();

Time

This function will return a 17 digit precision Unix epoch.

The timetoken is constructed using the following algorithm:

1timetoken = (Unix epoch time in seconds) * 10000000

Example of creating a timetoken for a specific time and date

108/19/2013 @ 9:20pm in UTC = 1376961606
2timetoken = 1376961606 * 10000000
3timetoken = 13769616060000000

Method(s)

To fetch Time you can use the following method(s) in AngularJS SDK:

1. 1time(Function callback)

   * required

   Parameter	Description
   callback * Type: Function	Callback is called after a successful return.

Sample code

Get PubNub Timetoken

1// At the tone Pubnub time will be...
2Pubnub.time(function(status, response) {
3    if (status.error) {
4        // handle error if something went wrong based on the status object
5    } else {
6        console.log(response.timetoken);
7    }
8});

Response

1//Example of status
2{
3    error: false,
4    operation: 'PNTimeOperation',
5    statusCode: 200
6}
7

8//Example of response
9{
10    timetoken: 15031768233407550
11}

Push notification configuration

APNS2Configuration

APNS2 configuration type.

Method(s)

1. 1type APNS2Configuration = {  collapseId?: string,  expirationDate?: Date,  targets: Array<APNS2Target>}

   * required

   Parameter	Description
   collapseId Type: String	Notification group / collapse identifier. Value will be used in APNs POST request as apns-collapse-id header value.
   expirationDate Type: Date	Date till which APNs will try to deliver notification to target device. Value will be used in APNs POST request as apns-expiration header value.
   targets * Type: Array< APNS2Target >	List of topics which should receive this notification.

APNSNotificationPayload

APNSNotificationPayload instance provides access to options specific only to mobile push notifications sent with APNs.

Properties

1. Parameter	Description
   configurations Type: Array< APNS2NotificationConfiguration *> *	List of HTTP/2-based APNs delivery configurations.
   notification Type: Hash	Hash with parameters which specify user-visible key-value pairs.
   payload Type: Hash	Platform specific notification payload. In addition to data required to make notification visual presentation it can be used to pass additional information which should be sent to remote device.
   silent Type: Boolean	Whether operation system should handle notification layout by default or not. alert, sound and badge will be removed from resulting payload if set to true.

APNS2Target

APNS2 configuration target type.

Method(s)

1. 1type APNS2Target = {  topic: string,  environment?: 'development' | 'production',  excludedDevices?: Array<string>}

   * required

   Parameter	Description
   topic * Type: String Default: n/a	Notifications topic name (usually it is bundle identifier of applicationfor Apple platform). Required only if pushGateway set to apns2.
   environment Type: String Default: development	Environment within which registered devices to which notifications should be delivered. Available: development production
   excludedDevices * Type: Array Default: n/a	List of devices (their push tokens) to which this notification shouldn't be delivered.

FCMNotificationPayload

FCMNotificationPayload instance provides access to options specific only to mobile push notifications sent with FCM.

Properties

1. Parameter	Description
   notification Type: Hash	Hash with parameters which specify user-visible key-value pairs.
   data Type: Hash	Custom key-value object with additional information which will be passed to device along with displayable notification information. All object and scalar type value should be converted to strings before passing to this object. Keys shouldn't match: from, message_type or start with google or gcm. Also as key can't be used any word defined in this table
   silent Type: Boolean	Whether operation system should handle notification layout by default or not. notification key with it's content will be moved from root level under data key.
   icon Type: String	Icon which should be shown on the left from notification title instead of application icon.
   tag Type: String	Unique notification identifier which can be used to publish update notifications (they will previous notification with same tag).
   payload Type: Hash	Platform specific notification payload. In addition to data required to make notification visual presentation it can be used to pass additional information which should be sent to remote device.

NotificationsPayload

NotificationsPayload instance provides convenient method and properties which allow to setup notification for multiple platforms without getting into details how they should be formatted.
Builder instance contain additional set of properties which allow to fine tune payloads for particular platforms and even access to RAW payload dictionaries.

Method(s)

1. Parameter	Description
   subtitle Type: String	Additional information which may explain reason why this notification has been delivered.
   badge Type: Number	Number which should be shown in space designated by platform (for example atop of application icon).
   sound Type: String	Path to file with sound or name of system sound which should be played upon notification receive.
   debugging Type: Boolean	Whether PubNub service should provide debug information about devices which received created notifications payload.
   apns Type: APNSNotificationPayload	Access to APNs specific notification builder.
   fcm Type: FCMNotificationPayload	Access to FCM specific notification builder.

2. 1PubNub.notificationPayload(String title, String body)

   * required

   Parameter	Description
   title Type: String	Short text which should be shown at the top of notification instead of application name.
   body Type: String	Message which should be shown in notification body (under title line).

3. 1buildPayload(Array<String> platforms)

   * required

   Parameter	Description
   platforms * Type: Array	List of platforms for which payload should be added to final dictionary. Available: apns apns2 fcm

Sample code

Create notification payload builder with pre-defined notification title and body:

1. 1let builder = PubNub.notificationPayload('Chat invitation',
   2                                         'You have been invited to \'quiz\' chat');
   3let messagePayload = builder.buildPayload(['apns2', 'fcm']);
   4messagePayload.message = 'Max invited you to \'quiz\' chat room';
   5messagePayload.roomID = 'ewuiogw9vewg0';
   6
   
   7pubnub.publish(
   8    {
   9        message: messagePayload,
   10        channel: 'chat-bot',
   11    },
   12    function (status, response) {
   13        // Handle publish results
   14    }
   15);

2. 1let builder = PubNub.notificationPayload('Chat invitation',
   2                                         'You have been invited to \'quiz\' chat');

Response

Hash with data, which can be sent with publish method call and trigger remote notifications for specified platforms.

Other examples

1. Generate simple notification payload for FCM and APNs:

   1let builder = PubNub.notificationPayload('Chat invitation',
   2                                         'You have been invited to \'quiz\' chat');
   3builder.sound = 'default';
   4
   
   5console.log(JSON.stringify(builder.buildPayload(['apns', 'fcm']), null, 2));

   Output

   {
       "pn_apns": {
           "aps": {
               "alert": {
                   "body": "You have been invited to 'quiz' chat",
                   "title": "Chat invitation"
               },
               "sound": "default"
           }
       },
       "pn_fcm": {
           "notification": {
               "body": "You have been invited to 'quiz' chat",
               "title": "Chat invitation"
           },
           "android": {
               "notification": {
                   "sound": "default"
               }
           }
       }
   }

   show all 22 lines

2. Generate simple notification payload for FCM and HTTP/2-based APNs (default configuration):

   1let builder = PubNub.notificationPayload('Chat invitation',
   2                                         'You have been invited to \'quiz\' chat');
   3builder.apns.configurations = [{ targets: [{ topic: 'com.meetings.chat.app' }] }];
   4builder.sound = 'default';
   5
   
   6console.log(JSON.stringify(builder.buildPayload(['apns2', 'fcm']), null, 2));

   Output

   {
       "pn_apns": {
           "aps": {
               "alert": {
                   "body": "You have been invited to 'quiz' chat",
                   "title": "Chat invitation"
               },
               "sound": "default"
           },
           "pn_push": [
               {
                   "targets": [
                       {
                           "environment": "development",
                           "topic": "com.meetings.chat.app"
                       }
                   ],
                   "version": "v2"
               }
           ]
       },
       "pn_fcm": {
           "notification": {
               "body": "You have been invited to 'quiz' chat",
               "title": "Chat invitation"
           },
           "android": {
               "notification": {
                   "sound": "default"
               }
           }
       }
   }

   show all 33 lines

3. Generate simple notification payload for FCM and HTTP/2-based APNs (custom configuration):

   1let configuration = [
   2    {
   3        collapseId: 'invitations',
   4        expirationDate: new Date(Date.now() + 10000),
   5        targets: [{ topic: 'com.meetings.chat.app' }]
   6    }
   7];
   8let builder = PubNub.notificationPayload('Chat invitation',
   9                                         'You have been invited to \'quiz\' chat');
   10builder.apns.configurations = [configuration];
   11
   
   12console.log(JSON.stringify(builder.buildPayload(['apns2', 'fcm']), null, 2));

   Output

   {
       "pn_apns": {
           "aps": {
               "alert": {
                   "body": "Chat invitation",
                   "title": "You have been invited to 'quiz' chat"
               }
           },
           "pn_push": [
               {
                   "collapse_id": "invitations",
                   "expiration": "2019-11-28T22:06:09.163Z",
                   "targets": [
                       {
                           "environment": "development",
                           "topic": "com.meetings.chat.app"
                       }
                   ],
                   "version": "v2"
               }
           ]
       },
       "pn_fcm": {
           "notification": {
               "body": "You have been invited to 'quiz' chat",
               "title": "Chat invitation"
           }
       }
   }

   show all 29 lines

Example above show how to create notification payload which APNS will try to redeliver few times (if devices not active) and give up after 10 seconds since moment when it has been scheduled.

Additionally this invitation notification will be grouped along with other invitation notifications (using provided collapse_id as group identifier) and shown as one in notification center.

Returns

Configured and ready to use NotificationsPayload instance.