<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 15.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "GroupActivities",
  "identifier" : "/documentation/GroupActivities/GroupSessionEvent",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Group Activities"
    ],
    "preciseIdentifier" : "s:15GroupActivities0A12SessionEventV"
  },
  "title" : "GroupSessionEvent"
}
-->

# GroupSessionEvent

A session-related event that appears in the system UI.

```
struct GroupSessionEvent
```

## Overview

Use this structure to specify the contents of custom activity-related
events. The AV Foundation framework posts media-related events
to the system on your app’s behalf; create an instance of this structure
if your app posts additional events that don’t route through AV Foundation.

After creating an instance of this structure, post it to the system using
the [`showNotice(_:)`](/documentation/GroupActivities/GroupSession/showNotice(_:)) method of [`GroupSession`](/documentation/GroupActivities/GroupSession).

## Topics

### Creating a group session event

[`init(originator: Participant, action: GroupSessionEvent.Action, url: URL?)`](/documentation/GroupActivities/GroupSessionEvent/init(originator:action:url:))

Creates a new event with the specified participant and action details.

### Getting the event details

[`let originator: Participant`](/documentation/GroupActivities/GroupSessionEvent/originator)

The participant that initiated the event.

[`let url: URL?`](/documentation/GroupActivities/GroupSessionEvent/url)

The URL to open when the participant taps the event link in the system UI.

[`let action: GroupSessionEvent.Action`](/documentation/GroupActivities/GroupSessionEvent/action-swift.property)

The reason for the event.

[`struct Action`](/documentation/GroupActivities/GroupSessionEvent/Action-swift.struct)

A playback-related change that occurs during the session.


---

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)