Controlo do skybox

Alterar a hora do skybox

Pode alterar a forma como um jogador vê o skybox sempre que estiverem na sua scene; isto também afeta a matiz e a direção da iluminação global.

O céu em Decentraland segue um ciclo padrão de dia/noite que demora 2 horas a completar, por isso há 12 ciclos completos por cada dia real. Se a scene não estiver a impor nenhuma hora do dia fixa, então os jogadores também podem mudar para uma hora do dia específica, alterando um seletor na sua UI.

Sempre que os jogadores entram numa scene com uma hora do dia diferente, ou a scene altera a hora do dia dinamicamente, o skybox faz uma transição suave ao longo de alguns segundos para este novo valor.

Hora do dia fixa

Você pode definir um horário fixo do dia para a sua scene. Todos os jogadores verão a scene nesse horário, e o skybox não seguirá o ciclo de dia/noite.

No Creator Hub, abra as definições da scene e clique em Configurações aba para encontrar a seção Skybox . Desmarque a opção Auto e defina o horário do dia desejado.

Você também pode definir a hora do dia do skybox no código da sua scene. Para fazer isso, adicione a seguinte seção ao seu scene.json no nível raiz:

 "skyboxConfig": {
    "fixedTime": 36000
  }

O número refere-se ao número de segundos desde o início do dia, variando de 0 (que corresponde a 00:00) até 86400 (que corresponde a 24:00). Qualquer número superior a 86400 também é interpretado como meia-noite.

Aqui estão mais alguns exemplos de valores válidos:

• 0 seconds => 00:00

• 21600 seconds => 06:00

• 43200 seconds => 12:00

• 64800 seconds => 18:00

• 86400 seconds => 24:00

Ler a hora do dia

Pode ler a hora do dia a partir do código da sua scene usando o getWorldTime() função.

import { getWorldTime } from '~system/Runtime'

executeTask(async () => {
  let time = await getWorldTime({})
  console.log(time.seconds)
})

A função devolve um número entre 0 e 86400, onde 0 é meia-noite e 86400 é 24:00. Este valor é atualizado se a scene alterar a hora do dia dinamicamente ou se o jogador alterar a hora do dia na UI. Caso contrário, devolve o valor relativo ao ciclo padrão de dia/noite.

Alterar a hora do dia dinamicamente

Pode alterar a hora do dia dinamicamente usando o SkyboxTime componente. Este componente só pode ser adicionado à RootEntity da scene engine.RootEntity.

import { SkyboxTime } from '@dcl/sdk/ecs'

function main() {
  SkyboxTime.create(engine.RootEntity, { fixedTime: 36000 })
}

O fixed_time a propriedade é um número entre 0 e 86400, onde 0 é meia-noite e 86400 é 24:00. Qualquer número superior a 86400 também é interpretado como meia-noite.

Sempre que este componente é adicionado, removido, ou a fixed_time propriedade é alterada, a hora do dia do skybox faz uma transição suave ao longo de alguns segundos para este novo valor. O mesmo acontece quando o jogador sai da scene ou entra nela. Enquanto a hora do dia do skybox estiver fixa, o skybox deixará de seguir a progressão do seu ciclo dia/noite e os jogadores não poderão alterar a hora do dia através da UI.

Por predefinição, a transição acontece sempre na direção para a frente, mas pode alterar isso definindo o transitionMode propriedade para TransitionMode.TM_FORWARD ou TransitionMode.TM_BACKWARD.

import { SkyboxTime, TransitionMode } from '@dcl/sdk/ecs'

function main() {
  SkyboxTime.create(engine.RootEntity, { fixedTime: 36000, transitionMode: TransitionMode.TM_BACKWARD })
}