Class

INSetClimateSettingsInCarIntent

Changes the climate settings in a CarPlay-enabled vehicle.

Overview

Automotive venders can add support for this intent to an Intents extension that they ship with their automotive apps. When the user asks Siri to change a setting related to the vehicle’s climate control, Siri creates an INSetClimateSettingsInCarIntent object and delivers it to the app’s Intents extension. You use the intent to identify which setting the user wants to change.

This class contains properties for multiple types of climate settings, but a given instance of this class contains changes for only one system at a time. When resolving and confirming the parameters of this intent, use the properties that were specified to modify your vehicle’s settings. Assume no changes for other settings. If your vehicle does not support a particular setting, offer a reasonable fallback setting and ask the user for confirmation.

The object that handles this intent must adopt the INSetClimateSettingsInCarIntentHandling protocol. Use this intent object to identify which setting changed and to create an INSetClimateSettingsInCarIntentResponse object indicating the results of changing the climate settings.

For a list of other intents in the CarPlay domain, see INCarPlayDomainHandling.

Additional Intent Attributes

Table 1 lists additional attributes of this intent object.

Table 1

Set climate settings in car intent attributes

Attribute

Description

Supported by

Siri (in conjunction with CarPlay)

Always requires unlocked device

No

Example Phrases

There are many ways in which users can ask Siri to change the climate settings in a vehicle. 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 climate settings

Locale

Example 1

Example 2

en

Turn on the AC

Turn the fan to max

zh_CN

打开空调

空调调到最高

zh_HK

打開空調

空調較到最大

zh_TW

打開空調

空調調到最強

yue_CN

打开空调

空调较到最大

ar

شغل تكييف الهواء

أطفأ التحكم بالمناخ

da

tænd for klimaanlægget

Skru blæseren op på max

de

Klimaanlage einschalten

Schalte Klimaanlage ein

es

Prende el aire acondicionado

Pon el climatizador a 20 grados

fi

Laita ilmastointi päälle

Laita tuuletin täysille

fr

Allume le chauffage

Branche le chauffage

he

תרימי את הבקרת אקלים

it

Accendi l'aria condizionata

Metti la ventola al massimo

ja

エアコンをオンにして

ファンを最大にして

ko

에어콘 켜줘

팬을 최대로 틀어줘

ms

Hidupkan pendingin hawa

Setkan kipas ke posisi maksimum

nb

Skru på klimaanlegget

Skru viften opp til maks

nl

Zet de airconditioning aan

Zet de ventilator op het maximum

pt

Ligar o ar condicionado

Coloque o ventilador no máximo

ru

Включи кондиционер

Сделай обдув на максимум

sv

ändra klimatkontrollen till auto

byt klimat till automatiskt

th

เปิดแอร์

เปิดพัดลมระดับสูงสุด

tr

Klimayı aç

Fanı sonuna kadar aç

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

Getting the Climate Control Settings

var enableClimateControl: Bool?

A Boolean value indicating whether to turn on the climate control system.

var enableAutoMode: Bool?

A Boolean value indicating whether to enable automatic mode for the climate control system.

var airCirculationMode: INCarAirCirculationMode

The air circulation mode for the climate control system.

var temperature: Measurement<UnitTemperature>?

The specific temperature to set for the climate control system.

var climateZone: INCarSeat

The seat position whose climate settings are to be modified.

Getting the Fan Settings

var enableFan: Bool?

A Boolean value indicating whether to turn on the cabin fan system.

var fanSpeedIndex: Int?

An integer value indicating the desired fan speed position.

var fanSpeedPercentage: Double?

A floating-point value indicating the requested fan speed specified as a percentage of the maximum speed.

Getting the Air Conditioner Settings

var enableAirConditioner: Bool?

A Boolean value indicating whether to turn on the air conditioner system.

Relationships

Inherits From

Conforms To

See Also

Set Climate Settings in Car

protocol INSetClimateSettingsInCarIntentHandling

Handles the changing of a vehicle’s climate control settings.

class INSetClimateSettingsInCarIntentResponse

Contains your app’s response to a set climate settings in car intent.