--- title: "Sequência de tweens" version: snapshot-2026-10-07 engineGeneration: astra-current language: C# status: source-reviewed reviewedAt: 2026-10-07 appRelease: "0.2.3-preview.20261007" runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/componentes/astra-tween-sequence/ --- # Sequência de tweens Encadeia Transform Tweens em etapas sequenciais ou paralelas **Família:** Lógica · **Grupo:** Tempo · **Identificador:** `astra.tween.sequence` · **Payload:** 1 :::note[Escopo da evidência] Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho. ::: ## Para que usar Coordena tweens persistentes em até oito etapas, em sequência ou em grupos paralelos. Use para abrir duas partes de uma porta ou encadear movimentos. Prepare Transform Tween ou Tween de propriedade nos objetos alvos. A sequência reinicia os tweens desses objetos; não os cria. Atribua os objetos em Etapa 1…8, na ordem desejada. Junto da anterior reúne uma etapa ao grupo anterior. ## Criar e configurar Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Tempo** → **Sequência de tweens**. O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.TweenSequence](/pt-br/snapshot-2026-10-07/api/astra-components-tweensequence/). Intervalo da etapa soma uma espera antes do grupo à espera do próprio tween. Ignorar escala de tempo aqui vale para os intervalos; cada tween conserva seu próprio relógio. A próxima etapa começa no quadro seguinte ao término, sem promessa de reaproveitar o tempo restante. **Guia relacionado:** [Receita de duas etapas](/pt-br/snapshot-2026-10-06/versoes/preview-2026-10-07/#sequência-de-tweens-duas-ações-uma-depois-da-outra) ## Exemplo de uso Prepare A e B com Transform Tween de rotação Y até 90°, duração 2 s, Girar ligado e Mover/Escalar desligados. Escolha A na Etapa 1 e B na Etapa 2. Com Junto da anterior desligado, B deve começar depois de A. Ligue para comparar paralelo. Um tween infinito impede terminar o grupo. ## Dependências Nenhuma regra adicional declarada no schema deste componente. ## Conflitos Nenhuma regra adicional declarada no schema deste componente. ## Edição e ciclo de vida | Operação | Contrato | |---|---| | Adicionar/remover em Play | ponto seguro | | Alterar propriedades em Play | ponto seguro | | Múltiplas instâncias | Não | | Versão do payload | 1 | Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/). ## Propriedades Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto. ### Etapas | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Intervalo da etapa 1**](#field-interval-0)
`interval_0` | número · s | 0 | 0 … 3600 | | [**Intervalo da etapa 2**](#field-interval-1)
`interval_1` | número · s | 0 | 0 … 3600 | | [**Intervalo da etapa 3**](#field-interval-2)
`interval_2` | número · s | 0 | 0 … 3600 | | [**Intervalo da etapa 4**](#field-interval-3)
`interval_3` | número · s | 0 | 0 … 3600 | | [**Intervalo da etapa 5**](#field-interval-4)
`interval_4` | número · s | 0 | 0 … 3600 | | [**Intervalo da etapa 6**](#field-interval-5)
`interval_5` | número · s | 0 | 0 … 3600 | | [**Intervalo da etapa 7**](#field-interval-6)
`interval_6` | número · s | 0 | 0 … 3600 | | [**Intervalo da etapa 8**](#field-interval-7)
`interval_7` | número · s | 0 | 0 … 3600 | | [**Etapa 2 junto da anterior**](#field-join-1)
`join_1` | booleano | falso | verdadeiro \| falso | | [**Etapa 3 junto da anterior**](#field-join-2)
`join_2` | booleano | falso | verdadeiro \| falso | | [**Etapa 4 junto da anterior**](#field-join-3)
`join_3` | booleano | falso | verdadeiro \| falso | | [**Etapa 5 junto da anterior**](#field-join-4)
`join_4` | booleano | falso | verdadeiro \| falso | | [**Etapa 6 junto da anterior**](#field-join-5)
`join_5` | booleano | falso | verdadeiro \| falso | | [**Etapa 7 junto da anterior**](#field-join-6)
`join_6` | booleano | falso | verdadeiro \| falso | | [**Etapa 8 junto da anterior**](#field-join-7)
`join_7` | booleano | falso | verdadeiro \| falso | | [**Etapa 1**](#field-step-0)
`step_0` | referência | Nenhum | objeto compatível com o receptor | | [**Etapa 2**](#field-step-1)
`step_1` | referência | Nenhum | objeto compatível com o receptor | | [**Etapa 3**](#field-step-2)
`step_2` | referência | Nenhum | objeto compatível com o receptor | | [**Etapa 4**](#field-step-3)
`step_3` | referência | Nenhum | objeto compatível com o receptor | | [**Etapa 5**](#field-step-4)
`step_4` | referência | Nenhum | objeto compatível com o receptor | | [**Etapa 6**](#field-step-5)
`step_5` | referência | Nenhum | objeto compatível com o receptor | | [**Etapa 7**](#field-step-6)
`step_6` | referência | Nenhum | objeto compatível com o receptor | | [**Etapa 8**](#field-step-7)
`step_7` | referência | Nenhum | objeto compatível com o receptor |

Intervalo da etapa 1 · interval_0

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Intervalo da etapa 1**. **Uso e efeito:** Espera antes de a etapa começar, somada à espera do próprio tween **Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 3600. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Intervalo da etapa 2 · interval_1

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Intervalo da etapa 2**. **Uso e efeito:** Espera antes de a etapa começar, somada à espera do próprio tween **Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 3600. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Intervalo da etapa 3 · interval_2

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Intervalo da etapa 3**. **Uso e efeito:** Espera antes de a etapa começar, somada à espera do próprio tween **Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 3600. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Intervalo da etapa 4 · interval_3

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Intervalo da etapa 4**. **Uso e efeito:** Espera antes de a etapa começar, somada à espera do próprio tween **Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 3600. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Intervalo da etapa 5 · interval_4

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Intervalo da etapa 5**. **Uso e efeito:** Espera antes de a etapa começar, somada à espera do próprio tween **Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 3600. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Intervalo da etapa 6 · interval_5

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Intervalo da etapa 6**. **Uso e efeito:** Espera antes de a etapa começar, somada à espera do próprio tween **Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 3600. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Intervalo da etapa 7 · interval_6

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Intervalo da etapa 7**. **Uso e efeito:** Espera antes de a etapa começar, somada à espera do próprio tween **Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 3600. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Intervalo da etapa 8 · interval_7

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Intervalo da etapa 8**. **Uso e efeito:** Espera antes de a etapa começar, somada à espera do próprio tween **Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 3600. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 2 junto da anterior · join_1

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 2 junto da anterior**. **Uso e efeito:** Começa com a etapa anterior em vez de esperar ela terminar **Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 3 junto da anterior · join_2

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 3 junto da anterior**. **Uso e efeito:** Começa com a etapa anterior em vez de esperar ela terminar **Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 4 junto da anterior · join_3

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 4 junto da anterior**. **Uso e efeito:** Começa com a etapa anterior em vez de esperar ela terminar **Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 5 junto da anterior · join_4

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 5 junto da anterior**. **Uso e efeito:** Começa com a etapa anterior em vez de esperar ela terminar **Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 6 junto da anterior · join_5

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 6 junto da anterior**. **Uso e efeito:** Começa com a etapa anterior em vez de esperar ela terminar **Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 7 junto da anterior · join_6

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 7 junto da anterior**. **Uso e efeito:** Começa com a etapa anterior em vez de esperar ela terminar **Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 8 junto da anterior · join_7

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 8 junto da anterior**. **Uso e efeito:** Começa com a etapa anterior em vez de esperar ela terminar **Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 1 · step_0

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 1**. **Uso e efeito:** Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa **Valor:** Nenhum · **Tipo:** referência · **Domínio:** objeto compatível com o receptor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 2 · step_1

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 2**. **Uso e efeito:** Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa **Valor:** Nenhum · **Tipo:** referência · **Domínio:** objeto compatível com o receptor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 3 · step_2

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 3**. **Uso e efeito:** Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa **Valor:** Nenhum · **Tipo:** referência · **Domínio:** objeto compatível com o receptor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 4 · step_3

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 4**. **Uso e efeito:** Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa **Valor:** Nenhum · **Tipo:** referência · **Domínio:** objeto compatível com o receptor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 5 · step_4

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 5**. **Uso e efeito:** Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa **Valor:** Nenhum · **Tipo:** referência · **Domínio:** objeto compatível com o receptor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 6 · step_5

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 6**. **Uso e efeito:** Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa **Valor:** Nenhum · **Tipo:** referência · **Domínio:** objeto compatível com o receptor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 7 · step_6

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 7**. **Uso e efeito:** Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa **Valor:** Nenhum · **Tipo:** referência · **Domínio:** objeto compatível com o receptor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

Etapa 8 · step_7

**Onde:** Inspector → **Sequência de tweens** → **Etapas** → **Etapa 8**. **Uso e efeito:** Objeto com Transform Tween ou Tween de propriedade; a sequência reinicia esses tweens quando a etapa começa **Valor:** Nenhum · **Tipo:** referência · **Domínio:** objeto compatível com o receptor. Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. ### Execução | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Ativa**](#field-enabled)
`enabled` | booleano | verdadeiro | verdadeiro \| falso | | [**Iniciar no Play**](#field-autoplay)
`autoplay` | booleano | verdadeiro | verdadeiro \| falso | | [**Ignorar escala de tempo**](#field-ignore-time-scale)
`ignore_time_scale` | booleano | falso | verdadeiro \| falso | | [**Repetição**](#field-loops)
`loops` | enumeração | Uma vez | Infinito \| Uma vez \| Duas vezes \| Três vezes \| Dez vezes |

Ativa · enabled

**Onde:** Inspector → **Sequência de tweens** → **Execução** → **Ativa**. **Uso e efeito:** Desligada não reinicia etapas; a configuração é preservada **Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Iniciar no Play · autoplay

**Onde:** Inspector → **Sequência de tweens** → **Execução** → **Iniciar no Play**. **Uso e efeito:** Sem isto a sequência espera o método Tocar (script ou Conexão de evento) **Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Ignorar escala de tempo · ignore_time_scale

**Onde:** Inspector → **Sequência de tweens** → **Execução** → **Ignorar escala de tempo**. **Uso e efeito:** Vale para os intervalos da sequência; cada tween segue a própria opção **Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Repetição · loops

**Onde:** Inspector → **Sequência de tweens** → **Execução** → **Repetição**. **Uso e efeito:** Quantas vezes a lista inteira de etapas é percorrida **Valor:** Uma vez · **Tipo:** enumeração · **Domínio:** Infinito \| Uma vez \| Duas vezes \| Três vezes \| Dez vezes. ## Roadmap deste componente [Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Presente no APK 0.2.3, com Play, Cancel, Pause, Resume, Step e eventos de etapa/conclusão. Não é uma timeline geral; coordenação de áudio, clipes e qualquer função arbitrária não está declarada. Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade. ## Conferir na sua cena 1. Crie **Sequência de tweens** pelo fluxo indicado e resolva as dependências. 2. Altere uma propriedade por vez e observe o efeito esperado na cena. 3. Salve, reabra e confira os valores autorais. 4. Entre em Play e verifique o comportamento com os recursos reais do projeto. 5. Pare o Play e confira a cena autoral. Este é um roteiro de conferência; não representa um teste executado nesta publicação. ## Limitações da referência A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas. **Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_tween.html). Essa referência não representa paridade funcional. ## Comandos e leituras em Play Os IDs abaixo são operações nativas do componente existente. Não são novos botões de autoria. Use a fachada C# correspondente para nomes e assinaturas; Conexão de evento oferece as ações compatíveis no seletor. Confira o componente e o mundo vivos antes de chamar. | Operação / ID | Uso e efeito | Argumentos | Retorno | |---|---|---|---| | **Tocar** · `play` | Recomeça da etapa 1, cancelando os tweens das etapas em andamento | Nenhum | nada | | **Cancelar** · `cancel` | Interrompe a sequência e os tweens da etapa em andamento, sem voltar poses | Nenhum | nada | | **Pausar** · `pause` | Congela intervalo e tweens da etapa em andamento | Nenhum | nada | | **Retomar** · `resume` | Continua de onde pausou | Nenhum | nada | | **Etapa atual** · `step` | Número da etapa em andamento (1 a 8); zero parada | Nenhum | inteiro | [Assinaturas da fachada TweenSequence](/pt-br/snapshot-2026-10-07/api/astra-components-tweensequence/#membros) ## Eventos do componente No Behavior, a fachada permite inscrever um receptor usando o owner vivo; a inscrição pertence ao lifecycle daquela execução. Uma Conexão de evento precisa de emissor, evento, receptor e ação: adicionar a conexão não define a regra do jogo. | Evento / ID | Quando ocorre | Dados enviados | |---|---|---| | **Etapa começou** · `step_started` | Emitido quando cada etapa reinicia o seu tween; carrega o número da etapa | Etapa: inteiro | | **Concluiu** · `completed` | Emitido uma vez quando as repetições finitas terminam | Nenhum |