Astra.Components.GameTimer
Timer: Dispara eventos temporizados e ações persistentes de ativação de objetos. Família Lógica · Tempo.
Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct
Declaração
Seção intitulada “Declaração”readonly struct Astra.Components.GameTimerTimer: Dispara eventos temporizados e ações persistentes de ativação de objetos. Família Lógica · Tempo.
Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_timer.html
Interfaces: Astra.Components.IComponentFacade<Astra.Components.GameTimer>.
Onde acessar este tipo
Seção intitulada “Onde acessar este tipo”Hierarquia → selecione o objeto → Inspector → Adicionar componente → Lógica / Tempo → Timer.
No Behavior em Play, obtenha a fachada com Object.GetComponent<GameTimer>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new GameTimer(component) envolve um componente existente; não adiciona um componente à cena.
Roadmap e uso
Seção intitulada “Roadmap e uso”Tempo, eventos e tweens: 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.
Consulte também Timer para propriedades, valores iniciais, requisitos e edição em Play.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| .ctor | Method |
| OnElapsed | Method |
| Pause | Method |
| Remaining | Method |
| Remove | Method |
| Resume | Method |
| Running | Method |
| Start | Method |
| Stop | Method |
| Wrap | Method |
| AutoStart | Property |
| Component | Property |
| ElapsedAction | Property |
| ElapsedTarget | Property |
| Enabled | Property |
| IgnoreTimeScale | Property |
| InstanceId | Property |
| IntervalSeconds | Property |
| IsAlive | Property |
| Object | Property |
| Repeat | Property |
| TypeId | Property |
.ctor
public GameTimer(Astra.Component component)Caminho: Inspector → Timer; ou fachada C# em um 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: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
component |
Astra.Component |
OnElapsed
public Astra.ComponentSubscription OnElapsed(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Disparou. Um evento por quadro; Disparos conta intervalos vencidos no quadro. Payload: Disparos: inteiro
Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Disparou. Um evento por quadro; Disparos conta intervalos vencidos no quadro. Payload: Disparos: inteiro
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
Pause
public void Pause()Pausar. Congela a contagem sem perder o restante
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Pausar. Congela a contagem sem perder o restante
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Remaining
public double Remaining()Restante. Segundos até o próximo disparo; zero quando parado
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Restante. Segundos até o próximo disparo; zero quando parado
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Remove
public void Remove()Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.
Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Resume
public void Resume()Retomar. Continua a contagem pausada
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Retomar. Continua a contagem pausada
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Running
public bool Running()Em execução. Verdadeiro enquanto conta, inclusive pausado
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Em execução. Verdadeiro enquanto conta, inclusive pausado
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Start
public void Start(double interval)Iniciar. Reinicia a contagem; intervalo zero usa o autorado
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Iniciar. Reinicia a contagem; intervalo zero usa o autorado
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
interval |
double |
Stop
public void Stop()Parar. Interrompe e zera a contagem
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Parar. Interrompe e zera a contagem
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Wrap
public static Astra.Components.GameTimer Wrap(Astra.Component component)Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Envolve um Component existente após conferir TypeId; não cria componente.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
component |
Astra.Component |
AutoStart
public bool AutoStart { get; set; }Iniciar automaticamente. Inicia ao entrar em Play ou criar a instância; desligado exige Start. Alteração não reinicia timer já criado
Caminho: Inspector → Timer → Disparo; ou fachada C# em um Behavior.
Uso: Iniciar automaticamente: Inicia ao entrar em Play ou criar a instância; desligado exige Start. Alteração não reinicia timer já criado
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Component
public Astra.Component Component { get; }Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Handle genérico da instância, usado para operações de reflexão e recursos.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
ElapsedAction
public Astra.Components.GameTimer.ElapsedActionOption ElapsedAction { get; set; }Ao disparar. Executa uma ação no alvo antes de entregar TimerElapsed; alternar preserva a paridade dos disparos agregados
Caminho: Inspector → Timer → Conexão; ou fachada C# em um Behavior.
Uso: Ao disparar: Executa uma ação no alvo antes de entregar TimerElapsed; alternar preserva a paridade dos disparos agregados
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
ElapsedTarget
public Astra.ObjectReference ElapsedTarget { get; set; }Receptor. Alvo da ação; usa referência persistente remapeada por clone/prefab
Caminho: Inspector → Timer → Conexão; ou fachada C# em um Behavior.
Uso: Receptor: Alvo da ação; usa referência persistente remapeada por clone/prefab
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Enabled
public bool Enabled { get; set; }Ativo
Caminho: Inspector → Timer → Disparo; ou fachada C# em um Behavior.
Uso: Ativo: Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
IgnoreTimeScale
public bool IgnoreTimeScale { get; set; }Ignorar escala de tempo. Usa o intervalo não escalado aceito do quadro; a pausa do editor interrompe ambos os relógios
Caminho: Inspector → Timer → Disparo; ou fachada C# em um Behavior.
Uso: Ignorar escala de tempo: Usa o intervalo não escalado aceito do quadro; a pausa do editor interrompe ambos os relógios
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
InstanceId
public ulong InstanceId { get; }Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Distingue a instância no mesmo objeto; importante para componentes múltiplos.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
IntervalSeconds
public float IntervalSeconds { get; set; }Intervalo (s). Tempo entre disparos; uma vez quando Repetir está desligado
Faixa válida: 0.05 a 3600.
Caminho: Inspector → Timer → Disparo; ou fachada C# em um Behavior.
Uso: Intervalo: Tempo entre disparos; uma vez quando Repetir está desligado
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
IsAlive
public bool IsAlive { get; }Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Object
public Astra.GameObject Object { get; }Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Objeto dono deste componente; use para resolver composição.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Repeat
public bool Repeat { get; set; }Repetir
Caminho: Inspector → Timer → Disparo; ou fachada C# em um Behavior.
Uso: Repetir: Repete o intervalo; desligado produz um disparo e termina.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
TypeId
public static string TypeId { get; }Caminho: Inspector → Timer; ou fachada C# em um Behavior.
Uso: Identificador nativo usado em AddComponent/GetComponent.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.