Zifferblattdienst erstellen

Ein Zifferblatt ist ein Dienst die in einer Wear OS-App verpackt sind. Wenn ein Nutzer ein verfügbares Zifferblatt auswählt, wird das Zifferblatt Callback-Methoden des Dienstes aufgerufen.

Wenn ein Nutzer eine Wear-App mit Zifferblättern installiert, wird die Smartwatch Zifferblätter sind auf der Uhr über die Zifferblattauswahl verfügbar. Alternativ kann der Nutzer ein Zifferblatt aus einer Companion-App auf dem gekoppelten Smartphone auswählen.

Auf dieser Seite wird beschrieben, wie du ein Wear OS-Projekt so konfigurierst, dass Zifferblätter enthalten um ein Zifferblatt zu implementieren.

Zifferblatt-Projekt erstellen

Hinweis:Wir empfehlen die Verwendung von Android Studio für die Wear OS-Entwicklung, da Sie umfasst die Projekteinrichtung, die Einbindung von Bibliotheken und die Paketerstellung.

Führen Sie die folgenden Schritte aus, um Projekt erstellen in Android Studio für Ihr Zifferblatt:

1. Klicken Sie auf Datei > Neu > Neues Projekt.
2. Wählen Sie im Fenster Projektvorlage auswählen die Option den Tab Wear und wählen Sie Zifferblatt und klicken Sie in der Liste der Optionen auf Weiter.
3. Akzeptieren Sie die Änderungen im Fenster Projekt konfigurieren. und klicken Sie auf Fertigstellen.

Android Studio erstellt ein Projekt mit einem app-Modul für den Zifferblattdienst.

Abhängigkeiten

Android Studio fügt die erforderlichen Abhängigkeiten automatisch in build.gradle hinzu Dateien. In den Abhängigkeiten ist Folgendes enthalten: AndroidX Zifferblattbibliothek sieh dir die <ph type="x-smartling-placeholder"></ph> Codebeispiel auf GitHub finden Sie weitere Informationen zu dieser Bibliothek.

API-Referenz der Wearable-Supportbibliothek

Die Referenzdokumentation enthält detaillierte Informationen zu den Klassen, die Sie für die Zifferblätter implementieren. In der API-Referenz für die Wearable-Supportbibliothek.

Erklärung von Berechtigungen

Für Zifferblätter ist die Berechtigung WAKE_LOCK erforderlich. Füge den Manifestdateien der Wear OS-App die folgende Berechtigung hinzu: und die mobile App unter dem Element manifest:

<manifest ...>
    <uses-permission
        android:name="android.permission.WAKE_LOCK" />

    <!-- Required for complications to receive complication data and open the provider chooser. -->
    <uses-permission
        android:name="com.google.android.wearable.permission.RECEIVE_COMPLICATION_DATA"/>
    ...
</manifest>

Direct-Boot-Unterstützung

Sie müssen Ihr Zifferblatt vor dem Entsperren durch den Nutzer verfügbar machen. Gehen Sie dazu so vor: Direct Boot-Anleitung:

1. Setzen Sie das Attribut android:directBootAware für Ihren Dienst intrue in deinem Manifest.
2. Auf deinem Zifferblatt sollten Informationen in gespeichert werden Verschlüsselter Speicher Ihres Geräts.

Dienst- und Callback-Methoden implementieren

Zifferblätter in Wear OS sind als WatchFaceService Für die Implementierung von WatchFaceService müssen drei Objekte erstellt werden: ein UserStyleSchema, ComplicationSlotsManager und WatchFace.

Diese drei Objekte werden angegeben, indem drei abstrakte Methoden aus WatchFaceService, wie im folgenden Beispiel gezeigt:

class CustomWatchFaceService : WatchFaceService() {

    /**
     * The specification of settings the watch face supports.
     * This is similar to a database schema.
     */
    override fun createUserStyleSchema(): UserStyleSchema = // ...

    /**
     * The complication slot configuration for the watchface.
     */
    override fun createComplicationSlotsManager(
        currentUserStyleRepository: CurrentUserStyleRepository
    ): ComplicationSlotsManager = // ...

    /**
     * The watch face itself, which includes the renderer for drawing.
     */
    override suspend fun createWatchFace(
        surfaceHolder: SurfaceHolder,
        watchState: WatchState,
        complicationSlotsManager: ComplicationSlotsManager,
        currentUserStyleRepository: CurrentUserStyleRepository
    ): WatchFace = // ...

}

<service
    android:name=".AnalogWatchFaceService"
    android:label="@string/analog_name"
    android:permission="android.permission.BIND_WALLPAPER" >
    <meta-data
        android:name="android.service.wallpaper"
        android:resource="@xml/watch_face" />
    <meta-data
        android:name="com.google.android.wearable.watchface.preview_circular"
        android:resource="@drawable/preview_analog_circular" />
    <intent-filter>
        <action android:name="android.service.wallpaper.WallpaperService" />
        <category
            android:name=
            "com.google.android.wearable.watchface.category.WATCH_FACE" />
    </intent-filter>
</service>

<?xml version="1.0" encoding="UTF-8"?>
<wallpaper xmlns:android="http://schemas.android.com/apk/res/android" />