Fornire attività di configurazione su Wear OS

Alcuni quadranti supportano parametri di configurazione per consentire agli utenti di personalizzare l'aspetto e il comportamento del quadrante. Ad esempio, alcuni quadranti consentono agli utenti di scegliere un colore di sfondo personalizzato. Altri quadranti che indicano l'ora di due diversi fusi orari consentono agli utenti di selezionare i fusi orari di loro interesse.

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 anche avviare l'attività di configurazione companion dall'app portatile, se installata. Inoltre, gli utenti possono configurare il quadrante nell'app complementare del dispositivo per i dispositivi Wear OS 3.

Nota: la configurazione nell'app complementare del dispositivo è disponibile sui dispositivi che hanno come target il livello API 30 e versioni successive. La configurazione su un'app portatile è disponibile su tutti i dispositivi.

Usa sessione editor

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

A questo scopo, un quadrante può fornire una configurazione Activity e consentire all'utente di modificare le impostazioni utilizzando un EditorSession restituito da EditorSession.createOnWatchEditorSession. Man mano che l'utente apporta modifiche, la chiamata a EditorSession.renderWatchFaceToBitmap fornisce un'anteprima in tempo reale del quadrante nell'editor Activity.

Specifica 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 nel 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 i filtri per intent per questo intent e il sistema attiva questo intent quando gli utenti vogliono configurare il quadrante.

Se il quadrante include solo un'attività di configurazione companion o indossabile, devi solo includere la voce dei 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 quadrante, in quanto i menu complessi sono difficili da navigare su schermi più piccoli. Nella tua attività di configurazione indossabile, fornisci opzioni binarie e solo poche selezioni per personalizzare gli aspetti principali del quadrante dell'orologio.

Per creare un'attività di configurazione indossabile, aggiungi una nuova attività al modulo dell'app indossabile e dichiara 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 semplice UI che consenta agli utenti di personalizzare il quadrante.

Crea un'attività di configurazione companion

Le attività di configurazione companion offrono agli utenti l'accesso al set completo di opzioni di configurazione per un quadrante, in quanto è più facile interagire con menu complessi sullo schermo più grande di un dispositivo portatile. Ad esempio, un'attività di configurazione su un dispositivo portatile ti consente di presentare agli utenti sofisticati selettori colori per scegliere il colore di sfondo di un quadrante.

Nota: le attività di configurazione possono essere scritte solo per i dispositivi portatili con Android come telefoni, tablet e pieghevoli.

Per creare un'attività di configurazione companion, aggiungi una nuova attività al modulo dell'app portatile e dichiara 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 un'interfaccia utente che fornisca opzioni per personalizzare tutti gli 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: