Share via


Windows.ApplicationModel.VoiceCommands Namespace

Provides support for handling voice commands in Cortana, entered by speech or text, to access features and functionality from a background app. When an app handles a voice command in the background it can display feedback on the Cortana canvas and communicate with the user using the Cortana voice.

A Voice Command Definition (VCD) file must be registered by the app to enable voice command access to its functionality. See Launch a background app with voice commands for more info on creating and registering a Voice Command Definition (VCD) file for your app.

Note

A voice command is a single utterance, defined in a Voice Command Definition (VCD) file, directed at an installed app through Cortana. The app can be launched in the foreground or background, depending on the level and complexity of the interaction. For instance, voice commands that require additional context or user input are best handled in the foreground, while basic commands can be handled in the background.

Classes

VoiceCommand

The command given to Cortana, using either speech or text, and routed to a background app.

The command must be declared in a Voice Command Definition (VCD) file registered by the app referred to in the command. See Launch a background app with voice commands for more info on creating and registering a Voice Command Definition (VCD) file for your app.

VoiceCommandCompletedEventArgs

Contains event data for the VoiceCommandCompleted event.

VoiceCommandConfirmationResult

The response to the question specified by the background app and shown on the Cortana confirmation screen. This screen is displayed when the background app service calls RequestConfirmationAsync.

VoiceCommandContentTile

An asset, containing image, text, and link data, provided by the background app service for display on the Cortana canvas.

VoiceCommandDefinition

Enables operations on a specific installed command set.

VoiceCommandDefinitionManager

A static class that enables registering and using command sets from a Voice Command Data (VCD) file.

VoiceCommandDisambiguationResult

The result obtained from the disambiguation screen displayed on the Cortana canvas.

Calling RequestDisambiguationAsync from the background app service causes Cortana to display the disambiguation screen.

VoiceCommandResponse

The response from a background app service for progress, confirmation, disambiguation, completion, or failure screens displayed on the Cortana canvas.

VoiceCommandServiceConnection

The background app service connection to Cortana.

Used to retrieve the voice command from Cortana and present messages that are spoken by Cortana and shown on the Cortana canvas.

VoiceCommandUserMessage

The message that is spoken by Cortana and shown on the Cortana canvas.

This message should be:

Enums

VoiceCommandCompletionReason

Specifies the possible reasons the voice command completed.

VoiceCommandContentTileType

The layout template used for content tiles on the Cortana canvas.

Specify the template with the ContentTileType property.

Note

All content tiles on a Cortana feedback screen must use the same template.

See also