Admin da cena

Os administradores da cena têm controlo especial sobre o que acontece na cena em tempo real.

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.

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.

Configurar admins

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

📔 Nota: Atualize a sua scene para usar as dependências mais recentes.

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.

• Qualquer utilizador que esteja a alugar esse terreno. Veja Rentals.

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.

   
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.

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

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.

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.

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

💡 Dica: Para mais informações sobre async functions, veja Async Functions.

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

   

   Veja Video Screen 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.

   📔 Nota: Um admin só pode gerir videos que sejam reproduzidos no smart item Video Screen, não em screens adicionados via código do SDK.

   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.

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.

   

   Nome da scene

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.

Nome da scene

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.

💡 Dica: Para mostrar o mesmo video em várias screens que possam ser controladas como uma só, veja Multiple Video Screens.

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.

  

  Nome da scene

  📔 Nota: 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 Streaming from other sources para mais informações sobre o que pode e não pode reproduzir na Decentraland.

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

  

  DCL Cast
• 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.

  

  Nome da scene

  Veja Live Streaming 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.

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.

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 .

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

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.

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

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.

Nome da scene

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