Настройте приложение на телефоне для Watch Face Push

Для канонического рынка основным способом взаимодействия пользователя с приложением является приложение для телефона.

Установить циферблат

Когда пользователь выбирает циферблат в приложении для телефона, последующий процесс настройки циферблата состоит из двух этапов:

  1. Установка: Установите циферблат с помощью Watch Face Push, инициированного через MessageClient . Этот шаг прост, используйте addWatchFace или updateWatchFace , инициируемый с помощью MessageClient с телефона на часы.
  2. Активация: Установите установленный циферблат как активный . Этот шаг имеет несколько возможных путей в зависимости от состояния разрешения:
    • Возможно, никаких действий не требуется . Маркетплейс уже может контролировать активный циферблат.
    • Вмешательство пользователя может не потребоваться . Приложение имеет необходимые разрешения для установки активного циферблата и может сделать это напрямую с помощью setWatchFaceAsActive() .
    • Возможно, вам потребуются указания относительно того, как принимать запросы на разрешения или как вручную настроить циферблат с помощью долгого нажатия или через сопутствующее приложение.

Установка ответа

Для облегчения фазы активации фаза установки должна вернуть следующую информацию с часов на телефон:

  • Результат попытки установки
  • Результат isWatchFaceActive() — определяет, есть ли у приложения активный циферблат.
  • Вызывался ли setWatchFaceAsActive() ранее — приложение Wear OS должно отслеживать и сохранять эту информацию локально. Этот вызов API можно использовать только один раз.

Активация

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

Сценарий 1: Все попытки установить активный циферблат исчерпаны

Если в ответе от установки указано, что setWatchFaceAsActive() уже вызывался ранее, то кнопка должна открывать обучающий экран на телефоне, показывающий пользователю, как нажать и удерживать циферблат, чтобы вручную установить его на нужный ему вариант.

Сценарий 2. Попробуйте установить активный циферблат

Телефон должен дать указание часам проверить наличие необходимого разрешения SET_PUSHED_WATCH_FACE_AS_ACTIVE :

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

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

    • Если пользователь предоставляет разрешение, часы должны вызвать setWatchFaceAsActive() .
    • В противном случае часы должны дать указание телефону отобразить обучающий экран, объясняющий необходимость разрешения и как вручную предоставить его.