Proposer des activités de configuration sur Wear OS

Certains cadrans proposent des paramètres de configuration permettant de personnaliser leur apparence et leur comportement. Par exemple, certains cadrans permettent de choisir une couleur d'arrière-plan personnalisée. D'autres, qui indiquent l'heure pour deux fuseaux horaires différents, permettent aux utilisateurs de sélectionner les fuseaux horaires qui les intéressent.

Les cadrans qui proposent des paramètres de configuration permettent aux utilisateurs de les personnaliser à l'aide d'une activité. Les utilisateurs peuvent lancer l'activité de configuration sur l'appareil connecté. Ils peuvent également lancer l'activité de configuration associée depuis l'application portable, si celle-ci a été installée. De plus, les utilisateurs peuvent configurer le cadran dans l'application associée pour les appareils Wear OS 3.

Remarque : La configuration dans l'application associée est disponible sur les appareils qui ciblent le niveau d'API 30 ou supérieur. La configuration dans une application portable est disponible sur tous les appareils.

Utiliser la session d'édition

Nous vous recommandons vivement de prendre en charge la configuration sur la montre connectée afin que l'utilisateur puisse personnaliser son cadran sans nécessiter d'appareil associé.

Pour ce faire, un cadran peut fournir une configuration Activity et permettre à l'utilisateur de modifier les paramètres à l'aide d'un EditorSession renvoyé par EditorSession.createOnWatchEditorSession. Lorsque l'utilisateur effectue des modifications, vous pouvez appeler EditorSession.renderWatchFaceToBitmap pour prévisualiser le cadran dans l'éditeur Activity.

Spécifier un intent pour les activités de configuration

Si le cadran inclut des activités de configuration et que vous le configurez à partir de l'application associée de l'appareil, ajoutez les entrées de métadonnées suivantes à la déclaration de service dans le fichier manifeste de l'application connectée :

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

Les activités de configuration enregistrent des filtres d'intent pour cet intent, intent que le système déclenche lorsque les utilisateurs souhaitent configurer votre cadran.

Si le cadran n'inclut qu'une activité de configuration dans une application associée ou sur un accessoire connecté, il vous suffit d'inclure l'entrée de métadonnées correspondante indiquée dans l'exemple ci-dessus.

Créer une activité de configuration sur les accessoires connectés

Les activités de configuration sur les accessoires connectés offrent un ensemble limité d'options de personnalisations d'un cadran, car les menus complexes ne sont pas adaptés aux petits écrans. Dans votre activité de configuration sur un accessoire connecté, fournissez des choix binaires et quelques sélections permettant de personnaliser les principaux aspects du cadran.

Pour créer une activité de configuration sur un accessoire connecté, ajoutez une activité au module de votre application connectée et déclarez le filtre d'intent suivant dans le fichier manifeste de l'application :

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

Le nom de l'action dans ce filtre d'intent doit être androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR.

Dans votre activité de configuration, créez une UI simple qui propose des options permettant aux utilisateurs de personnaliser le cadran.

Créer une activité de configuration associée

Les activités de configuration associées permettent aux utilisateurs d'accéder à l'ensemble des choix de configuration pour un cadran, car il est plus facile d'interagir avec des menus complexes sur le grand écran d'un appareil portable. Par exemple, une activité de configuration sur un appareil portable vous permet de présenter aux utilisateurs des sélecteurs de couleur élaborés pour choisir la couleur d'arrière-plan d'un cadran.

Remarque : Les activités de configuration ne peuvent être écrites que pour les appareils portables Android tels que les téléphones, les tablettes et les pliables.

Pour créer une activité de configuration associée, ajoutez une activité à votre module d'application portable et déclarez le filtre d'intent suivant dans le fichier manifeste de l'application portable :

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

Dans votre activité de configuration, créez une UI qui fournit des options permettant de personnaliser tous les éléments configurables de votre cadran. Une fois la sélection effectuée, utilisez l'API Wearable Data Layer pour communiquer la modification de configuration à l'activité du cadran.

Consultez les ressources associées suivantes :