<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "GroupActivities",
  "identifier" : "/documentation/GroupActivities/GroupActivityAssociationKind/primary(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "Group Activities"
    ],
    "preciseIdentifier" : "s:15GroupActivities0A23ActivityAssociationKindV7primaryyACSSFZ"
  },
  "title" : "primary(_:)"
}
-->

# primary(_:)

A primary association with a SharePlay group activity that is identified by a given
string value.

```
static func primary(_ identifier: String) -> GroupActivityAssociationKind
```

## Discussion

When in an active SharePlay activity, the system will annotate the primary associated scene
scene as “shared” and use it as the common scene to arrange spatial Personas around.
This association between the group activity and a scene in your app creates a shared space
for spatial Personas to interact in.

> Important: The identifier provided must match the identifier used for the primary
> association across all participants in the group activity.

You should pick an identifier that reflects the content of this view.
For example: `"in-game"`, `"score-board"`, or `"solar-system-photo.png"`. Synchronizing
the identifier used across all participants in the activity allows FaceTime to synchronize
the position of the containing scene.

---

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)