Storie di utilizzo delle API

L'API Mirror fornisce un insieme di componenti di base che puoi utilizzare per creare servizi per Glass. Probabilmente i servizi Glass sono diversi da quelli di altri software che hai sviluppato, quindi potrebbe non essere chiaro come adattare le funzionalità dell'API Mirror.

Molti servizi rientrano in alcune categorie di utilizzo delle API. Ecco alcune storie che illustrano come combinare le funzionalità dell'API Mirror per creare servizi Glass.

Informazioni sui gatti

La distribuzione di contenuti nella sequenza temporale di Glass è un utilizzo semplice ma potente dell'API Google Mirror. L'esempio di Catware Facts fornisce informazioni sui gatti agli utenti e potrebbe poter seguire questo flusso:

1. L'utente visita la tua applicazione web e si abbona con OAuth 2.0.
2. Ogni ora, nell'ora specificata, il servizio invia una nuova curiosità sul gatto a ciascuno degli utenti di Glass.

"Facts Cat" verrebbe implementato utilizzando il metodo di inserimento della sequenza temporale:

1. Gli utenti si abbonano con OAuth 2.0
2. Cat Facts memorizza un indice degli utenti e le loro credenziali
3. Ogni ora, Cat Facts pubblica una nuova storia. A tal fine, eseguono l'iterazione di tutti gli utenti archiviati e inserendo una sequenza temporale nella propria cronologia.

Aggiungi un gatto

Ogni passo nel progresso tecnologico umano fornisce metodi migliori per la distribuzione delle foto dei gatti. Project Glass non è diverso.

Poiché ogni fotografia è migliore con un gatto, questo servizio consente agli utenti di comporre un'immagine di un gatto casuale e una foto scattata con Glass.

1. L'utente visita la tua applicazione web e installa Aggiungi un gatto a questo eseguendo l'autenticazione con OAuth 2.0.
2. Il servizio crea un nuovo contatto su Glass degli utenti chiamato "Aggiungi un gatto".
3. Quando un utente scatta foto, le condivide con Aggiungi un gatto.
4. Il tuo servizio compone l'immagine casuale di un gatto sulla fotografia condivisa.
5. Infine, il tuo servizio pubblica la foto ottimizzata per i gatti sul Glass dell'utente.

Dal punto di vista architetturale, questo servizio seguirebbe questo flusso API:

1. L'utente autorizza OAuth 2.0. Il servizio archivia le proprie credenziali.
2. Subito dopo la fine di OAuth 2.0, il servizio inserisce un contatto denominato "Add a Cat to That".
3. Successivamente, il tuo servizio si abbona agli aggiornamenti nella cronologia di questo utente inserendo una sottoscrizione per la raccolta timeline. Aggiungi un gatto a Ora che è completamente configurato.
4. Nel tempo, l'utente scatta fotografie.
5. L'utente condivide una foto con la funzionalità Aggiungi un gatto. In questo modo, la scheda della cronologia associata a questa foto sarà accessibile al tuo servizio.
6. Poiché il servizio è iscritto agli aggiornamenti della cronologia, viene inviata una notifica al servizio. Questa notifica rimanda all'elemento nella sequenza temporale che contiene la foto condivisa.
7. Il servizio esamina la notifica e utilizza la id inclusa per recuperare la scheda della sequenza temporale che contiene la foto.
8. Successivamente, il servizio esamina l'elemento della sequenza temporale e utilizza l'ID allegato per recuperare i byte della fotografia.
9. Il servizio seleziona un'immagine casuale di un gatto e la compone nella foto condivisa.
10. Infine, il servizio crea una nuova scheda della sequenza temporale e la inserisce nella scheda della cronologia dell'utente con la foto migliorata del gatto allegata.

Nota: come ulteriore sciocco bonus, puoi aggiungere alla scheda della cronologia gli elementi SHARE del menu integrato. In questo modo, le foto ottimizzate per i gatti possono essere condivise con altri servizi o ripetutamente condivise con Aggiungi un gatto a questo elemento per aggiungere più gatti a una foto.

Negozi di animali nelle vicinanze

C'è solo una cosa che è meglio dei fatti sui gatti o sulle immagini dei gatti, ovvero i gatti reali, pelosi. L'API Mirror può semplificare questa operazione assicurandoti di sapere sempre dov'è il negozio per animali più vicino.

L'utilizzo segue questo flusso:

1. L'utente visita la tua applicazione web e si abbona con OAuth 2.0.
2. Il servizio determina la località dell'utente.
3. Il tuo servizio cerca negozi di animali domestici nelle vicinanze di quella località.
4. Il servizio inserisce una scheda a sinistra dell'orologio che elenca questi negozi per animali domestici nelle vicinanze.
5. Glass invia una notifica al tuo servizio in merito alla posizione del tuo utente.
6. Per ogni notifica, il servizio ripete la ricerca del negozio di animali e aggiorna la scheda bloccata in modo che rifletta il nuovo insieme di negozi di animali più vicini.

L'implementazione di questo servizio segue questo flusso API:

1. L'utente autorizza OAuth 2.0. Oltre al consueto ambito glass.timeline, la tua applicazione richiede anche l'accesso all'ambito glass.location.
2. Appena dopo il completamento di OAuth 2.0, il servizio si abbona agli aggiornamenti sulla posizione dell'utente.
3. Successivamente, il servizio recupera l'ultima posizione dell'utente dall'endpoint di posizione.
4. Il tuo servizio cerca negozi di animali domestici vicino alla tua attività.
5. Il servizio crea una scheda timeline in cui sono elencati i risultati di ricerca relativi al negozio per animali. Per mantenere questa scheda sul lato sinistro dello schermo dell'orologio, il servizio blocca la scheda.
6. Quando l'utente si sposta, la sua ultima posizione viene aggiornata.
7. Poiché il servizio è registrato per gli aggiornamenti di posizione, viene inviata una notifica al servizio. Questa notifica rimanda all'elemento latest nella raccolta location.
8. In base alla notifica, il servizio recupera i location di latest dell'utente dalla raccolta di location.
9. Il tuo servizio cerca i negozi di animali domestici vicino al tuo utente.
10. Infine, il tuo servizio utilizza il metodo patch per aggiornare il corpo dell'elemento della sequenza temporale inserito nel passaggio 5.