Storie di utilizzo delle API

L'API Mirror fornisce un insieme di componenti di base che puoi utilizzare per creare servizi per Glass. Poiché i servizi Glass sono probabilmente diversi da altri software che hai sviluppato, potrebbe non essere ovvio come abbinare le funzionalità dell'API Mirror.

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

Informazioni sui gatti

L'invio di contenuti nella sequenza temporale di Glass è un uso semplice ma efficace dell'API Google Mirror. L'esempio di Cat Facts Glassware fornisce informazioni sui gatti agli utenti e potrebbe potresti seguire questa procedura:

1. L'utente visita la tua applicazione web e si abbona effettuando l'autenticazione con OAuth 2.0.
2. Ogni ora, ogni ora, il tuo servizio fornisce un nuovo Cat Fact a ciascuno dei tuoi utenti Vetro.

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

1. Gli utenti si abbonano mediante l'autenticazione con OAuth 2.0
2. Cat Facts archivia un indice di utenti e le relative credenziali
3. Ogni ora Cat Facts pubblica un nuovo Cat Fact. A tale scopo, esegue l'iterazione di tutti gli utenti archiviati e inserisce un elemento della sequenza temporale nelle sequenze temporali.

Aggiungi un gatto

Ogni passo nel progresso tecnologico umano offre metodi migliori per la distribuzione delle foto di gatti. Lo stesso vale per Project Glass.

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

1. L'utente visita la tua applicazione web e installa "Add a That" effettuando l'autenticazione con OAuth 2.0.
2. Il servizio crea un nuovo contatto sul dispositivo Glass dell'utente chiamato "Add a Cat to That".
3. Quando un utente scatta delle foto, le condivide con "Aggiungi un gatto".
4. Il tuo servizio compone l'immagine casuale di un gatto sulla foto condivisa.
5. Infine, il servizio invia la foto migliorata ai gatti su Glass dell'utente.

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

1. L'utente autorizza con OAuth 2.0. Il servizio archivia le relative credenziali.
2. Subito dopo il completamento della verifica tramite OAuth 2.0, il servizio inserisce un contatto chiamato "Add a Cat to That".
3. In seguito, il servizio si iscrive agli aggiornamenti della sequenza temporale di questo utente inserendo un abbonamento per la raccolta timeline. La configurazione della funzione "Aggiungi un gatto a" è stata completata.
4. Nel tempo, gli utenti scattano fotografie.
5. L'utente condivide una foto con "Aggiungi un gatto". In questo modo, la scheda della sequenza temporale associata a questa foto diventa accessibile al tuo servizio.
6. Poiché il servizio è abbonato agli aggiornamenti della cronologia, viene inviata una notifica al servizio. Questa notifica rimanda all'elemento della sequenza temporale contenente la foto condivisa.
7. Il servizio esamina la notifica e utilizza l'elemento id incluso 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 fotografia condivisa.
10. Infine, il servizio crea una nuova scheda della sequenza temporale e la inserisce nella scheda della sequenza temporale dell'utente con allegata la foto migliorata del gatto.

Nota: come bonus extra, puoi aggiungere la voce di menu SHARE integrata alla scheda della sequenza temporale. In questo modo le foto migliorate dai gatti possono essere condivise con altri servizi o condivise ripetutamente con "Aggiungi un gatto a quello" per aggiungere più gatti a una foto.

Negozi di animali nelle vicinanze

Esiste solo una cosa migliore dei fatti sui gatti o delle immagini di gatti, e cioè gatti reali, fisici e pelosi. Con l'API Mirror questa operazione ti consente di sapere sempre dove si trova il negozio di animali più vicino.

L'utilizzo segue questo flusso:

1. L'utente visita la tua applicazione web e si abbona effettuando l'autenticazione con OAuth 2.0.
2. Il servizio determina la posizione dell'utente.
3. Il servizio cerca negozi per animali nelle vicinanze di quella località.
4. Il servizio inserisce a sinistra dell'orologio una scheda che elenca i negozi di animali nelle vicinanze.
5. Glass invia una notifica al servizio riguardante la posizione dell'utente.
6. Per ogni notifica, il servizio ripete la ricerca di negozi 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 dell'API:

1. L'utente autorizza con OAuth 2.0. Oltre al consueto ambito glass.timeline, la tua applicazione richiede anche l'accesso all'ambito glass.location.
2. Subito dopo il completamento della verifica tramite OAuth 2.0, il servizio si iscrive agli aggiornamenti relativi alla località dell'utente.
3. Successivamente, il servizio recupera l'ultima posizione dell'utente dall'endpoint di località.
4. Il servizio cerca negozi per animali nelle vicinanze dell'utente.
5. Il servizio crea una scheda timeline che elenca i risultati di ricerca relativi ai negozi di animali. Per mantenere questa carta sul lato sinistro della schermata dell'orologio, il tuo servizio la blocca.
6. Mentre l'utente si sposta, la sua ultima posizione viene aggiornata.
7. Poiché il servizio è abbonato agli 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 l'elemento latest dell'utente latest dalla raccolta location.location
9. Successivamente, il servizio cerca negozi per animali nelle vicinanze dell'utente.
10. Infine, il servizio utilizza il metodo patch per aggiornare il corpo dell'elemento della sequenza temporale inserito nel passaggio 5.