Class

INStartPhotoPlaybackIntent

A request to search for photos and initiate a slideshow with the results.

Declaration

@interface INStartPhotoPlaybackIntent : INIntent

Overview

The system creates an INStartPhotoPlaybackIntent object when the user asks to start a slideshow of a set of photos. This intent object contains the parameters to use when searching for the photos, including the possible name of a photo album, the people in the photos, or the location of the photos. Use this intent object to perform the search and initiate the slideshow in your app. When performing the search, use only the parameters provided and ignore any that have no values.

To handle this intent, the handler object in your Intents extension must adopt the INStartPhotoPlaybackIntentHandling protocol. Your handler should confirm the request and create an INStartPhotoPlaybackIntentResponse object with the results of the search. After a successful search, Siri launches your app so that it can begin the slideshow.

For a list of other intents in the photos domain, see INPhotosDomainHandling.

Additional Intent Attributes

Table 1 lists additional attributes of this intent object.

Table 1

Start photo playback intent attributes

Attribute

Description

Supported by

Siri Intents

Always requires unlocked device

Yes

Example Phrases

Users can ask Siri to start a slideshow in a variety of ways. Table 2 provides a few sample phrases in different languages. You can use these phrases during testing to trigger your intents. This list is not exhaustive and Siri may recognize many other phrases.

Table 2

Siri phrases that trigger the starting of a slideshow

Locale

Example 1

Example 2

en

Start a slideshow in <appName>

zh_CN

<appName>搜索相册

自动播放<appName>上的照片

zh_HK

<appName>搵吓上個禮拜影嘅相

去微信搵吓上個禮拜影嘅相

zh_TW

用<appName>搜尋照片

用<appName>搜尋上星期的照片

yue_CN

去<appName>揾吓上个礼拜影嘅相

去微信揾吓上个礼拜影嘅相

ar

بدء عرض الشرائح في <appName>

da

Vis et diasshow med mit album sommer i Spanien i <appName>

Afspil slideshow med mine katter billeder via <appName>

de

Zeige eine Diashow mit <appName>

Starte eine Diavorführung mit <appName>

es

Inicia una presentación de diapositivas con <appName>

Pon una secuencia de diapositivas de mis fotos de <appName>

fi

Aloita kuvaesitys <appName>ssa

Aloita <appName> kuvaesitys

fr

Lance un diaporama avec <appName>

Démarre un diaporama sur <appName>

he

תתחיל מצגת של אלבום המועדפים שלי באמצעות <appName>

תתחיל מצגת באמצעות <appName>

it

Fai partire uno slideshow con <appName>

Inizia una presentazione di foto con <appName>

ja

<appName>でスライドショーを開始

<appName>のスライドショーを開始

ko

<appName>에서 슬라이드 쇼 시작해

<appName>에서 슬라이드 쇼 해

ms

Mulakan tayangan slaid album kucing saya dengan <appName>

Tayangkan slaid percutian dengan <appName>

nb

Start et slideshow med <appName>

Vis lysbildeserien i <appName>

nl

Start een diavoorstelling in<appName>

Speel een slideshow in <appName>

pt

Começar uma apresentação de slides no <appName>

Inicie uma apresentação de slides no <appName>

ru

Сделай результаты как слайдшоу в <appName>

Покажи как слайдшоу в <appName>

sv

starta ett bildspel av mina favoritalbum i <appName>

Visa ett bildspel i <appName>

th

เล่นสไลด์โชว์ใน <appName>

เล่นสไลด์โชว์บน <appName>

tr

<appName> kullanarak fovoriler albümümü slayt sunusu yap

Favoriler albümümü <appName> slayt sunusu yap

In Table 2, <appName> represents the name of the app whose Intents extension performs the search and initiates the slideshow. If your app uses custom photo album names, photo tags, or contact names, you can tell Siri about those names using the INVocabulary class.

Topics

Creating the Intent Object

Getting the People in the Photos

peopleInPhoto

The people in the photos.

peopleInPhotoOperator

The operator that defines how to search for people in the photos.

Getting the Search Terms

searchTerms

An array of terms to look for in the photos.

searchTermsOperator

The operator that defines how to incorporate the search terms when performing the search.

Getting the Search Attributes

dateCreated

The range of dates during which someone took the pictures.

locationCreated

The location where someone took the photos.

albumName

The name of the album that contains the photos.

includedAttributes

The attributes that must be present in the photos.

excludedAttributes

The attributes that must not be present in the photos.

Relationships

Inherits From

See Also

Start Photo Playback

INStartPhotoPlaybackIntentHandling

The handler interface for searching the user’s photos and the playback of the results.

INStartPhotoPlaybackIntentResponse

Your app’s response to a start photo playback intent.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software