OneSignal

Improve this doc

$ ionic plugin add onesignal-cordova-plugin
$ npm install --save @ionic-native/onesignal

Repo: https://github.com/OneSignal/OneSignal-Cordova-SDK

The OneSignal plugin is an client implementation for using the OneSignal Service. OneSignal is a simple implementation for delivering push notifications.

Requires Cordova plugin: onesignal-cordova-plugin. For more info, please see the OneSignal Cordova Docs.

Supported platforms

• Android
• iOS
• Windows
• FireOS

Usage

import { OneSignal } from '@ionic-native/onesignal';

constructor(private oneSignal: OneSignal) { }

...

this.oneSignal.startInit('b2f7f966-d8cc-11e4-bed1-df8f05be55ba', '703322744261');

this.oneSignal.inFocusDisplaying(this.oneSignal.OSInFocusDisplayOption.InAppAlert);

this.oneSignal.handleNotificationReceived().subscribe(() => {
 // do something when notification is received
});

this.oneSignal.handleNotificationOpened().subscribe(() => {
  // do something when a notification is opened
});

this.oneSignal.endInit();

Instance Members

OSInFocusDisplayOption

constants to use in inFocusDisplaying()

startInit(appId, googleProjectNumber)

Start the initialization process. Once you are done configuring OneSignal, call the endInit function.

handleNotificationReceived()

Callback to run when a notification is received, whether it was displayed or not.

handleNotificationOpened()

Callback to run when a notification is tapped on from the notification shade (ANDROID) or notification center (iOS), or when closing an Alert notification shown in the app (if InAppAlert is enabled in inFocusDisplaying).

iOSSettings(settings)

iOS - Settings for iOS apps

endInit()

Must be called after startInit to complete initialization of OneSignal.

getTags()

Retrieve a list of tags that have been set on the user from the OneSignal server.

Quirk: You must wait for getTags to resolve before calling it again, as the plugin will only process the last method call and discard any previous ones.

getIds()

Lets you retrieve the OneSignal user id and device token. Your handler is called after the device is successfully registered with OneSignal.

sendTag(Key, Value)

Tag a user based on an app event of your choosing so later you can create segments on onesignal.com to target these users. Recommend using sendTags over sendTag if you need to set more than one tag on a user at a time.

sendTags(Pass)

Tag a user based on an app event of your choosing so later you can create segments on onesignal.com to target these users. Recommend using sendTags over sendTag if you need to set more than one tag on a user at a time.

deleteTag(Key)

Deletes a tag that was previously set on a user with sendTag or sendTags. Use deleteTags if you need to delete more than one.

deleteTags(Keys)

Deletes tags that were previously set on a user with sendTag or sendTags.

registerForPushNotifications()

Call this when you would like to prompt an iOS user to accept push notifications with the default system prompt. Only works if you set kOSSettingsAutoPrompt to false in iOSSettings

enableVibrate(false)

Warning: Only applies to Android and Amazon. You can call this from your UI from a button press for example to give your user’s options for your notifications.

By default OneSignal always vibrates the device when a notification is displayed unless the device is in a total silent mode. Passing false means that the device will only vibrate lightly when the device is in it’s vibrate only mode.

enableSound(false)

Warning: Only applies to Android and Amazon. You can call this from your UI from a button press for example to give your user’s options for your notifications.

By default OneSignal plays the system’s default notification sound when the device’s notification system volume is turned on. Passing false means that the device will only vibrate unless the device is set to a total silent mode.

inFocusDisplaying(displayOption)

Setting to control how OneSignal notifications will be shown when one is received while your app is in focus. By default this is set to inAppAlert, which can be helpful during development.

setSubscription(enable)

You can call this method with false to opt users out of receiving all notifications through OneSignal. You can pass true later to opt users back into notifications.

postNotification(Parameters)

promptLocation()

Prompts the user for location permission to allow geotagging based on the “Location radius” filter on the OneSignal dashboard.

syncHashedEmail(email)

setLogLevel(contains)

Enable logging to help debug if you run into an issue setting up OneSignal. The logging levels are as follows: 0 = None, 1= Fatal, 2 = Errors, 3 = Warnings, 4 = Info, 5 = Debug, 6 = Verbose

The higher the value the more information is shown.

OSNotification

OSLockScreenVisibility

OSDisplayType

OSNotificationPayload

OSActionButton

OSBackgroundImageLayout

OSNotificationOpenedResult

OSActionType