A partir de 27 de março de 2025, recomendamos usar android-latest-release
em vez de aosp-main
para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Controle giratório
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Um controle giratório é um botão e botões ao redor no console central de
um automóvel usados para controlar a unidade principal. Um controle giratório precisa oferecer suporte a estas funções:
- Deslocar em quatro direções (para cima, para baixo, para a esquerda e para a direita)
- Girar no sentido horário e anti-horário
- Botão central
- Botão "Voltar"
Um controle giratório pode oferecer suporte a empurrões diagonais. A rotação precisa ser ilimitada com
detents (cliques). Pode haver um botão no centro ou o botão rotativo
pode funcionar como um botão. Normalmente, há outros botões ao redor do botão rotativo, por exemplo, "Início", "Mídia", "Telefone" e "Navegação" (mapa).
Um controlador rotativo funciona assim:
- O empurrão é usado para navegação grosseira na interface do usuário. A tela é
dividida em várias regiões retangulares, chamadas de
FocusAreas
.
O nudge navega entre esses FocusAreas
.
- A rotação é usada para navegação fina. A rotação navega pelas
visualizações com foco em um
FocusArea
na mesma ordem que a tecla Tab.
- O botão central realiza uma ação na visualização em foco, por exemplo, pressionar um botão.
- O botão "Voltar" normalmente funciona como de costume no Android, com exceção da
manipulação direta, descrita abaixo.
O histórico de sugestões garante que você volte para onde estava ao deslizar para a direita e depois para a esquerda.
Isso pode ser configurado pelo OEM.
Quando configurado pelo OEM, a tentativa de mover a borda da tela aciona uma
ação em todo o sistema, por exemplo, "Voltar".
Se a interação mais recente ocorreu por toque em vez de pelo controle giratório,
qualquer empurrão, giro ou pressão no botão central inicia o modo rotativo ao focar uma visualização, mas
geralmente é ignorado. As ações subsequentes funcionam conforme descrito acima, movendo o foco ou
realizando uma ação.
Se um SeekBar
estiver em foco quando o botão central for pressionado,
o modo de manipulação direta (DM) será iniciado. Nesse modo, a rotação manipula o
SeekBar
em vez de navegar. O botão "Voltar" é usado para sair do modo DM.
Outras visualizações que oferecem suporte ao modo DM podem usar o deslocamento e a rotação para manipular a visualização.
Por exemplo, uma visualização de mapa pode usar a rotação para fazer zoom e a movimentação para mover (rolar) o mapa.
Para saber mais, consulte:
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Rotary controller\n\nA *rotary controller* is a knob and surrounding buttons in the center console of\nan automobile used to control the head unit. A rotary controller must support these functions:\n\n- Nudge in four directions (up, down, left, and right)\n- Rotate clockwise and counterclockwise\n- Center button\n- Back button\n\nA rotary controller might support diagonal nudges. Rotation must be limitless with\ndetents (clicks). There can either be a button in the center or the rotary knob itself\ncan act as a button. There are typically additional buttons surrounding the rotary knob,\nfor example, Home, Media, Phone, and navigation (map).\n\nA rotary controller works like this:\n\n- Nudging is used for *coarse* navigation in the user interface. The screen is partitioned into several rectangular regions, referred to as `FocusAreas`. Nudging navigates between these `FocusAreas`.\n- Rotation is used for *fine* navigation. Rotation navigates through the focusable views in a `FocusArea` in the same order as the Tab key.\n- Center button takes action on the focused view, for example to press a button.\n- Back button typically functions as usual in Android, an exception being [direct manipulation](#dm), described below.\n\nNudge history ensures that nudging right and then left takes you back where you were.\nThis can be configured by the OEM.\n\nWhen configured by the OEM, attempting to nudge off the edge of the screen triggers a\nsystem-wide action, for example Back.\n\nIf the most recent interaction took place through touch rather than the rotary controller,\nany nudge, rotate, or press of the Center button starts rotary mode by focusing a view, but\nis typically ignored. Subsequent actions function as described above, moving focus or\ntaking action.\n\nIf a `SeekBar` is focused when the Center button is pressed,\n*direct manipulation (DM)* mode starts. In this mode, rotation manipulates the\n`SeekBar` rather than navigating. The Back button is used to exit DM mode.\nOther views that support DM mode can use nudging as well as rotation to manipulate the view.\nFor example, a map view can use rotation to zoom and nudging to pan (scroll) the map.\n\nTo learn more, see:\n\n- [Develop apps](/docs/automotive/hmi/rotary_controller/app_developers)\n- [Develop apps\n without the Car UI library](/docs/automotive/hmi/rotary_controller/app_developers_no_carui)\n- [Integration guide for OEMs](/docs/automotive/hmi/rotary_controller/oem_integration)"]]