---
title: PlayMediaIntent
framework: SiriKit Cloud Media
role: symbol
role_heading: Object
platforms: [sirikit cloud media 1.0.2+]
path: sirikitcloudmedia/playmediaintent
---

# PlayMediaIntent

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

## Declaration

```data
object PlayMediaIntent
```

## Properties

class: The specific type of intent. mediaItems: Particular pieces of media, such as songs, albums, or playlists, to play. In a resolveMediaItems request, this value is generally empty. Your service responds with a PlayMediaIntentHandlingResolveMediaItemsInvocationResponse that contains an array of MediaItem results, with the most relevant one first. On subsequent requests to process this intent, this value contains that array. mediaSearch: Search parameters that describe the media items the user wants to play. playbackQueueLocation: The position within the queue to play the requested media items. playbackRepeatMode: A value that indicates whether to play one or all of the media items more than once. If your service supports repeat modes, repeat the content within the queue you provide. The client doesn’t replay queue segments. playbackSpeed: The rate for the media items to play, relative to normal speed. The default value of this property is 1.0. The user can request a different playback speed with several Siri utterances, such as “Play slower” or “Play double speed.” However, the client always plays content at the normal speed, as if this value is 1.0. playShuffled: A Boolean value that indicates whether to randomize the order of media items during playback. resumePlayback: A Boolean that indicates whether to continue paused content, or to start at the beginning of the requested media item.

## Relationships

### Inherits From

- [Intent](sirikitcloudmedia/intent.md)

## See Also

### Processing a Play Media Intent

- [PlayMediaIntentHandlingInvocation](sirikitcloudmedia/playmediaintenthandlinginvocation.md)
- [PlayMediaIntentHandlingInvocationResponse](sirikitcloudmedia/playmediaintenthandlinginvocationresponse.md)