Smart Items - Básico
Usando smart items na sua scene para adicionar interatividade.
Alguns dos itens no catálogo do Scene Editor são Smart Items. Os jogadores podem interagir com estes, eles têm propriedades configuráveis e podem disparar ações em outros smart items. Por exemplo: portas que podem ser abertas e fechadas, plataformas que sobem e descem, ou botões e alavancas que podem ativar outros itens.
Você pode reconhecer esses itens no asset pack explorer porque eles têm um ícone de raio e um fundo de cor diferente.
Você pode reconhecer quais itens na sua cena são smart porque eles têm o ícone de raio ao lado deles na entity tree.
Usando itens
Para usar um smart item, arraste-o para a cena como qualquer outro item. Todos os itens incluem um comportamento padrão; execute um preview da cena para experimentá-lo.
Aqui estão alguns itens comuns e seus comportamentos padrão:
Portas: As portas são abertas ou fechadas quando clicadas. Você pode alterar esse comportamento para que sejam abertas por botões, trigger areas, etc.
Botões: Quando clicados, eles reproduzem som e uma animação como feedback. Adicione mais ações aos seus eventos de trigger para ativar outros smart items.
Alavancas: Quando clicadas, elas alternam entre dois estados. Faça com que cada posição da alavanca execute ações diferentes em outros smart items.
Baús: Eles funcionam como portas; por padrão, são abertos ou fechados ao clicar. Você pode colocar itens menores dentro deles.
Plataformas: Elas se movem entre duas posições. Use suas ações de tween para controlar para onde se movem, a velocidade etc.
Trigger area: Um item invisível que pode disparar outros smart items quando o jogador entra na sua área. Veja Sobre trigger areas.
Avatar Modifier Area: Uma área invisível que altera como os avatars se comportam ou aparecem dentro dela, por exemplo ocultando avatars ou desativando popups de passport. Veja Modifier Areas.
Camera Modifier Area: Uma área invisível que força a câmera do jogador para primeira ou terceira pessoa enquanto estiver dentro dela. Veja Modifier Areas.
Video Player: Uma tela para exibir vídeos ou streams ao vivo. Veja Reproduzindo Vídeos.
Audio Stream: Reproduza áudio de um stream ao vivo. Veja Reproduzindo Streams de Áudio
NFT: Exiba uma imagem de NFT como um retrato. Veja Exibindo NFTs
Todos os smart items podem ser configurados para se comportarem de maneiras personalizadas. Por exemplo, quão longe uma plataforma se move, ou o que um botão ativa.
Configurar um item
Selecione um item no Scene Editor para ver todas as suas propriedades à direita.
Alguns campos típicos que você pode encontrar em muitos itens são:
Texto de hover: Qual texto é exibido na UI como dica quando o jogador passa o cursor sobre o item. Por exemplo, uma porta pode dizer "Open"
Interação: Com qual botão o item é ativado? Em um teclado típico:
Primário é E
Secundário é F
Pointer é Botão Esquerdo do Mouse
Action3 é a tecla 1
Action4 é a tecla 2
Action5 é a tecla 3
Action6 é a tecla 4
Quando clicado: Selecione qual ação é executada quando o item é interagido, usando o botão do Interação campo. Você pode ativar quantas ações quiser; elas podem ser ações nesse mesmo item ou também em outros itens.
Cada item tem suas próprias configurações específicas, que podem variar de um item para outro.
Todos os itens têm um Advanced Mode que permite configurar quase tudo sobre eles. Isso inclui coisas como quais sons são reproduzidos ou em que direção uma plataforma se move. Você também pode adicionar ações personalizadas que incluem todo tipo de coisas, como teleportar o jogador, reproduzir animações do avatar, anexar um item às mãos do jogador etc. Você também pode adicionar lógica condicional para ativar algo apenas em certos cenários. Veja Smart Items - Advanced.
Chamar uma ação em outro item
Smart items podem disparar ações em outros smart items, para que aconteçam toda vez que o item for ativado. Basta selecionar o item que você quer chamar, de uma lista de todos os itens na cena, e depois selecionar uma ação. Itens diferentes expõem ações diferentes.
Por exemplo, aqui há um botão que abre ou fecha uma porta. Cada vez que o botão é pressionado, a porta abrirá ou fechará.
Aqui há uma alavanca que abre uma porta quando ativada e fecha essa porta quando desativada.
Você pode adicionar quantas ações diferentes de itens diferentes quiser para serem disparadas juntas. Basta clicar + Atribuir Ação.
Remova ações clicando nos três pontos ao lado de uma ação e selecionando Remover ação.
Você também pode encadear ações. Por exemplo, se a porta aberta pela alavanca incluir uma ação em seu próprio Quando Aberta campo, essa ação também será disparada indiretamente pela alavanca.
Se você usar o Advanced mode você também pode adicionar lógica condicional a esses tipos de ações.
Smart items especiais
Alguns smart items têm características únicas que os tornam muito úteis para cenários comuns:
Trigger areas
Use o smart item Trigger Area para disparar uma ação quando o jogador entrar em uma área.
Use o Player Enters Area e Player Leaves Area tipos de trigger nos Triggers components do item. As ações nesses eventos de trigger são ativadas toda vez que o jogador entra ou sai da área.
Veja Trigger area para mais informações.
Paredes invisíveis
Uma coleção de formas invisíveis que podem impedir que os jogadores atravessem ou cliquem através de uma área.
Essas paredes invisíveis podem ser úteis ao importar um modelo 3D que não tenha uma collider mesh, ou quando você quiser criar uma parede que não seja visível para o jogador.
Veja Colliders para mais informações.
Área de clique
Um cubo invisível que pode ser clicado pelos jogadores para disparar ações em quaisquer outros smart items. Esse item pode ser habilitado ou desabilitado por qualquer outro smart item; quando desabilitado, ele não poderá ser clicado. Você também pode definir o texto que os jogadores veem quando apontam o cursor para ele.
Reproduzindo vídeos
Reproduza vídeos a partir de:
Arquivos locais
Stream de uma URL
Stream ao vivo de Decentraland Cast
Stream ao vivo de RTMP Software (OBS, XSplit, StreamYard, etc.)
📔 Nota: Reproduzir vídeos exige bastante desempenho, então mantenha baixo o número de vídeos reproduzidos ao mesmo tempo. O Engine limita quantos vídeos podem ser reproduzidos simultaneamente com base nas configurações de qualidade de cada jogador (1 no baixo, 5 no médio, 10 no alto) e pausa quaisquer vídeos além desse limite. Veja Reproduzir Vídeos.
Veja Reproduzir Vídeos para mais informações.
Reproduzindo streams de áudio
Reproduza um stream de áudio de uma URL usando o Audio Stream smart item.
Você pode ajustar o volume do seu stream. Observe que o áudio do stream não é posicional; ele é ouvido com volume uniforme em toda a sua cena.
Exibindo NFTs
Para exibir um NFT em uma moldura, use o NFT smart item. Você deve fornecer os seguintes campos:
Rede
NFT Collection Contract: O smart contract da coleção de NFT.
Token ID: O ID do token deste NFT colecionável específico.
Você pode obter essas informações no OpenSea, verificando a aba Detalhes sob a imagem do NFT.
Você também pode configurar uma cor de fundo; isso é particularmente útil para NFTs com fundo transparente.
Você também pode escolher um estilo da moldura, para emoldurar o NFT em uma variedade de estilos diferentes, clássicos e modernos.
Veja NFTs para mais detalhes.
Barras de vida
O Health Bar smart item é um ótimo bloco de construção para várias mecânicas de jogo. Ele pode ser usado de várias maneiras:
Aninhe-o sob o Player para exibir a vida do jogador sobre o avatar
Aninhe-o sob o Camera para exibi-lo fixo na UI
Aninhe-o literalmente sob qualquer item na cena para acompanhar a vida desse item
Outros itens podem interagir com a barra de vida para adicionar ou subtrair vida dela.
Itens como o Spikes ou Robot Enemy podem reduzir a vida
itens como First Aid ou o Healing Pad podem restaurá-la.
Você deve configurar a Health Bar para definir o que acontecerá quando a vida for igual a 0. Você pode reaparecer o jogador na posição de um Respawn Pad smart item, redefinir o contador da pontuação dele, fazer reaparecer quaisquer inimigos, exibir um texto na UI ou qualquer coisa que faça sentido na lógica do seu jogo.
Você também pode disparar ações quando a vida estiver abaixo de um certo valor, por exemplo tocar uma música especial ou mostrar uma dica na UI quando a vida for menor que 3.
As barras de vida podem ser configuradas para afetar qualquer coisa! Por exemplo, adicione uma barra de vida aninhada sob o Wooden Door smart item. Essa barra pode ter sua vida reduzida pelo jogador usando o Sword smart item, mas também por uma explosão do Barrel ou o ataque do Robot Enemy. Para isso funcionar, configure a barra de vida para que ela execute uma ação no seu item pai quando seu valor for 0.
Armas como a Sword podem ser apanhadas pelo jogador e então usadas para causar dano em qualquer outro item com uma barra de vida que esteja perto do jogador ao executar a ação.
Multiplayer
Quase todos os smart items têm comportamento de multiplayer, para que todos os jogadores na cena compartilhem a mesma experiência à medida que os itens mudam de estado. Se o jogador A abrir uma porta, o jogador B também verá essa porta aberta. Se o jogador C então entrar na cena enquanto os outros jogadores ainda estiverem lá, ela também verá a porta já aberta.
No entanto, se não houver jogadores perto da cena, então a cena é restaurada ao seu estado padrão. Então, se todos os jogadores saírem, mas depois o jogador A voltar, ela encontrará a porta fechada (se esse era o estado padrão da porta).
Certifique-se de projetar sua cena de modo que as ações de um jogador não sabotem a cena para outros que venham depois. Por exemplo, se a cena for um jogo de puzzle, você pode usar uma ação de atraso em um ferramentas smart item para fazer com que todos os itens na cena retornem ao seu estado inicial alguns segundos depois que o puzzle for resolvido.
Você também pode desativar o comportamento de multiplayer de um item, veja Smart Items - Advanced.
Resolução de problemas
Um item na minha cena deveria ser clicável, mas não pode ser clicado.
Certifique-se de que ele não esteja sendo obstruído por outra coisa. Você não pode clicar através de outros itens. Alguns itens têm um collider mesh que tem uma geometria simplificada e pode estar obstruindo seu item, mesmo que sua forma visível não pareça estar fazendo isso. Tente mover o item para ver o que acontece.
Veja também
Atualizado