이 항목은 아직 평가되지 않았습니다.- 이 항목 평가

Windows Phone 8의 음성 명령 요소 및 특성 참조

2013-12-05

적용 대상: Windows Phone 8 전용입니다.

다음 표에서는 음성 명령 정의 파일의 요소 및 특성에 대해 설명합니다.

요소

Description

VoiceCommands

음성 명령 매니페스트의 필수 루트 요소입니다. xmlns 특성 값은 http://schemas.microsoft.com/voicecommands/1.0이어야 합니다(대문자 없음). 각각 단일 언어의 음성 명령을 나타내는 CommandSet 요소 하나 이상을 포함합니다.

CommandSet

VoiceCommands 요소의 필수 자식 요소입니다. 필수 xml:lang 특성으로 지정된 단일 언어에서 앱이 허용하는 모든 음성 명령에 대한 컨테이너입니다. xml:lang 특성 값은 VoiceCommand 문서에서 고유해야 합니다. Name 특성은 선택 사항이며 임의 문자열일 수 있습니다. 그러나 CommandSet 요소의 PhraseList를 프로그래밍 방식으로 참조 및 업데이트하려면 Name 특성이 필요합니다. CommandSet 요소에는 다음 자식 요소가 포함됩니다. CommandPrefix(0 또는 1), Example(1만), Command(1 ~ 100) 및 PhraseList 요소(0 이상). 이러한 자식 요소는 나열된 순서대로 발생해야 합니다.

CommandPrefix

VoiceCommands 요소의 선택적 자식 요소입니다. 있는 경우 CommandSet 요소의 첫 번째 자식 요소여야 합니다. 음성 명령을 제공할 때 사용자가 말할 수 있는 앱의 사용자에게 친숙한 이름을 지정합니다. 이 요소는 이름이 길거나 발음하기 어려운 앱에 유용합니다.

Command

CommandSet 요소의 필수 자식 요소입니다. Name 특성을 사용합니다. 사용자가 음성으로 시작할 수 있는 앱 동작 및 사용자가 동작을 시작하기 위해 말할 수 있는 내용을 정의합니다. 각 Command 요소는 앱에서 특정 페이지와 연결됩니다. 다음 필수 자식 요소를 포함합니다. Example(1만), ListenFor(최대 10), Feedback(1만) 및 Navigate(1만). 이러한 자식 요소는 나열된 순서대로 발생해야 합니다.

예제

Command 요소의 필수 자식 요소이며 CommandSet 요소의 선택적 자식입니다. 사용자가 명령에 대해 말할 수 있는 내용의 이상적인 예제를 제공합니다.

다음 화면에는 CommandSet 요소의 자식인 텍스트 예제가 표시됩니다.

  • 이렇게 말 하세요 화면의 페이지에 있는 앱 이름 아래에서. 페이지에는 고급 음성 명령이 포함된 모든 앱이 나열됩니다.

  • 이렇게 말 하세요 화면의 열기 페이지에는 페이지에 연결된 앱 이름 + 텍스트 예제의 두 가지 추가 예제가 있습니다.

  • 일부 오류 화면에서.

  • 수신 화면에서.

  • 앱에 대한 명령을 나열하는 알고 계셨나요? 도움말 화면에서.

ListenFor

Command 요소의 필수 자식 요소입니다. 앱이 이 명령에 대해 인식하는 단어 또는 구를 포함합니다. 이 요소는 중괄호에 포함된 ListenFor 요소에 나타나는 PhraseList 요소의 Label 특성에 대한 참조를 포함하거나 참조일 수 있습니다(예: {myList}). Command 요소에는 최대 10개 ListenFor 요소가 포함될 수 있고 명령을 활성화하기 위해 요소의 콘텐츠가 인식될 수 있습니다.

선택 사항인 단어 주위에 괄호를 사용하세요. 즉, 단어는 말할 수 있지만 반드시 일치할 필요는 없습니다. 중괄호 쌍으로 별표 문자를 묶어서 와일드카드 기능을 설정할 수 있습니다(예: <ListenFor>Find {*}</ListenFor>). 이 예제에서는 사용자가 "Find"와 다른 단어나 구를 차례로 말하면 음성 명령이 일치하게 됩니다. 와일드카드 사용 ListenFor 요소에 대한 음성 명령이 일치할 경우 reco 키에는 "…" 문자열이 포함됩니다.

Feedback

Command 요소의 필수 자식 요소입니다. 명령이 인식될 때 사용자에게 표시되고 들리는 텍스트를 지정합니다. Feedback 요소에 PhraseList 요소에 대한 참조가 포함되면 포함하는 Commnad 요소의 모든 ListenFor 요소도 동일한 PhraseList를 참조해야 합니다.

Navigate

Command 요소의 필수 자식 요소입니다.

앱이 시작될 때 로드되어야 하는 페이지를 지정하는 선택적 Target 특성을 지정할 수 있습니다. Target 특성을 지정하면 사용자 지정 쿼리 매개 변수를 추가할 수도 있습니다. Target 특성을 지정하지 않으면 앱이 기본 페이지로 시작됩니다.

다음 XML 코드는 Target 특성 및 사용자 지정 쿼리 매개 변수를 사용하여 Navigate 요소를 설정하는 방법의 예제를 보여 줍니다.

<Navigate Target="Page2.xaml?myParam=someValue"/>

PhraseList

CommandSet 요소의 선택적 자식입니다. ListenFor 또는 Feedback 요소 내부에서 값이 중괄호로 묶이는 Label 특성을 필요로 하고 PhraseList를 참조하는 데 사용됩니다.

선택적으로 이 PhraseList 요소의 콘텐츠가 사용자 명확성을 생성하고 음성 명령을 참조하기 위해 인식을 쿼리 문자열 매개 변수로 내보낼지 여부를 제어하는 Disambiguate 특성(기본값 true)을 지정합니다.

각각 PhraseList를 참조하는 명령을 시작하기 위해 인식할 수 있는 단어 또는 구를 지정하는 최대 2,000개 항목 요소를 포함합니다. 2,000개 항목 요소 제한은 CommandSet의 모든 PhraseList 요소에서 결합된 합계입니다.

항목

PhraseList 요소의 선택적 자식입니다. 명령을 시작하기 위해 인식할 수 있는 여러 단어 또는 구 중 하나입니다. CommandSet에는 모든 자식 PhraseList 요소에서 2,000개 이하 항목 요소가 포함될 수 있습니다.

다음 특수 문자를 사용하여 명령을 정의할 수 있습니다.

중요중요:

아래 나열된 특수 문자는 중첩할 수 없습니다. 예를 들어 [[start] new game][{myPhraseList}] 같은 문은 사용할 수 없습니다.

특수 문자

Description

{}

참조할 PhraseList에 대한 Label 특성 값을 포함합니다(예: {myPhraseList}). ListenFor 또는 Feedback 요소 내에서 사용됩니다. Feedback 요소의 PhraseList 참조는 동일 명령에서 ListenFor 요소의 해당 참조와 일치해야 합니다.

[]

포함된 단어 또는 구가 선택 사항이 되도록 지정합니다. 포함된 단어 또는 구를 말할 수 있지만 명령을 시작하기 위해 반드시 인식할 필요는 없습니다. 예를 들어 ListenFor 요소의 콘텐츠가 "[start] [begin] new game"인 경우 사용자는 "start new game", "new game" 또는 "begin new game"(또는 "start begin new game" 포함)을 말하여 명령을 시작할 수 있습니다.

각 괄호로 묶인 요소는 개별적으로 선택 사항이지만 인식되는 정확한 순서대로 말해야 합니다. 따라서 'new game' 예제에서 'start begin new game'은 작동하지만 'begin start new game'은 선언된 순서 때문에 작동하지 않습니다.

표시:
© 2014 Microsoft. All rights reserved.