Historias de uso de las API

La API de Mirror proporciona un conjunto de componentes básicos que puedes usar a fin de crear servicios para Glass. Debido a que los servicios de Glass probablemente son diferentes de otro software que hayas desarrollado, puede que no sea obvio cómo unir las características de la API de Mirror.

Muchos servicios se dividen en algunas categorías de uso de API. A continuación, se incluyen algunas historias que ilustran cómo combinar las funciones de la API de Mirror para crear servicios de Glass.

Datos sobre gatos

La entrega de contenido al cronograma de Glass es un uso simple pero potente de la API de Google Mirror. La muestra de Glassware de Cat Facts brinda datos a los usuarios sobre gatos y podría podrías seguir este flujo:

1. El usuario visita tu aplicación web y se suscribe a través de la autenticación con OAuth 2.0.
2. Cada hora, a cada hora, tu servicio entrega un nuevo dato sobre gatos a cada uno de los datos de acceso de tus usuarios. Vidrio.

Cat Facts se implementaría usando el método de inserción de cronograma:

1. Los usuarios se suscriben a través de la autenticación con OAuth 2.0
2. Cat Facts almacena un índice de usuarios y sus credenciales
3. Cada hora, Cat Facts publica un nuevo Cat Fact. Para ello, itera a través de todos los usuarios almacenados y, luego, inserta un elemento de cronograma en sus cronogramas.

Agrégale un gato

Cada paso en el avance tecnológico humano proporciona métodos mejorados para la distribución de fotos de gatos. Project Glass no es la excepción.

Como cada fotografía es mejor con un gato, este servicio permite a los usuarios componer una imagen aleatoria de un gato y una fotografía que hayan tomado con Glass.

1. El usuario visita tu aplicación web y, luego, instala Add a Cat to That mediante la autenticación con OAuth 2.0.
2. El servicio crea un contacto nuevo en el Glass del usuario llamado "Add a Cat to That".
3. A medida que el usuario toma fotos, las comparte con Add a Cat to That.
4. Tu servicio compone una imagen aleatoria de un gato en la fotografía compartida.
5. Por último, tu servicio envía una foto mejorada con gato al Glass del usuario.

A nivel arquitectónico, este servicio seguiría este flujo de API:

1. Tu usuario lo autoriza con OAuth 2.0. Tu servicio almacena sus credenciales.
2. Justo después de que finaliza el baile de OAuth 2.0, tu servicio inserta un contacto llamado "Add a Cat to That".
3. A continuación, tu servicio se suscribe a las actualizaciones del cronograma de este usuario mediante la inserción de una suscripción para la colección timeline. Add a Cat to That ya está completamente configurado.
4. Con el tiempo, el usuario toma fotografías.
5. Tu usuario comparte una foto con Add a Cat to That. De esta forma, tu servicio podrá acceder a la tarjeta de rutas asociada a esta foto.
6. Debido a que tu servicio está suscrito a las actualizaciones de la línea de tiempo, se envía una notificación a tu servicio. Esta notificación se vincula al elemento de la línea de tiempo que contiene la foto compartida.
7. Tu servicio examina la notificación y usa el id incluido para recuperar la tarjeta del cronograma que contiene la foto.
8. A continuación, tu servicio examina el elemento del cronograma y usa el ID del archivo adjunto para recuperar los bytes de la fotografía.
9. Tu servicio selecciona una imagen aleatoria de un gato y la compone en la fotografía compartida.
10. Por último, tu servicio crea una nueva tarjeta de cronograma y la inserta en la tarjeta del cronograma del usuario con la foto mejorada con gato adjunta.

Nota: Como beneficio adicional, puedes agregar el elemento de menú integrado SHARE a la tarjeta de cronograma. Esto permite que las fotos mejoradas de gatos se compartan con otros servicios o se compartan repetidamente con Add a Cat to That para agregar varios gatos a una foto.

Tiendas de mascotas cercanas

Solo hay una cosa mejor que los datos sobre gatos o imágenes de gatos: los gatos reales, físicos y peludos. La API de Mirror puede facilitar esta tarea, ya que garantiza que siempre sepas dónde se encuentra la tienda de mascotas más cercana.

El uso sigue este flujo:

1. El usuario visita tu aplicación web y se suscribe a través de la autenticación con OAuth 2.0.
2. Tu servicio determina la ubicación del usuario.
3. Tu servicio busca tiendas de mascotas cerca de esa ubicación.
4. Tu servicio inserta una tarjeta a la izquierda del reloj que indica las tiendas de mascotas cercanas.
5. Glass notifica al servicio sobre la ubicación del usuario.
6. Para cada notificación, tu servicio repite la búsqueda de la tienda de mascotas y actualiza la tarjeta fijada para reflejar el nuevo conjunto de tiendas de mascotas más cercanas.

La implementación de este servicio sigue este flujo de API:

1. Tu usuario lo autoriza con OAuth 2.0. Además del alcance glass.timeline habitual, tu aplicación también solicita el acceso al alcance glass.location.
2. Justo después de que finaliza el proceso de baile de OAuth 2.0, tu servicio se suscribe a las actualizaciones sobre la ubicación del usuario.
3. A continuación, tu servicio recuperará la ubicación más reciente del usuario desde el extremo de ubicación.
4. Tu servicio busca tiendas de mascotas cerca del usuario.
5. Tu servicio crea una tarjeta timeline que enumera los resultados de la búsqueda de la tienda de mascotas. Para mantener esta tarjeta en el lado izquierdo de la pantalla del reloj, el servicio la fijará.
6. A medida que el usuario se desplaza, se actualiza su ubicación más reciente.
7. Como tu servicio está suscrito a las actualizaciones de ubicación, se enviará una notificación a tu servicio. Esta notificación vincula al elemento latest de la colección location.
8. En función de la notificación, tu servicio recupera el latest location de tu usuario de la colección location.
9. A continuación, tu servicio busca tiendas de mascotas cerca del usuario.
10. Por último, tu servicio usa el método patch para actualizar el cuerpo del elemento de cronograma insertado en el paso 5.