# Admin da cena

Conceda a certos jogadores a função especial de **admin** na sua scene.

Durante um evento ao vivo, um admin pode controlar espontaneamente o que acontece na scene a partir do interior da Decentraland, sem necessidade de agendar ações antecipadamente nem de depender de um serviço de terceiros. Comece a tocar a música quando já houver gente suficiente, largue confettis ou faça aparecer uma nave espacial quando chegar o momento certo.

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

Quando um admin de uma scene visita a sua scene, vê uma UI especial no canto superior direito que só ele consegue ver. Através desta UI, pode reproduzir videos ou live streams, enviar anúncios, banir jogadores ou ativar qualquer smart item que esteja configurado para ser ativado desta forma. Estas ações são vistas por todos os outros jogadores na scene que estejam ligados à mesma comms island que o admin.

![](/files/b20ecc18e36514b88f761d4c1f38541f22f2c4a6)

## Configurar admins

Para atribuir admins, precisa de adicionar o **Scene Admin** smart item à sua scene.

![](/files/1aed3b1d889da68d435fa94eafa84207c196f5d7)

{% hint style="warning" %}
**📔 Nota**: Atualize a sua scene para usar as dependências mais recentes.

<img src="/files/979574cfaa5bc131fe6851da55bb26b8f998b501" alt="" data-size="original">
{% endhint %}

Enquanto está a desenvolver a scene e a testá-la localmente, é sempre um admin. Quando a scene é publicada, qualquer pessoa com permissões de publish para a scene também é automaticamente um admin. Isto inclui:

* O proprietário dos parcels de LAND ou NAMEs de World onde a scene é publicada
* Qualquer pessoa a quem sejam concedidos **direitos de Operator** nestes parcels ou nome. Veja [Conceder permissões](https://github.com/decentraland/docs/blob/main/creator/scene-editor/marketplace/land-manager.md#give-permissions).
* Qualquer utilizador que esteja a alugar esse terreno. Veja [Rentals](https://github.com/decentraland/docs/blob/main/creator/scene-editor/marketplace/rentals.md).

Para atribuir admins adicionais que não têm permissão de publish mas podem fazer live-ops na scene:

1. Publique a scene e visite a versão ao vivo como admin
2. Abra o **Permissions & Moderation** tab.

   ![](/files/31baee7017f5fa04b437d15a239fc20f22bd8dd2)
3. Escreva o endereço da wallet da pessoa que pretende adicionar ao lado de **Add an Admin** e clique em **Add**.

Pode ver quem é admin na scene clicando no botão **View Admin List** . Nesta tela também pode **Remove** pessoas da lista de admins.

![](/files/e4de7adeadb7f8f12dfd2eca5dd7e05023dfda0c)

{% hint style="warning" %}
**📔 Nota**: Só é possível remover a função de admin dos jogadores que foram adicionados manualmente à lista através do separador **Moderation Tools** . Os jogadores que são proprietários, operators ou renters da scene são apresentados nesta lista, mas não podem ser removidos das suas funções de admin a partir desta UI. Para remover a função de admin de um operator, primeiro tem de remover a respetiva função de operator.
{% endhint %}

Sempre que um jogador admin estiver na scene, verá uma UI especial no canto superior direito. Os jogadores não-admin não veem esta UI.

![](/files/b20ecc18e36514b88f761d4c1f38541f22f2c4a6)

### Verificar o estado de admin via código

Também é possível saber se um Player é Admin de uma scene através de código. Isto permite que outros comportamentos estejam disponíveis (ou não) para um Player, por exemplo, permitindo interações com uma Entity específica da scene.

```ts
import { isAdmin } from "@dcl/asset-packs/dist/admin";

async function onPlayerSpawn() {
  const isAdminUser = await isAdmin();
  if (isAdminUser) {
    // Mostrar UI apenas para admins, teleportar para o palco, mostrar Entity, etc.
  }
}
```

{% hint style="info" %}
**💡 Dica**: Para mais informações sobre async functions, veja [Async Functions](/creator/content-creator-pt/scenes-sdk7/padroes-de-programacao/async-functions.md).
{% endhint %}

## Reprodução de video

Uma das ações mais comuns dos admins é reproduzir videos. O painel de admin inclui uma secção de video player onde podem controlar tudo o que esteja relacionado com videos.

Para ativar isto, precisa de adicionar um **Video Player** smart item à sua scene e ligá-lo ao smart item Scene Admin.

1. Adicione um **Video Player** smart item à sua scene

   ![](/files/fd2cf4be0027fdb808e232f3cb20b593c8c881b3)

   Veja [Video Screen](/creator/content-creator-pt/scene-editor/interatividade/video-screen.md) para mais detalhes sobre como pode configurar a fonte de media predefinida e outras definições do smart item Video Player. A maioria destas configurações pode ser substituída pelo admin depois de a scene estar em execução.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>📔 Nota</strong>: Um admin só pode gerir videos que sejam reproduzidos no smart item Video Screen, não em screens adicionados via código do SDK.</p><p>Pode incluir tantas video screens quantas quiser. Em geral, evite ter mais do que um video diferente a ser reproduzido ao mesmo tempo, pois isso prejudica bastante o desempenho.</p></div>
2. Abra o Smart Item Scene Admin e certifique-se de que a **Video Screens** checkbox está ativada para que esta secção seja mostrada. Depois selecione a screen numa lista dropdown e dê-lhe um nome amigável para ser exibido na UI de Admin. Pode adicionar tantas Video Screens quantas quiser; cada screen é controlada independentemente.

   <img src="/files/b65ac1197cb927c233cd26cbdb4cc81ee74b57d9" alt="Nome da scene" width="300">

Depois de configurar o acima, os utilizadores admin na sua scene podem abrir o painel de admin e selecionar a secção de video para controlar estas video screens.

<img src="/files/f9bc1ff2b5d56cacdf3bf22212dafa607371869c" alt="Nome da scene" width="300">

Se a sua scene tiver várias video screens independentes, o dropdown **Current Screen** permite escolher qual video screen controlar. A lista apresenta os nomes que deu a cada video screen na configuração do smart item Admin Tools.

{% hint style="info" %}
**💡 Dica**: Para mostrar o mesmo video em várias screens que possam ser controladas como uma só, veja [Multiple Video Screens](/creator/content-creator-pt/scene-editor/interatividade/video-screen.md#multiple-video-screens).
{% endhint %}

## Media Sources

Existem três opções de media source para reproduzir videos:

* **Video URL**: Reproduza um ficheiro de video a partir do seu filesystem local ou de um URL. Cole um video URL no campo **Video URL** e clique no botão verde **Activate** . O video começará a ser reproduzido na screen selecionada para todos os jogadores. Também pode parar, colocar em pausa, reiniciar, silenciar ou alterar o volume do video.

  <img src="/files/b24ba0a67ce9c8021388745ed14a847ec999c1e7" alt="Nome da scene" width="300">

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>📔 Nota</strong>: Nem qualquer video URL funcionará. Videos de alguns sites têm políticas rigorosas sobre o respetivo conteúdo e bloquearão o acesso a partir da Decentraland. Veja <a href="/pages/fdb421da1f6c42f57f4a399eacbaffadffaf8be2#streaming-from-other-sources">Streaming from other sources</a> para mais informações sobre o que pode e não pode reproduzir na Decentraland.</p></div>
* **DCL Cast**: Use a aplicação web gratuita de streaming da Decentraland para partilhar facilmente a sua camera ou screen com outros jogadores na scene, sem necessidade de configurar um software de streaming.

  <img src="/files/da4e114af88c8f924a7c0c9d80d5d0ed15566259" alt="DCL Cast" width="300">
* **Live stream**: Reproduza uma live stream usando a infraestrutura gratuita de streaming da Decentraland e um software de streaming como o OBS ou o StreamYard.

  <img src="/files/86ddd7e9ca8a0f04fdd26c3bf77ecf1d2f81ede6" alt="Nome da scene" width="300">

  Veja [Live Streaming](/creator/content-creator-pt/scene-editor/operar-em-direto/live-streaming.md) para mais informações sobre como configurar uma live stream.

Cada screen na sua scene terá uma das media sources acima definida como **Active**. Pode clicar nos botões **Video** ou **Live** para explorar as definições de cada secção; não irá interromper o que está atualmente a ser reproduzido até clicar no botão **Activate** em qualquer uma das secções.

![](/files/81b793f347b28787263f1a7663c1711ca712f31c)

## Announcements

No separador **Announcements** do painel de admin, os admins podem লিখ messages que são vistos por todos os jogadores na scene. Mensagens deste tipo só podem ser enviadas por admins, pelo que outros jogadores as considerarão mais legítimas do que uma mensagem no chat de alguém que afirme ser admin.

Selecione a secção Message da UI de admin. Escreva uma mensagem e clique em **Share**. A mensagem pode ter até 90 caracteres.

![](/files/e7e66ab3d26964dc9bbb5afb35b8ca45d9fca6e2)

## Banir jogadores

Pode banir jogadores da sua scene selecionando o separador **Moderation** da UI de admin, escrevendo o nome ou endereço da wallet do jogador que pretende banir e clicando no botão **Ban** .

![](/files/31baee7017f5fa04b437d15a239fc20f22bd8dd2)

{% hint style="info" %}
**💡 Dica**: Para obter o endereço da wallet de um jogador, clique no seu avatar para abrir o respetivo perfil e depois clique no botão **Copy to clipboard** ao lado do endereço da wallet.
{% endhint %}

Os jogadores banidos não conseguirão carregar a sua scene nem interagir com qualquer um dos respetivos conteúdos. Os outros jogadores não os verão na scene nem lerão quaisquer mensagens de chat deles.

{% hint style="warning" %}
**📔 Nota**: Os efeitos do seu ban são imediatos e permanentes. Assim que um jogador é banido, permanecerá banido até que o ban seja levantado. Banir um jogador da sua scene afeta apenas o que os jogadores que estão dentro da sua scene podem ver; se um jogador sair dos limites da sua scene, deixa de ser afetado pelo ban. Os jogadores banidos são invisíveis para os outros jogadores se também estiverem fora da sua scene.
{% endhint %}

Clique em **View Ban List** para ver a lista de jogadores atualmente banidos. A partir desta lista também pode **Unban** jogadores.

## Acionar smart items

Para acionar uma ação de qualquer smart item na scene:

* Adicione um smart item à sua scene
* Abra as definições de **Scene Admin** Smart Item no Creator Hub
* No separador **secção Smart item actions** , adicione o smart item a partir do dropdown, dê-lhe um nome personalizado e selecione uma ação predefinida

Depois de configurar o acima, os admins podem acionar a ação abrindo a secção **Smart Item Actions** da UI de admin e depois selecionando um item na lista dropdown. Em seguida, podem clicar no botão **Default** para acionar a ação predefinida desse item, ou selecionar qualquer outra ação do item na lista.

<img src="/files/ba2e3695cdb147b5aa3ef124047961030c1322ac" alt="Nome da scene" width="300">

Também pode mostrar ou esconder qualquer smart item nesta lista, mesmo que não inclua uma ação para isso.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scene-editor/operar-em-direto/scene-admin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
