Cortana API: Reconhecimento de voz para apps universais (UWP)

Fique por dentro

O avanço tecnol�gico trouxe-nos diversas novidades, e uma delas s�o os assistentes digitais, que n�o s�o novidades, mas est�o a cada dia mais sofisticados.

Imagine poder acessar diversas funcionalidades de seu sistema operacional e at� mesmo controlar sua aplicaç�o Windows / Windows Phone atrav�s de comandos de voz? �No princ�pio havia a Cortana, e agora se tem a Cortana API�.

O que estamos dizendo � que em suas vers�es iniciais era poss�vel somente realizar algumas funç�es em dispositivos computacionais atrav�s do comando de voz, mas que agora � poss�vel utilizar todo esse poder em suas pr�prias aplicaç�es � pode-se inclusive estender o dicion�rio de palavras reconhecidas em tempo de execuç�o.

No artigo em quest�o ser� feita uma introduç�o ao desenvolvimento de um aplicativo para restaurantes com Windows Universal utilizando a Cortana API, no qual ser� poss�vel pedir para que o aplicativo mostre o card�pio. A partir desse modelo, qualquer outra aplicaç�o que utilize esses recursos poder� ser desenvolvida com muita facilidade.

A cada dia novas ideias para o desenvolvimento de softwares surgem baseadas em novas tecnologias, conceitos de desenvolvimento ou novos produtos ou serviços que apresentam grande potencialidade de aceitaç�o no mercado, ou at� mesmo que permitam a criaç�o de aplicaç�es que venham a oferecer novas facilidades aos usu�rios ou resolver problemas antes computacionalmente invi�veis. Em alguns casos (como o que ser� tratado neste artigo), o surgimento de uma nova tecnologia ou conceito torna poss�vel a criaç�o de aplicaç�es antes inimagin�veis, ou simplesmente nos permite acrescentar em uma aplicaç�o algum recurso capaz de torn�-la destaque em sua �rea, atraindo assim a atenç�o de um p�blico espec�fico.

Neste artigo ser� desenvolvida parte de uma aplicaç�o que simula um �atendente� virtual para restaurantes. O prop�sito � permitir que o cliente realize seus pedidos sem a necessidade de requisitar um garçom. Para que isso seja poss�vel, deve-se considerar que o restaurante disponibiliza em cada uma de suas mesas algum dispositivo com sistema operacional Windows Phone.

O que � Cortana?

A Cortana � um assistente pessoal digital que promete auxiliar os usu�rios de um sistema computacional a realizar diversas atividades. N�o se pode visualizar a Cortana como um simples assistente que permite a realizaç�o de atividades atrav�s do comando de voz, apesar de essa parecer ser sua principal finalidade. Usado corretamente, esse assistente pode ajudar seu utilizador a se manter sempre bem informado, permitindo-o realizar diversas atividades atrav�s de dispositivos e plataformas distintas.

Muito al�m do que serviços de lembrete, ou at� mesmo uma interface interativa de pesquisa, a Cortana fornece uma arquitetura que permite facilmente a incorporaç�o de outras atividades ou serviços, melhorando assim sua experi�ncia. Sem demagogias, trata-se de um recurso capaz de aprender com o usu�rio para melhor servi-lo.

Curso: Primeiros passos na Plataforma Universal do Windows

A Cortana permite que o usu�rio interaja com o computador por qualquer uma de suas interfaces. Caber� ao desenvolvedor, dependendo do contexto, determinar qual aç�o ser� desencadeada, ou seja, o usu�rio pode interagir via texto ou voz e o desenvolvedor decidir� como ir� tratar cada uma das interfaces de entrada. Al�m de pr�tico e f�cil de utilizar, a Cortana � compat�vel com qualquer vers�o do Windows 10 ou superior, al�m do Android.

Para o desenvolvedor, � poss�vel a integraç�o das funcionalidades da Cortana �s suas aplicaç�es, podendo essa interaç�o ocorrer atrav�s de solicitaç�es expl�citas ou at� mesmo com base no contexto do usu�rio (an�lise de seu comportamento).

Ao desenvolvedor, a Cortana oferece tamb�m suporte a uma s�rie de aç�es pr�-determinadas, sendo necess�rio somente fornecer � API uma ligaç�o capaz de indicar como sua aplicaç�o deve responder/completar a aç�o. O desenvolvedor pode, entretanto, a qualquer momento personalizar uma aç�o pr�-definida (se julgar necess�rio), buscando assim atender �s necessidades de sua aplicaç�o.

Iniciando o projeto

Inicialmente, � preciso criar um novo projeto Universal Windows. Para isso, siga as seguintes instruç�es:

Crie um novo projeto atrav�s do menu File > New > Project (esse projeto foi realizado no Visual Studio 2015);
Na tela que ser� aberta (veja Figura 1), selecione a opç�o Installed > Templates > C# > Windows > Universal > Blank App (Universal Windows).
Escolha um nome para o projeto (no caso deste artigo ComandoVozApp), um nome para a Solution (que repetir� o nome do projeto) e clique em OK.

Figura 1. Iniciando um novo projeto Universal Windows

Criando o arquivo VCD

Criado o projeto, deve-se ent�o criar o arquivo de definiç�o de vocabul�rio (Voice Command Definitions - VCD). Esse arquivo concentrar� as definiç�es de comandos de voz que ser�o recebidos e tratados pela aplicaç�o, bem como alguns que poder�o ser enviados como feedback para o usu�rio.

Guia: Guias para Programaç�o Mobile

O processo para criaç�o do arquivo � simples, basta navegar pelo Solution Explorer at� a pasta raiz do projeto e, nela, clicar com o bot�o direito do mouse. No menu que ser� apresentado escolha a opç�o Add > New Item... como pode ser observado na Figura 2.

Figura 2. Criando o arquivo VCD � Parte I

A tela da Figura 3 ser� apresentada. Nela, escolha a opç�o Installed > Visual C# > XML File e nomeie o arquivo como ComandosSuportados.xml.

Figura 3. Criando arquivo VCD � Parte II

Criado o arquivo, volte ao Solution Explorer, selecione o arquivo criado (ComandosSuportados.xml), clique com o bot�o direito do mouse sobre o mesmo e selecione a opç�o Properties. Nas propriedades do arquivo, marque a opç�o Build Action como Content, para que o arquivo n�o seja compilado junto da aplicaç�o, mas sim inserido aos arquivos que ser�o publicados com ela, e a opç�o Copy to output directory como Copy if newer (veja a Figura 4). Com essa �ltima opç�o, sempre que o documento for alterado, ele substituir� o documento j� existente.

Figura 4. Configurando as propriedades do arquivo VCD

Uma vez que as devidas configuraç�es referentes ao arquivo foram realizadas, deve-se ent�o edit�-lo permitindo que o mesmo tenha utilidade para o projeto em construç�o.

Editando o arquivo VCD

Antes de editar o arquivo, � importante entender um pouco sobre a sua estrutura. A Tabela 1 apresenta um resumo dos principais elementos.

Tabela 1. Principais elementos do arquivo VCD

Elemento		Descriç�o
VoiceCommands		Obrigat�rio. Este � o elemento raiz de um arquivo VCD. O valor desse atributo deve estar todo em min�sculo.
CommandSet		Obrigat�rio. Tem como elemento pai VoiceCommands. Define o idioma pelo atributo xml:lang, que ser� �nico para todo o documento. Obs.: Idiomas especificados, mas n�o suportados ser�o ignorados. Tem tamb�m o atributo Name, que � opcional, mas necess�rio para que se possa associar este com outros elementos.
Mutuamente exclusivos	CommandPrefix	Opcional. Se presente, deve ser o primeiro elemento filho do CommandSet. Define um nome amig�vel para o aplicativo que o usu�rio deseja ativar pelo comando de voz.
Mutuamente exclusivos	AppName	Opcional. Se presente deve ser o primeiro elemento do CommandSet. Substitui o elemento CommandPrefix. Define um nome amig�vel para o aplicativo que o usu�rio deseja ativar pelo comando de voz e fornece outras propriedades.
Command		Obrigat�rio. Possui um atributo Name que o identifica unicamente. Agrupa os elementos Example, que indica para o usu�rio o que ele deve dizer, ListenFor, que especifica o que se espera �ouvir�, podendo conter at� 10 itens, Feedback, elemento que envia mensagens para o usu�rio, e Navigate ou VoiceCommandService (um ou outro). Navigate: Especifica a p�gina para a qual o aplicativo deve navegar quando o comando for ativado. VoiceCommandService: Especifica que o comando de voz � feito atrav�s de um serviço de aplicativo.
PharseList		Opcional. Armazena um conjunto de comandos que n�o pode ultrapassar 2.000 itens. Cada item representa uma palavra ou frase que pode ser reconhecida para iniciar o comando referenciado pelo PharseList atrav�s do atributo Label. Os itens de um PharseList s�o agrupados/inseridos atrav�s do atributo Item.

Ao final deste artigo existe um link para os interessados em aprofundarem seu conhecimento na estrutura do arquivo VCD.

Ap�s editado, o arquivo ComandosSuportados.xml deve apresentar uma estrutura semelhante � da Listagem 1.

Listagem 1. Arquivo VCD com comandos suportados.


  1.  <?xml version="1.0" encoding="utf-8"?>
  2.  <VoiceCommands xmlns="http://schemas.microsoft.com/voicecommands/1.2">
  3.         <CommandSet xml:lang="pt-br" Name="commandSet_pt_br">
  4.                     <CommandPrefix> Garçom, </CommandPrefix>
  5.                     <Example> Apresente o card�pio </Example>
  6.                     <Command Name="apresentaMenu">
  7.                                 <Example> Apresente o card�pio </Example>
  8.                                 <ListenFor> [Por favor] apresente  </ListenFor>
  9.                                 <Feedback> Apresentando { opcao } </Feedback>
  10.                               <Navigate Target="PaginaCardapio.xaml"/>
  11.                   </Command>
  12.                   <PhraseList Label="opcao">
  13.                               <Item> card�pio</Item>
  14.                               <Item> o que tem</Item>
  15.                               <Item> menu </Item>
  16.                   </PhraseList>
  17.       </CommandSet>
  18. </VoiceCommands>

Na linha 1 � apresentado o cabeçalho padr�o de qualquer arquivo XML, na linha 2, um cabeçalho padr�o para o arquivo VCD, e por fim, na linha 3, indica-se que o arquivo est� configurado para linguagem portugu�s do Brasil e que o elemento ser� nomeado como commandSet_pt_br. O c�digo da linha 4 define o prefixo dos comandos, indicando ao aplicativo o que deve ser dito antes de qualquer comando (no caso dessa aplicaç�o sempre dever� ser dito �Garçom�). O elemento Example, na linha 5, indica qual texto deve ser apresentado ao usu�rio como exemplo para o que deve ser dito.

A linha 6 inicia o grupo Command, sendo que esse primeiro grupo tem sua propriedade Name configurada como apresentaMenu. Esse elemento ser� utilizado frequentemente nas classes que comp�em a aplicaç�o em desenvolvimento. Dentro do elemento Command� pode-se encontrar um elemento Example (linha 7), que tem a mesma funcionalidade do elemento Example utilizado na linha 5. Na linha 8, o elemento ListenFor indica o que se espera de entrada. Note que esse elemento tem um texto entre colchetes � todo texto entre colchetes � opcional, ou seja, indica algo que pode ou n�o ser dito pelo usu�rio. Ainda nessa linha encontra-se um texto entre chaves. Por ter sido utilizado o PharseList nesse exemplo, o texto contido dentro das chaves indica quais palavras substituem o termo �� constante no arquivo. Assim, se a palavra dita pelo usu�rio estiver entre algumas das palavras indicadas pelas TAGs <item> filhas do item PharseList, o sistema ser� capaz de realizar a operaç�o adequada.

Na linha 9, cria-se o elemento que recebe o texto que ser� apresentado ao usu�rio (feedback) caso o comando seja reconhecido, indicando o que est� sendo realizado no momento. Na linha 10, o elemento Navigate (que � opcional) atua como um roteador, redirecionando o usu�rio para uma p�gina espec�fica caso o comando seja entendido corretamente. A p�gina para onde o usu�rio ser� redirecionado deve ser inserida na propriedade Target do elemento. Como dito o campo � opcional, podendo, ent�o, esse processo ser realizado dentro das classes que controlam o aplicativo. Na linha 11, fecha-se o elemento Command.

Na linha 12, inicia-se o elemento PharseList que referencia a opç�o. Entre as linhas 13 e 15 est�o as palavras que ser�o referenciadas pela express�o {opç�o}. O elemento PharseList � encerrado na linha 16. Assim como o elemento Command, caso o desenvolvedor tenha mais de um Command e queira associar novos PharseList a esses Commands, basta inseri-los no arquivo, repetindo o que j� se observa no arquivo apresentado.

Na linha 17, encerra-se o elemento CommandSet e na linha 18, o elemento VoiceCommands.

Controlando estados com a classe SuspensionManager

Antes de apresentar as alteraç�es que iremos realizar na classe App.xaml.cs, precisamos criar as classes que dar�o suporte ao funcionamento do sistema. Uma dessas classes � a SuspensionManager, que foi criada com base em alguns projetos semelhantes observados na base de projetos da Microsoft. Assim sendo, o c�digo pode parecer � primeira vista um pouco complexo, mas pode tamb�m ser considerado como uma classe padr�o aplic�vel a qualquer projeto de prop�sito semelhante sem necessidade de alteraç�es. O prop�sito dessa classe � captar o estado global da sess�o do aplicativo, permitindo assim um melhor gerenciamento do tempo de vida de cada processo (n�o se trata de algo obrigat�rio, mas sim recomend�vel). Em uma aplicaç�o o estado de cada sess�o � automaticamente apagado sob uma variedade de condiç�es, devendo ser armazenadas somente informaç�es realmente convenientes, e para evitar a perda da sess�o foi criada a classe SuspensionManager.

Antes de criar essa classe, crie uma nova pasta no projeto denominada Common. Criada a pasta, crie a nova classe que receber� os c�digos apresentado nas Listagens 2 a 5.

Listagem 2. Classe SuspensionManager.cs � Parte I


  1.    using System;
  2.    using System.Collections.Generic;
  3.    using System.IO;
  4.    using System.Linq;
  5.    using System.Runtime.Serialization;
  6.    using System.Text;
  7.    using System.Threading.Tasks;
  8.    using Windows.ApplicationModel;
  9.    using Windows.Storage;
  10.  using Windows.Storage.Streams;
  11.  using Windows.UI.Xaml;
  12.  using Windows.UI.Xaml.Controls;
  13.  namespace ComandoVozApp.Common {
  14.      internal sealed class SuspensionManager {
  15.          private static Dictionary<string, object> _sessionState = new Dictionary<string, object>();
  16.   
  17.          private static List<Type> _knownTypes = new List<Type>();
  18.          private const string sessionStateFilename = "_sessionState.xml";
  19.   
  20.          public static Dictionary<string, object> SessionState{
  21.              get { return _sessionState; }
  22.          }
  23.   
  24.          public static List<Type> KnownTypes{
  25.              get { return _knownTypes; }
  26.          }
  27.   
  28.          public static async Task SaveAsync(){
  29.              try {
  30.                  foreach (var weakFrameReference in _registeredFrames) {
  31.                      Frame frame;
  32.                      if (weakFrameReference.TryGetTarget(out frame)) {
  33.                          SaveFrameNavigationState(frame);
  34.                      }
  35.                   }
  36.   
  37.                   MemoryStream sessionData = new MemoryStream();
  38.                   DataContractSerializer serializer = new DataContractSerializer(typeof(Dictionary<string, object>), _knownTypes);
  39.   
  40.                   serializer.WriteObject(sessionData, _sessionState);
  41.                   StorageFile file = await ApplicationData.Current.LocalFolder.Create
  42.                   FileAsync(sessionStateFilename,             CreationCollisionOption.ReplaceExisting);
  43.   
  44.                   using (Stream fileStream = await file.OpenStreamForWriteAsync()) {
  45.                       sessionData.Seek(0, SeekOrigin.Begin);
  46.                       await sessionData.CopyToAsync(fileStream);
  47.                   }
  48.             }
  49.            catch (Exception e) {
  50.                throw new SuspensionManagerException(e);
  51.            }
  52.         }

Entre as linhas 1 e 12, s�o realizadas importaç�es normais do sistema, a maioria inserida automaticamente pela IDE, exceto a biblioteca constante na linha 7. A inserç�o da biblioteca System.Threading.Tasks na linha 7 � necess�ria para que se possa trabalhar com os comandos async e await, comandos esses que ser�o explicados posteriormente. Pode-se observar na linha 14 o comando para criaç�o de uma classe interna selada (internal sealed), isso significa que a classe somente ser� acess�vel por qualquer c�digo do mesmo assembly e que a mesma n�o pode ser herdada por outras classes.

Cria-se na linha 15 um objeto _sessionState para armazenar o estado das seç�es. Tal objeto implementa a interface Dictionary, que permite criar coleç�es, no caso do objeto em quest�o, coleç�es de strings e objetos. Na linha 17 criamos um objeto _knownTypes que implementa a interface List, criando assim uma lista gen�rica, e na linha 18 definimos uma constante que indica o nome do arquivo, _sessionState.xml, que armazena os estados das seç�es do aplicativo.

Na linha 20 observa-se o m�todo para recuperaç�o do _sessionState, e na linha 24, da lista de tipos, procedimentos simples que dispensam maiores coment�rios.

Na linha 28 � definido o m�todo que armazena o estado atual da aplicaç�o; na linha 30 � realizado um laço por todos os frames (p�ginas) registrados no sistema; na linha 32, se for poss�vel recuperar a origem/caminho do frame, invoca-se o m�todo SaveFrameNavigationState, linha 33.

Continuando com a classe, tem-se na Listagem 3 mais de sua implementaç�o.

Listagem 3. Classe SuspensionManager.cs � Parte II


  53.      public static async Task RestoreAsync() {
  54.          _sessionState = new Dictionary<String, Object>();
  55.          try{
  56.              StorageFile file = await ApplicationData.Current.LocalFolder.GetFileAsync    
  57.              (sessionStateFilename);
  58.              using (IInputStream inStream = await file.OpenSequentialReadAsync()) {
  59.                  DataContractSerializer serializer = new DataContractSerializer(typeof(Dictionary<string, object>), _knownTypes);
  60.   
  61.                  _sessionState = (Dictionary<string, object>)serializer.ReadObject(  inStream.AsStreamForRead());
  62.   
  63.              }
  64.              foreach (var weakFrameReference in _registeredFrames) {
  65.                      Frame frame;
  66.                      if (weakFrameReference.TryGetTarget(out frame)) {
  67.                          frame.ClearValue(FrameSessionStateProperty);
  68.                          RestoreFrameNavigationState(frame);
  69.                      }
  70.                  }
  71.              }
  72.          catch (Exception e){
  73.              throw new SuspensionManagerException(e);
  74.          }
  75.      }

Na linha 53 inicia-se o m�todo que recupera o estado da sess�o do aplicativo. Assim como na listagem anterior, esse m�todo n�o ser� comentado linha a linha, mas sim seu prop�sito geral. Entre as linhas 55 e 63 s�o criados os objetos e vari�veis necess�rios para o funcionamento do m�todo. Na linha 64, percorre-se os frames da aplicaç�o � a cada frame que for acessado, seus dados de sess�o ser�o restaurados. Isso se faz necess�rio pois uma vez que a p�gina (frame) � enviada para segundo plano ela perde informaç�es sobre a sess�o. Com o m�todo em quest�o, essas informaç�es, que foram guardadas atrav�s do m�todo SaveFrameNavigationState apresentado na Listagem 2, podem ser recuperadas e podem mudar de acordo com a navegaç�o feita pelo usu�rio. Continuando na linha 67 executa-se o m�todo frame.ClearValue(FrameSessionStateProperty), atrav�s do qual o estado do frame � apagado para que na linha 68, atrav�s do m�todo RestoreFrameNavigationState, que ser� explicado adiante, a p�gina possa possuir o estado que estava antes de ser enviada para segundo plano.

Listagem 4. Classe SuspensionManager.cs � Parte III


  76.      private static DependencyProperty FrameSessionStateKeyProperty = Dependency    
  77.      Property.RegisterAttached("_FrameSessionStateKey",typeof(String),
  78.      typeof(SuspensionManager), null);
  79.      private static DependencyProperty FrameSessionStateProperty =Dependency 
  80.      Property.RegisterAttached("_FrameSessionState",typeof(Dictionary<String,
  81.      Object>), typeof(SuspensionManager), null);
  82.      private static List<WeakReference<Frame>> _registeredFrames = new     List<     
  83.      WeakReference<Frame>>();
  84.   
  85.      public static void RegisterFrame(Frame frame, String sessionStateKey) {
  86.          if (frame.GetValue(FrameSessionStateKeyProperty) != null) {
  87.              throw new InvalidOperationException("Frames can only be registered to one
  88.              session state key");
  89.          }
  90.          if (frame.GetValue(FrameSessionStateProperty) != null) {
  91.              throw new InvalidOperationException("Frames must be either be registered
  92.              before accessing frame session state, or not registered at all");
  93.          }
  94.          frame.SetValue(FrameSessionStateKeyProperty, sessionStateKey);
  95.          _registeredFrames.Add(new WeakReference<Frame>(frame));
  96.          RestoreFrameNavigationState(frame);
  97.      }
  98.      public static void UnregisterFrame(Frame frame) {
  99.          SessionState.Remove((String)frame.GetValue(FrameSessionStateKey 
  100.       Property));
  101.        _registeredFrames.RemoveAll((weakFrameReference) => {
  102.            Frame testFrame;
  103.            return !weakFrameReference.TryGetTarget(out testFrame) || testFrame ==   
  104.            frame; });
  105.    }

Entre as linhas 76 e 83, observa-se a criaç�o de alguns objetos espec�ficos de classes que controlam os estados das sess�es da aplicaç�o, dispensando assim maiores coment�rios. Na linha 85, � criado o m�todo RegisterFrame, que registra/armazena o estado de um frame, e na linha 86, verifica-se se existe alguma chave de estado para recuperar � caso n�o seja encontrada, um erro � retornado (linha 87); na linha 90, verifica-se se existe algum estado para recuperar, caso n�o exista, novamente envia-se uma mensagem de erro ao usu�rio (linhas 91 e 92). Na linha 94, o frame recebe os valores da chave e do estado atuais, e, posteriormente, na linha 95, adiciona-se o frame � lista de frames registrados, restaurando o estado do referido frame (linha 96).

Entre as linhas 98 e 105 � realizada a remoç�o do frame da lista de frames registrados. Na linha 99 remove-se a sess�o, e na linha 101 remove-se todos os frames que correspondem aos requisitos da condiç�o. Finalizando o c�digo da referida classe, tem-se a Listagem 5.

Listagem 5. Classe SuspensionManager.cs � Parte IV


  106.       public static Dictionary<String, Object> SessionStateForFrame(Frame frame) {
  107.           var frameState = (Dictionary<String, Object>)frame.GetValue 
  108.           (FrameSessionStateProperty);
  109.           if (frameState == null) {
  110.               var frameSessionKey = (String)frame.GetValue(FrameSessionState 
  111.               KeyProperty);
  112.               if (frameSessionKey != null) {
  113.                   if (!_sessionState.ContainsKey(frameSessionKey)) {
  114.                       _sessionState[frameSessionKey] = new Dictionary<String, Object>();
  115.                   }
  116.                   frameState = (Dictionary<String, Object>)_sessionState[ 
  117.                   frameSessionKey];
  118.               }
  119.               else {
  120.                   frameState = new Dictionary<String, Object>();
  121.               }
  122.               frame.SetValue(FrameSessionStateProperty, frameState);
  123.          }
  124.          return frameState;
  125.       }
  126.       private static void RestoreFrameNavigationState(Frame frame) {
  127.           var frameState = SessionStateForFrame(frame);
  128.           if (frameState.ContainsKey("Navigation")) {
  129.               frame.SetNavigationState((String)frameState["Navigation"]);
  130.           }
  131.       }
  132.       private static void SaveFrameNavigationState(Frame frame) {
  133.           var frameState = SessionStateForFrame(frame);
  134.           frameState["Navigation"] = frame.GetNavigationState();
  135.       }
  136.    }
  137.    public class SuspensionManagerException : Exception {
  138.        public SuspensionManagerException() { }
  139.        public SuspensionManagerException(Exception e) : base("         
  140.        SuspensionManagerfailed", e) {}
  141.    }
  142.}

Observa-se no c�digo a implementaç�o de diversos m�todos utilizados nas listagens anteriormente apresentadas. Na linha 106, o m�todo SessionStateForFrame recupera o estado atual da sess�o para armazenamento no dicion�rio de objetos. Na linha 126, o m�todo RestoreFrameNavigationState retorna o estado de navegaç�o do frame, permitindo que esse permaneça com seus dados originais. Na linha 132, o m�todo SaveFrameNavigationState armazena o estado de uma sess�o � esse m�todo ser� invocado sempre que uma sess�o for iniciada. Por fim, na linha 137, � criado o m�todo SuspensioManagerException, que herda as propriedades da classe Exception. O prop�sito desse m�todo � realizar um tratamento diferenciado nos erros que podem vir a ocorrer na execuç�o da classe. O leitor deve se lembrar de que essa � uma classe gen�rica, assim sendo, os coment�rios sobre o c�digo utilizado na mesma foram reduzidos, devendo o usu�rio, caso queira, pesquisar sobre o assunto nas refer�ncias da linguagem C# uma vez que esse n�o � o foco desse trabalho e pelo fato de a referida classe ser recomendada, mas n�o obrigat�ria.

Implementaç�o da p�gina principal

Terminada a classe de gerenciamento de sess�es, pode-se ent�o criar a interface gr�fica MainPage.xaml da aplicaç�o. Para o projeto em quest�o, foi utilizado o modelo Windows Universal Application, logo as interfaces gr�ficas seguem um modelo semelhante ao HTML. A primeira tela criada � a da p�gina principal, e seu c�digo pode ser observado na Listagem 6.

Listagem 6. MainPage.xaml


  1.        <Page x:Class=" ComandoVozApp.MainPage"
  2.               xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  3.               xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  4.               xmlns:local="using: ComandoVozApp "
  5.               xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  6.               xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  7.               mc:Ignorable="d"
  8.               Background="">
  9.               <Grid x:Name="LayoutRaiz">
  10.                <Grid.ChildrenTransitions>
  11.                     <TransitionCollection>
  12.                         <EntranceThemeTransition/>
  13.                     </TransitionCollection>
  14.                </Grid.ChildrenTransitions>
  15.                <Grid.RowDefinitions>
  16.                      <RowDefinition Height="Auto"/>
  17.                      <RowDefinition Height="*"/>
  18.                </Grid.RowDefinitions>
  19.                <!--�rea do T�tulo -->
  20.                <StackPanel Margin="19,0,0,0">
  21.                     <StackPanel Orientation="Horizontal" Margin="0,12,0,0">
  22.                          <Image Source="Assets/toolbox-icon.png" Stretch="None"
  23.                           VerticalAlignment="Bottom"/>
  24.                          <TextBlock Text="Introduç�o ao Cortana API" Margin="6,0"
  25.                           />
  26.                      </StackPanel>
  27.                      <TextBlock Text="MEU GARÇOM � COMANDO VOZ"
  28.                      />
  29.                      <TextBlock Text="Como Utilizar" Margin="0,-6.5,0,26.5"
  30.                        
  31.                      CharacterSpacing="{ThemeResource
  32.                      PivotHeaderItemCharacterSpacing}"/>
  33.                </StackPanel>
  34.                <!--�rea do Corpo-->
  35.                <Grid Grid.Row="1" Margin="19,0">
  36.                  <Grid.RowDefinitions>
  37.                       <RowDefinition Height="*"/>
  38.                  <RowDefinition Height="Auto"/>
  39.              </Grid.RowDefinitions>
  40.              <StackPanel Margin="0,0,19,0">
  41.                    <TextBlock Text=" Pressione o bot�o de busca para iniciar a cortana."            
  42.                    TextWrapping="Wrap" />              
  43.                    <Button x:Name="addMaisItens" Margin="0,7,0,0" Content="Adicione 
  44.                    mais itens" Click="AddMaisItens_Click"/>
  45.              </StackPanel>
  46.              <!--Campo Footer -->
  47.              <Grid Grid.Row="1">
  48.                   <Grid.RowDefinitions>
  49.                        <RowDefinition Height="Auto"/>
  50.                        <RowDefinition Height="Auto"/>
  51.                   </Grid.RowDefinitions>
  52.                   <Grid.ColumnDefinitions>
  53.                        <ColumnDefinition Width="Auto"/>
  54.                        <ColumnDefinition Width="Auto"/>
  55.                   </Grid.ColumnDefinitions>
  56.                   <TextBlock Text="DevMedia � Ubiratan Roberte." Margin="0,9,0,0" 
  57.                   FontSize="12" HorizontalAlignment="Right"/>
  58.                   <Image Source="Assets/105x25microsoft-logo.png" Width="105" 
  59.                   Height="25" HorizontalAlignment="Left" Grid.Column="1" 
  60.                   Margin="6,6,0,0" Grid.RowSpan="2" VerticalAlignment="Top"/>
  61.              </Grid>
  62.          </Grid>
  63.       </Grid>
  64.    </Page>

Observa-se no c�digo que, entre as linhas 1 e 8, tem-se somente os cabeçalhos padr�es da p�gina de apresentaç�o dos dados, onde realizamos importaç�es e definiç�es de configuraç�o do modelo da p�gina que ser� apresentada.

Entre as linhas 9 e 18, s�o definidos os crit�rios do layout, e entre as linhas 19 e 33, encontra-se a �rea de controle do t�tulo da aplicaç�o, que ser�: �MEU GARÇON � COMANDO VOZ�. Das linhas 34 a 45, pode-se observar os c�digos referentes ao corpo da p�gina de apresentaç�o. Assim como na parte referente ao t�tulo, n�o existem muitas particularidades nesse bloco de c�digo, sendo que na linha 41, � apresentada uma instruç�o inicial de como iniciar o comando por voz, e na linha 43, encontra-se o c�digo respons�vel por apresentar o bot�o �Adicione mais itens�, que ir� disparar o evento AddMaisItens_Click.

Por fim entre as linhas 46 e 61, v�-se a �rea de rodap� da p�gina. Em uma estrutura Windows Universal, as p�ginas t�m estrutura semelhante a c�digos XML ou HTML, sendo poss�vel inserir nessas vis�es c�digos JavaScript, CSS e outros. No bloco do rodap� � inserido um texto, linha 56, e uma imagem, linha 58. Conclu�do o c�digo, uma tela similar � que se pode ver na Figura 5 deve ser apresentada.

Figura 5. Tela inicial da aplicaç�o

Implementaç�o da p�gina do card�pio

Seguindo com a aplicaç�o, ser� desenvolvida a p�gina de apresentaç�o do card�pio. Todo c�digo dessa p�gina pode ser observado na Listagem 7.

Listagem 7. PaginaCardapio.xaml


  1.      <Page
  2.          x:Class=" ComandoVozApp.PaginaCardapio"
  3.          xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  4.          xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  5.          xmlns:local="using: ComandoVozApp "
  6.          xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  7.          xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  8.          mc:Ignorable="d"
  9.          Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
  10.      <Grid x:Name="LayoutRaiz">
  11.          <Grid.ChildrenTransitions>
  12.              <TransitionCollection>
  13.                  <EntranceThemeTransition/>
  14.              </TransitionCollection>
  15.          </Grid.ChildrenTransitions>
  16.          <Grid.RowDefinitions>
  17.              <RowDefinition Height="Auto"/>
  18.              <RowDefinition Height="*"/>
  19.          </Grid.RowDefinitions>
  20.          <!��rea do T�tulo-->
  21.          <StackPanel Margin="19,0,0,0">
  22.              <StackPanel Orientation="Horizontal" Margin="0,12,0,0">
  23.                  <Image Source="Assets/toolbox-icon.png" Stretch="None"    
  24.                   VerticalAlignment="Bottom"/>
  25.                   <TextBlock Text="Windows platform sample" Margin="6,0" 
  26.                    />
  27.              </StackPanel>
  28.              <TextBlock Text="MEU GARÇON - COMANDO VOZ" 
  29.              />
  30.              <TextBlock Text="Card�pio" Margin="0,-6.5,0,26.5" 
  31.               
  32.              CharacterSpacing="{ThemeResource         
  33.              PivotHeaderItemCharacterSpacing}"/>
  34.          </StackPanel>
  35.          <!-- Corpo da P�gina -->
  36.          <Grid Grid.Row="1" Margin="19,0">
  37.              <Grid.RowDefinitions>
  38.                  <RowDefinition Height="*"/>
  39.                  <RowDefinition Height="Auto"/>
  40.              </Grid.RowDefinitions>
  41.              <StackPanel Margin="0,0,19,0">
  42.                  <TextBlock x:Name="CardapioPorcoes" Text="Porç�es" 
  43.                  TextWrapping="Wrap" Style="{StaticResource 
  44.                  SubheaderTextBlockStyle}"/>
  45.                  <Image Source="Assets/escondidim.png" Width="119" Height="89
  46.                  " HorizontalAlignment="Left" Grid.Column="1" Margin="6,6,0,0"          
  47.                  Grid.RowSpan="2" VerticalAlignment="Top"/>
  48.                  <TextBlock x:Name="escondidinho" Margin="0,14.5,0,0" 
  49.                  Text="[Escondidinho]" TextWrapping="Wrap" 
  50.                  />
  51.                  <Button x:Name="addPedido_1" Margin="0,14.5,0,0" 
  52.                  Content="Adicionar Pedido" Click=" adicionar _Click"/>
  53.                  <Image Source="Assets/moqueca.png" Width="119" Height="89
  54.                  " HorizontalAlignment="Left" Grid.Column="1" Margin="6,6,0,0"             
  55.                  Grid.RowSpan="2" VerticalAlignment="Top"/>
  56.                   <TextBlock x:Name="moqueca" Margin="0,14.5,0,0" 
  57.                  Text="Moqueca Capixaba" TextWrapping="Wrap"   
  58.                  />
  59.                   <Button x:Name="addPedido_2" Margin="0,14.5,0,0" 
  60.                  Content="Adicionar Pedido" Click="adicionar_Click"/>
  61.              </StackPanel>
  62.              <!-- Footer panel -->
  63.              <Grid Grid.Row="1">
  64.                  <Grid.RowDefinitions>
  65.                      <RowDefinition Height="Auto"/>
  66.                      <RowDefinition Height="Auto"/>
  67.                  </Grid.RowDefinitions>
  68.                  <Grid.ColumnDefinitions>
  69.                      <ColumnDefinition Width="Auto"/>
  70.                      <ColumnDefinition Width="Auto"/>
  71.                  </Grid.ColumnDefinitions>
  72.                  <TextBlock Text="DevMedia - Ubiratan." Margin="0,9,0,0" 
  73.                  FontSize="12" HorizontalAlignment="Right"/>
  74.                  <Image Source="Assets/devmedia.png" Width="105" Height="25"
  75.                  HorizontalAlignment="Left" Grid.Column="1" Margin="6,6,0,0" 
  76.                  Grid.RowSpan="2" VerticalAlignment="Top"/>
  77.              </Grid>
  78.          </Grid>
  79.      </Grid>
  80.  </Page>

Das linhas 1 a 9, o que se observa s�o importaç�es b�sicas de qualquer arquivo xaml produzido pelo Visual Studio, exceto pelas linhas 2, que determina o nome da p�gina na aplicaç�o, e 5, que realizada a devida importaç�es de classe. Na linha 42, � adicionado um TextBlock, que apresenta ao usu�rio o texto Porç�es, que servir� de t�tulo para a p�gina. Na linha 45 � inserida uma imagem que representa um item dispon�vel no card�pio, e, na sequ�ncia (linha 48) � inserido um texto com o nome do item do menu, no caso do pedido em quest�o, �escondidinho�. Por fim, na linha 51 temos um bot�o que far� a chamada de um evento para inserir o item ao pedido da mesa.

Nos trecho que segue at� a linha 60 � realiza uma repetiç�o do c�digo compreendido entre as linhas 45 e 52, trocando somente o nome e imagem do prato.

As linhas que n�o foram comentadas apresentam funcionamento semelhante ao visto na Listagem 6. O resultado ap�s a implementaç�o do c�digo deve ser similar ao apresentado na Figura 6.

Figura 6. Tela de card�pio

Classe da P�gina PaginaCardapio

Para que a p�gina seja corretamente apresentada, faz-se necess�rio tamb�m criar sua classe de retaguarda. O c�digo dessa classe � apresentado na Listagem 8.

Listagem 8. PaginaCardapio.xaml.cs


  1.        using System;
  2.        using ComandoVozApp.Common;
  3.        using Windows.UI.Xaml;
  4.        using Windows.UI.Xaml.Controls;
  5.        using Windows.UI.Xaml.Navigation;
  6.         
  7.            namespace ComandoVozApp{
  8.                public sealed partial class PaginaCardapio : Page {
  9.                    public PaginaCardapio() {
  10.                    this.InitializeComponent();
  11.                }
  12.                protected override void OnNavigatedTo(NavigationEventArgs e) {
  13.                    if (e.NavigationMode == NavigationMode.New) {
  14.                        SuspensionManager.SessionState["PaginaCardapio"] =
  15.                        e.Parameter.ToString();
  16.                  }
  17.            }
  18.            private void adicionar_Click(object sender, RoutedEventArgs e) {
  19.                (Window.Current.Content as Frame).Navigate(typeof(MainPage));
  20.            }
  21.        }
  22.    }

Entre as linhas 1 e 5 do c�digo apresentado na Listagem 8, s�o realizadas importaç�es de bibliotecas que ser�o utilizadas na classe. Entre as linhas 7 e 11, observamos comandos b�sicos de definiç�o da classe, especificaç�o do m�todo construtor e inicializaç�o dos componentes. Na linha 12, sobrescreve-se o m�todo OnNavigatedTo, e na linha 13 verifica-se se o par�metro de entrada do m�todo refere-se a uma nova p�gina (apresentaç�o): se sim, ent�o uma refer�ncia dessa p�gina � armazenada atrav�s do m�todo SessionState da classe SuspensionManager.

Efetua-se na linha 18 a implementaç�o do m�todo adicionar_Click, que nesse projeto simplesmente redirecionar� o usu�rio para a p�gina inicial do projeto (como se trata de um artigo de introduç�o, alguns eventos n�o ser�o totalmente implementados, devendo o leitor ajust�-los para suas necessidades).

Classe do arquivo principal

Criadas as p�ginas prim�ria e secund�ria, deve-se realizar algumas alteraç�es na classe principal da aplicaç�o, a App.xaml.cs. Navegue pelo Solution Explorer, encontre o referido arquivo e abra-o. Devido a sua extens�o, o c�digo da classe ser� apresentado em partes que conter�o o conte�do que deve ser inserido ou alterado no arquivo.

Na Listagem 9, � poss�vel observar as importaç�es necess�rias para a classe.

Listagem 9. App.xaml.cs � Parte I


  1.             using System;
  2.             using ComandoVozApp.Common;
  3.             using Windows.ApplicationModel;
  4.             using Windows.ApplicationModel.Activation;
  5.             using Windows.Phone.UI.Input;
  6.             using Windows.UI.Xaml;
  7.             using Windows.UI.Xaml.Controls;
  8.             using Windows.UI.Xaml.Media.Animation;
  9.             using Windows.UI.Xaml.Navigation;
  10.         namespace ComandoVozApp {
  11.          public sealed partial class App : Application {
  12.              private Frame rootFrame;
  13.              private TransitionCollection transitions;
  14.              public App() {
  15.                  this.InitializeComponent();
  16.                  this.Suspending += this.OnSuspending;
  17.                  HardwareButtons.BackPressed += HardwareButtons_BackPressed;
  18.              }
  19.              private void HardwareButtons_BackPressed(object sender, 
  20.              BackPressedEventArgs e) {
  21.                  if (this.rootFrame == null) {
  22.                      return;
  23.                  }
  24.                  if (this.rootFrame.CanGoBack) {
  25.                      this.rootFrame.GoBack();
  26.                      e.Handled = true;
  27.                  }
  28.              }

Na linha 2 � realizada importaç�o do pacote Common da aplicaç�o. As demais linhas devem ser inseridas automaticamente, caso n�o sejam, basta copi�-las para o projeto. Na linha 14, � implementado o m�todo construtor da classe e na linha 19, o m�todo que efetua o retorno para p�gina anterior, independente de em que p�gina o usu�rio se encontre.

Na linha 21 verifica-se se existe algum frame raiz para o frame em que o usu�rio se encontra no momento; caso n�o exista o m�todo n�o ter� retorno. Na linha 24, caso exista alguma raiz (pai) para o frame, ent�o verifica-se se � poss�vel realizar o retorno para o mesmo: se sim, na linha 25 � invocado o m�todo de retorno, e na linha 26 informa-se ao aplicativo que um handle foi utilizado (Handled = true).

Dando sequ�ncia ao c�digo do arquivo App.xaml.cs, tem-se a Listagem 10.

Listagem 10. App.xaml.cs � Parte II


  29.          private async void EnsureRootFrame(ApplicationExecutionState
  30.          previousExecutionState) {
  31.          this.rootFrame = Window.Current.Content as Frame;
  32.              if (this.rootFrame == null) {
  33.                  this.rootFrame = new Frame();
  34.                  SuspensionManager.RegisterFrame(this.rootFrame, "AppFrame");
  35.                  this.rootFrame.CacheSize = 1;
  36.                  if (previousExecutionState == ApplicationExecutionState.Terminated) {
  37.                      try {
  38.                          await SuspensionManager.RestoreAsync();
  39.                      }
  40.                      catch (SuspensionManagerException) { }
  41.                  }
  42.                  Window.Current.Content = this.rootFrame;
  43.              }
  44.          Window.Current.Activate();
  45.      }

O c�digo apresentado trata de um m�todo que deve ser criado automaticamente pela IDE, no qual ser�o inseridos os c�digos presentes entre as linhas 34 e 41. Na linha 34 o frame principal, AppFrame, � enviado para o m�todo RegisterFrame, da classe SuspensionManager, cujas funç�es j� foram discutidas neste artigo. Na linha 36, verifica-se se o atual estado da sess�o permanece ativo, caso n�o esteja, o m�todo RestoreAsync, tamb�m pertencente � classe SuspensionManager, � invocado, restaurando o estado da sess�o. Seguindo para o terceiro bloco de c�digo, � apresentada a Listagem 11.

Listagem 11. App.xaml.cs � Parte III


  46.      protected override void OnActivated(IActivatedEventArgs e) {
  47.          if (e.Kind != Windows.ApplicationModel.Activation.
  48.          ActivationKind.VoiceCommand) {
  49.              return;
  50.          }
  51.          var commandArgs = e as Windows.ApplicationModel.Activation. 
  52.          VoiceCommandActivatedEventArgs;
  53.          Windows.Media.SpeechRecognition.SpeechRecognitionResult 
  54.          speechRecognitionResult = commandArgs.Result;
  55.          string commandMode = this.SemanticInterpretation("commandMode", 
  56.          speechRecognitionResult);
  57.          string voiceCommandName = speechRecognitionResult.RulePath[0];
  58.          string textSpoken = speechRecognitionResult.Text;
  59.          string navigationTarget = this.SemanticInterpretation("NavigationTarget",    
  60.          speechRecognitionResult);
  61.   
  62.          Type navigateToPageType = typeof(MainPage);
  63.          string navigationParameterString = string.Empty;
  64.   
  65.          switch (voiceCommandName) {
  66.              case "apresentaMenu":
  67.                  navigateToPageType = typeof(PaginaCardapio);
  68.              break;
  69.              default:
  70.              break;
  71.          }
  72.   
  73.          this.EnsureRootFrame(e.PreviousExecutionState);
  74.          if (!this.rootFrame.Navigate(navigateToPageType, 
  75.          navigationParameterString)) {
  76.              throw new Exception("Falha ao Redirecionar a p�gina");
  77.          }
  78.      }
  79.   
  80.      private string SemanticInterpretation(string key,
  81.      Windows.Media.SpeechRecognition.SpeechRecognitionResult 
  82.      speechRecognitionResult) {
  83.          if (speechRecognitionResult.SemanticInterpretation.Properties. 
  84.          ContainsKey(key)) {
  85.              return speechRecognitionResult.SemanticInterpretation. 
  86.              Properties[key][0];
  87.          }
  88.          else {
  89.              return "unknown";
  90.          }
  91.      }

Inicia-se na linha 46 o m�todo OnActivated. O referido m�todo � padr�o e mesmo que n�o seja implementado estar� presente no arquivo, logo, encontre-o para inserir os demais c�digos que se fazem necess�rios. Na linha 48 verifica-se se a aplicaç�o recebeu comando de voz, se n�o recebeu, ent�o � realizado o retorno e o restante do c�digo n�o ser� executado. Da linha 51 at� a linha 63 s�o realizadas inicializaç�es de diversas vari�veis, das quais merecem destaque: linha 55: o m�todo SemanticInterpretation recupera uma string com o entendimento sem�ntico que a aplicaç�o teve sobre a fala do usu�rio; na linha 57: � recuperada tamb�m em forma de string o nome do comando que foi interpretado pelo sistema; por fim, na linha 58 todo texto dito pelo usu�rio � armazenado na vari�vel textSpoken.

Na linha 65 insere-se um switch para determinar, de acordo com o retorno realizado pela interpretaç�o do texto falado pelo usu�rio, qual deve ser a aç�o da aplicaç�o. Na linha 67, � realizado o redirecionamento da p�gina. O c�digo contido entre as linhas 73 e 78 se tratam de c�digo inserido automaticamente pela IDE. Na linha 80, inicia-se a implementaç�o do m�todo SemanticInterpretation, que, de acordo com o que foi dito pelo usu�rio, retornar� a propriedade Name do Command associado ao comando dito. Por exemplo: caso o usu�rio tenha dito �apresente card�pio�, a aplicaç�o retornar� o valor da propriedade Name do elemento Command referenciado pela palavra card�pio, nesse caso, apresentaMenu. A parte final do c�digo em estudo � apresentada na Listagem 12.

Listagem 12. App.xaml.cs � Parte VI


  92.      protected override async void OnLaunched(LaunchActivatedEventArgs e) {
  93.          #if DEBUG
  94.          if (System.Diagnostics.Debugger.IsAttached) {
  95.              this.DebugSettings.EnableFrameRateCounter = true;
  96.          }
  97.          #endif
  98.          this.EnsureRootFrame(e.PreviousExecutionState);
  99.          if (this.rootFrame.Content == null) {
  100.                 if (this.rootFrame.ContentTransitions != null) {
  101.                     this.transitions = new TransitionCollection();
  102.                     foreach (var c in this.rootFrame.ContentTransitions) {
  103.                         this.transitions.Add(c);
  104.                     }
  105.                 }
  106.                 this.rootFrame.ContentTransitions = null;
  107.                 this.rootFrame.Navigated += this.RootFrame_FirstNavigated;
  108.                 if (!this.rootFrame.Navigate(typeof(MainPage), e.Arguments)) {
  109.                     throw new Exception("Failed to create initial page");
  110.                 }
  111.             }
  112.             var storageFile = await Windows.Storage.StorageFile.GetFileFrom          
  113.            ApplicationUriAsync(new Uri("ms-appx:///ComandosSuportados.xml"));
  114.            await Windows.Media.SpeechRecognition.VoiceCommandManager.InstallCommandSetsFromStorageFileAsync(storageFile);
  115.         }
  116.         private void RootFrame_FirstNavigated(object sender,
  117.         NavigationEventArgs e){
  118.             var rootFrame = sender as Frame;
  119.             rootFrame.ContentTransitions = this.transitions ?? newTransitionCollection() 
  120.             { new NavigationThemeTransition() };
  121.             rootFrame.Navigated -= this.RootFrame_FirstNavigated;
  122.         }
  123.         private async void OnSuspending(object sender, SuspendingEventArgs e) {
  124.             var deferral = e.SuspendingOperation.GetDeferral();
  125.             await SuspensionManager.SaveAsync();
  126.             deferral.Complete();
  127.         }
  128.     }
  129.}

O m�todo OnLaunched, iniciado na linha 92, � padr�o da aplicaç�o, contudo algumas alteraç�es foram realizadas no mesmo visando a instalaç�o do arquivo de comandos suportados (VCD). Ainda na linha 92, foi adicionado ao m�todo o termo async, que em conjunto com o await, permite determinar um sincronismo no fluxo da troca de mensagens do aplicativo. Todo c�digo constante entre as linhas 93 e 111 � de geraç�o autom�tica, e por isso n�o ser� comentado.

Executa-se nas linhas 112 e 113 o comando que recupera o arquivo contendo os comandos suportados, ComandosSuportados.xml, arquivo esse que � inserido na Cortana (observer a linha 113). O restante do c�digo tamb�m � gerado automaticamente, assim sendo, n�o ser� comentado, exceto o c�digo da linha 125, que invoca o m�todo SaveAsync da classe SuspensionManager.

Conclu�das as implementaç�es a aplicaç�o pode ent�o ser testada. Sua interface gr�fica final � bem simples, como se pode notar nas imagens anteriormente apresentadas.

A sequ�ncia de funcionamento da aplicaç�o � apresentada na Figura 7. Como pode ser visto, a tela inicial da aplicaç�o somente indica ao usu�rio o que deve ser feito para iniciar a utilizaç�o da aplicaç�o. Ap�s dito o comando (corretamente), a nova p�gina com o card�pio � aberta. O fluxo da aplicaç�o encerra-se neste momento, dado que essa � apenas uma aplicaç�o introdut�ria (exemplo).

Figura 7. Fluxo de funcionamento da aplicaç�o

Utilizar os recursos da Cortana API em suas aplicaç�es Windows Universal mostrou-se ser uma tarefa relativamente simples. Ainda que o c�digo para uma simples aplicaç�o seja extenso, grande parte desse � gerada automaticamente. Essa API permite estender significantemente os recursos de sua aplicaç�o, sendo poss�vel inclusive inserir novos termos a qualquer momento, sem a necessidade de grandes alteraç�es.

Cortana API: Implementando reconhecimento de voz para apps universais

Aprenda a desenvolver aplicativos para Universal Windows Platform utilizando a Cortana API com reconhecimento de voz.