---
title: "Astra.GuiInputAccess"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guiinputaccess/
---

# Astra.GuiInputAccess

Read the Canvas receiver's sampled action map. Runtime policy is inherited from Input.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.GuiInputAccess
```

Read the Canvas receiver's sampled action map. Runtime policy is inherited from Input.

## Onde acessar este tipo

Editor → **Interface** → documento .aeui; cena → objeto **Canvas UI**. Dentro de um Behavior, **Gui.ForCanvas(owner)** seleciona a instância, **Find/TryFind** localiza o elemento e **Poll** consome eventos. **GuiInputAccess** configura ou descreve dados de GUI. Leia [campos e valores](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-bcfd3acbf68cfd67) | Method |
| [ActionState](#member-c8dcb38241991fa8) | Method |
| [Axis](#member-4649d52052b89e61) | Method |
| [Axis2](#member-459a6af30ec05299) | Method |
| [JustPressed](#member-1b1dcd43885bf4a1) | Method |
| [JustReleased](#member-4f23e5c95c76cdd6) | Method |
| [Pressed](#member-fbe513758f270c9e) | Method |

<h3 id="member-bcfd3acbf68cfd67" class="astra-member">.ctor</h3>

```csharp
public GuiInputAccess(Astra.ISceneAccess scene)
```

Read the Canvas receiver's sampled action map. Runtime policy is inherited from Input.

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `scene` | `Astra.ISceneAccess` |  |

<h3 id="member-c8dcb38241991fa8" class="astra-member">ActionState</h3>

```csharp
public Astra.InputActionState ActionState(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Estado tipado da ação amostrada, incluindo fase/valor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-4649d52052b89e61" class="astra-member">Axis</h3>

```csharp
public float Axis(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Lê a componente X da ação do receptor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-459a6af30ec05299" class="astra-member">Axis2</h3>

```csharp
public System.Numerics.Vector2 Axis2(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Lê o vetor 2D da ação do receptor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-1b1dcd43885bf4a1" class="astra-member">JustPressed</h3>

```csharp
public bool JustPressed(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Borda de pressionar na amostra de entrada.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-4f23e5c95c76cdd6" class="astra-member">JustReleased</h3>

```csharp
public bool JustReleased(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Borda de soltar na amostra de entrada.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |

<h3 id="member-fbe513758f270c9e" class="astra-member">Pressed</h3>

```csharp
public bool Pressed(string action)
```

**Caminho:** Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

**Uso:** Estado mantido da ação do receptor.

**Roadmap deste membro:** [Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `action` | `string` |  |