<!--
{
  "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/GroupSession/requestForegroundPresentation()",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Group Activities"
    ],
    "preciseIdentifier" : "s:15GroupActivities0A7SessionC29requestForegroundPresentationyyF"
  },
  "title" : "requestForegroundPresentation()"
}
-->

# requestForegroundPresentation()

Tells the system that your app needs to be in the foreground to continue an activity.

```
final func requestForegroundPresentation()
```

## Discussion

Call this method if your app is in the background and can’t start the activity
without the participant’s assistance. For example, you might call the
method if your app requires the participant’s credentials to play back a
shared media file. Don’t call this method if you’re able to start the activity
without assistance. When you call this method, the system asks the participant
to continue the activity in your app.

To create a smoother user experience, the system might launch your app in
the background when starting an activity. Apps can start activities in
either the foreground or background, but you might configure your app
differently when in the background. For example, when in the background,
you play media files in a picture-in-picture window instead of a fullscreen
interface. This method lets you notify the user when a background solution
isn’t possible.

The session must be in the [`GroupSession.State.waiting`](/documentation/GroupActivities/GroupSession/State-swift.enum/waiting) or [`GroupSession.State.joined`](/documentation/GroupActivities/GroupSession/State-swift.enum/joined)
state when you call this method. If it isn’t, this method does nothing.

---

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)