Historias de uso de las API

La API de Mirror proporciona un conjunto de componentes básicos que puedes usar a fin de compilar servicios para Glass. Debido a que los servicios de Glass probablemente sean diferentes de otros programas que has desarrollado, puede que no sea evidente cómo ajustar las funciones de la API de Mirror.

Muchos servicios se incluyen en algunas categorías de uso de la API. Estas son algunas historias que ilustran cómo combinar las funciones de la API de Mirror para crear servicios de Glass.

Datos sobre gatos

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

1. Tu usuario visita tu aplicación web y se suscribe mediante la autenticación con OAuth 2.0.
2. Cada hora, en cada hora, tu servicio brinda un nuevo dato curioso sobre el vidrio a cada uno de los usuarios de Glass.

Cat Facts se implementará mediante el método de inserción de cronograma:

1. Los usuarios se suscriben autenticando con OAuth 2.0
2. Cat Facts almacena un índice de usuarios y sus credenciales
3. Cada hora, Cat Facts publica un nuevo dato curioso sobre gatos. Para ello, itera a través de todos los usuarios almacenados e inserta un elemento de cronograma en sus líneas de tiempo.

Agrega un gato a eso

Cada paso del avance tecnológico humano proporciona métodos mejorados para la distribución de fotos de gatos. El proyecto Glass no es diferente.

Dado que cada fotografía es mejor con un gato, este servicio permite a los usuarios crear una imagen de gato al azar y una foto que hayan tomado con Glass.

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

A nivel de arquitectura, este servicio seguiría este flujo de API:

1. Tu usuario autoriza con OAuth 2.0. Tu servicio almacena sus credenciales.
2. Justo después de que se complete 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 de las rutas de este usuario. Para ello, inserta una suscripción para la colección timeline. La función para agregar un gato a eso ya está completamente configurada.
4. Con el tiempo, el usuario toma fotografías.
5. Tu usuario comparte una foto con la opción Agregar un gato. Esto permite que tu servicio pueda acceder a la tarjeta de cronograma asociada con esta foto.
6. Como tu servicio está suscrito a las actualizaciones de cronograma, se le envía una notificación al servicio. Esta notificación incluye un vínculo al elemento de la línea de tiempo que contiene la foto compartida.
7. El servicio examina la notificación y usa el objeto id incluido para recuperar la tarjeta de cronograma que contiene la foto.
8. A continuación, el servicio examina el elemento de la línea de tiempo y usa el ID del archivo adjunto para obtener 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 de cronograma del usuario con la foto mejorada para gatos.

Nota: Como beneficio adicional, puedes agregar el elemento de menú integrado SHARE a la tarjeta del cronograma. Esto permite que las fotos mejoradas con gatos se compartan con otros servicios o que se compartan de forma reiterada con "Agregar un gato a eso" 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, que son los gatos reales, físicos y peludos. La API de Mirror hace que esto sea más fácil, ya que se asegura de que siempre sepa dónde está la tienda de mascotas más cercana.

El uso sigue este flujo:

1. Tu usuario visita tu aplicación web y se suscribe mediante 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. El servicio inserta una tarjeta a la izquierda del reloj para enumerar las tiendas de mascotas cercanas.
5. Glass notifica a tu servicio sobre la ubicación de tu usuario.
6. Para cada notificación, el 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 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 finalice el baile de OAuth 2.0, tu servicio se suscribe a las actualizaciones sobre la ubicación de tu usuario.
3. A continuación, tu servicio recupera la ubicación más reciente del usuario desde el extremo de ubicación.
4. Tu servicio busca tiendas de mascotas cerca de tu usuario.
5. Tu servicio crea una tarjeta timeline que muestra los resultados de la búsqueda de la tienda de mascotas. Para que esta tarjeta aparezca en el lado izquierdo de la pantalla del reloj, el servicio debe fijarla.
6. Cuando tu usuario se desplaza, su ubicación más reciente se actualiza.
7. Como el servicio está suscrito a las actualizaciones de ubicación, se le envía una notificación al servicio. Esta notificación incluye un vínculo al elemento latest de la colección location.
8. Según la notificación, tu servicio recupera el location de latest de tu usuario de la colección location.
9. A continuación, tu servicio busca tiendas de mascotas cerca de tu usuario.
10. Por último, tu servicio usa el método patch para actualizar el cuerpo del elemento de cronograma que se insertó en el paso 5.