---
title: INSetAudioSourceInCarIntent
framework: intents
role: symbol
role_heading: Class
path: intents/insetaudiosourceincarintent
---

# INSetAudioSourceInCarIntent

A request to change the source of audio playback in a CarPlay-enabled vehicle.

## Declaration

```swift
class INSetAudioSourceInCarIntent
```

## Overview

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 the audio source of the vehicle, SiriKit creates an INSetAudioSourceInCarIntent object and delivers it to your app’s Intents extension. You use the intent to identify which audio source the user wants to use and to communicate the new audio source information directly to your vehicle’s systems. Users may select audio sources by name or by asking for the next or previous audio source that’s available. When the user asks for an audio source by name, Siri populates the audioSource property of this intent object with the specific requested source. When the user asks for the next or previous audio source, Siri places the appropriate value in the relativeAudioSourceReference property so that you can determine which audio source to select. Only one of these properties contains usable information; Siri sets the other to a constant indicating an unknown status for the value. The object that handles this intent must adopt the INSetAudioSourceInCarIntentHandling protocol. Use this intent object to resolve the audio source details and to create an INSetAudioSourceInCarIntentResponse object indicating the results of changing the audio source. Additional Intent Attributes The following table lists additional attributes of this intent object:  |   |   |  Example Phrases Users can ask Siri to change the audio source in a vehicle in a variety of ways. The table below provides a few sample phrases in different languages. You can use these phrases during testing to trigger your intents. This list isn’t exhaustive and Siri may recognize many other phrases.  |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |   |  |  When managing CarPlay features, users don’t 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(audioSource:relativeAudioSourceReference:)](intents/insetaudiosourceincarintent/init(audiosource:relativeaudiosourcereference:).md)

### Getting Details About the Audio Source to Set

- [audioSource](intents/insetaudiosourceincarintent/audiosource.md)
- [relativeAudioSourceReference](intents/insetaudiosourceincarintent/relativeaudiosourcereference.md)

## Relationships

### Inherits From

- [INIntent](intents/inintent.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [INIntentSetImageKeyPath](intents/inintentsetimagekeypath.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### CarPlay Audio Source

- [INSetAudioSourceInCarIntentHandling](intents/insetaudiosourceincarintenthandling.md)
- [INSetAudioSourceInCarIntentResponse](intents/insetaudiosourceincarintentresponse.md)