AppleApsNativeMessage interface

Represents a native APNs APS message.

Extends

Record<string, any>

Properties

alert

The information for displaying an alert.

badge

The number to display in a badge on your app’s icon.

category

The notification’s type.

content-available

The background notification flag. To perform a silent background update, specify the value 1 and don’t include the alert, badge, or sound keys in your payload.

content-state

The updated or final content for a Live Activity.

dismissal-date

The UNIX timestamp that represents the date at which the system ends a Live Activity and removes it from the Dynamic Island and the Lock Screen.

events

The string that describes whether you update or end an ongoing Live Activity with the remote push notification. To update the Live Activity, use update. To end the Live Activity, use end.

filter-criteria

The criteria the system evaluates to determine if it displays the notification in the current Focus.

interruption-level

The importance and delivery timing of a notification.

mutable-content

The notification service app extension flag. If the value is 1, the system passes the notification to your notification service app extension before delivery.

relevance-score

The relevance score, a number between 0 and 1, that the system uses to sort the notifications from your app. The highest score gets featured in the notification summary.

sound

The name of a sound file in your app’s main bundle or in the Library/Sounds folder of your app’s container directory. Specify the string “default” to play the system sound. Use this key for regular notifications. For critical alerts, use the sound dictionary instead.

stale-date

The UNIX timestamp that represents the date at which a Live Activity becomes stale, or out of date.

target-content-id

The identifier of the window brought forward.

thread-id

An app-specific identifier for grouping related notifications.

timestamp

The UNIX timestamp that marks the time when you send the remote notification that updates or ends a Live Activity.

Property Details

alert

The information for displaying an alert.

alert?: string | AppleAlert

Property Value

string | AppleAlert

badge

The number to display in a badge on your app’s icon.

badge?: number

Property Value

number

category

The notification’s type.

category?: string

Property Value

string

content-available

The background notification flag. To perform a silent background update, specify the value 1 and don’t include the alert, badge, or sound keys in your payload.

content-available?: number

Property Value

number

content-state

The updated or final content for a Live Activity.

content-state?: Record<string, any>

Property Value

Record<string, any>

dismissal-date

The UNIX timestamp that represents the date at which the system ends a Live Activity and removes it from the Dynamic Island and the Lock Screen.

dismissal-date?: number

Property Value

number

events

The string that describes whether you update or end an ongoing Live Activity with the remote push notification. To update the Live Activity, use update. To end the Live Activity, use end.

events?: string

Property Value

string

filter-criteria

The criteria the system evaluates to determine if it displays the notification in the current Focus.

filter-criteria?: string

Property Value

string

interruption-level

The importance and delivery timing of a notification.

interruption-level?: "passive" | "active" | "time-sensitive" | "critical"

Property Value

"passive" | "active" | "time-sensitive" | "critical"

mutable-content

The notification service app extension flag. If the value is 1, the system passes the notification to your notification service app extension before delivery.

mutable-content?: number

Property Value

number

relevance-score

The relevance score, a number between 0 and 1, that the system uses to sort the notifications from your app. The highest score gets featured in the notification summary.

relevance-score?: number

Property Value

number

sound

The name of a sound file in your app’s main bundle or in the Library/Sounds folder of your app’s container directory. Specify the string “default” to play the system sound. Use this key for regular notifications. For critical alerts, use the sound dictionary instead.

sound?: string | AppleCriticalSound

Property Value

stale-date

The UNIX timestamp that represents the date at which a Live Activity becomes stale, or out of date.

stale-date?: number

Property Value

number

target-content-id

The identifier of the window brought forward.

target-content-id?: string

Property Value

string

thread-id

An app-specific identifier for grouping related notifications.

thread-id?: string

Property Value

string

timestamp

The UNIX timestamp that marks the time when you send the remote notification that updates or ends a Live Activity.

timestamp?: number

Property Value

number