Clima

Família: Renderização · Grupo: Ambiente · Identificador: astra.environment.weather · 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

Faz o papel do script de clima da Unity: muda nuvens, neblina e atmosfera do Ambiente do mesmo objeto, dosa as partículas de Chuva e Neve que acompanham a câmera e molha, empoça e cobre de neve as superfícies.

Crie por + › Volume e céu › Clima: nasce um Ambiente global (prioridade 2) com o Clima e os filhos Chuva e Neve ligados. Escolha Tipo (Limpo, Nublado, Chuva, Tempestade, Neve) e Intensidade. Em Superfícies ajuste Molhado, Poças e Neve acumulada e os tempos para molhar, secar e acumular.

Vindo de outra engine

Na Unity, o conceito mais próximo está em create-simple-clouds-cloud-layer. 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: Weather, Clima, Chuva, Neve, Tempestade, Rain, Snow, Storm.

Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Renderização / Ambiente → Clima.

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

O Clima escreve propriedades que você vê: Cobertura, Tom e Densidade das nuvens, a neblina do Ambiente e a taxa de emissão das partículas. Na edição a mudança é imediata; no Play passa pela Transição. Vento na precipitação inclina a chuva pelo vento das nuvens. O teto de partículas do aparelho é repartido pelo que cada sistema emite. Custo medido com chuva: cerca de +0,8 ms de GPU.

Guia relacionado: Nuvens e clima

Exemplo de uso

Tipo Chuva, Intensidade 0,7, Variação natural 0,35: no Play as gotas oscilam com pancadas e calmarias (no POCO F7, 3.003 a 3.553 gotas vivas em 2 min) e o chão escurece em 20 s e empoça nos pisos planos. Troque para Neve: céu aberto, sol e telhados com espessura. Tempestade acrescenta relâmpagos com clarão.

Dependências

• Ambiente: Adicione um Ambiente a este objeto: o clima muda as nuvens dele

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.

Clima

Propriedade	Tipo / unidade	Padrão	Domínio
Intensidade intensity	número	0.7	0 … 1
Transição transition_seconds	número · s	8	0 … 120
Variação natural variation	número	0.35	0 … 1
Ritmo da variação variation_period	número · s	45	5 … 600
Ativo enabled	booleano	verdadeiro	verdadeiro | falso
Tipo kind	enumeração	Chuva	Limpo | Nublado | Chuva | Tempestade | Neve

Intensidade · intensity

Onde: Inspector → Clima → Clima → Intensidade.

Uso e efeito: Quanto chove ou neva e quão fechado fica o céu

Valor: 0.7 · Tipo: número · Domínio: 0 … 1.

Aceita tween numérico via contrato de propriedade. Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Transição · transition_seconds

Onde: Inspector → Clima → Clima → Transição.

Uso e efeito: Em Play, tempo para chegar ao clima novo quando tipo ou intensidade mudam

Valor: 8 · Tipo: número · Unidade: s · Domínio: 0 … 120.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Variação natural · variation

Onde: Inspector → Clima → Clima → Variação natural.

Uso e efeito: Em Play a chuva e a neve engrossam e afinam sozinhas; 0 deixa a intensidade fixa

Valor: 0.35 · Tipo: número · Domínio: 0 … 1.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Ritmo da variação · variation_period

Onde: Inspector → Clima → Clima → Ritmo da variação.

Uso e efeito: Tempo médio entre uma pancada e uma calmaria

Valor: 45 · Tipo: número · Unidade: s · Domínio: 5 … 600.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Ativo · enabled

Onde: Inspector → Clima → Clima → Ativo.

Uso e efeito: Desligado, o clima não escreve mais nada; os valores ficam como estão

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

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Tipo · kind

Onde: Inspector → Clima → Clima → Tipo.

Uso e efeito: Limpo, nublado, chuva, tempestade ou neve: muda nuvens, neblina e precipitação

Valor: Chuva · Tipo: enumeração · Domínio: Limpo | Nublado | Chuva | Tempestade | Neve.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Precipitação

Propriedade	Tipo / unidade	Padrão	Domínio
Gotas por segundo rain_rate	número · /s	7000	0 … 20000
Flocos por segundo snow_rate	número · /s	3000	0 … 20000
Altura sobre a câmera height_above_camera	número · m	10	0 … 100
Vento na precipitação wind_influence	número · ×	0.35	0 … 2
Seguir a câmera follow_camera	booleano	verdadeiro	verdadeiro | falso
Chuva rain	referência	Escolher partículas	astra.effects.particle_system · outro objeto
Neve snow	referência	Escolher partículas	astra.effects.particle_system · outro objeto

Gotas por segundo · rain_rate

Onde: Inspector → Clima → Precipitação → Gotas por segundo.

Uso e efeito: Emissão da Chuva na intensidade máxima

Valor: 7000 · Tipo: número · Unidade: /s · Domínio: 0 … 20000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Flocos por segundo · snow_rate

Onde: Inspector → Clima → Precipitação → Flocos por segundo.

Uso e efeito: Emissão da Neve na intensidade máxima

Valor: 3000 · Tipo: número · Unidade: /s · Domínio: 0 … 20000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Altura sobre a câmera · height_above_camera

Onde: Inspector → Clima → Precipitação → Altura sobre a câmera.

Uso e efeito: Onde ficam os emissores, acima da câmera da cena

Valor: 10 · Tipo: número · Unidade: m · Domínio: 0 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Vento na precipitação · wind_influence

Onde: Inspector → Clima → Precipitação → Vento na precipitação.

Uso e efeito: Quanto o vento das nuvens deste Ambiente inclina a chuva e arrasta a neve

Valor: 0.35 · Tipo: número · Unidade: × · Domínio: 0 … 2.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Seguir a câmera · follow_camera

Onde: Inspector → Clima → Precipitação → Seguir a câmera.

Uso e efeito: Leva Chuva e Neve para cima da câmera da cena, como filhos da Main Camera

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

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Chuva · rain

Onde: Inspector → Clima → Precipitação → Chuva.

Uso e efeito: Partículas de chuva: o clima dosa a emissão e as leva sobre a câmera

Valor: Escolher partículas · Tipo: referência · Domínio: astra.effects.particle_system · outro objeto.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Neve · snow

Onde: Inspector → Clima → Precipitação → Neve.

Uso e efeito: Partículas de neve: o clima dosa a emissão e as leva sobre a câmera

Valor: Escolher partículas · Tipo: referência · Domínio: astra.effects.particle_system · outro objeto.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Atmosfera

Propriedade	Tipo / unidade	Padrão	Domínio
Neblina máxima fog_density	número · 1/m	0.045	0 … 0.2

Neblina máxima · fog_density

Onde: Inspector → Clima → Atmosfera → Neblina máxima.

Uso e efeito: Densidade da neblina do Ambiente com chuva ou neve no máximo; vale com Sobrescrever neblina

Valor: 0.045 · Tipo: número · Unidade: 1/m · Domínio: 0 … 0.2.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Relâmpago

Propriedade	Tipo / unidade	Padrão	Domínio
Intervalo médio lightning_interval	número · s	9	1 … 120
Clarão lightning_brightness	número · EV	3	0 … 8
Relâmpagos lightning	booleano	verdadeiro	verdadeiro | falso

Intervalo médio · lightning_interval

Onde: Inspector → Clima → Relâmpago → Intervalo médio.

Uso e efeito: Tempo médio entre relâmpagos em Play

Valor: 9 · Tipo: número · Unidade: s · Domínio: 1 … 120.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Clarão · lightning_brightness

Onde: Inspector → Clima → Relâmpago → Clarão.

Uso e efeito: Quanto o clarão acende as nuvens e a neblina

Valor: 3 · Tipo: número · Unidade: EV · Domínio: 0 … 8.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Relâmpagos · lightning

Onde: Inspector → Clima → Relâmpago → Relâmpagos.

Uso e efeito: Clarões aleatórios nas nuvens durante a Tempestade

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

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Superfícies

Propriedade	Tipo / unidade	Padrão	Domínio
Molhado surface_wetness	número	1	0 … 1
Poças surface_puddles	número	0.6	0 … 1
Neve acumulada surface_snow	número	1	0 … 1
Tempo para molhar wet_seconds	número · s	20	1 … 600
Tempo para secar dry_seconds	número · s	90	1 … 1200
Tempo para acumular snow_seconds	número · s	60	1 … 1200

Molhado · surface_wetness

Onde: Inspector → Clima → Superfícies → Molhado.

Uso e efeito: Quanto a chuva escurece o chão e as paredes e deixa tudo liso e refletindo

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

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Poças · surface_puddles

Onde: Inspector → Clima → Superfícies → Poças.

Uso e efeito: Poças nos pisos planos: espelho d’água escuro que reflete o céu

Valor: 0.6 · Tipo: número · Domínio: 0 … 1.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Neve acumulada · surface_snow

Onde: Inspector → Clima → Superfícies → Neve acumulada.

Uso e efeito: Cobertura branca em telhados, chão e no topo dos objetos

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

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Tempo para molhar · wet_seconds

Onde: Inspector → Clima → Superfícies → Tempo para molhar.

Uso e efeito: Segundos de chuva até o molhado completo (Play)

Valor: 20 · Tipo: número · Unidade: s · Domínio: 1 … 600.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Tempo para secar · dry_seconds

Onde: Inspector → Clima → Superfícies → Tempo para secar.

Uso e efeito: Segundos sem chuva até secar (Play)

Valor: 90 · Tipo: número · Unidade: s · Domínio: 1 … 1200.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Tempo para acumular · snow_seconds

Onde: Inspector → Clima → Superfícies → Tempo para acumular.

Uso e efeito: Segundos de neve até a cobertura completa; derrete no dobro (Play)

Valor: 60 · Tipo: número · Unidade: s · Domínio: 1 … 1200.

Componente Clima escreve as nuvens e a neblina do próprio Ambiente e a emissão de partículas de Chuva e Neve sobre a câmera; relâmpago é clarão nas nuvens e na neblina, sem raio desenhado, trovão nem respingo no chão (colisão de partícula é o P4) Capacidade necessária: render.environment.weather; veja estado do renderer.

Roadmap deste componente

Objetos, Behaviors e composição. Presente na 0.4.0. A chuva ainda entra sob telhados; raio desenhado, trovão e colisão das gotas com a física 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 Clima 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.