Создайте службу циферблата

Циферблат — это услуга , включенная в приложение Wear OS . Когда пользователь выбирает доступный циферблат, он отображается и вызываются методы обратного вызова службы.

Когда пользователь устанавливает приложение Wear с циферблатами, циферблаты становятся доступными на часах с помощью переключателя циферблатов. Альтернативно, пользователь может выбрать циферблат из сопутствующего приложения на сопряженном телефоне.

На этой странице описано, как настроить проект Wear OS для включения циферблатов и как реализовать службу циферблата.

Создание проекта циферблата

Примечание. Мы рекомендуем использовать Android Studio для разработки Wear OS, поскольку она обеспечивает настройку проекта, включение библиотек и удобство упаковки.

Выполните следующие шаги, чтобы создать проект в Android Studio для циферблата:

1. Нажмите Файл > Создать > Новый проект .
2. В окне «Выбор шаблона проекта» выберите вкладку «Износ» , затем выберите «Циферблат» из списка параметров и нажмите «Далее» .
3. В окне «Настройка проекта» примите значения по умолчанию и нажмите « Готово» .

Android Studio создает проект с модулем app для службы циферблата.

Зависимости

Android Studio автоматически добавляет необходимые зависимости в ваши файлы build.gradle . В зависимости включена библиотека циферблатов AndroidX ; дополнительные сведения об этой библиотеке см. в примере кода на GitHub.

Справочник по API библиотеки поддержки носимых устройств

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

Объявить разрешения

Для циферблата требуется разрешение WAKE_LOCK . Добавьте следующее разрешение в файлы манифеста приложения Wear OS и приложения для мобильного телефона в элементе manifest :

<manifest ...>
    <uses-permission
        android:name="android.permission.WAKE_LOCK" />

    <!-- Required for complications to receive complication data and open the provider chooser. -->
    <uses-permission
        android:name="com.google.android.wearable.permission.RECEIVE_COMPLICATION_DATA"/>
    ...
</manifest>

Поддержка прямой загрузки

Перед разблокировкой пользователем необходимо сделать циферблат доступным, следуя инструкциям по прямой загрузке :

1. Установите для атрибута android:directBootAware значение true для вашей службы в манифесте.
2. Ваш циферблат должен хранить информацию в зашифрованном хранилище устройства .

Реализация службы и методов обратного вызова

Циферблаты в Wear OS реализованы как WatchFaceService . Для реализации WatchFaceService необходимо создать три объекта: UserStyleSchema , ComplicationSlotsManager и WatchFace .

Эти три объекта определяются путем переопределения трех абстрактных методов из WatchFaceService , как показано в следующем примере:

class CustomWatchFaceService : WatchFaceService() {

    /**
     * The specification of settings the watch face supports.
     * This is similar to a database schema.
     */
    override fun createUserStyleSchema(): UserStyleSchema = // ...

    /**
     * The complication slot configuration for the watchface.
     */
    override fun createComplicationSlotsManager(
        currentUserStyleRepository: CurrentUserStyleRepository
    ): ComplicationSlotsManager = // ...

    /**
     * The watch face itself, which includes the renderer for drawing.
     */
    override suspend fun createWatchFace(
        surfaceHolder: SurfaceHolder,
        watchState: WatchState,
        complicationSlotsManager: ComplicationSlotsManager,
        currentUserStyleRepository: CurrentUserStyleRepository
    ): WatchFace = // ...

}

<service
    android:name=".AnalogWatchFaceService"
    android:label="@string/analog_name"
    android:permission="android.permission.BIND_WALLPAPER" >
    <meta-data
        android:name="android.service.wallpaper"
        android:resource="@xml/watch_face" />
    <meta-data
        android:name="com.google.android.wearable.watchface.preview_circular"
        android:resource="@drawable/preview_analog_circular" />
    <intent-filter>
        <action android:name="android.service.wallpaper.WallpaperService" />
        <category
            android:name=
            "com.google.android.wearable.watchface.category.WATCH_FACE" />
    </intent-filter>
</service>

<?xml version="1.0" encoding="UTF-8"?>
<wallpaper xmlns:android="http://schemas.android.com/apk/res/android" />