Skip to content

Commit 75ef433

Browse files
authored
Move Cortana docs to UWP (#6065)
* Move Cortana docs to UWP * update links * add content-links * fix links
1 parent 40bd0ff commit 75ef433

29 files changed

Lines changed: 108 additions & 48 deletions

.openpublishing.redirection.json

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10319,6 +10319,46 @@
1031910319
"source_path": "hub/apps/design/input/drag-and-drop.md",
1032010320
"redirect_url": "/windows/apps/develop/data/drag-and-drop",
1032110321
"redirect_document_id": false
10322+
},
10323+
{
10324+
"source_path": "hub/apps/design/input/cortana-deep-link-into-your-app.md",
10325+
"redirect_url": "/windows/uwp/ui-input/cortana-deep-link-into-your-app",
10326+
"redirect_document_id": false
10327+
},
10328+
{
10329+
"source_path": "hub/apps/design/input/cortana-design-guidelines.md",
10330+
"redirect_url": "/windows/uwp/ui-input/cortana-design-guidelines",
10331+
"redirect_document_id": false
10332+
},
10333+
{
10334+
"source_path": "hub/apps/design/input/cortana-dynamically-modify-voice-command-definition-vcd-phrase-lists.md",
10335+
"redirect_url": "/windows/uwp/ui-input/cortana-dynamically-modify-voice-command-definition-vcd-phrase-lists",
10336+
"redirect_document_id": false
10337+
},
10338+
{
10339+
"source_path": "hub/apps/design/input/cortana-interactions.md",
10340+
"redirect_url": "/windows/uwp/ui-input/cortana-interactions",
10341+
"redirect_document_id": false
10342+
},
10343+
{
10344+
"source_path": "hub/apps/design/input/cortana-interact-with-a-background-app.md",
10345+
"redirect_url": "/windows/uwp/ui-input/cortana-interact-with-a-background-app",
10346+
"redirect_document_id": false
10347+
},
10348+
{
10349+
"source_path": "hub/apps/design/input/cortana-launch-a-background-app-with-voice-commands.md",
10350+
"redirect_url": "/windows/uwp/ui-input/cortana-launch-a-background-app-with-voice-commands",
10351+
"redirect_document_id": false
10352+
},
10353+
{
10354+
"source_path": "hub/apps/design/input/cortana-launch-a-foreground-app-with-voice-commands.md",
10355+
"redirect_url": "/windows/uwp/ui-input/cortana-launch-a-foreground-app-with-voice-commands",
10356+
"redirect_document_id": false
10357+
},
10358+
{
10359+
"source_path": "hub/apps/design/input/cortana-support-natural-language-voice-commands.md",
10360+
"redirect_url": "/windows/uwp/ui-input/cortana-support-natural-language-voice-commands",
10361+
"redirect_document_id": false
1032210362
}
1032310363
]
1032410364
}

uwp/develop/toc.yml

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
items:
12
- name: Overview
23
href: index.md
34
- name: App types
@@ -1294,4 +1295,23 @@
12941295
- name: Use AppWindow
12951296
href: ../ui-input/app-window.md
12961297
- name: Use ApplicationView
1297-
href: ../ui-input/application-view.md
1298+
href: ../ui-input/application-view.md
1299+
- name: Cortana
1300+
href: ../ui-input/cortana-interactions.md
1301+
items:
1302+
- name: Design guidelines
1303+
href: ../ui-input/cortana-design-guidelines.md
1304+
- name: Activate a foreground app
1305+
href: ../ui-input/cortana-launch-a-foreground-app-with-voice-commands.md
1306+
- name: Modify VCD phrase lists
1307+
href: ../ui-input/cortana-dynamically-modify-voice-command-definition-vcd-phrase-lists.md
1308+
- name: Launch a background app
1309+
href: ../ui-input/cortana-launch-a-background-app-with-voice-commands.md
1310+
- name: Interact with a background app
1311+
href: ../ui-input/cortana-interact-with-a-background-app.md
1312+
- name: Deep link from a background app
1313+
href: ../ui-input/cortana-deep-link-into-your-app.md
1314+
- name: Support natural-language voice commands
1315+
href: ../ui-input/cortana-support-natural-language-voice-commands.md
1316+
- name: Content links
1317+
href: ../ui-input/content-links.md
File renamed without changes.

hub/apps/design/input/cortana-design-guidelines.md renamed to uwp/ui-input/cortana-design-guidelines.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ You should localize the voice commands your app responds to and all TTS and GUI
111111

112112
You should avoid lengthy GUI strings. The **Cortana** canvas provides three lines for responses and will truncate strings longer than that.
113113

114-
For more info, see the [Globalization and localization section](../globalizing/guidelines-and-checklist-for-globalizing-your-app.md).
114+
For more info, see the [Globalization and localization section](/windows/apps/design/globalizing/guidelines-and-checklist-for-globalizing-your-app).
115115

116116
## Image resources and scaling
117117

@@ -121,7 +121,7 @@ For more detail on image resources for high contrast and scale factors, see [Gui
121121

122122
You name resources using qualifiers. Resource qualifiers are folder and filename modifiers that identify the context in which a particular version of a resource should be used.
123123

124-
The standard naming convention is "foldername/qualifiername-value\[\_qualifiername-value\]/filename.qualifiername-value\[\_qualifiername-value\].ext". For example: images/logo.scale-100\_contrast-white.png is simply referred to in code using the root folder and the filename: images/logo.png. See [Manage language and region](../globalizing/manage-language-and-region.md) and [How to name resources using qualifiers](/previous-versions/windows/apps/hh965324(v=win.10)).
124+
The standard naming convention is "foldername/qualifiername-value\[\_qualifiername-value\]/filename.qualifiername-value\[\_qualifiername-value\].ext". For example: images/logo.scale-100\_contrast-white.png is simply referred to in code using the root folder and the filename: images/logo.png. See [Manage language and region](/windows/apps/design/globalizing/manage-language-and-region) and [How to name resources using qualifiers](/previous-versions/windows/apps/hh965324(v=win.10)).
125125

126126
We recommend that you mark the default language on string resource files (such as "en-US\\resources.resw") and the default scale factor on images (such as "logo.scale-100.png"), even if you do not currently plan to provide localized or multiple resolution resources. However, at a minimum, we recommend that you provide assets for 100, 200, and 400 scale factors.
127127

hub/apps/design/input/cortana-dynamically-modify-voice-command-definition-vcd-phrase-lists.md renamed to uwp/ui-input/cortana-dynamically-modify-voice-command-definition-vcd-phrase-lists.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ For more info about **PhraseList** and other VCD elements, see the [**VCD elemen
4545
>
4646
> **User experience guidelines**
4747
>
48-
> See [Cortana design guidelines](cortana-design-guidelines.md) for info about how to integrate your app with **Cortana** and [Speech interactions](speech-interactions.md) for helpful tips on designing a useful and engaging speech-enabled app.
48+
> See [Cortana design guidelines](cortana-design-guidelines.md) for info about how to integrate your app with **Cortana** and [Speech interactions](/windows/apps/develop/input/speech-interactions) for helpful tips on designing a useful and engaging speech-enabled app.
4949
5050
## Identify the command and update the phrase list
5151

hub/apps/design/input/cortana-interact-with-a-background-app.md renamed to uwp/ui-input/cortana-interact-with-a-background-app.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ Cortana supports a complete turn-by-turn workflow with your app. This workflow i
4040
>
4141
> **User experience guidelines**
4242
>
43-
> See [Cortana design guidelines](cortana-design-guidelines.md) for info about how to integrate your app with **Cortana** and [Speech interactions](speech-interactions.md) for helpful tips on designing a useful and engaging speech-enabled app.
43+
> See [Cortana design guidelines](cortana-design-guidelines.md) for info about how to integrate your app with **Cortana** and [Speech interactions](/windows/apps/develop/input/speech-interactions) for helpful tips on designing a useful and engaging speech-enabled app.
4444
4545
Compose the feedback strings that are both displayed and spoken by **Cortana**.
4646

Lines changed: 40 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,41 @@
1-
---
2-
description: Extend the basic functionality of **Cortana** with voice commands that launch and execute a single action in a Windows application.
3-
title: Cortana interactions in Windows apps
4-
ms.assetid: 4C11A7CF-DA26-4CA1-A9B9-FE52670101F5
5-
label: Cortana
6-
template: detail.hbs
7-
keywords: Cortana, Cortana canvas, Cortana design, user interface, voice commands, VCD
8-
ms.date: 01/27/2021
9-
ms.topic: article
10-
ms.localizationpriority: medium
11-
---
12-
13-
# Cortana interactions in Windows apps
14-
15-
>[!WARNING]
16-
> This feature is no longer supported as of the Windows 10 May 2020 Update (version 2004, codename "20H1").
17-
18-
Extend the basic functionality of **Cortana** with voice commands that launch and execute a single action in a Windows application.
19-
20-
The target app can be launched in the foreground (the app takes focus and **Cortana** is dismissed) or activated in the background (**Cortana** retains focus but provides results from the app), depending on the complexity of the interaction. Generally, voice commands that require additional context or user input are best handled in a foreground app, while basic commands can be handled in **Cortana** through a background app.
21-
22-
By integrating the basic functionality of your app, and providing a central entry point for the user to accomplish most of the tasks without opening your app directly, **Cortana** becomes a liaison between your app and the user. Providing this shortcut to app functionality and reducing the need to switch apps, can save the user significant time and effort.
23-
24-
> [!NOTE]
25-
> A voice command is a single utterance with a specific intent, defined in a Voice Command Definition (VCD) file, directed at an installed app via **Cortana**.
26-
>
27-
> A VCD file defines one or more voice commands, each with a unique intent.
28-
>
29-
> Voice command definitions can vary in complexity. They can support anything from a single, constrained utterance to a collection of more flexible, natural language utterances, all denoting the same intent.
30-
31-
## Other speech and conversation components
32-
33-
### Speech, voice, and conversation in Windows 10
34-
35-
See [Speech, voice, and conversation in Windows 10](../../develop/speech.md) for information on how the various Windows development frameworks provide speech recognition, speech synthesis, and conversation support for developers building Windows applications.
36-
37-
## Related articles
38-
39-
- [VCD elements and attributes v1.2](/uwp/schemas/voicecommands/voice-command-elements-and-attributes-1-2)
40-
- [Cortana design guidelines](cortana-design-guidelines.md)
1+
---
2+
description: Extend the basic functionality of **Cortana** with voice commands that launch and execute a single action in a Windows application.
3+
title: Cortana interactions in Windows apps
4+
ms.assetid: 4C11A7CF-DA26-4CA1-A9B9-FE52670101F5
5+
label: Cortana
6+
template: detail.hbs
7+
keywords: Cortana, Cortana canvas, Cortana design, user interface, voice commands, VCD
8+
ms.date: 01/27/2021
9+
ms.topic: article
10+
ms.localizationpriority: medium
11+
---
12+
13+
# Cortana interactions in Windows apps
14+
15+
>[!WARNING]
16+
> This feature is no longer supported as of the Windows 10 May 2020 Update (version 2004, codename "20H1").
17+
18+
Extend the basic functionality of **Cortana** with voice commands that launch and execute a single action in a Windows application.
19+
20+
The target app can be launched in the foreground (the app takes focus and **Cortana** is dismissed) or activated in the background (**Cortana** retains focus but provides results from the app), depending on the complexity of the interaction. Generally, voice commands that require additional context or user input are best handled in a foreground app, while basic commands can be handled in **Cortana** through a background app.
21+
22+
By integrating the basic functionality of your app, and providing a central entry point for the user to accomplish most of the tasks without opening your app directly, **Cortana** becomes a liaison between your app and the user. Providing this shortcut to app functionality and reducing the need to switch apps, can save the user significant time and effort.
23+
24+
> [!NOTE]
25+
> A voice command is a single utterance with a specific intent, defined in a Voice Command Definition (VCD) file, directed at an installed app via **Cortana**.
26+
>
27+
> A VCD file defines one or more voice commands, each with a unique intent.
28+
>
29+
> Voice command definitions can vary in complexity. They can support anything from a single, constrained utterance to a collection of more flexible, natural language utterances, all denoting the same intent.
30+
31+
## Other speech and conversation components
32+
33+
### Speech, voice, and conversation in Windows 10
34+
35+
See [Speech interactions](/windows/apps/develop/input/speech-interactions) for information on how the various Windows development frameworks provide speech recognition, speech synthesis, and conversation support for developers building Windows applications.
36+
37+
## Related articles
38+
39+
- [VCD elements and attributes v1.2](/uwp/schemas/voicecommands/voice-command-elements-and-attributes-1-2)
40+
- [Cortana design guidelines](cortana-design-guidelines.md)
4141
- [Cortana voice command sample](https://go.microsoft.com/fwlink/p/?LinkID=619899)

hub/apps/design/input/cortana-launch-a-background-app-with-voice-commands.md renamed to uwp/ui-input/cortana-launch-a-background-app-with-voice-commands.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ The following basic steps add voice-command functionality and extend **Cortana**
6161
>
6262
> **User experience guidelines**
6363
>
64-
> See [Cortana design guidelines](cortana-design-guidelines.md) for info about how to integrate your app with **Cortana** and [Speech interactions](speech-interactions.md) for helpful tips on designing a useful and engaging speech-enabled app.
64+
> See [Cortana design guidelines](cortana-design-guidelines.md) for info about how to integrate your app with **Cortana** and [Speech interactions](/windows/apps/develop/input/speech-interactions) for helpful tips on designing a useful and engaging speech-enabled app.
6565
6666
## Create a New Solution with a Primary Project in Visual Studio
6767

hub/apps/design/input/cortana-launch-a-foreground-app-with-voice-commands.md renamed to uwp/ui-input/cortana-launch-a-foreground-app-with-voice-commands.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ These are the basic steps to add voice-command functionality and integrate Corta
5757
>
5858
> **User experience guidelines**
5959
>
60-
> See [Cortana design guidelines](cortana-design-guidelines.md) for info about how to integrate your app with **Cortana** and [Speech interactions](speech-interactions.md) for helpful tips on designing a useful and engaging speech-enabled app.
60+
> See [Cortana design guidelines](cortana-design-guidelines.md) for info about how to integrate your app with **Cortana** and [Speech interactions](/windows/apps/develop/input/speech-interactions) for helpful tips on designing a useful and engaging speech-enabled app.
6161
6262
## Create a new solution with project in Visual Studio
6363

hub/apps/design/input/cortana-support-natural-language-voice-commands.md renamed to uwp/ui-input/cortana-support-natural-language-voice-commands.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ You can set up your voice commands to support the app name as a:
4343
>
4444
> **User experience guidelines**
4545
>
46-
> See [Cortana design guidelines](cortana-design-guidelines.md) for info about how to integrate your app with **Cortana** and [Speech interactions](speech-interactions.md) for helpful tips on designing a useful and engaging speech-enabled app.
46+
> See [Cortana design guidelines](cortana-design-guidelines.md) for info about how to integrate your app with **Cortana** and [Speech interactions](/windows/apps/develop/input/speech-interactions) for helpful tips on designing a useful and engaging speech-enabled app.
4747
4848
## Specify an **AppName** element in the VCD
4949

0 commit comments

Comments
 (0)