---
title: "Astra.InputAccess"
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-inputaccess/
---
# Astra.InputAccess
As ações de entrada vistas pelo projeto. O núcleo não conhece "Mover" nem "Saltar": quem nomeia as ações, escolhe o que as aciona e diz quais papéis elas cumprem é o projeto, no recurso de ações. Um comportamento que queira "a ação de andar deste jogo, seja qual for o nome" pergunta por Astra.InputAccess.RoleAction(Astra.InputRole). Quando a interface do editor está com o toque (IDE aberta, teclado, modal, gizmo arrastado) o gameplay perde o foco: todos os eixos leem zero e nenhum botão fica preso.
**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.InputAccess
```
As ações de entrada vistas pelo projeto. O núcleo não conhece "Mover" nem "Saltar": quem nomeia as ações, escolhe o que as aciona e diz quais papéis elas cumprem é o projeto, no recurso de ações. Um comportamento que queira "a ação de andar deste jogo, seja qual for o nome" pergunta por Astra.InputAccess.RoleAction(Astra.InputRole). Quando a interface do editor está com o toque (IDE aberta, teclado, modal, gizmo arrastado) o gameplay perde o foco: todos os eixos leem zero e nenhum botão fica preso.
## Onde acessar este tipo
Configure ações do projeto e, no Behavior, use **Input** ou **Haptics**. Controles do Canvas leem o receptor pelo contexto Gui.ForCanvas; não confunda ação de entrada com evento de GUI.
## 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-d182649f804cfcd0) | Method |
| [ActionState](#member-71ba134a07bae39a) | Method |
| [ApplyBindingOverride](#member-c21b28f38231ba6f) | Method |
| [Axis](#member-a78c589b02726841) | Method |
| [Axis2](#member-0a3439dca9a729d2) | Method |
| [BeginBindingCapture](#member-2f9ec90d2cd4a84e) | Method |
| [CancelBindingCapture](#member-f6c45c59febfa91c) | Method |
| [ContextEnabled](#member-97912a16db0d12c8) | Method |
| [Exists](#member-2e9b788483a86d8b) | Method |
| [ExportProfile](#member-b4492439701520f0) | Method |
| [GetBinding](#member-2ace1ae05546bca6) | Method |
| [ImportProfile](#member-44a05b44253e77d3) | Method |
| [JustPressed](#member-dd9e8da95801be42) | Method |
| [JustReleased](#member-aefe85caa733c991) | Method |
| [LoadProfile](#member-ec069fef3eb3731f) | Method |
| [Pressed](#member-6ba5c5131a0ef4f2) | Method |
| [RemoveAllBindingOverrides](#member-d7091a7696619d1b) | Method |
| [RemoveBindingOverride](#member-6af46d6f38f3918b) | Method |
| [RestoreActionEnabled](#member-5487213b6eae1809) | Method |
| [RoleAction](#member-5e259fcc03e9429e) | Method |
| [SaveProfile](#member-0d4bd789f8e5ec00) | Method |
| [SetActionEnabled](#member-1083caec06e969ab) | Method |
| [SetContextEnabled](#member-b054ff1bc97eea09) | Method |
| [BindingCaptureStatus](#member-1814b21d852740a3) | Property |
| [DeviceGroups](#member-cc22a9a3571bc008) | Property |
| [JumpPressed](#member-354513fa23ad64e7) | Property |
| [Look](#member-16d698a1ab4eb40c) | Property |
| [Move](#member-1cdc227face2cf83) | Property |
.ctor
```csharp
public InputAccess(Astra.ISceneAccess scene)
```
As ações de entrada vistas pelo projeto. O núcleo não conhece "Mover" nem "Saltar": quem nomeia as ações, escolhe o que as aciona e diz quais papéis elas cumprem é o projeto, no recurso de ações. Um comportamento que queira "a ação de andar deste jogo, seja qual for o nome" pergunta por Astra.InputAccess.RoleAction(Astra.InputRole). Quando a interface do editor está com o toque (IDE aberta, teclado, modal, gizmo arrastado) o gameplay perde o foco: todos os eixos leem zero e nenhum botão fica preso.
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**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` | |
ActionState
```csharp
public Astra.InputActionState ActionState(string action)
```
State of the real interaction. Timing uses unscaled sampled input time.
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** State of the real interaction. Timing uses unscaled sampled input time.
**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` | |
ApplyBindingOverride
```csharp
public bool ApplyBindingOverride(string action, uint index, Astra.InputBindingValue binding)
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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` | |
| `index` | `uint` | |
| `binding` | `Astra.InputBindingValue` | |
Axis
```csharp
public float Axis(string action)
```
Componente X do eixo, para ações Axis1D.
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Componente X do eixo, para ações Axis1D.
**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` | |
Axis2
```csharp
public System.Numerics.Vector2 Axis2(string action)
```
Eixo 2D da ação. Ação desconhecida lê zero.
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Eixo 2D da ação. Ação desconhecida lê zero.
**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` | |
BeginBindingCapture
```csharp
public bool BeginBindingCapture(string action, uint index, Astra.InputSource source, bool negative = false, uint cancelKey = 111)
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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` | |
| `index` | `uint` | |
| `source` | `Astra.InputSource` | |
| `negative` | `bool` | · Opcional: `False` |
| `cancelKey` | `uint` | · Opcional: `111` |
CancelBindingCapture
```csharp
public void CancelBindingCapture()
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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.
ContextEnabled
```csharp
public bool ContextEnabled(string context)
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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 |
|---|---|---|
| `context` | `string` | |
Exists
```csharp
public bool Exists(string action)
```
Falso quando a ação nem existe no mapa do projeto.
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Falso quando a ação nem existe no mapa do projeto.
**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` | |
ExportProfile
```csharp
public string ExportProfile()
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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.
GetBinding
```csharp
public Astra.InputBindingValue GetBinding(string action, uint index = 0, bool authored = false)
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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` | |
| `index` | `uint` | · Opcional: `0` |
| `authored` | `bool` | · Opcional: `False` |
ImportProfile
```csharp
public bool ImportProfile(string profile)
```
Troca todos os overrides atomicamente; mapa incompatível é recusado sem alteração.
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Troca todos os overrides atomicamente; mapa incompatível é recusado sem alteração.
**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 |
|---|---|---|
| `profile` | `string` | |
JustPressed
```csharp
public bool JustPressed(string action)
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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` | |
JustReleased
```csharp
public bool JustReleased(string action)
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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` | |
LoadProfile
```csharp
public bool LoadProfile(string path)
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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 |
|---|---|---|
| `path` | `string` | |
Pressed
```csharp
public bool Pressed(string action)
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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` | |
RemoveAllBindingOverrides
```csharp
public void RemoveAllBindingOverrides()
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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.
RemoveBindingOverride
```csharp
public bool RemoveBindingOverride(string action, uint index = 0)
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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` | |
| `index` | `uint` | · Opcional: `0` |
RestoreActionEnabled
```csharp
public bool RestoreActionEnabled(string action)
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
**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` | |
RoleAction
```csharp
public string RoleAction(Astra.InputRole role)
```
Nome da ação que o projeto atribuiu a este papel, ou vazio.
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Nome da ação que o projeto atribuiu a este papel, ou vazio.
**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 |
|---|---|---|
| `role` | `Astra.InputRole` | |
SaveProfile
```csharp
public void SaveProfile(string path)
```
Grava o perfil separado da cena. O jogo escolhe o caminho de armazenamento do jogador.
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Grava o perfil separado da cena. O jogo escolhe o caminho de armazenamento do jogador.
**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 |
|---|---|---|
| `path` | `string` | |
SetActionEnabled
```csharp
public bool SetActionEnabled(string action, bool enabled)
```
Runtime policy only; the scene and rebind profile remain authored data.
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Runtime policy only; the scene and rebind profile remain authored data.
**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` | |
| `enabled` | `bool` | |
SetContextEnabled
```csharp
public void SetContextEnabled(string context, bool enabled)
```
Liga ou desliga um contexto. Uma ação em contexto desligado lê zero sem perder o que o usuário configurou — é assim que um menu do jogo silencia o controle do personagem sem apagar o mapa.
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Liga ou desliga um contexto. Uma ação em contexto desligado lê zero sem perder o que o usuário configurou — é assim que um menu do jogo silencia o controle do personagem sem apagar o mapa.
**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 |
|---|---|---|
| `context` | `string` | |
| `enabled` | `bool` | |
BindingCaptureStatus
```csharp
public Astra.InputCaptureStatus BindingCaptureStatus { get; }
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
**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.
DeviceGroups
```csharp
public Astra.InputDeviceGroups DeviceGroups { get; set; }
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
**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.
JumpPressed
```csharp
public bool JumpPressed { get; }
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
**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.
Look
```csharp
public System.Numerics.Vector2 Look { get; }
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
**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.
Move
```csharp
public System.Numerics.Vector2 Move { get; }
```
**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
**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.