<!--
{
  "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/GroupStateObserver",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Group Activities"
    ],
    "preciseIdentifier" : "s:15GroupActivities0A13StateObserverC"
  },
  "title" : "GroupStateObserver"
}
-->

# GroupStateObserver

An object that contains information about the system’s ability to start SharePlay experiences.

```
final class GroupStateObserver
```

## Overview

Starting a SharePlay experience with the Group Activities framework requires an active FaceTime
call. Use a `GroupStateObserver` object to determine whether it’s possible to start such
an experience. When no call is active, you might adjust your app’s user interface.
For example, you might hide or remove controls that start a shared activity.

To get the current system state, create a `GroupStateObserver` object and check the value
of its [`isEligibleForGroupSession`](/documentation/GroupActivities/GroupStateObserver/isEligibleForGroupSession) property. To respond right away when the value of the
property changes, configure a subscriber for that property.

## Topics

### Creating a group state observer

[`init()`](/documentation/GroupActivities/GroupStateObserver/init())

Creates a new group state observer object for determining the availability of group sessions.

### Determining the eligibility for shared activities

[`isEligibleForGroupSession`](/documentation/GroupActivities/GroupStateObserver/isEligibleForGroupSession)

A Boolean value that indicates whether the system can start a group 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)