class Lorkhan::Notification
Describes a push notification
Required attributes
- token: The device token to deliver the notification to - apns_id: The APNS id for the notification. This *must* be a UUID and is created when the instance is initialized. - priority: The priority of the notification. Apple will use this to determine how to deliver the notification. See `PRIORITY_DELIVER_IMMEDIATELY` & `PRIORITY_DELIVER_BACKGROUND` for more info. - expiration: A UNIX UTC epoch expressed in seconds for how long Apple will retain the notification, and attempt redelivery. A 0 time will attempt a single delivery then disguard the message. - topic: The topic of the remote notification, which is typically the bundle ID for your app. The certificate you create in your developer account must include the capability for this topic.
Optional attributes
- alert: The message displayed to the user. - title: Title of the notification displayed to the user. - badge: The badge number displayed on the app icon. - category: The category for the notification. Used to provide direct notification actions. - collapse_id: Used to group multiple notifications on the screen. - content_available: A boolean if this should be a content available push. This will deliver a silent notification to the device. Your app's entitlements must be enabled. If the value for this is truthy, the alert, badge, sound will be ignored. - custom_payload: A custom hash of data to send. Must be JSON encodable. - mutable_content: A `1` if the notificaiton is mutable. See `UNNotificationServiceExtension` (https://developer.apple.com/reference/usernotifications/unnotificationserviceextension) - sound: The name of a bundled sound file to play. - url_args: Used in conjunction with the `urlFormatString` in the `website.json` file for sending web notifications.
Constants
- DEFAULT_SOUND_NAME
- PRIORITY_DELIVER_BACKGROUND
Send the push message at a time that takes into account power considerations for the device. Notifications with this priority might be grouped and delivered in bursts.
- PRIORITY_DELIVER_IMMEDIATELY
Send the push message immediately. Notifications with this priority must trigger an alert, sound, or badge on the target device.
Attributes
alert[R]
apns_id[R]
badge[RW]
category[RW]
collapse_id[RW]
content_available[R]
custom_payload[RW]
expiration[RW]
mutable_content[RW]
priority[R]
sound[RW]
title[RW]
token[R]
topic[R]
url_args[RW]
Public Class Methods
new(id, topic, token)
click to toggle source
Create a new notification
token: The Device token that the notification will be delivered to
# File lib/lorkhan/notification.rb, line 62 def initialize(id, topic, token) @id = id @token = token @topic = topic @apns_id = id || SecureRandom.uuid @expiration = 0 @content_available = false @priority = PRIORITY_DELIVER_IMMEDIATELY end
Public Instance Methods
alert=(alert)
click to toggle source
# File lib/lorkhan/notification.rb, line 82 def alert=(alert) @alert = alert @priority = PRIORITY_DELIVER_IMMEDIATELY if @alert end
body()
click to toggle source
# File lib/lorkhan/notification.rb, line 72 def body JSON.dump(to_h).force_encoding(Encoding::BINARY) end
content_available=(content_available)
click to toggle source
# File lib/lorkhan/notification.rb, line 87 def content_available=(content_available) @content_available = content_available @priority = PRIORITY_DELIVER_BACKGROUND if content_available == true end
push_type()
click to toggle source
# File lib/lorkhan/notification.rb, line 76 def push_type return 'background' if content_available == true && alert.nil? 'alert' end
to_h()
click to toggle source
# File lib/lorkhan/notification.rb, line 92 def to_h {}.tap do |root| root[:aps] = {}.tap do |aps| aps[:alert] = alert if alert aps[:title] = title if title aps[:badge] = badge if badge aps[:sound] = sound if sound aps[:category] = category if category aps['url-args'] = url_args if url_args aps['mutable-content'] = 1 if mutable_content aps['content-available'] = 1 if content_available end root.merge!(custom_payload) if custom_payload end end