<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "macOS: 14.0.0 -",
    "tvOS: 17.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 10.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Accessibility",
  "identifier" : "/documentation/Accessibility/AccessibilityNotification/Announcement",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Accessibility"
    ],
    "preciseIdentifier" : "s:13Accessibility0A12NotificationO12AnnouncementV"
  },
  "title" : "AccessibilityNotification.Announcement"
}
-->

# AccessibilityNotification.Announcement

A notification that an app posts when it needs to convey an announcement to an assistive
app.

```
struct Announcement
```

## Overview

Include an announcement value, such as <doc://com.apple.documentation/documentation/Swift/String>
or <doc://com.apple.documentation/documentation/Foundation/AttributedString>, for
an assistive app to announce.

Optionally, you can apply accessibility speech attributes to the announcement. For
example, you can set a priority to specify the announcement’s importance relative
to other announcements that are in the queue for an assistive app to speak. Announcement
priorities give you more control over which announcements people need to hear, and
which ones are acceptable to ignore or interrupt.

You specify an announcement priority using the <doc://com.apple.documentation/documentation/Foundation/AttributeScopes/AccessibilityAttributes/accessibilitySpeechAnnouncementPriority>
property. The following code shows an example of how to post an announcement notification
with a high priority, which interrupts other speech and isn’t interruptible after
it starts:

```swift
import SwiftUI

var body: some View {
    Button(action: {
        // Load the camera.
        openCamera()

        // Post an announcement to indicate the camera is done loading.
        var highPriorityAnnouncement = AttributedString("Camera active")
        highPriorityAnnouncement.accessibilitySpeechAnnouncementPriority = .high
        AccessibilityNotification.Announcement(highPriorityAnnouncement).post()
    }) {
        Image("Camera")
    }
}
```

## Topics

### Creating an announcement notification

[`init(_:)`](/documentation/Accessibility/AccessibilityNotification/Announcement/init(_:)-621va)

Creates an announcement notification with a string.

[`init(_:)`](/documentation/Accessibility/AccessibilityNotification/Announcement/init(_:)-46byj)

Creates an announcement notification with an attributed string value.

[`init(_:)`](/documentation/Accessibility/AccessibilityNotification/Announcement/init(_:)-btpf)

Creates an announcement notification with an attributed string object.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)