---
title: CPVoiceControlTemplate
framework: carplay
role: symbol
role_heading: Class
path: carplay/cpvoicecontroltemplate
---

# CPVoiceControlTemplate

A template that displays a voice control indicator during audio input.

## Declaration

```swift
@MainActor class CPVoiceControlTemplate
```

## Overview

Overview CarPlay navigation apps must show a voice control indicator during audio input by presenting a voice control template. When creating the template, provide one or more CPVoiceControlState objects. To switch between states, call the activateVoiceControlState(withIdentifier:) method.

## Topics

### Creating a Voice Control Template

- [init(voiceControlStates:)](carplay/cpvoicecontroltemplate/init(voicecontrolstates:).md)
- [CPVoiceControlState](carplay/cpvoicecontrolstate.md)

### Activating a State

- [activateVoiceControlState(withIdentifier:)](carplay/cpvoicecontroltemplate/activatevoicecontrolstate(withidentifier:).md)
- [activeStateIdentifier](carplay/cpvoicecontroltemplate/activestateidentifier.md)

### Getting Available States

- [voiceControlStates](carplay/cpvoicecontroltemplate/voicecontrolstates.md)

### Instance Properties

- [backButton](carplay/cpvoicecontroltemplate/backbutton.md)
- [leadingNavigationBarButtons](carplay/cpvoicecontroltemplate/leadingnavigationbarbuttons.md)
- [trailingNavigationBarButtons](carplay/cpvoicecontroltemplate/trailingnavigationbarbuttons.md)

## Relationships

### Inherits From

- [CPTemplate](carplay/cptemplate.md)

### Conforms To

- [CPBarButtonProviding](carplay/cpbarbuttonproviding.md)
- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Navigation

- [Integrating CarPlay with Your Navigation App](carplay/integrating-carplay-with-your-navigation-app.md)
- [CPTemplateApplicationDashboardScene](carplay/cptemplateapplicationdashboardscene.md)
- [CPTemplateApplicationDashboardSceneDelegate](carplay/cptemplateapplicationdashboardscenedelegate.md)
- [CPMapTemplate](carplay/cpmaptemplate.md)
- [CPSearchTemplate](carplay/cpsearchtemplate.md)