Histórias de uso da API

A API Mirror fornece um conjunto de elementos básicos que pode ser usado para criar serviços para o Google Glass. Como os serviços do Google Glass provavelmente são diferentes de outros softwares que você desenvolveu, pode não ser óbvio como combinar os recursos da API Mirror.

Muitos serviços se enquadram em algumas categorias de uso da API. Veja algumas histórias que ilustram como combinar os recursos da API Mirror para criar serviços do Google Glass.

Fatos sobre gatos

O envio de conteúdo ao cronograma do Google Glass é um uso simples, mas eficiente, da API Google Mirror. O exemplo da Glass Facts Glassware mostra fatos sobre gatos para os usuários e pode seguir este fluxo:

1. O usuário acessa seu aplicativo da Web e se inscreve usando o OAuth 2.0.
2. A cada hora, na hora, seu serviço envia um novo fato felino para cada usuário do Google Glass.

Os fatos do Cat seriam implementados usando o método de inserção de linha do tempo:

1. Os usuários fazem a assinatura usando a autenticação com OAuth 2.0.
2. Fats do Cat armazena um índice de usuários e suas credenciais
3. A cada hora, a Fato Facts publica um novo Cat Fact. Ele faz isso iterando todos os usuários armazenados e inserindo um item de cronograma nos cronogramas.

Adicione um gato a isso

Cada etapa do avanço tecnológico humano tem métodos aprimorados de distribuição de fotos de gatos. O Project Glass não é diferente.

Como cada foto é melhor com um gato, esse serviço permite que os usuários componham uma imagem aleatória de um gato e uma foto que eles tiraram com o Google Glass.

1. O usuário visita seu aplicativo da Web e instala a opção "Add a Cat to That" ao se autenticar com o OAuth 2.0.
2. Seu serviço cria um novo contato no Google Glass do seu usuário chamado "Adicionar um gato a isso".
3. Conforme o usuário tira fotos, ele as compartilha com o recurso "Adicionar um gato a isso".
4. Seu serviço compõe uma imagem aleatória de um gato para a foto compartilhada.
5. Por fim, seu serviço entrega a foto aprimorada por gatos no Glass do usuário.

Em termos de arquitetura, este serviço seguiria este fluxo de API:

1. Seu usuário autoriza com o OAuth 2.0. O serviço armazena as credenciais.
2. Logo após a conclusão da dança OAuth 2.0, seu serviço insere um contato chamado "Add a Cat to That".
3. Em seguida, o serviço assina as atualizações na linha do tempo do usuário, inserindo uma assinatura para a coleção timeline. A opção "Add a Cat to That" está totalmente configurada.
4. Com o tempo, o usuário tira fotos.
5. O usuário compartilha uma foto com "Adicionar um gato a isso". Isso faz com que o cartão da linha do tempo associado a esta foto seja acessível ao seu serviço.
6. Como o serviço está inscrito para as atualizações da linha do tempo, uma notificação será enviada. Essa notificação inclui um link para o item da linha do tempo que contém a foto compartilhada.
7. Seu serviço examina a notificação e usa o id incluído para buscar o card da linha do tempo que contém a foto.
8. Em seguida, o serviço examina o item da linha do tempo e usa o ID do anexo para buscar os bytes da foto.
9. Seu serviço seleciona uma imagem aleatória de um gato e a compõe na foto compartilhada.
10. Por fim, o serviço cria um novo card da linha do tempo e o insere no card da linha do tempo do usuário com a foto melhorada para gatos.

Observação: como bônus extra, você pode adicionar o item de menu integrado SHARE ao card da linha do tempo. Isso permite que as fotos aprimoradas por gatos sejam compartilhadas com outros serviços ou repetidamente com o recurso "Adicionar um gato a". Para adicionar vários gatos a uma foto.

Pet shop por perto

Só há uma coisa melhor do que fatos sobre gatos ou imagens de gatos, e isso é gatos peludos, físicos e reais. A API Mirror pode facilitar isso, porque você sempre sabe onde fica o pet shop mais próximo.

O uso segue este fluxo:

1. O usuário acessa seu aplicativo da Web e se inscreve usando o OAuth 2.0.
2. O serviço determina a localização do usuário.
3. Seu serviço procura pet shop perto desse local.
4. O serviço insere um card à esquerda do relógio que lista os pet shop próximos.
5. O Google Glass notifica o serviço sobre a localização do usuário.
6. Para cada notificação, o serviço repete a pesquisa de pet shop e atualiza o cartão fixado para refletir o novo conjunto de pet shop mais próximo.

A implementação desse serviço segue este fluxo de API:

1. Seu usuário autoriza com o OAuth 2.0. Além do escopo glass.timeline comum, o aplicativo também solicita o acesso glass.location.
2. Logo após a conclusão da dança OAuth 2.0, seu serviço se inscreve para receber atualizações sobre a localização do usuário.
3. Em seguida, o serviço busca a localização mais recente do usuário no endpoint de local.
4. Seu serviço pesquisa por pet shop perto do usuário.
5. Seu serviço cria um card timeline que lista os resultados da pesquisa do pet shop. Para manter este cartão no lado esquerdo da tela do relógio, o serviço fixa o cartão.
6. O local mais recente do usuário é atualizado.
7. Como o serviço está inscrito nas atualizações de localização, uma notificação será enviada para ele. Essa notificação inclui um link para o item latest na coleção location.
8. Com base na notificação, seu serviço busca o latest location do usuário na coleção location.
9. Em seguida, seu serviço procura pet shop perto do usuário.
10. Por fim, o serviço usa o método patch para atualizar o corpo do item de linha do tempo inserido na etapa 5.