Udostępnia działania konfiguracyjne w Wear OS

Niektóre tarcze zegarka obsługują parametry konfiguracyjne, dzięki czemu użytkownicy mogą dostosować wygląd tarczy zegarka i działaniu. Na przykład niektóre tarcze zegarka pozwalają użytkownikom wybrać niestandardowy kolor tła. Inny powód tarcze zegarka z informacją o godzinie w dwóch strefach czasowych pozwalają użytkownikom wybrać produktów i usług, którymi użytkownik jest zainteresowany.

Tarcze zegarka, które obsługują parametry konfiguracji, umożliwiają użytkownikom dostosowanie tarczy zegarka za pomocą aktywność. Użytkownicy mogą uruchamiać na nim aktywność związaną z konfiguracją urządzenia do noszenia. Mogą rozpoczęcie aktywności konfiguracji towarzyszącej także z aplikacji podręcznej, jeśli została zainstalowana. Użytkownicy mogą też skonfigurować tarczę zegarka w aplikacji towarzyszącej urządzenia na Wear OS 3 urządzenia.

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

Użyj sesji edytora

Zdecydowanie zalecamy obsługę konfiguracji na zegarku, użytkownik może dostosować tarczę zegarka bez konieczności używania urządzenia towarzyszącego.

W tym celu tarcza zegarka może udostępnić konfigurację Activity i zezwolić użytkownik zmienił ustawienia za pomocą polecenia EditorSession zwróconego przez EditorSession.createOnWatchEditorSession. Gdy użytkownik wprowadza zmiany, EditorSession.renderWatchFaceToBitmap wyświetla podgląd tarczy zegarka na żywo w edytorze Activity.

Określ intencję dla działań związanych z konfiguracją

Jeśli tarcza zegarka zawiera aktywność związaną z konfiguracją, a Ty konfigurujesz tarczę zegarka z aplikacji towarzyszącej urządzeniu dodaj następujące wpisy metadanych do deklaracji usługi w plik manifestu aplikacji do noszenia:

<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 konfiguracyjne rejestrują filtry intencji dla tej intencji, a system uruchamia tę intencję podczas konfigurowania tarczy zegarka.

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

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

Aktywności związane z konfiguracją urządzenia do noszenia zapewniają ograniczony zestaw możliwości dostosowywania tarczy zegarka, ponieważ na mniejszych ekranach trudno jest poruszać się po złożonych menu. Na Twoim urządzeniu do noszenia działania konfiguracji, podać opcje binarne i tylko kilka głównych aspektów tarczy zegarka.

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

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

Nazwa działania w tym filtrze intencji musi wyglądać tak: androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR

W działaniach konfiguracyjnych utwórz prosty interfejs użytkownika, który daje użytkownikom możliwość wyboru dostosować tarczę zegarka.

Tworzenie aktywności związanej z konfiguracją kreacji towarzyszącej

Aktywności związane z konfiguracją elementów towarzyszących dają użytkownikom dostęp do pełnego zestawu opcji konfiguracji na tarczy zegarka. Korzystanie ze złożonych menu na większym ekranie urządzenia przenośnego. Aktywność konfiguracji na urządzeniu mobilnym pozwala na przykład pozwalają użytkownikom korzystać z zaawansowanych selektorów kolorów, aby mogli wybrać kolor tła tarczy zegarka.

Uwaga: działania konfiguracyjne można zapisywać tylko na urządzeniach mobilnych urządzeń z Androidem, takich jak telefony, tablety i urządzenia składane.

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

<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 konfiguracyjnej utwórz interfejs użytkownika z opcjami dostosowania wszystkich konfigurowalne elementy tarczy zegarka. Gdy użytkownicy dokonają wyboru, użyj interfejsu API warstwy danych do noszenia, aby informować o zmianie konfiguracji na tarczy zegarka.

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