Como acionar widgets do Marketplace a partir de comandos

Um comando personalizado pode enviar um evento de ação para um item interativo do Marketplace dentro de um layout salvo do Overlay Builder.

Preparar o Widget

  1. Instale o pacote widget do Marketplace.
  2. Abrir Configurações → Sobreposições → Sobreposição Construtor.
  3. Adicionar um Ponto de mercado widget.
  4. Selecione o pacote instalado e configure seus campos.
  5. Poupe a sobreposição.
  6. Certifique-se de que a sobreposição salva – ou a sobreposição Master que a exibe atualmente – esteja ativa em sua fonte do navegador.

O widget deve existir em uma sobreposição salva antes de aparecer no seletor de destino do Action Builder.

Criar o Comando

  1. Abrir Comandos do bot → Comandos.
  2. Criar um Comando Personalizado, como spin ou decide.
  3. Definir permissões e refrigerações apropriadas para o efeito.
  4. Deixe a resposta normal em branco se o widget for a resposta completa.
  5. Em Acções, escolher Sobreposição de Widgets → Ativar Widget Marketplace.
  6. Selecione o widget salvo do Marketplace.
  7. Digite a ação do widget documentada pelo seu editor, como spinWheel.
  8. Adicione o JSON de carga útil opcional se o widget o suportar.
  9. Salve e teste o comando.

Adicionar Variáveis à Carga Vazável

Variáveis de comando suportadas podem ser inseridas no JSON de carga útil:

{
  "viewer": "{user}",
  "message": "{message}",
  "source": "chat-command"
}

O nome exato da ação e os campos de carga útil pertencem ao pacote widget. Use a sua descrição do Marketplace ou documentação do editor, em vez de adivinhar.

Controle Quem Pode Atirá - la

Use permissão VIP, Moderador ou Broadcaster durante o teste. Adicione um resfriamento global para animações ou jogos que devem terminar antes de outro visualizador iniciar.

Problemas Comuns

  • Falta um elemento no seletor: Adicione-o a uma sobreposição, salve e reabra o editor de comandos.
  • Não aconteceu nada... Confirme se a sobreposição ativa contém essa instância exata do widget.
  • Execuçãos de ação erradas: Verifique a chave de ação do editor, incluindo a capitalização.
  • A carga útil é ignorada: Validar o JSON e confirmar que o widget suporta esses campos.
  • Visualizadores spam o efeito: Aumentar o arrefecimento global do comando.
  • O pacote relata um erro: Open Marketplace Package Detalhes e inspecione suas dependências e status de tempo de execução.