> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/advanced-button-events.md).

# Eventos Avançados de Botão

Saiba como lidar com cliques de usuário na sua scene.

Se precisar que a interação na sua cena siga uma lógica personalizada que não seja compatível com a [Registar callback](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/register-callback.md) ou com as abordagens [baseadas em System](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/system-based-events.md) , pode tratar diretamente os dados brutos do evento de entrada. Esta abordagem é a mais difícil, mas também a mais flexível.

## O componente PointerEventsResult

Quando o Engine deteta um evento de ponteiro, é atribuído um componente `PointerEventsResult` à Entity em que clicou. Este componente contém todos os dados brutos sobre o evento de colisão e guarda dados históricos sobre eventos anteriores.

Os auxiliares em `inputSystem`, como `inputSystem.isTriggered` ou `inputSystem.getInputCommand` são adequados para a maioria dos cenários simples, mas, se precisar de obter mais detalhes sobre o evento de colisão, consulte os dados brutos em `PointerEventsResult`.

O componente `PointerEventsResult` contém uma lista de eventos de ponteiro, com um objeto para cada evento. Guarda uma lista de até 100 eventos, sendo que os mais recentes ficam no final da lista. Quando a lista atinge 100 eventos, começa a descartar os mais antigos à medida que chegam novos.

Cada evento da lista contém os seguintes dados:

* `analog`: Número opcional, presente apenas em eventos de uma entrada analógica (como um joystick), que guarda o valor analógico da entrada.
* `button`: O ID do botão que foi premido. O número corresponde ao enum `InputAction` , que lista todos os botões disponíveis.
* `state`: Tipo de evento de ponteiro, do enum `PointerEventType`. *0* refere-se a `PointerEventType.PET_UP`, *1* a `PointerEventType.PET_DOWN`, *2* a `PointerEventType.PET_HOVER_ENTER`, *3* a `PointerEventType.PET_HOVER_LEAVE`, *4* a `PointerEventType.PET_PROXIMITY_ENTER`, *5* a `PointerEventType.PET_PROXIMITY_LEAVE`
* `timestamp`: Um [timestamp Lamport](https://en.wikipedia.org/wiki/Lamport_timestamp) para identificar cada evento de botão.

  > Nota: este timestamp não é calculado com base na hora atual. Pense nele como um contador que começa em 0 e aumenta em 1 a cada evento.
* `hit`: Um objeto que contém os seguintes dados sobre o evento de colisão:
  * `entityId`: O número de ID da entidade atingida pelo raio.
  * `meshName`: *String* com o nome interno da malha específica do modelo 3D atingida. Isto é útil quando um modelo 3D é composto por várias malhas.
  * `globalOrigin`: *Vector3* para a posição de origem do raio (em relação à cena)
  * `direction`: *Vector3* com o vetor de direção do raio, em coordenadas globais
  * `position`: *Vector3* para a posição em que o raio intersectou a entidade atingida (em relação à cena)
  * `length`: Comprimento do raio desde a sua origem até à posição em que ocorreu a colisão com a entidade.
  * `normalHit`: *Vector3* com um vetor de direção normalizado, que descreve o ângulo da normal do impacto no espaço global.

```ts
import { engine, PointerEventsResult } from '@dcl/sdk/ecs'

function PointerReadingSystem() {
  for (const [entity] of engine.getEntitiesWith(PointerEventsResult)) {
    const events = PointerEventsResult.get(entity)
    for (const event of events) {
      console.log('POINTER EVENT DATA:', event)
    }
  }
}

engine.addSystem(PointerReadingSystem)
```

## Acompanhar os movimentos dos jogadores

Em jogos multijogador em tempo real, nos quais o momento dos movimentos dos jogadores é crucial, pode querer acompanhar a posição de cada jogador usando um servidor de terceiros como fonte da verdade. Pode melhorar o tempo de resposta ao detetar o botão antecipadamente e prever os efeitos no seu servidor antes de o avatar mudar de posição.

Esta abordagem ajuda a compensar os atrasos da rede, mas resulta inevitavelmente em discrepâncias, pelo que também deve consultar regularmente a posição atual do jogador para fazer correções. O equilíbrio entre estas previsões e correções pode exigir muitos ajustes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/eventos-de-botao/advanced-button-events.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
