Предоставление действий по настройке Wear OS.

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

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

Примечание. Конфигурация приложения-компаньона устройства доступна на устройствах, ориентированных на уровень API 30 и выше. Конфигурация портативного приложения доступна на всех устройствах.

Использовать сеанс редактора

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

Для поддержки этого циферблат может предоставить Activity конфигурации и позволить пользователю изменять настройки с помощью EditorSession , возвращаемого из EditorSession.createOnWatchEditorSession . Когда пользователь вносит изменения, вызов EditorSession.renderWatchFaceToBitmap обеспечивает предварительный просмотр циферблата в реальном времени в редакторе Activity .

Укажите цель действий по настройке

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

<service>
    <meta-data
        android:name="com.google.android.wearable.watchface.wearableConfigurationAction"
        android:value="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
    <meta-data
        android:name="com.google.android.wearable.watchface.companionBuiltinConfigurationEnabled"
        android:value="true" />
</service>

Действия по настройке регистрируют фильтры намерений для этого намерения, и система активирует это намерение, когда пользователи хотят настроить ваш циферблат.

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

Создайте действие по настройке носимых устройств

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

Чтобы создать действие настройки носимого устройства, добавьте новое действие в модуль носимого приложения и объявите следующий фильтр намерений в файле манифеста носимого приложения:

<activity
    android:name=".DigitalWatchFaceWearableConfigActivity"
    android:label="@string/digital_config_name">
    <intent-filter>
        <action android:name="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
        <category android:name=
        "com.google.android.wearable.watchface.category.WEARABLE_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

Имя действия в этом фильтре намерений должно быть androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR .

В процессе настройки создайте простой пользовательский интерфейс, который предоставляет пользователям возможность настроить циферблат.

Создайте действие по настройке сопутствующего товара

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

Примечание. Действия по настройке можно записать только для портативных устройств под управлением Android, таких как телефоны, планшеты и складные устройства.

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

<activity
    android:name=".DigitalWatchFaceCompanionConfigActivity"
    android:label="@string/app_name">
    <intent-filter>
        <action android:name=
            "com.example.android.wearable.watchface.CONFIG_DIGITAL" />
        <category android:name=
        "com.google.android.wearable.watchface.category.COMPANION_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

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

Обратитесь к следующим соответствующим ресурсам: