Como Funciona A Alexa Presentation Language (APL)?

Tempo de leitura: 5 min

Escrito por Celso Kitamura
em 2 de abril de 2021

Entre para o Grupo VIP e fique sabendo antes das novidades

Junte-se à nossa comunidade de App Devs que estão transformando o mundo

100% livre de spam.

Compartilhe agora mesmo:

Como Funciona A Alexa Presentation Language (APL)?

Você sabia que podemos criar experiências visuais para acompanhar sua skill?

 

Nesse vídeo vou explicar como funciona a Alexa Presentation Language (APL).

 

Já fiz um vídeo sobre o que é a APL, e hoje vamos ver mais um pouco sobre a Alexa Presentation Language, vamos ver como ela funciona.

 

Como Funciona A Alexa Presentation Language (APL)?

 

Todas as skills personalizadas usam uma interface de request e response.

 

Se você for um desenvolvedor web já deve estar careca de ver isso.

 

Em resumo, a Alexa envia uma requisição à sua backend, que pode ser uma função Lambda ou webservice.

 

Seu código processa este request e retorna uma resposta (response). A APL funciona dentro desta estrutura:

 

  • Sua skill recebe um LaunchRequest ou IntentRequest normal para iniciar uma interação com o usuário.
  • Na sua resposta da skill, você pode retornar diretivas para dizer ao dispositivo para exibir seu conteúdo APL e executar comandos. A interface Alexa.Presentation.APL define essas diretivas. A carga desta diretiva inclui um documento APL. Ela também inclui uma fonte de dados.
  • Sua skill pode escutar solicitações acionadas por ações do usuário, como quando o usuário seleciona um botão na tela. A interface Alexa.Presentation.APL também define esses tipos de solicitação. Você cria handlers no código da sua skill para aceitar e processar essas solicitações, semelhantes aos handlers que você cria para suas intenções.
  • Como com qualquer skill, os usuários podem fazer solicitações de voz, que são enviadas para sua skill como uma solicitação IntentRequest normal. Para uma boa experiência, permita que os usuários interajam com sua skill tanto por voz quanto por toque e não obrigue os usuários a usar apenas um modo de entrada.

 

Vamos Ver Um Exemplo?

 

Imagine a seguinte interação com uma skill que utiliza APL e o dispositivo do usuário é um Echo Show.

 

Usuário: Alexa, abra Perguntas Rápidas

 

O Echo Show mostra uma animação de boas-vindas quando Alexa começa a falar.

Alexa: Bem-vindo ao Perguntas Rápidas! Pronto para jogar?

 

Usuário: Sim.

 

O Echo Show exibe uma lista de categorias.

Alexa: Legal, por favor, escolha a categoria que deseja jogar! Você pode dizer uma categoria ou selecionar um item na tela.

 

Usuário: (toca na categoria “Animais” na tela. Como alternativa, o usuário poderia ter respondido com “Jogue a categoria de animais”.)

 

O dispositivo exibe a pergunta sobre uma imagem relacionada.

Alexa: OK, faremos perguntas sobre animais. Aqui está sua primeira pergunta: (o texto da pergunta)…

 

Depois de ler a pergunta, a tela é atualizada para mostrar uma lista de respostas possíveis para escolher.

 

O usuário responde às perguntas por voz ou tocando nas opções na tela.

 

Agora Em Detalhes

 

1

Usuário: Alexa, abra Perguntas Rápidas

 

Sua skill recebe um LaunchRequest normal, em seguida, retorna uma resposta com duas partes:

  • Resposta falada
  • A diretiva Alexa.Presentation.APL.RenderDocument. O conteúdo desta diretiva inclui um documento APL que define uma animação de boas-vindas.

 

2

O Echo Show exibe uma animação de boas-vindas quando Alexa começa a falar.

Alexa: Bem-vindo ao Perguntas Rápidas! Pronto para jogar?

 

O Echo Show renderiza o documento fornecido em sua resposta. Este documento exibe uma animação de boas-vindas.

 

Quando Alexa termina de falar, o aparelho abre o microfone para ouvir a resposta do usuário.

 

3

Usuário: Sim.

 

Sua skill recebe um IntentRequest para a intenção AMAZON.YesIntent e, em seguida, retorna uma resposta que inclui a resposta falada e a diretiva RenderDocument. Desta vez, o documento APL define uma lista de categorias.

 

4

O Echo Show exibe uma lista de categorias.

Alexa: Por favor, escolha a categoria que deseja jogar!

 

O Echo Show renderiza o documento fornecido em sua resposta. Este documento exibe uma lista de categorias.

 

Quando Alexa termina de falar, o dispositivo abre o microfone para ouvir a resposta do usuário.

 

5

Usuário: (O usuário toca na categoria “Animais” na tela.)

 

  • Sua skill recebe um request Alexa.Presentation.APL.UserEvent que indica o item que o usuário tocou.
  • Seu handler para a UserEvent retorna uma resposta de voz e as diretivas RenderDocument e ExecuteCommands.
  • O documento APL define duas páginas: uma página de detalhes que exibe a pergunta e uma página de resposta que exibe uma lista de respostas.
  • A diretiva ExecuteCommands especifica comandos para ler o texto da pergunta exibido na tela e destaca cada linha em sincronia (SpeakItem), em seguida muda para a segunda página para exibir as respostas possíveis (SetPage).

 

6

O dispositivo exibe a pergunta sobre uma imagem relacionada.

Alexa: OK, faremos perguntas sobre animais. Aqui está sua primeira pergunta: (texto da pergunta)

 

O Echo Show renderiza o documento para exibir o texto da pergunta e, em seguida, executa o comando SpeakItem para ler o texto com realce.

 

7

Depois de ler a pergunta, a tela é atualizada para mostrar uma lista de respostas possíveis para escolher.

 

O usuário pode responder às perguntas por voz ou tocando nas opções na tela.

 

Quando o comandeo SpeakItem termina, o dispositivo executa o comando SetPage para mudar a exibição para a próxima página, que exibe uma lista de respostas.

 

Palavras Finais

 

Com este exemplo dá para ter uma ideia de como funciona a Alexa Presentation Language (APL).

 

Claro que existem muitos outros comandos que podemos utilizar.

 

Fora o fato desta interface estar em constante evolução, então a Amazon sempre inclui coisas novas para usarmos.

 

Meu e-book com 5 passos para desenvolver skills Alexa está GRATUITO por tempo limitado!

Olha o link: 👉🏼 https://celsokitamura.com.br/ebook-gratis-alexa

Bora aprender a desenvolver skills para Alexa!

 

Compartilhe agora mesmo:

Comece pelo e-book GRATUITO (Por Tempo Limitado)

5 Passos Para Desenvolver Alexa Skills

Se você não sabe por onde começar, este e-book te mostra os passos para ser um desenvolvedor de skills de sucesso.

QUERO CRIAR SKILLS PARA ALEXA!
100% livre de spam.

Você vai gostar também:

Para enviar seu comentário, preencha os campos abaixo:

Deixe uma resposta


*


*


Seja o primeiro a comentar!

Entre para o Grupo VIP e fique sabendo antes das novidades

Junte-se à nossa comunidade de App Devs que estão transformando o mundo

100% livre de spam.

Damos valor à sua privacidade

Nós e os nossos parceiros armazenamos ou acedemos a informações dos dispositivos, tais como cookies, e processamos dados pessoais, tais como identificadores exclusivos e informações padrão enviadas pelos dispositivos, para as finalidades descritas abaixo. Poderá clicar para consentir o processamento por nossa parte e pela parte dos nossos parceiros para tais finalidades. Em alternativa, poderá clicar para recusar o consentimento, ou aceder a informações mais pormenorizadas e alterar as suas preferências antes de dar consentimento. As suas preferências serão aplicadas apenas a este website.

Cookies estritamente necessários

Estes cookies são necessários para que o website funcione e não podem ser desligados nos nossos sistemas. Normalmente, eles só são configurados em resposta a ações levadas a cabo por si e que correspondem a uma solicitação de serviços, tais como definir as suas preferências de privacidade, iniciar sessão ou preencher formulários. Pode configurar o seu navegador para bloquear ou alertá-lo(a) sobre esses cookies, mas algumas partes do website não funcionarão. Estes cookies não armazenam qualquer informação pessoal identificável.

Cookies de desempenho

Estes cookies permitem-nos contar visitas e fontes de tráfego, para que possamos medir e melhorar o desempenho do nosso website. Eles ajudam-nos a saber quais são as páginas mais e menos populares e a ver como os visitantes se movimentam pelo website. Todas as informações recolhidas por estes cookies são agregadas e, por conseguinte, anónimas. Se não permitir estes cookies, não saberemos quando visitou o nosso site.

Cookies de funcionalidade

Estes cookies permitem que o site forneça uma funcionalidade e personalização melhoradas. Podem ser estabelecidos por nós ou por fornecedores externos cujos serviços adicionámos às nossas páginas. Se não permitir estes cookies algumas destas funcionalidades, ou mesmo todas, podem não atuar corretamente.

Cookies de publicidade

Estes cookies podem ser estabelecidos através do nosso site pelos nossos parceiros de publicidade. Podem ser usados por essas empresas para construir um perfil sobre os seus interesses e mostrar-lhe anúncios relevantes em outros websites. Eles não armazenam diretamente informações pessoais, mas são baseados na identificação exclusiva do seu navegador e dispositivo de internet. Se não permitir estes cookies, terá menos publicidade direcionada.

Visite as nossas páginas de Políticas de privacidade e Termos e condições.

Importante: Este site faz uso de cookies que podem conter informações de rastreamento sobre os visitantes.
Criado por WP RGPD Pro