For the complete documentation index, see llms.txt. This page is also available as Markdown.

Trigger Area

Reaja à posição do player

Para disparar uma ação quando o jogador entrar ou sair de uma área, use o Trigger Area Smart Item.



O cubo laranja que você vê ao editar sua cena só fica visível no Scene Editor; ele se torna invisível ao executar uma pré-visualização da cena. Você pode ajustar e dimensionar facilmente o cubo laranja para cobrir exatamente a área de que precisa.

Se qualquer parte do corpo de um avatar — o jogador local ou qualquer outro jogador renderizado na cena — se sobrepuser a esse cubo laranja, o evento atribuído será chamado.

Use o On Player Enters Area e On Player Leaves Area tipos de trigger no item Triggers componente. As ações nesses eventos de trigger são ativadas sempre que o jogador entra ou sai da área.



Você pode adicionar quantas ações diferentes quiser no mesmo evento de trigger; isso ativará todas elas simultaneamente.

💡 Dica: Se as áreas de trigger na sua scene começarem a atrapalhar a edição de outros conteúdos, lembre-se de que você sempre pode bloqueá-las e/ou ocultá-las no Entity Tree.



Você também pode adicionar Condições de trigger, para que as ações sejam realizadas apenas se certas condições forem atendidas na cena. Por exemplo, você poderia ter uma área de trigger que abre uma porta de correr quando o jogador entra; você poderia usar uma condição ali para verificar o estado de uma alavanca que funciona como um interruptor de energia e só abrir a porta se a energia estiver ligada. Veja Estados e condições para mais detalhes.



Múltiplas áreas de trigger podem se sobrepor e não afetam umas às outras.

📔 Nota: Você também pode usar On Player Enters Area e On Player Leaves Area eventos de trigger em qualquer outro Smart Item, mas lembre-se de que pode ser desafiador saber a área coberta pelo trigger.

O tamanho da área acionável não se relaciona com a forma visível do item nem com seus colliders; é sempre um cubo de 1 m de cada lado, afetado pela escala do item.

💡 Dica: As áreas de trigger no Scene Editor são disparadas para qualquer avatar — o jogador local e quaisquer outros jogadores renderizados nas proximidades. Se você precisar reagir apenas ao jogador local e ignorar outros avatares, recorra ao código e use o componente TriggerArea do SDK7 com o CL_MAIN_PLAYER camada de colisão.

Atualizado