--- 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.