> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/operar-ao-vivo/scene-admin.md).

# Admin da scene

Conceda a certos jogadores o papel especial de **administrador** na sua cena.

Durante um evento ao vivo, um administrador pode controlar espontaneamente o que acontece na cena de dentro da Decentraland, sem precisar agendar ações com antecedência ou depender de um serviço de terceiros. Comece a tocar a música quando uma multidão suficiente tiver se reunido, solte confete ou faça uma nave espacial aparecer quando a hora parecer certa.

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

Quando um administrador de cena visita sua cena, ele vê uma UI especial no canto superior direito que só ele consegue ver. Por meio dessa UI, ele pode reproduzir vídeos ou transmissões ao vivo, enviar anúncios, banir jogadores ou ativar qualquer smart item configurado para ser ativado dessa forma. Essas ações são vistas por todos os outros jogadores na cena que estejam conectados à mesma comms island que o admin.

![](/files/b20ecc18e36514b88f761d4c1f38541f22f2c4a6)

## Configurando administradores

Para atribuir administradores, você precisa adicionar o **Ferramentas de administração** smart item à sua cena.

![](/files/1aed3b1d889da68d435fa94eafa84207c196f5d7)

{% hint style="warning" %}
**📔 Observação**: Atualize sua cena para usar as dependências mais recentes.

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

Enquanto você estiver desenvolvendo a cena e testando-a localmente, você sempre será um administrador. Depois que a cena for publicada, qualquer pessoa com permissões de publish para a cena também se torna automaticamente um administrador. Isso inclui:

* O proprietário das parcelas LAND ou do NAME do World onde a cena é publicada
* Qualquer pessoa a quem sejam concedidos **direitos de operador** nessas parcelas ou nome. Veja [Conceder permissões](https://docs.decentraland.org/player/marketplace/land-manager/#give-permissions).
* Qualquer usuário que esteja alugando esse terreno. Veja [Rentals](https://docs.decentraland.org/player/marketplace/rentals/).

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

1. Publique a cena e visite a versão ao vivo como administrador
2. Abra a **Permissões e moderação** aba.

   ![](/files/31baee7017f5fa04b437d15a239fc20f22bd8dd2)
3. Escreva o endereço da Wallet da pessoa que você quer adicionar ao lado de **Adicionar um administrador** e clique em **Adicionar**.

Você pode ver quem é administrador na cena clicando no **Ver lista de administradores** botão. Nesta tela, você também pode **Remove** pessoas da lista de administradores.

![](/files/e4de7adeadb7f8f12dfd2eca5dd7e05023dfda0c)

{% hint style="warning" %}
**📔 Observação**: Só é possível remover o papel de administrador de jogadores que foram adicionados manualmente à lista por meio da **Permissões e moderação** aba. Jogadores que são proprietários, operadores ou locatários da cena são exibidos nesta lista, mas não podem ter seus papéis de administrador removidos por esta UI. Para remover o papel de administrador de um operador, primeiro você deve remover seu papel de operador.
{% endhint %}

Sempre que um jogador admin estiver na cena, ele verá uma UI especial no canto superior direito. Jogadores que não são admin não veem essa UI.

![](/files/b20ecc18e36514b88f761d4c1f38541f22f2c4a6)

### Verifique o status de admin via código

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

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

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

{% hint style="info" %}
**💡 Dica**: Para mais informações sobre funções assíncronas, consulte [Funções assíncronas](/creator/content-creator-pt/cenas-sdk7/padroes-de-programacao/async-functions.md).
{% endhint %}

## Reprodução de vídeo

Uma das ações mais comuns que os admins fazem é reproduzir vídeos. O painel de admin inclui uma seção de reprodução de vídeo onde eles podem controlar qualquer coisa relacionada a vídeos.

Para habilitar isso, você precisa adicionar um **Video Player** smart item à sua cena e vinculá-lo ao smart item Admin Tools.

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

   ![](/files/fd2cf4be0027fdb808e232f3cb20b593c8c881b3)

   Veja [Ecrã de vídeo](/creator/content-creator-pt/scene-editor/interatividade/video-screen.md) para mais detalhes sobre como configurar a fonte de mídia padrão e outras configurações do smart item Video Player. A maioria dessas configurações pode ser sobrescrita pelo admin depois que a cena estiver em execução.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>📔 Observação</strong>: Um admin só pode gerenciar vídeos que sejam reproduzidos no smart item Video Screen, e não em telas adicionadas via código SDK.</p><p>Você pode incluir quantas video screens quiser. Em geral, evite ter mais de um vídeo diferente sendo reproduzido ao mesmo tempo, pois isso prejudica bastante o desempenho.</p></div>
2. Abra o Smart Item Admin Tools, certifique-se de que o **Ecrãs de vídeo** checkbox esteja habilitado para que esta seção apareça. Em seguida, selecione a tela em uma lista dropdown e dê a ela um nome amigável para exibir na UI de admin. Você pode adicionar quantas Video Screens quiser; cada tela é controlada independentemente.

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

Depois que o acima estiver configurado, os usuários admin na sua cena podem abrir o painel de admin e selecionar a seção de vídeo para controlar essas video screens.

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

Se a sua cena tiver várias video screens independentes, o **Tela atual** dropdown permite escolher qual video screen controlar. A lista exibe os nomes que você deu a cada video screen na configuração do smart item Admin Tools.

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

## Fontes de mídia

Há três opções de fonte de mídia para reproduzir vídeos:

* **URL de vídeo**: Reproduza um arquivo de vídeo do seu sistema de arquivos local ou de uma URL. Cole a URL do vídeo no **URL de vídeo** campo e clique no botão verde **Ativar** botão. O vídeo começará a ser reproduzido na tela selecionada para todos os jogadores. Você também pode parar, pausar, reiniciar, silenciar ou alterar o volume do vídeo.

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

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>📔 Observação</strong>: Nem toda URL de vídeo funcionará. Vídeos de alguns sites têm políticas rígidas sobre seu conteúdo e bloquearão o acesso a eles a partir de Decentraland. Veja <a href="/pages/fdb421da1f6c42f57f4a399eacbaffadffaf8be2#streaming-from-other-sources">Streaming de outras fontes</a> para mais informações sobre o que você pode e não pode reproduzir em Decentraland.</p></div>
* **DCL Cast**: Use o app web gratuito de streaming da Decentraland para compartilhar facilmente sua câmera ou tela com outros jogadores na cena, sem precisar configurar um software de streaming.

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

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

  Veja [Transmissão ao vivo](/creator/content-creator-pt/scene-editor/operar-ao-vivo/live-streaming.md) para mais informações sobre como configurar uma transmissão ao vivo.

Cada tela na sua cena terá uma das fontes de mídia acima definida como **Ativa**. Você pode clicar nos **URL de vídeo**, **DCL Cast** ou **Streaming** botões para explorar as configurações de cada seção; você não interromperá o que estiver sendo reproduzido no momento até clicar no **Ativar** botão em qualquer uma das seções.

![](/files/81b793f347b28787263f1a7663c1711ca712f31c)

## Anúncios

No **Anúncios** aba do painel de admin, administradores podem escrever mensagens que serão vistas por todos os jogadores na cena. Mensagens assim só podem ser enviadas por administradores, então outros jogadores as perceberão como mais legítimas do que uma mensagem no chat de alguém que afirma ser um administrador.

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

![](/files/e7e66ab3d26964dc9bbb5afb35b8ca45d9fca6e2)

## Banir jogadores

Você pode banir jogadores da sua cena selecionando a **Moderação** aba da UI de admin, escrevendo o nome ou o endereço da Wallet do jogador que você quer banir e clicando no **Banir** botão.

![](/files/31baee7017f5fa04b437d15a239fc20f22bd8dd2)

{% hint style="info" %}
**💡 Dica**: Para obter o endereço da Wallet de um jogador, clique no avatar dele para abrir o perfil e, em seguida, clique no **Copiar para a área de transferência** botão ao lado do endereço da Wallet.
{% endhint %}

Jogadores banidos não poderão carregar sua cena nem interagir com qualquer conteúdo dela. Outros jogadores não os verão na cena nem lerão nenhuma das mensagens de chat deles.

{% hint style="warning" %}
**📔 Observação**: Os efeitos do seu banimento são imediatos e permanentes. Depois que um jogador é banido, ele permanecerá banido até que o banimento seja removido. Enquanto estiver banido, um jogador não pode ver nem interagir com sua cena, não pode conversar no canal Nearby enquanto estiver nela, e os outros jogadores na cena não podem vê-lo.

Se um jogador sair dos limites da sua cena, ele não será mais afetado pelas regras de banimento da sua cena e voltará a ver jogadores banidos.
{% endhint %}

Clique **Ver lista de banidos** para ver a lista de jogadores atualmente banidos. Desta lista você também pode **Desbanir** jogadores.

## Acionar smart items

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

* Adicione um smart item à sua cena
* Abra as configurações da **Ferramentas de administração** Smart Item no Creator Hub
* No **Ações de smart item** seção, adicione o smart item no dropdown, dê a ele um nome personalizado e selecione uma ação padrão

Depois que o acima estiver configurado, os admins podem acionar a ação abrindo a **Ações de Smart Item** seção da UI de admin e, em seguida, selecionando um item da lista dropdown. Depois, podem escolher uma das ações do item na **Actions** dropdown e clicar em **Executar ação** para acioná-la. Também há um botão para **Ocultar/Mostrar** o item selecionado.

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

Você também pode mostrar ou ocultar qualquer smart item nesta lista, mesmo que ele não inclua uma ação para isso.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scene-editor/operar-ao-vivo/scene-admin.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
