---
title: "Astra.Components.GameTimer"
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-components-gametimer/
---

# 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

:::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.Components.GameTimer
```

Timer: 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

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

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/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](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Timer](/pt-br/snapshot-2026-10-06/componentes/astra-time-timer/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-9f8fa4c1fb910bb9) | Method |
| [OnElapsed](#member-993c4a6049890a01) | Method |
| [Pause](#member-9126daa86f6a27b7) | Method |
| [Remaining](#member-01357d174095e663) | Method |
| [Remove](#member-e80e786edb8e6ef7) | Method |
| [Resume](#member-af66a3e0b0712a6e) | Method |
| [Running](#member-9f821f5e033bc17d) | Method |
| [Start](#member-6e77bba7b6e953c1) | Method |
| [Stop](#member-6528deec4b8349eb) | Method |
| [Wrap](#member-bea5dab047433ffb) | Method |
| [AutoStart](#member-f0b60fbfcbd244dc) | Property |
| [Component](#member-42deb015c0dbaf87) | Property |
| [ElapsedAction](#member-e5dbce47b41c29b3) | Property |
| [ElapsedTarget](#member-785a84f42e6a3e78) | Property |
| [Enabled](#member-1bb8e29d7fced339) | Property |
| [IgnoreTimeScale](#member-0ef98182d38a1f26) | Property |
| [InstanceId](#member-d16aa8696140d16a) | Property |
| [IntervalSeconds](#member-c7f6cc07daf42406) | Property |
| [IsAlive](#member-10bec31cd0a04f6f) | Property |
| [Object](#member-055dc8cd3b87fe08) | Property |
| [Repeat](#member-c930592c536ad1ee) | Property |
| [TypeId](#member-ba88184c1edf2ebf) | Property |

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

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-993c4a6049890a01" class="astra-member">OnElapsed</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/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&lt;Astra.ComponentEventArgs&gt;` |  |

<h3 id="member-9126daa86f6a27b7" class="astra-member">Pause</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-01357d174095e663" class="astra-member">Remaining</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e80e786edb8e6ef7" class="astra-member">Remove</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-af66a3e0b0712a6e" class="astra-member">Resume</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9f821f5e033bc17d" class="astra-member">Running</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6e77bba7b6e953c1" class="astra-member">Start</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `interval` | `double` |  |

<h3 id="member-6528deec4b8349eb" class="astra-member">Stop</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-bea5dab047433ffb" class="astra-member">Wrap</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-f0b60fbfcbd244dc" class="astra-member">AutoStart</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-42deb015c0dbaf87" class="astra-member">Component</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e5dbce47b41c29b3" class="astra-member">ElapsedAction</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-785a84f42e6a3e78" class="astra-member">ElapsedTarget</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1bb8e29d7fced339" class="astra-member">Enabled</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0ef98182d38a1f26" class="astra-member">IgnoreTimeScale</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d16aa8696140d16a" class="astra-member">InstanceId</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c7f6cc07daf42406" class="astra-member">IntervalSeconds</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-10bec31cd0a04f6f" class="astra-member">IsAlive</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-055dc8cd3b87fe08" class="astra-member">Object</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c930592c536ad1ee" class="astra-member">Repeat</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-ba88184c1edf2ebf" class="astra-member">TypeId</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.