Complicações
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Uma complicação é um elemento da interface de um mostrador do relógio que contém informações
de visualização rápida que os usuários querem ver com frequência ao longo do dia. Por exemplo, você
pode criar uma complicação do clima atual ou de frequência cardíaca.
Princípios da UX
As seções a seguir descrevem os princípios que precisam ser considerados ao criar
complicações.
Com visualização rápida |
Focadas no conteúdo |
Focadas na privacidade |
| Complicações são pequenos componentes projetados para ajudar os usuários a concluir
tarefas frequentes com rapidez. O conteúdo precisa ser simples e legível. |
Complicações são mais valiosas quando o conteúdo de que o usuário precisa fica visível
apenas levantando o pulso, sem necessidade de mais
interações. |
O relógio acompanha o usuário para qualquer lugar. Pense em como o
conteúdo nas complicações será relevante para o contexto do usuário. |
Casos de uso
Quando tocadas, as complicações podem ajudar os usuários a acessar uma parte específica de um app.
Elas também podem realizar uma ação independente. Por exemplo, tocar em uma
complicação de contagem de água muda a quantidade de copos.
O Wear OS inclui automaticamente uma complicação de atalho de apps para que você não precise
criar seu próprio atalho. Em vez disso, concentre-se na criação de complicações que possam ajudar os usuários
a concluir tarefas com foco.
Tipos
Os tipos de complicação se referem aos tipos de dados mostrados na complicação ou
fornecidos por uma fonte de dados. Uma complicação sempre tem um único tipo que inclui
campos obrigatórios e opcionais. Um campo obrigatório contém os dados principais. A maioria
dos tipos de complicação recebe o nome do campo obrigatório. Você pode escolher quantas
complicações quer incluir no mostrador do relógio e a quais tipos quer
oferecer suporte. Há cinco tipos de complicação.
| Tipo |
Campos obrigatórios |
Campos opcionais |
Nome da classe |
Exemplo |
| SHORT_TEXT |
Texto curto |
Ícone,
Ícone de proteção de pixels,
Título curto |
ShortTextComplicationData |
 |
| ICON |
Ícone |
Ícone de proteção de pixels |
MonochromaticImageComplicationData |
 |
| RANGED_VALUE |
Valor
Valor mínimo
Valor máximo |
Ícone,
Ícone de proteção de pixels,
Texto curto,
Título curto |
RangedValueComplicationData |
 |
| LONG_TEXT |
Texto longo |
Título longo,
Ícone,
Ícone de proteção de pixels,
Imagem pequena |
LongTextComplicationData |
 |
| SMALL_IMAGE |
Imagem pequena |
|
SmallImageComplicationData |
 |
| LARGE_IMAGE |
Imagem grande |
|
PhotoImageComplicationData |
 |
Para saber mais sobre as fontes de dados de complicações, consulte
Tipos de complicação.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 2025-07-27 UTC."],[],[],null,["# Complications\n\nA complication is a UI element on a watch face that contains highly-glanceable\ninformation that users want to see often throughout the day. For example, you\ncould create a current weather complication, or a heart rate complication.\n\nUX Principles\n-------------\n\nThe following sections describe principles to keep in mind when creating\ncomplications.\n\n|------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| Glanceable ---------- | Content forward --------------- | Privacy first ------------- |\n| Complications are small components designed to help users complete frequent tasks quickly. Make content simple and readable. | Complications are most valuable when the content that the user needs is made visible by simply raising their wrist, without needing further interaction. | The watch travels with the user everywhere they go. Consider how the content in the complications is relevant to the user's context. |\n\nUse cases\n---------\n\nWhen tapped, complications can help users access a specific part of an app.\nThey can also perform a self-contained action. For example, tapping a\nWater Count complication changes the glass count.\n\nWearOS automatically includes an app shortcut complication, so you don't need to\ncreate your own. Instead focus on creating complications that can help users\ncomplete focused tasks.\n\nTypes\n-----\n\nComplication types refer to the kinds of data shown on the complication or\nsupplied by a data source. A complication always has a single type that includes\nrequired and optional fields. A required field contains the primary data. Most\ncomplication types take their name from their required field. You can choose how\nmany complications to include in your watch face and the complication types to\nsupport. There are five complication types.\n\n| Type | Required fields | Optional fields | Class name | Example |\n|--------------|---------------------------|--------------------------------------------------------|--------------------------------------|---------|\n| SHORT_TEXT | Short text | Icon, Burn in protection icon, Short title | `ShortTextComplicationData` | |\n| ICON | Icon | Burn in protection icon | `MonochromaticImageComplicationData` | |\n| RANGED_VALUE | Value Min value Max value | Icon, Burn in protection icon, Short text, Short title | `RangedValueComplicationData` | |\n| LONG_TEXT | Long text | Long title, Icon, Burn in protection icon, Small image | `LongTextComplicationData` | |\n| SMALL_IMAGE | Small image | | `SmallImageComplicationData` | |\n| LARGE_IMAGE | Large image | | `PhotoImageComplicationData` | |\n\nFor more information about complication data sources, see\n[Complication types](/training/wearables/watch-faces/complications#types)."]]
