Udostępnia działania konfiguracyjne w Wear OS

Niektóre tarcze zegarka obsługują parametry konfiguracji, dzięki którym można dostosować wygląd i działanie tarczy. Na przykład niektóre tarcze zegarka umożliwiają użytkownikom wybranie niestandardowego koloru tła. Inne tarcze zegarka, które wskazują czas w dwóch różnych strefach czasowych, pozwalają użytkownikom wybrać strefy, które ich interesują.

Tarcze zegarka, które obsługują parametry konfiguracji, pozwalają użytkownikom dostosowywać tarczę za pomocą aktywności. Użytkownicy mogą rozpoczynać aktywność związaną z konfiguracją urządzenia do noszenia. Mogą też rozpocząć działanie konfiguracji towarzyszącej z poziomu aplikacji przenośnej, jeśli została ona zainstalowana. Użytkownicy mogą też skonfigurować tarczę zegarka w aplikacji towarzyszącej urządzenia z Wear OS 3.

Uwaga: konfiguracja w aplikacji towarzyszącej urządzenia jest dostępna na urządzeniach kierowanych na interfejs API na poziomie 30 lub wyższym. Konfiguracja aplikacji na urządzenia przenośne jest dostępna na wszystkich urządzeniach.

Użyj sesji edytora

Zdecydowanie zalecamy obsługę konfiguracji na zegarku, aby użytkownik mógł dostosować tarczę zegarka bez konieczności korzystania z urządzenia towarzyszącego.

Aby to obsługiwać, tarcza zegarka może udostępniać konfigurację Activity i umożliwić użytkownikowi zmianę ustawień za pomocą polecenia EditorSession zwróconego z EditorSession.createOnWatchEditorSession. Gdy użytkownik wprowadzi zmiany, wywołając EditorSession.renderWatchFaceToBitmap, wyświetli się podgląd tarczy na żywo w edytorze Activity.

Określanie intencji dla działań związanych z konfiguracją

Jeśli tarcza zegarka obejmuje działania konfiguracyjne i konfigurujesz ją w aplikacji towarzyszącej, do deklaracji usługi w pliku manifestu aplikacji do noszenia dodaj te wpisy metadanych:

<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>

Działania związane z konfiguracją rejestrują filtry intencji dla tej intencji, a system uruchamia tę intencję, gdy użytkownicy chcą skonfigurować tarczę zegarka.

Jeśli tarcza zegarka zawiera tylko aktywność towarzyszącą lub konfigurację urządzenia do noszenia, wystarczy dodać odpowiedni wpis metadanych z poprzedniego przykładu.

Utwórz aktywność związaną z konfiguracją urządzenia do noszenia

Aktywności konfiguracyjne na urządzeniach do noszenia oferują ograniczony zestaw opcji dostosowywania tarczy zegarka, ponieważ po złożonych menu trudno jest się poruszać na mniejszych ekranach. W swojej aktywności konfiguracyjnej urządzenia do noszenia podaj opcje binarne i tylko kilka, aby dostosować główne elementy tarczy zegarka.

Aby utworzyć aktywność związaną z konfiguracją urządzenia do noszenia, dodaj nową aktywność do modułu aplikacji do noszenia i zadeklaruj ten filtr intencji w pliku manifestu aplikacji:

<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>

Nazwą działania w tym filtrze intencji musi być androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR.

W swoim działaniu związanym z konfiguracją stwórz prosty interfejs z możliwością dostosowania tarczy zegarka.

Utwórz aktywność związaną z konfiguracją kreacji towarzyszącej

Aktywności konfiguracji towarzyszącej dają użytkownikom dostęp do pełnego zestawu opcji konfiguracji tarczy, ponieważ łatwiej jest korzystać ze złożonych menu na większym ekranie urządzenia mobilnego. Na przykład aktywność związana z konfiguracją na urządzeniu mobilnym umożliwia prezentowanie użytkownikom rozbudowanych selektorów kolorów, które pozwalają wybrać kolor tła tarczy zegarka.

Uwaga: aktywności konfiguracyjne można zapisywać tylko na urządzeniach mobilnych z Androidem, takich jak telefony, tablety czy urządzenia składane.

Aby utworzyć aktywność związaną z konfiguracją towarzyszącą, dodaj nową aktywność do modułu aplikacji na urządzenia przenośne i zadeklaruj w pliku manifestu aplikacji ten filtr intencji:

<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>

W aktywności związanej z konfiguracją utwórz interfejs, który udostępnia opcje dostosowywania wszystkich konfigurowalnych elementów tarczy zegarka. Gdy użytkownicy dokonają wyboru, użyj interfejsu Wearable Data Layer API, aby poinformować o zmianie konfiguracji aktywności tarczy zegarka.

Zapoznaj się z tymi powiązanymi materiałami: