Fornire attività di configurazione su Wear OS

Alcuni quadranti supportano i parametri di configurazione per consentire agli utenti di personalizzare il modo appare e si comporta. Ad esempio, alcuni quadranti consentono agli utenti di scegliere un colore di sfondo personalizzato. Altro quadranti che indicano l'ora di due diversi fusi orari consentono agli utenti di selezionare i fusi orari a cui sono interessati.

I quadranti che supportano i parametri di configurazione consentono agli utenti di personalizzare un quadrante utilizzando un'attività. Gli utenti possono avviare l'attività di configurazione indossabile sul dispositivo indossabile. Possono consente anche di avviare l'attività di configurazione dell'app complementare dall'app portatile, se è stata installata. Inoltre, gli utenti possono configurare il quadrante nell'app complementare del dispositivo per Wear OS 3 dispositivi mobili.

Nota:la configurazione nell'app complementare del dispositivo è disponibile su Dispositivi con livello API target 30 o superiore. La configurazione su un'app portatile è disponibile su tutti dispositivi mobili.

Utilizza sessione editor

Ti consigliamo vivamente di supportare la configurazione sullo smartwatch in modo che l'utente può personalizzare il proprio quadrante senza richiedere un dispositivo associato.

A questo scopo, un quadrante può fornire una configurazione Activity e consentire l'utente modifica le impostazioni utilizzando un valore EditorSession restituito da EditorSession.createOnWatchEditorSession Quando l'utente apporta modifiche, la chiamata EditorSession.renderWatchFaceToBitmap fornisce un'anteprima in tempo reale del quadrante nell'editor Activity.

Specificare un intent per le attività di configurazione

Se il quadrante include attività di configurazione e stai configurando il quadrante dall'app complementare del dispositivo, aggiungi le seguenti voci di metadati alla dichiarazione del servizio in il file manifest dell'app indossabile:

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

Le attività di configurazione registrano filtri per intent per questo intent, che il sistema attiva quando gli utenti vogliono configurare il quadrante.

Se il quadrante include solo un'attività di configurazione companion o indossabile, e devi includere la voce di metadati corrispondente dell'esempio precedente.

Crea un'attività di configurazione indossabile

Le attività di configurazione degli indossabili offrono un insieme limitato di scelte di personalizzazione per un perché è difficile navigare su schermi più piccoli con menu complessi. Nel tuo dispositivo indossabile configurazione dell'attività, fornire scelte binarie e solo poche selezioni per personalizzare gli aspetti principali del quadrante.

Per creare un'attività di configurazione indossabile, aggiungi una nuova attività al modulo dell'app indossabile e dichiarare il seguente filtro per intent nel file manifest dell'app indossabile:

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

Il nome dell'azione in questo filtro per intent deve essere androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR.

Nell'attività di configurazione, crea una UI semplice che fornisca agli utenti selezioni personalizza il tuo quadrante.

Creare un'attività di configurazione companion

Le attività di configurazione companion consentono agli utenti di accedere all'insieme completo delle scelte di configurazione per un quadrante, perché è più facile interagire con menu complessi sullo schermo più grande un dispositivo portatile. Ad esempio, un'attività di configurazione su un dispositivo portatile consente di Presentano agli utenti sofisticati selettori di colori per scegliere il colore di sfondo di un quadrante.

Nota: le attività di configurazione possono essere scritte solo per dispositivi portatili I dispositivi con sistema operativo Android, ad esempio smartphone, tablet e pieghevoli.

Per creare un'attività di configurazione complementare, aggiungi una nuova attività al modulo dell'app portatile e dichiarare il seguente filtro per intent nel file manifest dell'app portatile:

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

Nell'attività di configurazione, crea una UI che fornisca opzioni per personalizzare elementi configurabili del quadrante. Dopo che gli utenti hanno effettuato una selezione, utilizza l'API Wearable Data Layer per comunicare la modifica della configurazione all'attività del quadrante.

Consulta le seguenti risorse correlate: