One Logo Pool Ball
AccessoryNotifications · IOS API REFERENCE

AlertingContext

struct · iOS 26.5+ · SDK 27.1

struct AlertingContext

Provides hints to the accessory about the preferred alerting behavior for newly-added notifications.

Members (7)

get · iOS 26.5+

shouldAlert

TypeScript
get shouldAlert(): boolean
Swift declaration
var shouldAlert: Bool { get }

Convenience property to determine the preferred alerting behavior based on the notification state and Focus state of the device. Accessories that do not wish to inspect individual properties on `AlertingContext` can use this property to get the preferred default alerting behavior.

get · iOS 26.5+

isSuppressedByFocus

TypeScript
get isSuppressedByFocus(): boolean
Swift declaration
var isSuppressedByFocus: Bool { get }

A flag to indicate whether a notification would be suppressed by a Focus mode on the phone.

init · iOS 26.5+

init

TypeScript
static init(notificationCanAlert?: boolean, suppressedByFocus?: boolean, kind?: AlertingContext_Kind, sound?: (AlertingContext_Sound) | null): AlertingContext
Swift declaration
init(notificationCanAlert: Bool = false, suppressedByFocus: Bool = false, kind: AlertingContext.Kind = .notification, sound: AlertingContext.Sound? = nil)
get · iOS 26.5+

notificationCanAlert

TypeScript
get notificationCanAlert(): boolean
Swift declaration
var notificationCanAlert: Bool

Flag to indicate whether a notification can alert. A notification is considered to alert when it is presented onscreen and plays sounds and/or haptics. Accessories should not alert if this flag is `false`. If this flag is `true`, an accessory may alert, but could also choose not to based on other factors specfic to the accessory. `notificationCanAlert` may be false for a newly-added notification if the notification has already alerted on another device, or if the user has configured the notification to not alert. > Note: This property is independent from whether a notification might be silenced due to the device being in a Focus mode.

set · iOS 26.5+

notificationCanAlert

TypeScript
set notificationCanAlert(value: boolean)
Swift declaration
var notificationCanAlert: Bool

Flag to indicate whether a notification can alert. A notification is considered to alert when it is presented onscreen and plays sounds and/or haptics. Accessories should not alert if this flag is `false`. If this flag is `true`, an accessory may alert, but could also choose not to based on other factors specfic to the accessory. `notificationCanAlert` may be false for a newly-added notification if the notification has already alerted on another device, or if the user has configured the notification to not alert. > Note: This property is independent from whether a notification might be silenced due to the device being in a Focus mode.

get · iOS 26.5+

kind

TypeScript
get kind(): AlertingContext_Kind
Swift declaration
var kind: AlertingContext.Kind { get }

The kind of notification this alerting context represents.

get · iOS 26.5+

sound

TypeScript
get sound(): (AlertingContext_Sound) | null
Swift declaration
var sound: AlertingContext.Sound? { get }

Indicates that this alert may play a sound. `nil` means there is no sound.

Skipped declarations

No declarations were skipped in this snapshot.

All AccessoryNotifications types →