<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "SiriKitCloudMedia",
  "identifier" : "/documentation/SiriKitCloudMedia/playMedia-1g2o9",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "SiriKit Cloud Media"
    ],
    "preciseIdentifier" : "rest:sirikit_media_api:post:intent-playMedia"
  },
  "title" : "Process a Play Media Intent"
}
-->

# Process a Play Media Intent

Interpret the user’s request to play a media item, and provide instructions to access a corresponding playback queue.

## Discussion

Processing a play media request requires a few steps:

- Resolve the intended media item.
- Resolve any playback customizations, such as repeat mode.
- Handle the intent.
- Provide a playback queue.

You can improve the overall response time to the user’s request by providing a response for resolving any playback customizations, and handling the intent alongside your response to the request to resolve the intended media item. This allows the client to skip subsequent requests when you can resolve each parameter successfully. If your service responds with a disambiguation, confirmation, or failure, the client disregards the pre-emptive responses, and sends the subsequent intent-processing requests.

## Topics

### Processing a Play Media Intent

[`object PlayMediaIntent`](/documentation/SiriKitCloudMedia/PlayMediaIntent)

An object that describes the user’s request to play a media item.

[`object PlayMediaIntentHandlingInvocation`](/documentation/SiriKitCloudMedia/PlayMediaIntentHandlingInvocation)

A request to process a play media intent.

[`* PlayMediaIntentHandlingInvocationResponse`](/documentation/SiriKitCloudMedia/PlayMediaIntentHandlingInvocationResponse)

The service’s response to a request to process a play media intent.

### Resolving a Media Item

[`object PlayMediaIntentHandlingResolveMediaItemsInvocationResponse`](/documentation/SiriKitCloudMedia/PlayMediaIntentHandlingResolveMediaItemsInvocationResponse)

Your service’s response to a request to resolve media items in a play media intent.

[`object PlayMediaMediaItemResolutionResult`](/documentation/SiriKitCloudMedia/PlayMediaMediaItemResolutionResult)

A media item that matches a play media intent, or information about why your service can’t provide a media item.

[`string PlayMediaMediaItemUnsupportedReason`](/documentation/SiriKitCloudMedia/PlayMediaMediaItemUnsupportedReason)

Reasons the media service can’t play the media item.

### Handling a Play Media Intent

[`object PlayMediaIntentHandlingHandleInvocationResponse`](/documentation/SiriKitCloudMedia/PlayMediaIntentHandlingHandleInvocationResponse)

Your service’s response to a request to handle a fully resolved play media intent.

[`object PlayMediaIntentResponse`](/documentation/SiriKitCloudMedia/PlayMediaIntentResponse)

A structure that contains a response code indicating how your service handles a play media intent.

[`string PlayMediaIntentResponseCode`](/documentation/SiriKitCloudMedia/PlayMediaIntentResponseCode)

Codes your service can return when handling a play media intent.

### Resolving the Intended Repeat Mode

[`object PlayMediaIntentHandlingResolvePlaybackRepeatModeInvocationResponse`](/documentation/SiriKitCloudMedia/PlayMediaIntentHandlingResolvePlaybackRepeatModeInvocationResponse)

Your service’s response to a request to resolve the repeat mode in a play media intent.

[`object PlayMediaIntentHandlingResolvePlaybackRepeatModeInvocationResponse.Result`](/documentation/SiriKitCloudMedia/PlayMediaIntentHandlingResolvePlaybackRepeatModeInvocationResponse/Result-data.dictionary)

The result of resolving the repeat mode for a play media intent.

[`object PlaybackRepeatModeResolutionResult`](/documentation/SiriKitCloudMedia/PlaybackRepeatModeResolutionResult)

Information about whether your service can identify the specified repeat mode.

[`string PlaybackRepeatMode`](/documentation/SiriKitCloudMedia/PlaybackRepeatMode)

The possible repeat modes for a media queue.

### Resolving the Intended Queue Location

[`object PlayMediaIntentHandlingResolvePlaybackQueueLocationInvocationResponse`](/documentation/SiriKitCloudMedia/PlayMediaIntentHandlingResolvePlaybackQueueLocationInvocationResponse)

Your service’s response to a request to resolve the queue location in a play media intent.

[`object PlaybackQueueLocationResolutionResult`](/documentation/SiriKitCloudMedia/PlaybackQueueLocationResolutionResult)

Information about whether your service can resolve the specified queue location.

[`string PlaybackQueueLocation`](/documentation/SiriKitCloudMedia/PlaybackQueueLocation)

Possible locations in a playback queue to insert a media item.

### Resuming Playback

[`object PlayMediaIntentHandlingResolveResumePlaybackInvocationResponse`](/documentation/SiriKitCloudMedia/PlayMediaIntentHandlingResolveResumePlaybackInvocationResponse)

Your service’s response to a request to resolve whether a play media intent resumes the current playback queue.

### Shuffling Playback

[`object PlayMediaIntentHandlingResolvePlayShuffledInvocationResponse`](/documentation/SiriKitCloudMedia/PlayMediaIntentHandlingResolvePlayShuffledInvocationResponse)

Your service’s response to a request to resolve whether a play media intent requests a shuffled queue.



---

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)