Konfigurationsaktivitäten unter Wear OS bereitstellen

Einige Zifferblätter unterstützen Konfigurationsparameter, mit denen Nutzer das Zifferblatt anpassen können. Aussehen und Verhalten. Bei einigen Zifferblättern können Nutzer beispielsweise eine benutzerdefinierte Hintergrundfarbe auswählen. Sonstiges Zifferblätter, die die Uhrzeit für zwei verschiedene Zeitzonen anzeigen, lassen Nutzer die gewünschten Zeitzonen auswählen für das sie sich interessieren.

Bei Zifferblättern, die Konfigurationsparameter unterstützen, können Nutzer ein Zifferblatt mit einer Aktivität. Nutzer können die Wearable-Konfigurationsaktivität auf dem Wearable-Gerät starten. Sie können die Companion-Konfigurationsaktivität über die Handheld-App starten, falls diese installiert wurde Außerdem können Nutzer das Zifferblatt in der Companion-App des Geräts für Wear OS 3 konfigurieren Geräte.

Hinweis:Die Konfiguration in der Companion-App des Geräts ist verfügbar auf Geräte mit einem Ziel-API-Level 30 und höher. Die Konfiguration in einer Handheld-App ist auf allen Geräte.

Editorsitzung verwenden

Wir empfehlen dringend, die Konfiguration auf der Smartwatch zu unterstützen, damit die Nutzer können ihr Zifferblatt anpassen, ohne dass dafür ein Begleitgerät erforderlich ist.

Dazu kann ein Zifferblatt eine Activity-Konfiguration bereitstellen und Der Nutzer ändert die Einstellungen mit einer EditorSession, die von EditorSession.createOnWatchEditorSession Wenn der Nutzer Änderungen vornimmt, EditorSession.renderWatchFaceToBitmap bietet eine Livevorschau des Zifferblatts im Editor Activity.

Intent für Konfigurationsaktivitäten angeben

Wenn auf Ihrem Zifferblatt Konfigurationsaktivitäten enthalten sind und Sie es konfigurieren aus der Companion-App auf dem Gerät die folgenden Metadateneinträge zur Dienstdeklaration in Manifestdatei der Wearable-App:

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

Konfigurationsaktivitäten registrieren Intent-Filter für diesen Intent und das System löst diese Aktion aus wenn Nutzer das Zifferblatt konfigurieren möchten.

Wenn Ihr Zifferblatt nur eine Companion- oder Wearable-Konfigurationsaktivität enthält, muss der entsprechende Metadateneintrag aus dem vorherigen Beispiel enthalten sein.

Wearable-Konfigurationsaktivität erstellen

Wearable-Konfigurationsaktivitäten bieten eine begrenzte Anzahl von Anpassungsmöglichkeiten für eine Zifferblatt, da komplexe Menüs auf kleineren Bildschirmen schwer zu navigieren sind. In deinem Wearable Konfigurationsaktivitäten, bieten Sie binäre Auswahlmöglichkeiten und nur wenige Optionen zur Anpassung die wichtigsten Aspekte Ihres Zifferblatts.

Füge zum Erstellen einer Wearable-Konfigurationsaktivität eine neue Aktivität zu deinem Wearable-App-Modul hinzu. und deklariere den folgenden Intent-Filter in der Manifestdatei der Wearable-App:

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

Der Name der Aktion in diesem Intent-Filter muss androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR

Erstellen Sie in Ihrer Konfigurationsaktivität eine einfache Benutzeroberfläche, in der Nutzer auswählen können, Personalisiere dein Zifferblatt.

Companion-Konfigurationsaktivität erstellen

Die Companion-Konfigurationsaktivitäten bieten Nutzern Zugriff auf alle Konfigurationsoptionen für ein Zifferblatt, da die Interaktion mit komplexen Menüs auf dem größeren Bildschirm ein Handheld-Gerät. Beispielsweise können Sie mit einer Konfigurationsaktivität auf einem Handheld-Gerät Folgendes tun: Präsentieren Sie Nutzenden eine aufwendige Farbauswahl, um die Hintergrundfarbe eines Zifferblatts auszuwählen.

Hinweis:Konfigurationsaktivitäten können nur für Handhelds geschrieben werden. Geräte mit Android wie Smartphones, Tablets und faltbare Geräte.

Um eine Companion-Konfigurationsaktivität zu erstellen, fügen Sie Ihrem Handheld-App-Modul eine neue Aktivität hinzu und Deklariere den folgenden Intent-Filter in der Manifestdatei der Handheld-App:

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

Erstellen Sie in Ihrer Konfigurationsaktivität eine UI, die Optionen zum Anpassen aller konfigurierbaren Elementen deines Zifferblatts. Nachdem Nutzer eine Auswahl getroffen haben, verwenden Sie die Wearable Data Layer API, um der Zifferblattaktivität die Konfigurationsänderung mitteilen.

Weitere Informationen finden Sie in den folgenden verwandten Ressourcen: