Astra.InputAccess

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

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

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.

Membros

Membro	Categoria
.ctor	Method
ActionState	Method
ApplyBindingOverride	Method
Axis	Method
Axis2	Method
BeginBindingCapture	Method
CancelBindingCapture	Method
ContextEnabled	Method
Exists	Method
ExportProfile	Method
GetBinding	Method
ImportProfile	Method
JustPressed	Method
JustReleased	Method
LoadProfile	Method
Pressed	Method
RemoveAllBindingOverrides	Method
RemoveBindingOverride	Method
RestoreActionEnabled	Method
RoleAction	Method
SaveProfile	Method
SetActionEnabled	Method
SetContextEnabled	Method
BindingCaptureStatus	Property
DeviceGroups	Property
JumpPressed	Property
Look	Property
Move	Property

.ctor

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.

Parâmetro	Tipo	Contrato
scene	Astra.ISceneAccess

ActionState

public Astra.InputActionState ActionState(string action)

State of the real interaction. Timing uses unscaled sampled input time.

Parâmetro	Tipo	Contrato
action	string

ApplyBindingOverride

public bool ApplyBindingOverride(string action, uint index, Astra.InputBindingValue binding)

Parâmetro	Tipo	Contrato
action	string
index	uint
binding	Astra.InputBindingValue

Axis

public float Axis(string action)

Componente X do eixo, para ações Axis1D.

Parâmetro	Tipo	Contrato
action	string

Axis2

public System.Numerics.Vector2 Axis2(string action)

Eixo 2D da ação. Ação desconhecida lê zero.

Parâmetro	Tipo	Contrato
action	string

BeginBindingCapture

public bool BeginBindingCapture(string action, uint index, Astra.InputSource source, bool negative = false, uint cancelKey = 111)

Parâmetro	Tipo	Contrato
action	string
index	uint
source	Astra.InputSource
negative	bool	· Opcional: False
cancelKey	uint	· Opcional: 111

CancelBindingCapture

public void CancelBindingCapture()

ContextEnabled

public bool ContextEnabled(string context)

Parâmetro	Tipo	Contrato
context	string

Exists

public bool Exists(string action)

Falso quando a ação nem existe no mapa do projeto.

Parâmetro	Tipo	Contrato
action	string

ExportProfile

public string ExportProfile()

GetBinding

public Astra.InputBindingValue GetBinding(string action, uint index = 0, bool authored = false)

Parâmetro	Tipo	Contrato
action	string
index	uint	· Opcional: 0
authored	bool	· Opcional: False

ImportProfile

public bool ImportProfile(string profile)

Troca todos os overrides atomicamente; mapa incompatível é recusado sem alteração.

Parâmetro	Tipo	Contrato
profile	string

JustPressed

public bool JustPressed(string action)

Parâmetro	Tipo	Contrato
action	string

JustReleased

public bool JustReleased(string action)

Parâmetro	Tipo	Contrato
action	string

LoadProfile

public bool LoadProfile(string path)

Parâmetro	Tipo	Contrato
path	string

Pressed

public bool Pressed(string action)

Parâmetro	Tipo	Contrato
action	string

RemoveAllBindingOverrides

public void RemoveAllBindingOverrides()

RemoveBindingOverride

public bool RemoveBindingOverride(string action, uint index = 0)

Parâmetro	Tipo	Contrato
action	string
index	uint	· Opcional: 0

RestoreActionEnabled

public bool RestoreActionEnabled(string action)

Parâmetro	Tipo	Contrato
action	string

RoleAction

public string RoleAction(Astra.InputRole role)

Nome da ação que o projeto atribuiu a este papel, ou vazio.

Parâmetro	Tipo	Contrato
role	Astra.InputRole

SaveProfile

public void SaveProfile(string path)

Grava o perfil separado da cena. O jogo escolhe o caminho de armazenamento do jogador.

Parâmetro	Tipo	Contrato
path	string

SetActionEnabled

public bool SetActionEnabled(string action, bool enabled)

Runtime policy only; the scene and rebind profile remain authored data.

Parâmetro	Tipo	Contrato
action	string
enabled	bool

SetContextEnabled

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.

Parâmetro	Tipo	Contrato
context	string
enabled	bool

BindingCaptureStatus

public Astra.InputCaptureStatus BindingCaptureStatus { get; }

DeviceGroups

public Astra.InputDeviceGroups DeviceGroups { get; set; }

JumpPressed

public bool JumpPressed { get; }

Look

public System.Numerics.Vector2 Look { get; }

Move

public System.Numerics.Vector2 Move { get; }