Você já sabe que o usuário pode cadastrar perfiz de voz em sua conta da Alexa para personalizar alguns serviços, certo?
Nesse artigo eu vou te mostrar como utilizar estes perfis de voz dentro da sua própria skill.
Vamos conversar sobre como capturar perfis de voz no seu código.
Como Capturar Perfis De Voz No Seu Código
Já conversamos sobre perfis de voz da Alexa, lembra?
Você pode criar um perfil de voz para que a Alexa forneça uma experiência personalizada ao reconhecer sua voz.
Os perfis também adaptam coisas como chamadas, calendários, lembretes e flash briefings (últimas notícias). No caso de chamadas e mensagens, por exemplo, cada pessoa consegue manter uma lista de contatos separada.
Disse também que nós, desenvolvedores, podemos utilizar estes perfis de voz em nossas skills.
E hoje vou mostrar como fazer isso.
Antes, veja que no meu app Alexa o meu perfil de voz está cadastrado.
Então, sem mais delongas, como capturar perfis de voz no seu código?
Configurando Sua Skill
Antes de mais nada, vou criar uma nova skill utilizando o modelo Start From Scratch, que nada mais é que o nosso conhecido Hello World.
Eu batizei esta skill de Capturando Perfil. E no nome de invocação eu coloquei a mesma coisa.
A primeira coisa que você precisa fazer é configurar a permissão para utilizar perfis.
Então, na aba Build, vá até o menu esquerdo e clique em Tools – Permissions.
Nesta tela, procure pelo item Skills Personalization e ligue a “chave”.
E pronto. Agora vamos pro código?
Capturando O Perfil De Voz No Código
Aqui não tem nada de mais, o código é muito simples.
O perfil está dentro deste objeto:
handlerInput.requestEnvelope.context.System.person
e para usar o primeiro nome do usuário na resposta, precisamos usar a tag proprietária alexa com a propriedade personId que está dentro do objeto person:
const speakOutput = "Oi <alexa:name type=\"first\" personId=\"" + handlerInput.requestEnvelope.context.System.person.personId + "\"/>";
Como Testar?
Podemos testar a skill dentro do Console do Desenvolvedor através do simulador Alexa.
Repare que na aba teste apareceu uma notificação, dizendo que a personalização de skills está ligado.
É aquela permissão que setamos na aba Build.
Pois bem, logo abaixo tem um quadro Personalization.
Através dele você pode escolher um perfil de voz que será utilizado quando a skill for executada no simulador.
Vamos tentar?
Legal né?
Vamos agora testar no Echo.
“Alexa, abra Capturando Perfil.”
Viu como ela reconheceu?
Melhorando O Código
Bom, este é o código para pegar o perfil de voz do usuário que está utilizando sua skill.
Claro que para essa skill ser publicada ainda precisamos incluir um tratamento de erro nele caso o usuário não tenha um perfil de voz.
Neste caso, o objeto person estará vazio.
Então é só incluir um if simples, verificando isso antes de utilizar esse objeto, ok?
Viu a simplicidade de como capturar perfis de voz no seu código?
Com uma linha de código você consegue capturar o nome do usuário que ativou sua skill e personalizar a interação com esse usuário.
Palavras Finais
Além de mostrar a linha de comando na tela, deixei ela aí em cima para você copiar e colar no seu código.
Isso é mais que suficiente para você começar a brincar aí.
Mas se mesmo assim você quiser o código fonte desta skill, vou deixar um link no primeiro comentário do vídeo onde você poderá baixar este código fonte por um valor simbólico, apenas para ajudar na manutenção do canal do YouTube, ok?
E como bônus, neste código fonte eu deixei um if para fazer um tratamento quando o usuário não tiver cadastrado seu perfil de voz na conta da Alexa. Ou seja, quando o objeto person estiver vazio.
O link para o código fonte da skill visto neste artigo está aqui:
👉🏼 http://celsokitamura.com.br/captura-perfil
Baixe o código fonte por um valor simbólico, para ajudar na manutenção do canal.
Bora aprender a desenvolver skills para Alexa!