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

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

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

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

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

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

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

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

Добавьте сюда кошку

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

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

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

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

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

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

Зоомагазины поблизости

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

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

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.