Hora do dia

Família: Luz · Grupo: Luzes · Identificador: astra.render.time_of_day · Payload: 2

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

Gira o objeto da luz direcional pela hora, data e latitude, como um script de ciclo de dia da Unity. O céu procedural, a luz ambiente e a neblina acompanham o ângulo do sol; à noite uma Lua opcional vira a luz principal.

Crie por + › Luzes › Sol com dia e noite (cria o Sol e a Lua já ligados) ou adicione a uma Luz direcional existente. Defina Hora, Latitude, Dia do ano e Norte. Duração do dia maior que zero faz a hora andar no Play. Em Lua, aponte outra Luz direcional para ela seguir a lua da mesma hora e data.

Vindo de outra engine

Na Godot, o conceito mais próximo está em directionallight3d. A Astra estudou essa referência; os campos e o comportamento são os desta página, sem paridade garantida. Palavras que a busca de Adicionar componente aceita: TimeOfDay, DayNight, Ciclo, dia, noite, Sol, Lua, Hora.

Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Luz / Luzes → Hora do dia.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é Astra.Components.TimeOfDay.

A rotação do transform muda de verdade e aparece no gizmo e no Inspector; quem escreve a rotação da luz por script disputa com a Hora do dia. Com duas direcionais, o céu usa a que tem Hora do dia. Fase da lua sai do dia do ano. No Play a hora avança no próprio componente; a hora escrita por script vale no quadro seguinte.

Guia relacionado: Dia e noite e a Lua

Exemplo de uso

Com o Sol com dia e noite na Vila, ponha Hora 17,4: o horizonte fica avermelhado e as sombras compridas. Ponha 22: a Lua (0,5 lux, 12000 K) projeta a sombra e as estrelas giram com a hora. Para um dia de 24 minutos, Duração do dia 24. Para o ciclo inteiro ficar legível, troque o Volume para Exposição Automática.

Dependências

• Luz: Adicione uma Luz direcional a este objeto: a hora do dia move o sol

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	2

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.

Hora do dia

Propriedade	Tipo / unidade	Padrão	Domínio
Hora hour	número · h	10	0 … 24
Duração do dia day_length_minutes	número · min	0	0 … 1440
Latitude latitude	número · °	-15	-90 … 90
Dia do ano day_of_year	número	172	1 … 366
Norte north_degrees	número · °	0	0 … 360
Ativo enabled	booleano	verdadeiro	verdadeiro | falso
Lua moon_light	referência	Nenhuma (noite sem luar)	astra.render.light

Hora · hour

Onde: Inspector → Hora do dia → Hora do dia → Hora.

Uso e efeito: Hora solar local; com Duração do dia, avança em Play

Valor: 10 · Tipo: número · Unidade: h · Domínio: 0 … 24.

Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: render.environment.time_of_day; veja estado do renderer.

Duração do dia · day_length_minutes

Onde: Inspector → Hora do dia → Hora do dia → Duração do dia.

Uso e efeito: Minutos reais para 24 h de jogo; 0 congela a hora

Valor: 0 · Tipo: número · Unidade: min · Domínio: 0 … 1440.

Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: render.environment.time_of_day; veja estado do renderer.

Latitude · latitude

Onde: Inspector → Hora do dia → Hora do dia → Latitude.

Uso e efeito: Altura do sol ao meio-dia e duração da noite; negativo no hemisfério sul

Valor: -15 · Tipo: número · Unidade: ° · Domínio: -90 … 90.

Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: render.environment.time_of_day; veja estado do renderer.

Dia do ano · day_of_year

Onde: Inspector → Hora do dia → Hora do dia → Dia do ano.

Uso e efeito: Estação e fase da lua; 172 é o solstício de junho

Valor: 172 · Tipo: número · Domínio: 1 … 366.

Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: render.environment.time_of_day; veja estado do renderer.

Norte · north_degrees

Onde: Inspector → Hora do dia → Hora do dia → Norte.

Uso e efeito: Gira o caminho do sol em torno do eixo vertical

Valor: 0 · Tipo: número · Unidade: ° · Domínio: 0 … 360.

Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: render.environment.time_of_day; veja estado do renderer.

Ativo · enabled

Onde: Inspector → Hora do dia → Hora do dia → Ativo.

Uso e efeito: Desligado, o componente para de agir e conserva os dados.

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Lua · moon_light

Onde: Inspector → Hora do dia → Hora do dia → Lua.

Uso e efeito: Luz direcional girada até a lua desta hora; à noite ilumina com a fase e projeta a sombra

Valor: Nenhuma (noite sem luar) · Tipo: referência · Domínio: astra.render.light.

Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: render.environment.time_of_day; veja estado do renderer.

Roadmap deste componente

Renderização e materiais. Presente na 0.4.0. Eventos Hora mudou, Nascer do sol, Pôr do sol e Dia mudou na Conexão de evento e em C# (HourChanged, Sunrise, Sunset, DayChanged); Speed acelera o dia. Eclipses e refração atmosférica não existem.

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 Hora do dia 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.

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
Hora mudou · hour_changed	A hora inteira mudou: passou o tempo ou um script escreveu outra hora	Hora: inteiro (h)
Nascer do sol · sunrise	O sol subiu acima do horizonte	Nenhum
Pôr do sol · sunset	O sol desceu abaixo do horizonte	Nenhum
Dia mudou · day_changed	A hora passou de 24 h; o Dia do ano avança um	Dia do ano: inteiro