---
title: playTrailer
framework: appintents
role: symbol
role_heading: Instance Property
platforms: [iOS 27.3+, iPadOS 27.3+, Mac Catalyst 27.3+, tvOS 27.3+, visionOS 27.3+]
path: appintents/appschema/videointent/playtrailer
---

# playTrailer

An intent schema that plays a trailer for a piece of supported video content.

## Declaration

```swift
var playTrailer: some AppSchemaIntent { get }
```

## Discussion

Discussion To make your app’s actions available to Apple Intelligence, conform your AppIntent to a schema that describes your action to the system. If your app’s functionality aligns with the video domain and one of your app’s actions matches the playTrailer schema, you can generate the properties and protocol conformance the schema requires for your intent implementation with the @AppIntent( .video.playTrailer) Swift macro. To make your app work with Siri, see Apple Intelligence and Siri AI. The following example shows an intent that conforms to the playTrailer schema: @AppIntent(schema: .video.playTrailer) struct PlayTrailerIntent {     /// Content to preview.     var content: <#TrailerContent#>

func perform() async throws -> some IntentResult {         <#code#>     } } Define a @UnionValue enumeration for the content parameter, as in the following example, by typing the first few characters of video_trailerContent in Xcode and selecting it from the code-completion suggestions. @UnionValue enum TrailerContent {     case movie(<#MovieEntity#>)     case tvShow(<#TVShowEntity#>)     case tvSeason(<#TVSeasonEntity#>) } tip: Keep the cases that your app supports and remove the rest. The schema supports the following system experiences: Siri Shortcuts For more information about the App Intents framework and the experiences it supports, see Getting started with the App Intents framework.

## See Also

### Actions

- [addToWatchList](appintents/appschema/videointent/addtowatchlist.md)
- [playContent](appintents/appschema/videointent/playcontent.md)
- [removeFromWatchList](appintents/appschema/videointent/removefromwatchlist.md)
- [AppSchema.VideoIntent](appintents/appschema/videointent.md)
