> 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.

Atribua a determinados jogadores a função especial de **administrador** na sua scene.

Durante um evento em direto, um administrador pode controlar espontaneamente o que acontece na scene a partir do Decentraland, sem precisar de agendar ações previamente nem de recorrer a um serviço de terceiros. Comece a reproduzir música quando houver gente suficiente, largue confetti ou faça aparecer uma nave espacial quando achar que é o momento certo.

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

Quando um administrador da scene visita a sua scene, vê um painel de administração especial no canto superior direito, visível apenas para si. O painel tem separadores com ícones na parte superior para alternar entre secções (Vídeo, Anúncios, Smart Items, Permissões). Através desta UI, pode reproduzir vídeos ou transmissões em direto, enviar anúncios, banir jogadores ou ativar qualquer Smart Item configurado para ser ativado desta forma. Estas ações são vistas por todos os outros jogadores na scene que estejam ligados à mesma ilha de comunicação que o administrador.

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

## Configurar administradores

Para atribuir administradores, tem de adicionar o **Admin Tools** à sua scene como Smart Item.

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

{% hint style="warning" %}
**📔 Nota**: O Smart Item Admin Tools requer `@dcl/sdk` 7.33.0 ou posterior na sua scene. Com uma versão mais antiga do SDK, a scene não consegue ser compilada depois de o adicionar. Atualize a sua scene para utilizar as dependências mais recentes.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-dc71db8d8ad64164f3024a63d6c48e7b484e5677%2Fupdate-dependencies.webp?alt=media" alt="" data-size="original">
{% endhint %}

Admin Tools é um script: as respetivas definições aparecem como grupos de campos no componente Script do item. Também pode alterar o aspeto do painel de administração; consulte [Personalizar o painel de administração](#customize-the-admin-panel).

Enquanto estiver a desenvolver a scene e a testá-la localmente, será sempre administrador. Depois de a scene ser publicada, qualquer pessoa com permissões de publicação para a scene também passa automaticamente a ser administrador. Isto inclui:

* O proprietário das parcelas de LAND ou do NAME de World onde a scene é publicada
* Qualquer pessoa a quem sejam concedidos **direitos de operador** nestas parcelas ou neste NAME. Consulte [Conceder permissões](https://docs.decentraland.org/player/marketplace/land-manager/#give-permissions).
* Qualquer utilizador que esteja a arrendar esse terreno. Consulte [Arrendamentos](https://docs.decentraland.org/player/marketplace/rentals/).

Para atribuir funções de administrador adicionais a pessoas sem permissão de publicação, mas que possam realizar operações em direto na scene, adicione os endereços das respetivas wallets antes de publicar, em **Lista de permissões de administradores** do grupo **Utilizadores administradores autorizados** . Em alternativa, adicione-os depois de a scene estar ativa:

1. Publique a scene e visite a versão ativa como administrador
2. Abra o separador **Permissões** (através dos separadores com ícones na parte superior do painel de administração).

   ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-cbff3e78863a23fcc4242cca17c7d4453943d81a%2Fmoderation-tools.webp?alt=media)
3. Escreva o endereço da wallet da pessoa que pretende adicionar junto a **Adicionar um administrador** e clique em **Adicionar**.

Pode ver quem é administrador na scene clicando no botão **Ver lista de administradores** . Neste ecrã, 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-7ed1d98e80252cf0f854cb322384cc32e2d97d8d%2Fadmin-list.webp?alt=media)

{% hint style="warning" %}
**📔 Nota**: Só é possível remover a função de administrador dos jogadores que foram adicionados manualmente à lista através do separador **Permissões e moderação** . Os jogadores que são proprietários, operadores ou arrendatários da scene aparecem nesta lista, mas não podem ter a função de administrador removida através desta UI. Para remover a função de administrador de um operador, tem primeiro de remover a função de operador.
{% endhint %}

Sempre que um jogador administrador estiver na scene, verá uma UI especial no canto superior direito. Os 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-d17f67699ef95e9e6c4d79a27844d7cced9d9283%2Fadmin-console.webp?alt=media)

### Verificar o estado de administrador através de código

Também é possível saber através de código se um Player é administrador de uma scene. Isto permite disponibilizar ou não outros comportamentos a um Player, por exemplo, permitir 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) {
    // Show admin-only UI, teleport to stage, show entity, etc.
  }
}
```

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

## Reprodução de vídeo

Uma das ações mais comuns dos administradores é reproduzir vídeos. O painel de administração inclui uma secção de leitor de vídeo, onde podem controlar tudo o que está relacionado com vídeos.

Para ativar esta funcionalidade, tem de adicionar um **Video Player** smart item à sua Scene e associá-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-4ffd58cadcc524a13cd567ca4d5ccdc70fc994f2%2Fvideo-player-item.webp?alt=media)

   Consulte [Video Screen](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/video-screen.md) para obter mais informações sobre como configurar a fonte de Media predefinida e outras definições do smart item Video Player. O administrador pode substituir a maioria destas configurações quando a Scene estiver em execução.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>📔 Nota</strong>: Um administrador só pode gerir vídeos reproduzidos no smart item Video Screen, não em ecrãs adicionados através de código do SDK.</p><p>Pode incluir quantos ecrãs de vídeo quiser. Em geral, evite reproduzir mais do que um vídeo diferente em simultâneo, pois isso prejudica bastante o desempenho.</p></div>
2. Abra o smart item Admin Tools e expanda o grupo **Video Control** . Certifique-se de que **Is Enabled** está selecionado. Em **Video Players**, clique em **Add**, selecione o ecrã no campo **Entity** (a lista só inclui itens Video Player) e atribua-lhe um **Custom Name** para apresentar no painel de administração. Pode adicionar quantos ecrãs quiser; cada um é controlado de forma independente.

   <img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-b2e6cf481ed7850bb28891a799dff08cb62c39e4%2Fmulti-video-setup.webp?alt=media" alt="Nome da Scene" width="300">

Depois de configurar tudo acima, os utilizadores administradores da sua Scene podem abrir o painel de administração e selecionar o separador de vídeo (através dos ícones no topo) para controlar estes ecrãs.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-da7f8987f35e3e9457d6fb1470595810288ecb96%2Fvideo-sources.webp?alt=media" alt="Nome da Scene" width="300">

Se a sua Scene tiver vários ecrãs de vídeo independentes, o menu suspenso **Screen** permite escolher que ecrã de vídeo controlar. A lista apresenta os nomes que atribuiu a cada ecrã de vídeo na configuração do smart item Admin Tools.

{% hint style="info" %}
**💡 Dica**: Para apresentar o mesmo vídeo em vários ecrãs que possam ser controlados em conjunto, consulte [Vários ecrãs de vídeo](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/video-screen.md#multiple-video-screens).
{% endhint %}

## Fontes de Media

Um controlo segmentado na parte superior da secção de vídeo permite alternar entre três fontes de Media. A fonte atualmente ativa é indicada por uma etiqueta em forma de cápsula. Mudar de separador apenas apresenta as definições dessa fonte; a reprodução atual só é interrompida quando clicar em **Ativar**.

* **URL do vídeo**: Reproduza um vídeo a partir de um URL. Cole o URL do vídeo no campo e clique em **Ativar**. O vídeo começará a ser reproduzido no ecrã selecionado para todos os jogadores. Também pode parar, pausar, reiniciar e ajustar o volume.

  <img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a83d68596d513ea75649d32f7847c95a58387574%2Fvideo-from-url.webp?alt=media" 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 todos os URLs de vídeo funcionam. Alguns sites têm políticas rigorosas relativas aos seus conteúdos e bloqueiam o acesso a partir do Decentraland. Consulte <a href="https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/video-screen.md#streaming-from-other-sources">Transmitir a partir de outras fontes</a> para obter mais informações sobre o que pode e não pode reproduzir em Decentraland.</p></div>
* **DCL Cast**: Utilize a aplicação Web gratuita de transmissão em streaming da Decentraland para partilhar facilmente a sua câmara ou ecrã com outros jogadores na Scene, sem precisar de configurar software de transmissão. Os controlos da apresentação (Anterior, Seguinte, Reproduzir vídeo, Parar) são apresentados em linha quando há uma apresentação ativa.

  <img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-26e1a45982ee2316827a0ae1732bacb9ff447fa0%2Fdcl-cast.webp?alt=media" alt="DCL Cast" width="300">
* **Stream**: Reproduza uma transmissão em direto utilizando a infraestrutura gratuita de streaming da Decentraland e um software de transmissão como o OBS ou o StreamYard.

  <img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e5638c12e0e713bab2ffe84cb895bc4071a09eaf%2Flive-stream.webp?alt=media" alt="Nome da Scene" width="300">

  Consulte [Transmissão em direto](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/operar-ao-vivo/live-streaming.md) para obter mais informações sobre como configurar uma transmissão em direto.

Cada secção de origem de multimédia inclui um **controlo deslizante do volume** que permite definir o volume entre 0% (sem som) e 100%.

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

## Anúncios

No separador **Anúncios** do painel de administração, os administradores podem escrever mensagens que são vistas por todos os jogadores na cena. Estas mensagens só podem ser enviadas por administradores, pelo que os outros jogadores as considerarão mais legítimas do que uma mensagem no chat de alguém que se faça passar por administrador.

Selecione o separador Anúncios do painel de administração. Escreva uma mensagem e clique em **Partilhar**. A mensagem pode ter até 90 caracteres. O campo de introdução é limpo automaticamente após o envio, para que possa escrever uma nova mensagem imediatamente.

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

## Banir jogadores

Pode banir jogadores da sua Scene selecionando o separador **Permissions** do painel de administração, escrevendo o nome ou o endereço da Wallet do jogador que pretende banir e clicando no botão **Ban** .

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

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

Os jogadores banidos não poderão carregar a sua Scene nem interagir com qualquer conteúdo desta. Os outros jogadores não os verão na Scene nem poderão ler nenhuma das suas mensagens no chat.

{% hint style="warning" %}
**📔 Nota**: Os efeitos do banimento são imediatos e permanentes. Depois de ser banido, um jogador continuará banido até que o banimento seja revogado. Enquanto estiver banido, o jogador não poderá ver nem interagir com a sua cena, nem conversar no canal Nearby enquanto estiver nela, e os outros jogadores na cena não o poderão ver.

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

Clique em **Ver lista de banimentos** para ver a lista dos jogadores atualmente banidos. Também pode **Revogar banimento** de 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 de **Admin Tools** Smart Item no Creator Hub e expanda o grupo **Smart Items Control** grupo
* Em **Smart Items**, clique em **Adicionar**, selecione o item no campo **Entidade**  (só apresenta itens com ações), atribua-lhe um **Nome personalizado**, e escolha a sua **Ação predefinida** no menu pendente

Depois de configurar os itens acima, os administradores podem acionar a ação abrindo o separador **Smart Items** do painel de administração e selecionando um item na lista pendente. Em seguida, podem escolher uma das ações do item no menu pendente **Ações** e clicar em **Executar ação** para a acionar. Também existe um botão para **Ocultar/Mostrar** o item selecionado.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-3acc9078a619cafd74823f6aa12c1b45d27dacc4%2Fsmart-item-actions.webp?alt=media" alt="Nome da Scene" width="300">

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

## Personalizar o painel de administração

O smart item Admin Tools inclui dois ficheiros, que o Creator Hub copia para a sua cena quando adiciona o item:

* `AdminTools.ts`: o script que lê as definições feitas no Creator Hub e inicia o painel.
* `AdminPanel.tsx`: o esquema do painel de administração no mundo, escrito com [React ECS](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/onscreen-ui.md).

Edite `AdminPanel.tsx` para personalizar o painel: adicione um separador, reorganize o cabeçalho, adicione botões com links ou altere a identidade visual. O conteúdo de cada separador (vídeo, anúncios, smart items, moderação) e os serviços associados são fornecidos pela biblioteca `@dcl/asset-packs` , pelo que só precisa de editar a estrutura à sua volta.

{% hint style="info" %}
**📔 Nota**: um item Admin Tools colocado numa cena antes de se tornar um script continua a funcionar como antes, com o respetivo painel de definições original. Para obter o painel editável, elimine o item e adicione novamente o Admin Tools. Em seguida, configure-o de raiz.
{% endhint %}


---

# 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=<question>&goal=<user_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.
