Scene Admin

Administradores da cena têm controle especial sobre o que acontece na cena em tempo real.

Conceder 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 houver público suficiente, lance confetes ou faça uma nave espacial aparecer quando parecer o momento certo.

Quando um admin da cena visita sua cena, ele vê uma UI especial no canto superior direito que apenas ele pode ver. Através dessa 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 dessa forma. Essas ações são vistas por todos os outros jogadores na cena que estão conectados à mesma ilha de comunicação que o admin.

Configurando admins

Para atribuir admins, você precisa adicionar o Scene Admin smart item à sua cena.

📔 Nota: Atualize sua cena para usar as dependências mais recentes. O Scene Admin Smart item não funcionará se a cena estiver desatualizada.

Enquanto você está desenvolvendo a cena e testando localmente, você é sempre um admin. Depois que a cena for publicada, qualquer pessoa com permissões de publicação na cena também é automaticamente um admin. Isso inclui:

• O proprietário dos terrenos LAND ou do World NAME onde a cena está publicada

• Qualquer pessoa que tenha recebido Operator rights nesses terrenos ou name. Veja Conceder permissões.

• Qualquer usuário que esteja alugando aquela terra. Veja Aluguéis.

Você também pode adicionar pessoas adicionais à lista de admins depois que sua cena for publicada visitando sua cena como admin e abrindo a aba Moderation Tools da.

Digite o endereço de wallet da pessoa que você quer adicionar à lista de admins e clique em Adicionar.

Você pode ver quem é admin na cena clicando no botão Admin List A partir desta tela você também pode Remover pessoas da lista de admins.

📔 Nota: É possível remover o papel de admin apenas de jogadores que foram adicionados manualmente à lista via a aba Moderation Tools . Jogadores que são proprietários, operadores ou inquilinos da cena aparecem nesta lista, mas não podem ter seus papéis de admin removidos por essa UI. Para remover o papel de admin de um operador, você deve primeiro remover o papel de operador dele.

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

Verificar 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, permitir interações com uma Entity específica da cena.

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 funções async, veja Async Functions.

Reprodução de vídeo

Uma das ações mais comuns que admins realizam é reproduzir vídeos. O painel de admin 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 cena e vinculá-lo ao Scene Admin smart item.

1. Adicione um Video Player smart item à sua cena

   

   Veja Video Screen para mais detalhes sobre como você pode configurar a fonte de mídia padrão e outras definições do Video Player smart item. A maioria dessas configurações pode ser substituída pelo admin quando a cena estiver em execução.

   📔 Nota: Um admin pode gerenciar apenas vídeos que são reproduzidos no Video Screen smart item, não em telas adicionadas via código 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 muito o desempenho.

2. Abra o Scene Admin Smart Item e certifique-se de que a caixa de seleção Video Screens esteja habilitada para que esta seção seja exibida. Em seguida, selecione a tela em um menu suspenso e dê um nome amigável para exibir na UI do Admin. Você pode adicionar quantas Video Screens quiser; cada tela é controlada de forma independente.

   

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

Se sua cena tiver múltiplas telas de vídeo independentes, o menu Current Screen permite escolher qual tela de vídeo controlar. A lista exibe os nomes que você deu a cada tela de vídeo na configuração do smart item Admin Tools.

💡 Dica: Para mostrar o mesmo vídeo em várias telas que podem ser controladas como uma só, veja Multiple Video Screens.

Fontes de mídia

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

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

  

  📔 Nota: Nem qualquer URL de vídeo funcionará. Vídeos de sites como o Youtube, por exemplo, têm políticas rígidas sobre seu conteúdo e bloquearão o acesso a partir do Decentraland. Veja Streaming from other sources para mais informações sobre o que você pode e não pode reproduzir no Decentraland.

• DCL Cast: Use o aplicativo web de streaming gratuito do Decentraland para compartilhar facilmente sua câmera ou tela com outros jogadores na cena, sem necessidade de configurar um software de streaming.

  

• Transmissão ao vivo: Reproduza uma live usando a infraestrutura gratuita de streaming do Decentraland e um software de transmissão como OBS ou StreamYard.

  

  Veja Live Streaming 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 Active. Você pode clicar nos botões Video ou Live para explorar as configurações de cada seção; você não interromperá o que está tocando no momento até clicar no botão Activate em qualquer uma das seções.

Anúncios

Na aba Anúncios do painel de admin, os admins podem escrever mensagens que são vistas por todos os jogadores na cena. Mensagens como essa só podem ser enviadas por admins, portanto outros jogadores as perceberão como mais legítimas do que uma mensagem no chat de alguém alegando ser admin.

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

Banir jogadores

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

💡 Dica: Para obter o endereço de wallet de um jogador, clique no avatar dele para abrir o perfil e então clique no botão Copy to clipboard ao lado do endereço de wallet.

Jogadores banidos não poderão carregar sua cena ou interagir com qualquer um dos seus conteúdos. Outros jogadores não os verão na cena, nem lerão qualquer uma de suas mensagens no chat.

📔 Nota: Os efeitos do seu banimento são imediatos e permanentes. Uma vez que um jogador é banido, ele permanecerá banido até que o banimento seja levantado. Banir um jogador da sua cena afeta apenas o que jogadores que estão dentro dos limites da sua cena podem ver; se um jogador sair dos limites da sua cena, ele não é mais afetado pelo banimento. Jogadores banidos também são invisíveis para outros jogadores se estiverem fora da sua cena.

Clique em View Ban List para ver a lista de jogadores atualmente banidos. Nesta lista você também pode Unban 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 do Scene Admin Smart Item in the Creator Hub

• Na aba Ações de smart item na seção, adicione o smart item a partir do menu suspenso, dê-lhe um nome personalizado e selecione uma ação padrão

Depois de configurado o acima, os admins podem acionar a ação abrindo a seção Smart Item Actions do UI do admin e então selecionando um item na lista suspensa. Eles podem então clicar no botão Default para acionar a ação padrão desse item, ou selecionar qualquer outra das ações do item na lista.

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