Class

INSetRadioStationIntent

A request to change the current radio station.

Overview

When the user asks Siri to change the current radio station, SiriKit creates an INSetRadioStationIntent object and delivers it to the app’s Intents extension. You use the intent to identify which radio station the user wants. Automotive vendors can use this intent to change the settings on a vehicle’s built-in entertainment system.

This properties of this class support identifying a radio station in several different ways, but a given instance of this class contains does not populate all of those properties. When resolving and confirming the parameters of this intent, use the properties that are available to change the station.

The object that handles this intent must adopt the INSetRadioStationIntentHandling protocol. Use this intent object to identify which station was selected and to create an INSetRadioStationIntentResponse object indicating the results of changing the station.

For a list of intents in the radio domain, see INRadioDomainHandling.

Additional Intent Attributes

Table 1 lists additional attributes of this intent object.

Table 1

Set radio station intent attributes

Attribute

Description

Supported by

Siri

Always requires unlocked device

No

Example Phrases

There are many ways in which users can ask Siri to change the radio station. 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 changing of the radio station

Locale

Example 1

Example 2

en

Tune into 88.5 FM

Switch to FM radio preset 3

zh_CN

zh_HK

zh_TW

yue_CN

ar

da

Stil ind på 88,5 FM

Skift til FM Radio 3

de

Stelle Radio auf 88.5 FM

Wechsele zu Radiostation 3

es

Sintoniza 88.5 FM

Escuchar radio FM

fi

Viritä radio taajuudelle 88.5 MHz

Laita radio esivalinnalle 3

fr

Mets la radio sur 88.5 FM

Mets la radio sur 3

he

it

Sintonizza 88.5 FM

Metti la radio FM al preset tre

ja

88.5FMに合わせて

FMラジオのプリセット3をかけて

ko

ms

Dengarkan frekuensi 88.5 FM

Tukar ke pratetap radio 3

nb

Still inn 88,5 FM

Bytt til kanal 3

nl

Stem af op 88.5 FM

Verander naar FM radio voorkeuze 3

pt

Sintonizar na 88.5 FM

Trocar para rádio FM número 3

ru

Включи 88.5 FM

Включи радио на настройку 3

sv

Skruva in 88,5 FM

Ändra FM radion till kanal 3

th

เปลี่ยนเป็น FM 88.5

เปลี่ยนไปที่ช่องวิทยุเบอร์ 3

tr

88.5 FM'i aç

3 numarada kayıtlı radyoya geç

When managing CarPlay features, users do not need to include the name of the app in the phrases that they speak. Siri knows automatically when CarPlay is active and routes CarPlay-related intents to the app of the corresponding automotive vendor.

Topics

Initializing the Intent Object

init(radioType: INRadioType, frequency: Double?, stationName: String?, channel: String?, presetNumber: Int?)

Initializes the intent object with the specified climate settings information.

init(__radioType: INRadioType, frequency: NSNumber?, stationName: String?, channel: String?, presetNumber: NSNumber?)

Initializes the intent object with the specified climate settings information.

Getting Details About the Radio Station to Set

var radioType: INRadioType

The type of radio tuner to use.

var frequency: Double?

The broadcast frequency of the radio station.

var stationName: String?

The name associated with the radio station.

var channel: String?

The channel number of the station.

var presetNumber: Int?

The programmable preset assigned to the station.

Relationships

Inherits From

Conforms To

See Also

Set Radio Station

protocol INSetRadioStationIntentHandling

The handler interface for changing a radio station.

class INSetRadioStationIntentResponse

Your app’s response to a set radio station intent.