Sequência de tweens

Família: Lógica · Grupo: Tempo · Identificador: astra.tween.sequence · Payload: 1

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.

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

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.

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 interval_0	número · s	0	0 … 3600
Intervalo da etapa 2 interval_1	número · s	0	0 … 3600
Intervalo da etapa 3 interval_2	número · s	0	0 … 3600
Intervalo da etapa 4 interval_3	número · s	0	0 … 3600
Intervalo da etapa 5 interval_4	número · s	0	0 … 3600
Intervalo da etapa 6 interval_5	número · s	0	0 … 3600
Intervalo da etapa 7 interval_6	número · s	0	0 … 3600
Intervalo da etapa 8 interval_7	número · s	0	0 … 3600
Etapa 2 junto da anterior join_1	booleano	falso	verdadeiro | falso
Etapa 3 junto da anterior join_2	booleano	falso	verdadeiro | falso
Etapa 4 junto da anterior join_3	booleano	falso	verdadeiro | falso
Etapa 5 junto da anterior join_4	booleano	falso	verdadeiro | falso
Etapa 6 junto da anterior join_5	booleano	falso	verdadeiro | falso
Etapa 7 junto da anterior join_6	booleano	falso	verdadeiro | falso
Etapa 8 junto da anterior join_7	booleano	falso	verdadeiro | falso
Etapa 1 step_0	referência	Nenhum	objeto compatível com o receptor
Etapa 2 step_1	referência	Nenhum	objeto compatível com o receptor
Etapa 3 step_2	referência	Nenhum	objeto compatível com o receptor
Etapa 4 step_3	referência	Nenhum	objeto compatível com o receptor
Etapa 5 step_4	referência	Nenhum	objeto compatível com o receptor
Etapa 6 step_5	referência	Nenhum	objeto compatível com o receptor
Etapa 7 step_6	referência	Nenhum	objeto compatível com o receptor
Etapa 8 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 enabled	booleano	verdadeiro	verdadeiro | falso
Iniciar no Play autoplay	booleano	verdadeiro	verdadeiro | falso
Ignorar escala de tempo ignore_time_scale	booleano	falso	verdadeiro | falso
Repetição 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. 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. 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

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