<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iOSAppExtension: -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "NowPlaying",
  "identifier" : "/documentation/NowPlaying/MediaSession/requestToBecomeSystemPrimary()",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Now Playing"
    ],
    "preciseIdentifier" : "s:10NowPlaying12MediaSessionC28requestToBecomeSystemPrimaryyyYaKF"
  },
  "title" : "requestToBecomeSystemPrimary()"
}
-->

# requestToBecomeSystemPrimary()

Requests to make this session the primary system media session.

```
@MainActor func requestToBecomeSystemPrimary() async throws
```

## Discussion

Use this method to request that the system display this session prominently
on the Lock Screen and in Control Center.

Your app’s primary session should match what your
app is prominently displaying to the user in your interface.

For example, if your app has two playing sessions and the
user has indicated they want to focus on one of those sessions,
call `requestToBecomeSystemPrimary` on that session.

> Note: For local playback, calling this method isn’t required unless
> your app needs to take over as the system primary from another session.

> Note: Calling this method doesn’t guarantee the system displays your session
> on the Lock Screen or in Control Center.

> Note: Your app must be in the foreground when calling this method,
> otherwise this request doesn’t take effect.

> Throws: ``doc://com.apple.nowplaying/documentation/NowPlaying/MediaSessionError/invalidState`` if the session can’t become application primary.
> ``doc://com.apple.nowplaying/documentation/NowPlaying/MediaSessionError/internalFailure`` if the system couldn’t promote 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)