Konfigurationsaktivitäten unter Wear OS bereitstellen

Einige Zifferblätter unterstützen Konfigurationsparameter, mit denen Nutzer Aussehen und Verhalten des Zifferblatts anpassen können. Bei einigen Zifferblättern können Nutzer beispielsweise eine benutzerdefinierte Hintergrundfarbe auswählen. Bei anderen Zifferblättern, die die Uhrzeit für zwei verschiedene Zeitzonen angeben, können Nutzer die für sie interessanten Zeitzonen auswählen.

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

Hinweis: Die Konfiguration in der Companion-App des Geräts ist auf Geräten verfügbar, die auf API-Level 30 oder höher ausgerichtet sind. Handheld-Apps können auf allen Geräten konfiguriert werden.

Editorsitzung verwenden

Wir empfehlen dringend, die Konfiguration auf der Smartwatch zu unterstützen, damit Nutzer ihr Zifferblatt anpassen können, ohne ein Begleitgerät zu benötigen.

Dazu kann auf einem Zifferblatt eine Activity konfiguriert werden. Der Nutzer kann die Einstellungen dann mit einem EditorSession ändern, das von EditorSession.createOnWatchEditorSession zurückgegeben wird. Wenn der Nutzer Änderungen vornimmt, wird durch das Aufrufen von EditorSession.renderWatchFaceToBitmap eine Livevorschau des Zifferblatts im Editor Activity angezeigt.

Intent für Konfigurationsaktivitäten angeben

Wenn das Zifferblatt Konfigurationsaktivitäten enthält und Sie es über die Companion-App des Geräts konfigurieren, fügen Sie der Dienstdeklaration in der Manifestdatei der Wearable-App die folgenden Metadateneinträge hinzu:

<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. Das System löst diesen Intent aus, wenn Nutzer Ihr Zifferblatt konfigurieren möchten.

Wenn Ihr Zifferblatt nur eine Companion- oder eine Wearable-Konfigurationsaktivität enthält, müssen Sie nur den entsprechenden Metadateneintrag aus dem vorherigen Beispiel einbeziehen.

Wearable-Konfigurationsaktivität erstellen

Wearable-Konfigurationsaktivitäten bieten nur begrenzte Anpassungsmöglichkeiten für ein Zifferblatt, da komplexe Menüs auf kleineren Bildschirmen schwer zu navigieren sind. Gib in deiner Wearable-Konfigurationsaktivität binäre Optionen und nur ein paar Auswahlmöglichkeiten an, um die Hauptaspekte deines Zifferblatts anzupassen.

Um eine Wearable-Konfigurationsaktivität zu erstellen, fügen Sie Ihrem Wearable-App-Modul eine neue Aktivität hinzu und deklarieren Sie 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 sein.

Erstellen Sie in Ihrer Konfigurationsaktivität eine einfache Benutzeroberfläche, über die Nutzer das Zifferblatt anpassen können.

Companion-Konfigurationsaktivität erstellen

Companion-Konfigurationsaktivitäten geben Nutzern Zugriff auf alle Konfigurationsoptionen für ein Zifferblatt, da die Interaktion mit komplexen Menüs auf dem größeren Bildschirm eines Handheld-Geräts einfacher ist. Bei einer Konfigurationsaktivität auf einem Handheld-Gerät können Sie Nutzern beispielsweise eine ausgefeilte Farbauswahl zur Auswahl der Hintergrundfarbe eines Zifferblatts anbieten.

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

Um eine Companion-Konfigurationsaktivität zu erstellen, fügen Sie Ihrem Handheld-App-Modul eine neue Aktivität hinzu und deklarieren Sie 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>

Erstelle in deiner Konfigurationsaktivität eine UI, die Optionen zum Anpassen aller konfigurierbaren Elemente des Zifferblatts bietet. Nachdem Nutzer eine Auswahl getroffen haben, verwenden Sie die Wearable Data Layer API, um die Konfigurationsänderung an die Zifferblattaktivität zu kommunizieren.

Weitere Informationen finden Sie in den folgenden Ressourcen: