# Smart Items - Básico

Alguns dos itens no catálogo do Scene Editor são **Smart Items**. Jogadores podem interagir com estes, eles têm propriedades configuráveis e podem acionar ações em outros smart items. Por exemplo: portas que podem ser abertas e fechadas, plataformas que se movem para cima e para baixo, ou botões e alavancas que podem ativar outros itens.

{% embed url="<https://www.youtube.com/watch?v=z7HF4GR01hE>" %}

Você pode reconhecer esses itens no explorador de asset pack porque eles têm um ícone de raio e um fundo com cor diferente.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f368bfdf7894d18f29875528bdd91cf8429e70b3%2Fsmart-items.jpg?alt=media)

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.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-26c0c6fbe09714f92806651fe637acf153da0e80%2Fsmart-item-icon.png?alt=media)

## 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 uma preview da cena para testá-lo.

Aqui estão alguns itens comuns e seus comportamentos padrão:

* **Portas**: Portas são abertas ou fechadas quando clicadas. Você pode mudar 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, alternam entre dois estados. Faça cada posição da alavanca executar ações diferentes em outros smart items.
* **Baús**: Eles se comportam 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, sua velocidade, etc.
* **Trigger area**: Um item invisível que pode acionar outros smart items quando o jogador entra em sua área. Veja [About trigger areas](#about-trigger-areas).
* **Video Player**: Uma tela para exibir vídeos ou streams ao vivo. Veja [Playing Videos](#playing-videos).
* **Audio Stream**: Reproduz áudio de um stream ao vivo. Veja [Playing Audio Streams](#playing-audio-streams)
* **NFT**: Exibe uma imagem de NFT como retrato. Veja [Displaying NFTs](#displaying-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:

* **Hover text**: Qual texto é exibido na UI como uma dica quando o jogador passa o cursor sobre o item. Por exemplo, uma porta pode dizer "Open"
* **Interaction**: Com qual botão o item é ativado? Em um teclado típico:
  * **Primary** is **E**
  * **Secondary** is **F**
  * **Pointer** is **Mouse Left Button**
  * **Action3** is key **1**
  * **Action4** is key **2**
  * **Action5** is key **3**
  * **Action6** is key **4**
* **When clicked**: Selecione qual ação é realizada quando o item é interagido, usando o botão do campo **Interaction** Você pode ativar quantas ações quiser, estas podem ser ações nesse mesmo item, ou em outros itens também.

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 qualquer coisa 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](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced).

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-958f6f53945e119e770d84f808814c18d173c9c1%2Fadvanced-mode.png?alt=media)

## Chamar uma ação em outro item

Smart items podem acionar ações em outros smart items, para que aconteçam toda vez que o item é ativado. Basta selecionar o item que você quer chamar, a partir de uma lista de todos os itens na cena, então selecionar uma ação. Itens diferentes expõem ações diferentes.

Por exemplo, aqui está um botão que abre ou fecha uma porta. Cada vez que o botão é pressionado, a porta vai ou abrir ou fechar.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-110156bc3c8fa17336e61490402e1cb19d83ff47%2Fbutton-to-door.png?alt=media)

Aqui está uma alavanca que abre uma porta quando ativada, e fecha essa porta quando desativada.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6e4cb24dd1b7e3e9b438b8825c0479672bc2254c%2Flever-to-door.png?alt=media)

Você pode adicionar quantas ações diferentes de itens distintos para serem acionadas juntas. Basta clicar **+ Assign Action**.

Remova ações clicando nos três pontos ao lado de uma ação e selecionando *Remove action*.

Você também pode encadear ações. Por exemplo, se a porta que é aberta pela alavanca inclui uma ação em seu próprio campo **When Opened** essa ação também será acionada indiretamente pela alavanca.

Se você usar o [Advanced mode](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced) você também pode adicionar lógica condicional a esse tipo 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 Trigger Area smart item para acionar uma ação quando o jogador entra em uma área.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-649dfd99d06849f543399b5b89a6a31a015cb439%2Ftrigger.png?alt=media)

Use o **On Player Enters Area** e **On Player Leaves Area** tipos de trigger nos **Triggers** components

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f8389cd077c495e0b8ada33ca0da01800eee7dcd%2Fon_player_enters.png?alt=media)

Veja [Trigger area](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/trigger-area) para mais informações.

### Ações de trigger nos componentes do item são ativadas toda vez que o jogador entra ou sai da área.

Paredes invisíveis

Uma coleção de formas invisíveis que podem impedir jogadores de atravessar ou clicar através de uma área.

Veja [Essas paredes invisíveis podem ser úteis ao importar um modelo 3D que não tem uma malha de collider, ou quando você quer criar uma parede que não seja visível para o jogador.](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/essenciais-de-conteudo-3d/colliders) para mais informações.

### Colliders

Click area

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e8ab432fd689e68f097f47e600c1789404f7ee4c%2Fclick-area.png?alt=media)

### Um cubo invisível que pode ser clicado por jogadores para acionar ações em qualquer outro smart items. Este 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 ao apontar o cursor para ele.

Reproduzindo vídeos

* **Reproduza vídeos a partir de:**
* **Local files**
* **Stream from a URL** [**Stream live from**](https://docs.decentraland.org/creator/content-creator-pt/operar-ao-vivo/live-streaming#dcl-cast)
* **Stream from a URL** [**Decentraland Cast**](https://docs.decentraland.org/creator/content-creator-pt/operar-ao-vivo/live-streaming#stream-method) **RTMP Software**

{% hint style="warning" %}
**📔 Nota**(OBS, XSplit, StreamYard, etc.)
{% endhint %}

Veja [: Evite reproduzir mais de um vídeo ao mesmo tempo em sua cena, pois isso pode afetar severamente o desempenho para os jogadores. Sempre pare outros vídeos antes de reproduzir um segundo vídeo.](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/video-screen) para mais informações.

### Play Videos

Reproduzindo streams de áudio **Audio Stream** Reproduza um stream de áudio a partir de uma URL, usando o

{% hint style="info" %}
**📔 Nota**smart item.

```ts
: Nem todos os serviços de streaming permitem que você reproduza seu áudio fora do site deles. A seguir estão alguns exemplos que funcionam em Decentraland:
GRAFFITI = 'https://n07.radiojar.com/2qm1fc5kb.m4a?1617129761=&rj-tok=AAABeIR7VqwAilDFeUM39SDjmw&rj-ttl=5'
SIGNS = 'https://edge.singsingmusic.net/MC2.mp3'
DELTA = 'https://cdn.instream.audio/:9069/stream?_=171cd6c2b6e'
```

{% endhint %}

JAZZ = '<https://live.vegascity.fm/radio/8010/the\\_flamingos.mp3>'

### Displaying NFTs

Você pode ajustar o volume do seu stream. Observe que o áudio do stream não é posicional, ele é ouvido com volume uniforme por toda a sua cena. **NFT** Para exibir um NFT em um porta-retrato, use o

* smart item. Você deve fornecer os seguintes campos:

{% hint style="info" %}
**📔 Nota**Network **: Atualmente** ethereum
{% endhint %}

* é a única rede suportada.
* NFT Collection Contract: O smart contract da coleção de NFT.

![NFT shape](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a9cb3597437e714e11f51e76c1315a1420e3d93e%2Fnft-shape.png?alt=media)

Token ID: O ID do token desse colecionável NFT em particular. [Você pode obter essa informação no](https://opensea.io)OpenSea **Detalhes** , verificando a

![OpenSea details](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-65a8932cfc446537eb6340c224fa47d067a12143%2Fopensea.png?alt=media)

{% hint style="info" %}
**📔 Nota**aba sob a imagem do NFT.

> `: Você também pode obter essa informação a partir da URL do opensea. Por exemplo, se a URL do NFT for a seguinte:`

<https://opensea.io/assets/ethereum/0x32b7495895264ac9d0b12d32afd435453458b1c6/1956>

* Você pode preencher os campos com o seguinte:
* Network: ethereum
* Contract: 0x32b7495895264ac9d0b12d32afd435453458b1c6
  {% endhint %}

Token: 1956

Você também pode configurar uma cor de fundo; isso é particularmente útil para NFTs com fundo transparente. **Você também pode escolher um**Frame style

Veja [, para emoldurar o NFT em uma variedade de estilos diferentes, clássico e moderno.](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items) para mais detalhes.

### Exibir um NFT

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7527837b3d800afc079980b60be5474e6d055b56%2Fhealth-bar.png?alt=media)

O **Barras de vida** Health Bar

* smart item é um ótimo bloco de construção para várias mecânicas de jogo. Pode ser usado de várias maneiras: **Nidifique-o sob o** Player

  ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4ba51729ed3cbcd78807385e4a315de8ea460a96%2Fnested-under-player.png?alt=media)
* smart item é um ótimo bloco de construção para várias mecânicas de jogo. Pode ser usado de várias maneiras: **para exibir a saúde do jogador sobre o avatar** Camera

  ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-3072a9cf441ecc75b66fba64c9ccbb367c4eb4f7%2Fnested-under-camera.png?alt=media)
* para exibi-lo fixo na UI

  ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5c9737b98956f6817efd09ad5de786331cbd9666%2Fnested-under-barrel.png?alt=media)

Nidifique-o sob literalmente qualquer item na cena para acompanhar a saúde desse item

* Outros itens podem interagir com a barra de vida para adicionar ou subtrair vida dela. **Itens como os** ou **Spikes** Robot Enemy

  ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-aed73698225063ac5cdd7257d9de8eb7c571e632%2Freduce-health.png?alt=media)
* podem reduzir a vida **itens como** ou o **First Aid** Healing Pad

  ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-2c80447061c76ae6b412ecbea4853f34d03469aa%2Frestore-health.png?alt=media)

podem restaurá-la. **Você deve configurar o Health Bar para definir o que acontecerá quando a vida for igual a 0. Você pode ressuscitar o jogador na posição de um** Respawn Pad

smart item, resetar o contador da pontuação, reaparecer quaisquer inimigos, exibir um texto na UI, ou o que fizer sentido na lógica do seu jogo.

Você também pode acionar ações quando a vida for menor que um certo valor, por exemplo reproduzir uma música especial ou mostrar uma dica na UI quando a vida for menor que 3. **Health bars podem ser configuradas para afetar qualquer coisa! Por exemplo, adicione uma barra de vida aninhada sob o** Wooden Door **smart item. Esta barra pode ter sua vida reduzida pelo jogador usando o** Sword **smart item, mas também por uma explosão do** Barrel **Spikes**ou o ataque do

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-88d81e8b8ea6b0985853612179ccbe55fff7e1a4%2Fwall-with-health.png?alt=media)

. Para que isso funcione, configure a barra de vida para que ela execute uma ação no item pai quando seu valor for 0. **smart item. Esta barra pode ter sua vida reduzida pelo jogador usando o** Armas como a

## Multiplayer

podem ser pegadas pelo jogador e então usadas para causar dano em qualquer outro item com uma barra de vida que esteja próximo ao jogador ao executar a ação.

Quase todos os smart items têm comportamento multiplayer, de forma que todos os jogadores na cena compartilhem a mesma experiência à medida que os itens mudam de estado. Se o jogador A abre uma porta, o jogador B também vê essa porta aberta. Se o jogador C então entra na cena enquanto os outros jogadores ainda estão lá, ela verá a porta já aberta também.

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 para 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 quebra-cabeça, você pode usar uma* delay *action on a* tools

smart item para fazer com que todos os itens na cena retornem ao seu estado inicial alguns segundos após o quebra-cabeça ser resolvido. [Smart Items - Advanced](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced).

## Você também pode desabilitar o comportamento multiplayer de um item, veja

* *Troubleshooting*.

Um item na minha cena deveria ser clicável, mas não pode ser clicado *collider mesh* 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

## Veja também

* [que tem uma geometria simplificada que 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.](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced)
* [States and conditions](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions)
* [Making any item smart](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/make-any-item-smart)
* [Combine with code](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/expandir-com-codigo/overview)