Истории использования API

Mirror API предоставляет набор стандартных блоков, которые можно использовать для создания сервисов для Glass. Поскольку сервисы Glass, вероятно, отличаются от другого программного обеспечения, которое вы разработали, может быть неясно, как объединить функции Mirror API.

Многие службы попадают в несколько категорий использования API. Вот несколько историй, иллюстрирующих, как объединить функции Mirror API для создания сервисов Glass.

Факты о кошках

Доставка контента на временную шкалу Glass — это простое, но мощное использование Google Mirror API. Образец Cat Facts Glassware предоставляет пользователям факты о кошках и потенциально может следовать этому потоку:

1. Ваш пользователь посещает ваше веб-приложение и подписывается, аутентифицируясь с помощью OAuth 2.0.
2. Каждый час ваш сервис доставляет новый факт о коте на очки каждого из ваших пользователей.

Факты о кошках будут реализованы с использованием метода вставки временной шкалы:

1. Пользователи подписываются, аутентифицируясь с помощью OAuth 2.0
2. Cat Facts хранит индекс пользователей и их учетные данные.
3. Каждый час Cat Facts публикует новый Cat Fact. Это делается путем перебора всех сохраненных пользователей и вставки элемента временной шкалы в их временные шкалы.

Добавьте к этому кошку

Каждый шаг в технологическом прогрессе человечества обеспечивает более совершенные методы распространения фотографий кошек. Project Glass ничем не отличается.

Поскольку любая фотография лучше с кошкой, этот сервис позволяет пользователям скомпоновать случайное изображение кошки и фотографию, сделанную с помощью Glass.

1. Ваш пользователь посещает ваше веб-приложение и устанавливает Add a Cat to That, пройдя аутентификацию с помощью OAuth 2.0.
2. Ваш сервис создает новый контакт на Glass вашего пользователя под названием «Добавить к этому кошку».
3. Когда ваш пользователь делает фотографии, они делятся ими с помощью функции «Добавить кошку».
4. Ваш сервис накладывает случайное изображение кота на общую фотографию.
5. Наконец, ваш сервис доставляет фотографию с изображением кошки на устройство Glass вашего пользователя.

Архитектурно этот сервис будет следовать этому потоку API:

1. Ваш пользователь авторизуется с помощью OAuth 2.0. Ваш сервис хранит их учетные данные.
2. Сразу после завершения танца OAuth 2.0 ваша служба вставляет контакт под названием «Добавить к этому кошку».
3. Затем ваша служба подписывается на обновления на временной шкале этого пользователя, вставляя подписку на коллекцию timeline . Добавление кота к этому теперь полностью настроено.
4. Со временем ваш пользователь фотографирует.
5. Ваш пользователь поделился фотографией с помощью Add a Cat to That. Это делает карточку временной шкалы, связанную с этой фотографией, доступной для вашего сервиса.
6. Поскольку ваша служба подписана на обновления временной шкалы, в вашу службу отправляется уведомление. Это уведомление ссылается на элемент временной шкалы, содержащий общую фотографию.
7. Ваша служба проверяет уведомление и использует включенный id для получения карточки временной шкалы, содержащей фотографию.
8. Затем ваш сервис проверяет элемент временной шкалы и использует идентификатор вложения для получения байтов фотографии.
9. Ваш сервис выбирает случайное изображение кота и объединяет его в общую фотографию.
10. Наконец, ваш сервис создает новую карточку временной шкалы и вставляет ее в карточку временной шкалы вашего пользователя с прикрепленной фотографией с изображением кошки.

Примечание. В качестве дополнительного глупого бонуса вы можете добавить встроенный пункт меню SHARE на карточку временной шкалы. Это позволяет обмениваться фотографиями с изображениями кошек с другими службами или повторно использовать функцию «Добавить кошку к этому», чтобы добавить на фотографию несколько кошек.

Ближайшие зоомагазины

Есть только одна вещь лучше, чем факты о кошках или фотографии кошек, и это настоящие, физические, пушистые кошки. Mirror API может упростить эту задачу, гарантируя, что вы всегда будете знать, где находится ближайший зоомагазин.

Использование следует этому потоку:

1. Ваш пользователь посещает ваше веб-приложение и подписывается, аутентифицируясь с помощью OAuth 2.0.
2. Ваш сервис определяет местоположение пользователя.
3. Ваш сервис ищет зоомагазины рядом с этим местом.
4. Ваша служба вставляет слева от часов карточку со списком ближайших зоомагазинов.
5. Glass уведомляет ваш сервис о местоположении вашего пользователя.
6. Для каждого уведомления ваша служба повторяет поиск зоомагазина и обновляет закрепленную карточку, чтобы отразить новый набор ближайших зоомагазинов.

Реализация этой службы следует этому потоку API:

1. Ваш пользователь авторизуется с помощью OAuth 2.0. В дополнение к обычной области glass.timeline ваше приложение также запрашивает доступ к области glass.location .
2. Сразу после завершения танца OAuth 2.0 ваша служба подписывается на обновления местоположения вашего пользователя.
3. Затем ваша служба получает последнее местоположение вашего пользователя из конечной точки местоположения.
4. Ваш сервис ищет зоомагазины рядом с вашим пользователем.
5. Ваш сервис создает карточку timeline , в которой перечислены результаты поиска зоомагазина. Чтобы эта карточка оставалась в левой части экрана часов, ваша служба закрепляет эту карточку.
6. Когда ваш пользователь перемещается, его последнее местоположение обновляется.
7. Поскольку ваша служба подписана на обновления местоположения, в вашу службу отправляется уведомление. Это уведомление ссылается на latest элемент в коллекции location .
8. На основе уведомления ваша служба получает latest location вашего пользователя из коллекции location .
9. Затем ваш сервис ищет зоомагазины рядом с вашим пользователем.
10. Наконец, ваша служба использует метод patch для обновления тела элемента временной шкалы, вставленного на шаге 5.