AirshipBasePushProtocol

@objc(UAPushProtocol)
public protocol AirshipBasePushProtocol : Sendable

Airship Push protocol.

  • Checks to see if push notifications are opted in.

    Declaration

    Swift

    @objc
@MainActor
var isPushNotificationsOptedIn: Bool { get }

  • Enables/disables background remote notifications on this device through Airship. Defaults to true.

    Declaration

    Swift

    @objc
@MainActor
var backgroundPushNotificationsEnabled: Bool { get set }

  • Enables/disables user notifications on this device through Airship. Defaults to false. Once set to true, the user will be prompted for remote notifications.

    Declaration

    Swift

    @objc
var userPushNotificationsEnabled: Bool { get set }

  • When enabled, if the user has ephemeral notification authorization the SDK will prompt the user for notifications. Defaults to false.

    Declaration

    Swift

    @objc
var requestExplicitPermissionWhenEphemeral: Bool { get set }

  • The device token for this device, as a hex string.

    Declaration

    Swift

    @objc
var deviceToken: String? { get }

  • User Notification options this app will request from APNS.

    Defaults to alert, sound and badge.

    Declaration

    Swift

    @objc
var notificationOptions: UANotificationOptions { get set }

  • Custom notification categories. Airship default notification categories will be unaffected by this field.

    Changes to this value will not take effect until the next time the app registers with updateRegistration.

    Declaration

    Swift

    @objc
@MainActor
var customCategories: Set<UNNotificationCategory> { get set }

  • The combined set of notification categories from customCategories set by the app and the Airship provided categories.

    Declaration

    Swift

    @objc
@MainActor
var combinedCategories: Set<UNNotificationCategory> { get }

  • Sets authorization required for the default Airship categories. Only applies to background user notification actions.

    Declaration

    Swift

    @objc
@MainActor
var requireAuthorizationForDefaultCategories: Bool { get set }

  • Set a delegate that implements the PushNotificationDelegate protocol.

    Declaration

    Swift

    @objc
weak var pushNotificationDelegate: PushNotificationDelegate? { get set }

  • Set a delegate that implements the RegistrationDelegate protocol.

    Declaration

    Swift

    @objc
weak var registrationDelegate: RegistrationDelegate? { get set }

  • Notification response that launched the application.

    Declaration

    Swift

    @objc
var launchNotificationResponse: UNNotificationResponse? { get }

  • The current authorized notification settings. If push is disabled in privacy manager, this value could be out of date.

    Note: this value reflects all the notification settings currently enabled in the Settings app and does not take into account which options were originally requested.

    Declaration

    Swift

    @objc
var authorizedNotificationSettings: UAAuthorizedNotificationSettings { get }

  • The current authorization status. If push is disabled in privacy manager, this value could be out of date.

    Declaration

    Swift

    @objc
var authorizationStatus: UAAuthorizationStatus { get }

  • Indicates whether the user has been prompted for notifications or not. If push is disabled in privacy manager, this value will be out of date.

    Declaration

    Swift

    @objc
var userPromptedForNotifications: Bool { get }

  • The default presentation options to use for foreground notifications.

    Declaration

    Swift

    @objc
var defaultPresentationOptions: UNNotificationPresentationOptions { get set }

  • Enables user notifications on this device through Airship.

    Note

    The completion handler will return the success state of system push authorization as it is defined by the user’s response to the push authorization prompt. The completion handler success state does NOT represent the state of the userPushNotificationsEnabled flag, which will be invariably set to true after the completion of this call.

    Declaration

    Swift

    @objc
func enableUserPushNotifications() async -> Bool

    Parameters

    completionHandler

    The completion handler with success flag representing the system authorization state.

  • The current badge number used by the device and on the Airship server.

    Note

    This property must be accessed on the main thread and must be set asynchronously using setBadgeNumber.

    Declaration

    Swift

    @objc
@MainActor
var badgeNumber: Int { get }
  • setBadgeNumber(_:) Asynchronous

    The current badge number used by the device and on the Airship server.

    Declaration

    Swift

    @objc
func setBadgeNumber(_ newBadgeNumber: Int) async throws
  • resetBadge() Asynchronous

    Resets the badge to zero (0) on both the device and on Airships servers. This is a convenience method for setting the badgeNumber property to zero.

    Declaration

    Swift

    @objc
func resetBadge() async throws

  • Toggle the Airship auto-badge feature. Defaults to false If enabled, this will update the badge number stored by Airship every time the app is started or foregrounded.

    Declaration

    Swift

    @objc
var autobadgeEnabled: Bool { get set }

  • Time Zone for quiet time. If the time zone is not set, the current local time zone is returned.

    Declaration

    Swift

    @objc
var timeZone: NSTimeZone? { get set }

  • Enables/Disables quiet time

    Declaration

    Swift

    @objc
var quietTimeEnabled: Bool { get set }

  • Sets the quiet time start and end time. The start and end time does not change if the time zone changes. To set the time zone, see ‘timeZone’.

    Update the server after making changes to the quiet time with the updateRegistration call. Batching these calls improves API and client performance.

    Warning

    This method does not automatically enable quiet time and does not automatically update the server. Please refer to quietTimeEnabled and updateRegistration for more information.

    Declaration

    Swift

    @objc
func setQuietTimeStartHour(
    _ startHour: Int,
    startMinute: Int,
    endHour: Int,
    endMinute: Int
)

    Parameters

    startHour

    Quiet time start hour. Only 0-23 is valid.
    startMinute

    Quiet time start minute. Only 0-59 is valid.
    endHour

    Quiet time end hour. Only 0-23 is valid.
    endMinute

    Quiet time end minute. Only 0-59 is valid.