> 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). # Administrador da Scene Administradores da scene têm controle especial sobre o que acontece na scene em tempo real. Conceda a certos jogadores o papel especial de **admin** na sua cena. Durante um evento ao vivo, um admin pode controlar espontaneamente o que acontece na cena de dentro do 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 se reunir, solte confetes ou faça uma nave espacial aparecer quando o momento parecer certo. {% embed url="" %} Quando um admin de cena visita a sua cena, ele vê um painel especial de admin no canto superior direito, que só ele consegue ver. O painel usa abas de ícones no topo para alternar entre seções (Video, Announcements, Smart Items, Permissions). Por meio dessa UI, ele pode reproduzir vídeos ou streams ao vivo, enviar anúncios, banir jogadores ou ativar qualquer smart item que esteja configurado para ser ativado assim. Essas ações são vistas por todos os outros jogadores na cena que estão conectados à mesma comms island que o admin. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ef6ca7ed3804223612f16fa60d45dd2fe09a72df%2Fadmin-console.png?alt=media) ## Configurando admins Para atribuir admins, você precisa adicionar o **Admin Tools** smart item à sua cena. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-15c658c9f27e5caf06e949d5d20f3ccc698ddd83%2Fadmin-smart-item.png?alt=media) {% hint style="warning" %} **📔 Observação**: Atualize sua cena para usar as dependências mais recentes. {% endhint %} Enquanto você está desenvolvendo a cena e testando-a localmente, você é sempre um admin. Quando a cena é publicada, qualquer pessoa com permissões de publicação da cena também se torna automaticamente um admin. Isso inclui: * O proprietário dos parcels de LAND ou do NAME do World onde a cena está publicada * Qualquer pessoa a quem sejam concedidos **direitos de Operator** nesses parcels ou nome. Veja [Conceder permissões](https://docs.decentraland.org/player/marketplace/land-manager/#give-permissions). * Qualquer usuário alugando esse terreno. Veja [Locações](https://docs.decentraland.org/player/marketplace/rentals/). Para atribuir admins adicionais que não tenham permissão de publicação, mas possam fazer live-ops na cena: 1. Publique a cena e visite a versão ao vivo como um admin 2. Abra a **Permissões** aba (pelas abas de ícones no topo do painel de admin). ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-661a1eede71f488537e08ab65b71bb999f9a6a0e%2Fmoderation-tools.png?alt=media) 3. Escreva o endereço da wallet da pessoa que você deseja adicionar ao lado de **Adicionar um Admin** e clique em **Adicionar**. Você pode ver quem é admin na cena clicando no **Ver lista de admins** botão. Nesta tela você também pode **Remover** pessoas da lista de admins. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-04856bc10ed6ef6e5463a1d178f184618cca36f8%2Fadmin-list.png?alt=media) {% hint style="warning" %} **📔 Observação**: Só é possível remover o papel de admin de jogadores que foram adicionados manualmente à lista via a **Permissions & Moderation** aba. Jogadores que são owners, operators ou renters da cena são exibidos nesta lista, mas seus papéis de admin não podem ser removidos a partir desta UI. Para remover o papel de admin de um operator, primeiro você deve remover seu papel de operator. {% 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. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ef6ca7ed3804223612f16fa60d45dd2fe09a72df%2Fadmin-console.png?alt=media) ### Verifique o status de admin via código Também é possível saber se um Player é um Admin de uma scene 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 scene. ```ts import { isAdmin } from "@dcl/asset-packs/dist/admin"; async function onPlayerSpawn() { const isAdminUser = await isAdmin(); if (isAdminUser) { // Mostrar UI exclusiva para admins, teleportar para o palco, mostrar Entity, etc. } } ``` {% hint style="info" %} **💡 Dica**: Para mais informações sobre async functions, veja [Funções assíncronas](/creator/content-creator-pt/scenes-sdk7/padroes-de-programacao/async-functions.md). {% endhint %} ## Reprodução de vídeo Uma das ações mais comuns para admins é reproduzir vídeos. O painel de admin inclui uma seção de reprodutor de vídeo onde eles podem controlar tudo relacionado 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 ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-01d7193f1148aa3fc6d53232dfb403cc815b6bce%2Fvideo-player-item.png?alt=media) Veja [Video Screen](/creator/content-creator-pt/scene-editor/interatividade/video-screen.md) para mais detalhes sobre como você pode configurar a fonte de mídia padrão e outras definições do smart item Video Player. A maioria dessas configurações pode ser sobrescrita pelo admin depois que a cena estiver em execução.

📔 Observação: Um admin só pode gerenciar vídeos que são reproduzidos no smart item Video Screen, não em telas adicionadas via código do SDK.

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 muito o desempenho.

2. Abra o Smart Item Admin Tools e certifique-se de que o **Video Screens** checkbox esteja ativado para que esta seção seja exibida. Em seguida, selecione a tela em uma dropdown list 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. Nome da scene Depois que o acima estiver configurado, os usuários admin na sua scene podem abrir o painel de admin e selecionar a aba de vídeo (pelas abas de ícones no topo) para controlar essas video screens. Nome da scene Se a sua scene tiver várias video screens independentes, o **Tela** dropdown permite que você escolha 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 screens que podem ser controladas como uma só, veja [Multiple Video Screens](/creator/content-creator-pt/scene-editor/interatividade/video-screen.md#multiple-video-screens). {% endhint %} ## Fontes de mídia Um controle segmentado no topo da seção de vídeo permite alternar entre três fontes de mídia. A fonte atualmente ativa é indicada por um rótulo em formato de pílula. Alternar entre abas mostra apenas as definições dessa fonte; isso não interrompe o que está sendo reproduzido no momento até que você clique em **Ativar**. * **URL do vídeo**: Reproduza um vídeo a partir de uma URL. Cole uma URL de vídeo no campo e clique em **Ativar**. O vídeo começará a ser reproduzido na tela selecionada para todos os jogadores. Você também pode parar, pausar, reiniciar e ajustar o volume. Nome da scene

📔 Observação: Nem toda URL de vídeo funcionará. Vídeos de alguns sites têm políticas rígidas sobre o conteúdo e bloquearão o acesso a eles a partir do Decentraland. Veja Streaming de outras fontes para mais informações sobre o que você pode e não pode reproduzir no Decentraland.

* **DCL Cast**: Use o aplicativo web gratuito de streaming do Decentraland para compartilhar facilmente sua câmera ou tela com outros jogadores na cena, sem precisar configurar um software de streaming. Os controles da apresentação (Anterior, Próximo, Reproduzir vídeo, Parar) são exibidos inline quando uma apresentação está ativa. DCL Cast * **Stream**: Reproduza uma transmissão ao vivo usando a infraestrutura gratuita de streaming do Decentraland e um software de streaming como OBS ou StreamYard. Nome da scene 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 seção de fonte de mídia inclui um **controle deslizante de volume** que permite definir o volume de 0% (mudo) a 100%. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d02037369d613aa59b3870b5cbad2a5914434f2a%2Factivate.png?alt=media) ## Anúncios Na **Anúncios** aba do painel de admin, os admins podem escrever mensagens que são vistas por todos os jogadores na cena. Mensagens assim só podem ser enviadas por admins, então os outros jogadores as perceberão como mais legítimas do que uma mensagem no chat de alguém que afirma ser um admin. Selecione a aba Anúncios do painel de admin. Escreva uma mensagem e clique em **Compartilhar**. A mensagem pode ter até 90 caracteres. O campo de entrada é limpo automaticamente após o envio, então você pode digitar uma nova mensagem imediatamente. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-495d94fd0f6bc44e948b8ff744687d7850de5fc3%2Fannouncement.png?alt=media) ## Banir jogadores Você pode banir jogadores da sua cena selecionando a **Permissões** aba do painel de admin, escrevendo o nome ou o endereço da wallet do jogador que você deseja banir e clicando no **Banir** botão. ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-661a1eede71f488537e08ab65b71bb999f9a6a0e%2Fmoderation-tools.png?alt=media) {% hint style="info" %} **💡 Dica**: Para obter o endereço da wallet de um jogador, clique no avatar dele para abrir o perfil e então 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 a sua cena nem interagir com nenhum de seus conteúdos. Os outros jogadores não os verão na cena nem lerão nenhuma de suas mensagens no chat. {% 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 suspenso. Enquanto estiver banido, um jogador não pode ver ou interagir com a 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 os jogadores banidos. {% endhint %} Clique em **Ver lista de banidos** para ver a lista de jogadores atualmente banidos. Nesta 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 definições do **Admin Tools** Smart Item no Creator Hub * Na **Ações do smart item** seção, adicione o smart item a partir do 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 **Smart Items** aba do painel de admin e selecionando um item da lista dropdown. Em seguida, podem escolher uma das ações do item na **Ações** dropdown e clicar em **Executar ação** para acioná-la. Há também um botão para **Ocultar/Mostrar** o item selecionado. Nome da scene 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=&goal= ``` `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.