# SceneAssociationBehavior A type that tells the system which scene to associate with an incoming group activity. ``` struct SceneAssociationBehavior ``` ## Overview Use a [`SceneAssociationBehavior`](/documentation/GroupActivities/SceneAssociationBehavior) type to match SharePlay activities to your app’s scenes. The static accessors of this type offer different scene-selection behaviors. For example, you can match each activity type to a specific scene, match scenes dynamically based on the contents of the activity, or prevent matching altogether. Select one of these behaviors and assign the related type to your [`GroupActivity`](/documentation/GroupActivities/GroupActivity) object’s metadata. On some platforms, the system adds a custom indicator to a scene to let people know that SharePlay is active. Add activation conditions to your SwiftUI or UIKit scenes to tell the system which activities they support. An activation condition is a custom string that identifies one of your app’s supported activities. You add these strings to your scenes to direct different types of external events to them. In SwiftUI, specify the activation conditions for a scene using the modifier. In the following example, the scene handles two app-related activities, including a group activity. ``` let activationConditions : Set = ["com.mycompany.MySharePlayActivity", "com.mycompany.MyUserActivity"] var body: some Scene { WindowGroup { ContentView() } .handlesExternalEvents(matching: activationConditions) ``` To handle the same activation condition in a UIKit app, add rules to the property of your object. Assign these rules in the method when you first configure your scene for use. Use the property when the scene is the preferred choice for handling the action. The following example shows how to configure a scene to handle two app-related activities, including a group activity. ``` let activationConditions = ["com.example.MySharePlayActivity", "com.example.MyUserActivity"] func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { // Specify the activities that this scene prefers to handle. scene.activationConditions.prefersToActivateForTargetContentIdentifierPredicate = NSPredicate(format: "self in %@", activationConditions) } ``` ## Topics ### Getting the scene-association options [`static let `default`: SceneAssociationBehavior`](/documentation/GroupActivities/SceneAssociationBehavior/default) A behavior that matches the activity to a scene using the identifier of your activity object. [`static func content(String) -> SceneAssociationBehavior`](/documentation/GroupActivities/SceneAssociationBehavior/content(_:)) A behavior that matches the activity to a scene using a custom string that you supply. [`static let none: SceneAssociationBehavior`](/documentation/GroupActivities/SceneAssociationBehavior/none) A behavior that doesn’t match any scenes to the activity. ## Relationships ### Conforms To [`SendableMetatype`](/documentation/Swift/SendableMetatype) [`Equatable`](/documentation/Swift/Equatable) [`Sendable`](/documentation/Swift/Sendable) --- Copyright © 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)