> 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). # Administração da Scene Os administradores da scene têm controle especial sobre o que acontece na scene em tempo real. Conceda a certos jogadores a função especial de **administrador** na sua scene. Durante um evento ao vivo, um administrador pode controlar espontaneamente o que acontece na scene 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 tiver se reunido, solte confetes ou faça uma nave espacial aparecer quando parecer a hora certa. {% embed url="" %} Quando um administrador da scene visita a sua scene, ele vê um painel especial de administrador no canto superior direito que só ele consegue ver. O painel usa abas de ícones na parte superior para alternar entre seções (Video, Announcements, Smart Items, Permissions). Por meio desta UI, ele pode reproduzir vídeos ou transmissões 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 scene que estejam conectados à mesma ilha de comms que o administrador. ![](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\&token=463da754-9254-4ec1-8e89-5000dc130b8e) ## Configurando administradores Para atribuir administradores, você precisa adicionar o **Ferramentas de administração** smart item para a tua scene. ![](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\&token=3ca8eae9-b2a9-4eec-a143-071588d47b4e) {% hint style="warning" %} **📔 Observação**: Atualize sua scene para usar as dependências mais recentes. {% endhint %} Enquanto você está desenvolvendo a scene e testando-a localmente, você é sempre um administrador. Quando a scene é publicada, qualquer pessoa com permissões de publicação da scene também é automaticamente um administrador. Isso inclui: * O proprietário dos parcels de LAND ou do NAME do World onde a scene é publicada * Qualquer pessoa a quem sejam concedidos **direitos de operador** nesses parcels ou nesse NAME. Veja [Conceder permissões](https://docs.decentraland.org/player/marketplace/land-manager/#give-permissions). * Qualquer usuário que esteja alugando esse LAND. Veja [Aluguéis](https://docs.decentraland.org/player/marketplace/rentals/). Para atribuir administradores adicionais que não têm permissão de publicação, mas podem fazer operações ao vivo na scene: 1. Publique a scene e visite a versão ao vivo como administrador 2. Abra o **Permissions** aba (por meio das abas de ícones no topo do painel de administrador). ![](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\&token=410f0301-681e-4110-9c79-71ed16ef806c) 3. Escreva o endereço de wallet da pessoa que você quer adicionar ao lado de **Adicionar um administrador** e clica em **Add**. Você pode ver quem é administrador na scene clicando no **Ver lista de administradores** botão. Nesta tela, você também pode **Remover** pessoas da lista de administradores. ![](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\&token=22fdb5d7-b513-450a-81e1-9b77035d99ec) {% hint style="warning" %} **📔 Observação**: Só é possível remover a função 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 scene aparecem nesta lista, mas não podem ter suas funções de administrador removidas por esta UI. Para remover a função de administrador de um operador, primeiro você deve remover a função de operador dele. {% endhint %} Sempre que um jogador administrador estiver na scene, ele verá uma UI especial no canto superior direito. Jogadores que não são administradores não veem esta 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\&token=463da754-9254-4ec1-8e89-5000dc130b8e) ### Verificar status de administrador via código Também é possível saber se um jogador é um Administrador de uma scene usando código. Isso permite que outros comportamentos fiquem disponíveis (ou não) para um jogador, 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 administradores, teleportar para o palco, mostrar Entity etc. } } ``` {% hint style="info" %} **💡 Dica**: Para mais informações sobre funções async, veja [Funções Async](/creator/content-creator-pt/scenes-sdk7/padroes-de-programacao/async-functions.md). {% endhint %} ## reprodução de vídeo Uma das ações mais comuns que os administradores fazem é reproduzir vídeos. O painel de administrador inclui uma seção de player de vídeo onde eles podem controlar tudo relacionado a vídeos. Para habilitar isso, você precisa adicionar um **Video Player** smart item à sua scene e vinculá-lo ao smart item Admin Tools. 1. Adicione um **Video Player** smart item à sua scene ![](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\&token=a7478d28-02c6-407d-a7c3-e63d964f062e) Veja [Ecrã de vídeo](/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 substituída pelo administrador quando a scene estiver em execução.

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

Você pode incluir quantas telas de vídeo quiser. Em geral, evite ter mais de um vídeo diferente tocando ao mesmo tempo, pois isso prejudica bastante o desempenho.

2. Abra o smart item Admin Tools e certifique-se de que a **Video Screens** caixa de seleção esteja habilitada para que esta seção seja exibida. Em seguida, selecione a tela em uma lista suspensa e dê a ela um nome amigável para exibir na UI do admin. Você pode adicionar quantas Video Screens quiser; cada tela é controlada independentemente. Nome da scene Depois que o acima estiver configurado, usuários administradores na sua scene podem abrir o painel de administrador e selecionar a aba de vídeo (por meio das abas de ícones na parte superior) para controlar essas telas de vídeo. Nome da scene Se a sua scene tiver várias telas de vídeo independentes, a **Tela** lista suspensa permite escolher qual tela de vídeo controlar. A lista mostra os nomes que você deu a cada tela de vídeo na configuração do smart item Admin Tools. {% hint style="info" %} **💡 Dica**: Para mostrar o mesmo vídeo em várias telas que podem ser controladas como uma só, veja [Vários 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 cápsula. Trocar de aba mostra apenas as configurações dessa fonte; isso não interrompe o que está tocando no momento até você clicar 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 tocar 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 seu 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 scene, sem precisar configurar software de streaming. Os controles de apresentação (Anterior, Próximo, Reproduzir vídeo, Parar) são mostrados 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\&token=3e11fe70-05b3-4970-9bd2-f0b20c08fd41) ## Anúncios No **Anúncios** aba do painel de administrador, administradores podem escrever mensagens que são vistas por todos os jogadores na scene. 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 administrador. Selecione a aba Anúncios do painel de administrador. 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\&token=dc514238-c132-4fdf-9410-4021e06b9e88) ## Banir jogadores Você pode banir jogadores da sua scene selecionando a **Permissions** aba do painel de administrador, escrevendo o nome ou o endereço de wallet do jogador que você deseja banir e clicando em **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\&token=410f0301-681e-4110-9c79-71ed16ef806c) {% hint style="info" %} **💡 Dica**: Para obter o endereço de 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 de wallet. {% endhint %} Jogadores banidos não poderão carregar sua scene nem interagir com nenhum de seus conteúdos. Outros jogadores não os verão na scene, nem lerão nenhuma de suas mensagens de chat. {% hint style="warning" %} **📔 Observação**: Os efeitos do seu banimento são imediatos e permanentes. Uma vez banido, um jogador permanecerá banido até que o banimento seja removido. Enquanto estiver banido, um jogador não pode ver nem interagir com sua scene, não pode conversar no canal Nearby enquanto estiver nela e os outros jogadores na scene não podem vê-lo. Se um jogador sair dos limites da sua scene, ele não será mais afetado pelas regras de banimento da sua scene e verá jogadores banidos novamente. {% 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 scene: * Adicione um smart item à sua scene * 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 pela lista suspensa, dê a ele um nome personalizado e selecione uma ação padrão Depois que o acima estiver configurado, os administradores podem acionar a ação abrindo a **Smart Items** aba do painel de administrador e selecionando um item na lista suspensa. Em seguida, eles podem escolher uma das ações do item na **Actions** lista suspensa e clicar em **Reproduzir ação** para acioná-la. Também há um botão para **Ocultar/Mostrar** o item selecionado. Nome da scene Você também pode mostrar ou esconder qualquer smart item nesta lista, mesmo que ele não inclua uma ação para fazer 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.