<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "SiriKitCloudMedia",
  "identifier" : "/documentation/SiriKitCloudMedia/Queue",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "SiriKit Cloud Media"
    ],
    "preciseIdentifier" : "data:sirikit_media_api:Queue"
  },
  "title" : "Queue"
}
-->

# Queue

A sequence of media content for playback, with links to the previous and next segments of a full playback queue.

```
object Queue
```

## Discussion

A `Queue` object is a segment of the full playback queue. You may instruct the client to insert a `Queue` object into its current playback queue, or replace it entirely.

The strings you provide in `nextContentUrl` and `previousContentUrl` may include tokens for the client to replace at runtime. Escape the brackets delimiting the tokens as `%7B` and `%7D`. The client URL encodes its replacement values. If the client doesn’t have a current value for a token, the client replaces the token with an empty string.

The client supports the following tokens:

- `{activity}`: The `persistentIdentifier` of the client’s current [`UserActivity`](/documentation/SiriKitCloudMedia/UserActivity).
- `{queue}`: The [`QueueIdentifier`](/documentation/SiriKitCloudMedia/QueueIdentifier) for the current queue.
- `{content}`: The [`ContentIdentifier`](/documentation/SiriKitCloudMedia/ContentIdentifier) for the current content.
- `{offset}`: The progress, in milliseconds, within the current content.
- `{firstContent}`: The [`ContentIdentifier`](/documentation/SiriKitCloudMedia/ContentIdentifier) for the first item in the current queue segment.
- `{lastContent}`: The [`ContentIdentifier`](/documentation/SiriKitCloudMedia/ContentIdentifier) for the last item in the current queue segment.
- `{transition}`: A [`QueueActivityReportEvent`](/documentation/SiriKitCloudMedia/QueueActivityReportEvent) that indicates how the client transitions to the current content.
- `{version}`: The version of the `SiriKitMediaAPI` library the client uses.

---

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)