Fornecer atividades de configuração no Wear OS

Alguns mostradores de relógio oferecem suporte a parâmetros de configuração que possibilitam que os usuários personalizem a aparência e o comportamento do mostrador. Por exemplo, alguns mostradores de relógio permitem que o usuário escolha uma cor de plano de fundo personalizada. Em outros, que mostram a hora de dois fusos diferentes, é possível selecionar os fusos horários de preferência do usuário.

Os mostradores do relógio que oferecem suporte a parâmetros de configuração permitem que os usuários façam personalizações usando uma atividade. O usuário pode iniciar a atividade de configuração no dispositivo wearable. Ele também pode iniciar a atividade de configuração complementar no app do dispositivo portátil, se estiver instalado. Além disso, o usuário pode configurar o mostrador do relógio no app complementar para dispositivos Wear OS 3.

Observação: é possível implementar a configuração no app complementar de dispositivos destinados ao nível 30 da API e versões mais recentes. A configuração no app para dispositivos portáteis está disponível em todos os dispositivos.

Usar sessão do editor

É altamente recomendável oferecer suporte à configuração no relógio, para que o usuário possa personalizar o mostrador sem precisar de um dispositivo complementar.

Para oferecer suporte a esse recurso, o mostrador do relógio pode incluir uma Activity de configuração e permitir que o usuário mude as configurações usando uma EditorSession, retornada de EditorSession.createOnWatchEditorSession. À medida que o usuário faz as mudanças, o sistema chama EditorSession.renderWatchFaceToBitmap para mostrar uma visualização em tempo real do mostrador do relógio no editor Activity.

Especificar uma intent para atividades de configuração

Se o mostrador do relógio incluir atividades de configuração e você estiver implementando personalizações no dispositivo complementar, adicione as entradas de metadados abaixo à declaração de serviço no arquivo de manifesto do app para wearables:

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

As atividades de configuração registram filtros para essa intent, e o sistema a aciona quando o usuário quer configurar o mostrador do relógio.

Se o mostrador do relógio inclui apenas uma atividade de configuração de dispositivo complementar ou de wearable, basta adicionar a entrada de metadados correspondente do exemplo acima.

Criar uma atividade de configuração de wearable

As atividades de configuração de wearables oferecem um conjunto limitado de opções de personalização, já que é difícil navegar em menus complexos em telas menores. Sua atividade de configuração de wearable precisa disponibilizar opções binárias e limitadas para personalizar os principais aspectos do mostrador do relógio.

Para criar uma atividade de configuração de wearable, adicione uma nova atividade ao módulo do app para wearables e declare o filtro de intent abaixo no arquivo de manifesto do 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>

O nome da ação nesse filtro de intent precisa ser androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR.

Na sua atividade de configuração, crie uma interface simples que ofereça opções para que o usuário personalize o mostrador do relógio.

Criar uma atividade de configuração de dispositivo complementar

Atividades de configuração de dispositivo complementar dão ao usuário um conjunto completo de opções de configuração para o mostrador do relógio, uma vez que é mais fácil interagir com menus complexos em telas maiores de dispositivos portáteis. Por exemplo, uma atividade de configuração em um dispositivo portátil permite que você ofereça aos usuários seletores de cores elaborados para escolher a cor de fundo de um mostrador do relógio.

Observação: as atividades de configuração só podem ser gravadas para dispositivos portáteis Android, como smartphones, tablets e dispositivos dobráveis.

Se quiser criar uma atividade de configuração de dispositivo complementar, adicione uma nova atividade ao módulo do app para dispositivo portátil e declare o filtro de intent a seguir no arquivo de manifesto desse 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>

Na sua atividade de configuração, crie uma interface que ofereça opções para personalizar todos os elementos configuráveis do mostrador do relógio. Depois que o usuário fizer uma seleção, use a API Wearable Data Layer para comunicar a mudança de configuração para a atividade do mostrador do relógio.

Confira estes recursos relacionados: