Pular para o conteúdo
AstraDOCS

Astra.Components.TweenSequence

Astra 0.2.3-preview.20261007Referência de assinaturasReferência revisada · 07 out. 2026

Sequência de tweens: Encadeia Transform Tweens em etapas sequenciais ou paralelas. Família Lógica · Tempo.

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

readonly struct Astra.Components.TweenSequence

Sequência de tweens: Encadeia Transform Tweens em etapas sequenciais ou paralelas. Família Lógica · Tempo.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_tween.html

Interfaces: Astra.Components.IComponentFacade<Astra.Components.TweenSequence>.

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Lógica / Tempo → Sequência de tweens.

No Behavior em Play, obtenha a fachada com Object.GetComponent<TweenSequence>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new TweenSequence(component) envolve um componente existente; não adiciona um componente à cena.

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 Sequência de tweens para propriedades, valores iniciais, requisitos e edição em Play.

Membro Categoria
.ctor Method
Cancel Method
OnCompleted Method
OnStepStarted Method
Pause Method
Play Method
Remove Method
Resume Method
Step Method
Wrap Method
Autoplay Property
Component Property
Enabled Property
IgnoreTimeScale Property
InstanceId Property
Interval0 Property
Interval1 Property
Interval2 Property
Interval3 Property
Interval4 Property
Interval5 Property
Interval6 Property
Interval7 Property
IsAlive Property
Join1 Property
Join2 Property
Join3 Property
Join4 Property
Join5 Property
Join6 Property
Join7 Property
Loops Property
Object Property
Step0 Property
Step1 Property
Step2 Property
Step3 Property
Step4 Property
Step5 Property
Step6 Property
Step7 Property
TypeId Property

.ctor

public TweenSequence(Astra.Component component)

Caminho: Inspector → Sequência de tweens; 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

Cancel

public void Cancel()

Cancelar. Interrompe a sequência e os tweens da etapa em andamento, sem voltar poses

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Sequência de tweens; ou fachada C# em um Behavior.

Uso: Cancelar. Interrompe a sequência e os tweens da etapa em andamento, sem voltar poses

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OnCompleted

public Astra.ComponentSubscription OnCompleted(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Concluiu. Emitido uma vez quando as repetições finitas terminam

Caminho: Inspector → Sequência de tweens; ou fachada C# em um Behavior.

Uso: Concluiu. Emitido uma vez quando as repetições finitas terminam

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&lt;Astra.ComponentEventArgs&gt;

OnStepStarted

public Astra.ComponentSubscription OnStepStarted(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)

Etapa começou. Emitido quando cada etapa reinicia o seu tween; carrega o número da etapa. Payload: Etapa: inteiro

Caminho: Inspector → Sequência de tweens; ou fachada C# em um Behavior.

Uso: Etapa começou. Emitido quando cada etapa reinicia o seu tween; carrega o número da etapa. Payload: Etapa: 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&lt;Astra.ComponentEventArgs&gt;

Pause

public void Pause()

Pausar. Congela intervalo e tweens da etapa em andamento

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Sequência de tweens; ou fachada C# em um Behavior.

Uso: Pausar. Congela intervalo e tweens da etapa em andamento

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Play

public void Play()

Tocar. Recomeça da etapa 1, cancelando os tweens das etapas em andamento

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Sequência de tweens; ou fachada C# em um Behavior.

Uso: Tocar. Recomeça da etapa 1, cancelando os tweens das etapas em andamento

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 → Sequência de tweens; 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 de onde pausou

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Sequência de tweens; ou fachada C# em um Behavior.

Uso: Retomar. Continua de onde pausou

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Step

public long Step()

Etapa atual. Número da etapa em andamento (1 a 8); zero parada

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Sequência de tweens; ou fachada C# em um Behavior.

Uso: Etapa atual. Número da etapa em andamento (1 a 8); zero parada

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Wrap

public static Astra.Components.TweenSequence Wrap(Astra.Component component)

Caminho: Inspector → Sequência de tweens; 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

Autoplay

public bool Autoplay { get; set; }

Iniciar no Play. Sem isto a sequência espera o método Tocar (script ou Conexão de evento)

Caminho: Inspector → Sequência de tweens → Execução; ou fachada C# em um Behavior.

Uso: Iniciar no Play: Sem isto a sequência espera o método Tocar (script ou Conexão de evento)

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 → Sequência de tweens; 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.

Enabled

public bool Enabled { get; set; }

Ativa. Desligada não reinicia etapas; a configuração é preservada

Caminho: Inspector → Sequência de tweens → Execução; ou fachada C# em um Behavior.

Uso: Ativa: Desligada não reinicia etapas; a configuração é preservada

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. Vale para os intervalos da sequência; cada tween segue a própria opção

Caminho: Inspector → Sequência de tweens → Execução; ou fachada C# em um Behavior.

Uso: Ignorar escala de tempo: Vale para os intervalos da sequência; cada tween segue a própria opção

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 → Sequência de tweens; 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.

Interval0

public float Interval0 { get; set; }

Intervalo da etapa 1 (s). Espera antes de a etapa começar, somada à espera do próprio tween

Faixa válida: 0 a 3600.

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Intervalo da etapa 1: Espera antes de a etapa começar, somada à espera do próprio tween

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Interval1

public float Interval1 { get; set; }

Intervalo da etapa 2 (s). Espera antes de a etapa começar, somada à espera do próprio tween

Faixa válida: 0 a 3600.

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Intervalo da etapa 2: Espera antes de a etapa começar, somada à espera do próprio tween

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Interval2

public float Interval2 { get; set; }

Intervalo da etapa 3 (s). Espera antes de a etapa começar, somada à espera do próprio tween

Faixa válida: 0 a 3600.

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Intervalo da etapa 3: Espera antes de a etapa começar, somada à espera do próprio tween

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Interval3

public float Interval3 { get; set; }

Intervalo da etapa 4 (s). Espera antes de a etapa começar, somada à espera do próprio tween

Faixa válida: 0 a 3600.

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Intervalo da etapa 4: Espera antes de a etapa começar, somada à espera do próprio tween

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Interval4

public float Interval4 { get; set; }

Intervalo da etapa 5 (s). Espera antes de a etapa começar, somada à espera do próprio tween

Faixa válida: 0 a 3600.

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Intervalo da etapa 5: Espera antes de a etapa começar, somada à espera do próprio tween

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Interval5

public float Interval5 { get; set; }

Intervalo da etapa 6 (s). Espera antes de a etapa começar, somada à espera do próprio tween

Faixa válida: 0 a 3600.

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Intervalo da etapa 6: Espera antes de a etapa começar, somada à espera do próprio tween

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Interval6

public float Interval6 { get; set; }

Intervalo da etapa 7 (s). Espera antes de a etapa começar, somada à espera do próprio tween

Faixa válida: 0 a 3600.

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Intervalo da etapa 7: Espera antes de a etapa começar, somada à espera do próprio tween

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Interval7

public float Interval7 { get; set; }

Intervalo da etapa 8 (s). Espera antes de a etapa começar, somada à espera do próprio tween

Faixa válida: 0 a 3600.

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Intervalo da etapa 8: Espera antes de a etapa começar, somada à espera do próprio tween

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 → Sequência de tweens; 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.

Join1

public bool Join1 { get; set; }

Etapa 2 junto da anterior. Começa com a etapa anterior em vez de esperar ela terminar

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 2 junto da anterior: Começa com a etapa anterior em vez de esperar ela terminar

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Join2

public bool Join2 { get; set; }

Etapa 3 junto da anterior. Começa com a etapa anterior em vez de esperar ela terminar

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 3 junto da anterior: Começa com a etapa anterior em vez de esperar ela terminar

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Join3

public bool Join3 { get; set; }

Etapa 4 junto da anterior. Começa com a etapa anterior em vez de esperar ela terminar

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 4 junto da anterior: Começa com a etapa anterior em vez de esperar ela terminar

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Join4

public bool Join4 { get; set; }

Etapa 5 junto da anterior. Começa com a etapa anterior em vez de esperar ela terminar

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 5 junto da anterior: Começa com a etapa anterior em vez de esperar ela terminar

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Join5

public bool Join5 { get; set; }

Etapa 6 junto da anterior. Começa com a etapa anterior em vez de esperar ela terminar

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 6 junto da anterior: Começa com a etapa anterior em vez de esperar ela terminar

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Join6

public bool Join6 { get; set; }

Etapa 7 junto da anterior. Começa com a etapa anterior em vez de esperar ela terminar

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 7 junto da anterior: Começa com a etapa anterior em vez de esperar ela terminar

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Join7

public bool Join7 { get; set; }

Etapa 8 junto da anterior. Começa com a etapa anterior em vez de esperar ela terminar

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 8 junto da anterior: Começa com a etapa anterior em vez de esperar ela terminar

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Loops

public Astra.Components.TweenSequence.LoopsOption Loops { get; set; }

Repetição. Quantas vezes a lista inteira de etapas é percorrida

Caminho: Inspector → Sequência de tweens → Execução; ou fachada C# em um Behavior.

Uso: Repetição: Quantas vezes a lista inteira de etapas é percorrida

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 → Sequência de tweens; 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.

Step0

public Astra.ObjectReference Step0 { get; set; }

Etapa 1. Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 1: Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Step1

public Astra.ObjectReference Step1 { get; set; }

Etapa 2. Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 2: Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Step2

public Astra.ObjectReference Step2 { get; set; }

Etapa 3. Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 3: Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Step3

public Astra.ObjectReference Step3 { get; set; }

Etapa 4. Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 4: Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Step4

public Astra.ObjectReference Step4 { get; set; }

Etapa 5. Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 5: Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Step5

public Astra.ObjectReference Step5 { get; set; }

Etapa 6. Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 6: Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Step6

public Astra.ObjectReference Step6 { get; set; }

Etapa 7. Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 7: Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Step7

public Astra.ObjectReference Step7 { get; set; }

Etapa 8. Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

Caminho: Inspector → Sequência de tweens → Etapas; ou fachada C# em um Behavior.

Uso: Etapa 8: Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa

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 → Sequência de tweens; 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.