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.
Implementar o retorno tátil
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Os fabricantes de dispositivos geralmente são considerados os proprietários dos recursos privados
criados para cada dispositivo. Por isso, os esforços de engenharia geralmente são focados em
uma base por dispositivo. Pouco ou nenhum esforço é feito para a consistência de outros
dispositivos no ecossistema.
Em contraste direto, os desenvolvedores se esforçam para criar apps que funcionem em todos os smartphones
Android no ecossistema, independentemente das especificações técnicas de cada dispositivo.
Essa diferença na abordagem pode causar um problema de fragmentação. Por exemplo, os
recursos de hardware de alguns smartphones não correspondem às expectativas definidas pelos
desenvolvedores do app. Portanto, se as APIs de haptics funcionarem em alguns smartphones Android, mas não em outros,
o resultado será um ecossistema inconsistente. É por isso que a configuração de hardware
é fundamental para garantir que os fabricantes possam implementar APIs
hapticas do Android em todos os dispositivos.
Esta página oferece uma lista de verificação detalhada para configurar a conformidade de hardware para
o melhor uso das APIs de háptica do Android.
A figura a seguir ilustra a criação de conhecimento comum entre fabricantes
de dispositivos e desenvolvedores, que é uma etapa essencial para criar um ecossistema
coerente:
Figura 1. Criar conhecimento entre fabricantes de dispositivos e desenvolvedores
Lista de verificação para implementação de haptics
Implementar constantes
- Lista de constantes para implementar a resposta tátil.
Implementar primitivos
- Diretrizes de implementação para primitivas de composição HAL.
Mapear constantes entre HAL e API
Implementar efeitos de envelope linear por partes (PWLE, na sigla em inglês)
- Diretrizes de implementação para envelopes de amplitude e frequência.
Avaliar o hardware
- Instruções sobre efeitos táteis de destino. Use estas instruções para realizar
verificações rápidas no hardware.
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,["# Implement haptics\n\nDevice manufacturers are generally considered the owners of the private assets\ncreated for each device. As such, their engineering efforts are often focused on\na *per-device basis*; little to no effort goes to the consistency of other\ndevices in the ecosystem.\n\nIn direct contrast, developers strive to build apps that work on *all* Android\nphones in the ecosystem, regardless of each device's technical specifications.\nThis difference in approach can cause a fragmentation problem, for example, the\nhardware capabilities of certain phones don't match expectations set by the app\ndevelopers. So if the haptics APIs work on some Android phones but not others,\nthe result is an inconsistent ecosystem. This is why hardware configuration\nplays a critical role in ensuring that manufacturers can implement Android\nhaptics APIs on *every* device.\n\nThis page provides a step-by-step checklist to set up hardware compliance for\nthe best use of the Android haptics APIs.\n\nThe following figure illustrates building common knowledge between device\nmanufacturers and developers, which is a critical step in creating a cohesive\necosystem:\n\n**Figure 1.** Building knowledge between device manufacturers and developers\n\nHaptics implementation checklist\n--------------------------------\n\n1. [Implement constants](/docs/core/interaction/haptics/haptics-constants-primitives#implement-constants)\n\n - List of constants to implement haptics.\n2. [Implement primitives](/docs/core/interaction/haptics/haptics-constants-primitives#implement-primitives)\n\n - Implementation guidance for HAL composition primitives.\n3. [Map constants between HAL and API](/docs/core/interaction/haptics/haptics-map-constants)\n\n - Mapping recommendations between public API constants (named *placeholders* in the framework) and HAL constants, which implement the placeholders.\n - See [Design principles to guide the recommended mapping](/docs/core/interaction/haptics/haptics-ux-design) to learn more about this process.\n4. [Implement piecewise linear envelope (PWLE) effects](/docs/core/interaction/haptics/haptics-pwle)\n\n - Implementation guidance for amplitude and frequency envelopes.\n5. [Assess the hardware](/docs/core/interaction/haptics/haptics-assess-hardware)\n\n - Instructions on target haptic effects. Use these instructions to perform quick checks on your hardware.\n\n| **Note:** You can learn more about building common knowledge between device manufacturers and developers in [Advanced Haptics: The When, What, and How of\n| Haptic APIs](https://www.youtube.com/watch?v=00jRoEFnpk8)."]]