Documentação

Primeiros passos

1. Instale o Featured Channels pelo diretório de extensões da Twitch.
2. No seu Painel do Criador, vá em Extensões → Minhas extensões e ative como painel, sobreposição ou componente. Dá para usar um painel e uma sobreposição ao mesmo tempo.
3. Abra as configurações da extensão (o ícone de engrenagem), adicione canais e clique em Salvar alterações.

Os espectadores veem as mudanças na hora, sem recarregar a página. A página de configurações tem uma prévia ao vivo que mostra exatamente o que os espectadores veem, no painel e na sobreposição.

Onde aparece

Canais e equipes

• Digite o nome de um canal e pressione Enter ou vírgula. Nomes que a Twitch não conhece são marcados e não são salvos.
• Arraste os canais para definir a ordem, ou selecione um e use Alt + setas.
• Adicione uma equipe da Twitch para destacar todos os membros. Novos membros aparecem automaticamente.
• Até 100 canais. A ordenação pode manter a sua ordem, ir de A a Z ou de Z a A, ou embaralhar. Canais ao vivo vêm sempre primeiro, e a ordenação organiza cada grupo.

Aparência

• Título e subtítulo acima da lista. Se ficarem no padrão, aparecem no idioma de cada espectador.
• Tema: segue o modo claro/escuro da Twitch de cada espectador, ou força escuro ou claro. PRO Cores e gradientes personalizados.
• Cor de destaque para o botão Seguir, realces e foco.
• Layout: cantos arredondados, ocultar avatares ou links, botões da sobreposição com a mesma largura, sobreposição no topo ou embaixo, alinhamento dos botões (esquerda, centro, direita ou justificado, que é o padrão e também alinha o título e o subtítulo na sobreposição), status ao vivo.
• Ocultar botões de seguir: os botões Seguir ficam escondidos até o espectador passar o mouse em um canal. Clicar em um canal ainda segue o canal, e as caixas da sobreposição só perdem a palavra "Seguir".
• Páginas da sobreposição: a sobreposição mostra 12 canais por vez, com setas à esquerda e à direita para ver o resto.
• Por quanto tempo a sobreposição aparece depois que você salva novas configurações (0 a 30 segundos).
• PRO Fontes: qualquer Google Font, uma separada para o título, e tamanho do texto.

Alertas de follow

Quando um espectador segue um canal em destaque pela extensão, todo mundo assistindo vê um balão rápido de "acabou de seguir!" naquele canal. Ele mostra o nome de quem seguiu se a pessoa compartilhou a identidade com a extensão; caso contrário, mostra "Alguém".

No painel, no componente e no celular, os alertas não aparecem enquanto ninguém está olhando. Eles se acumulam e passam rápido, um depois do outro, em uma barra no topo da lista assim que o espectador passa o mouse nela (no celular, enquanto o app está aberto). Os destaques com Bits vêm primeiro e ficam mais tempo.

Os alertas são limitados a um por espectador por canal por minuto e a dez por minuto no seu canal, então não dá para fazer spam. Você pode desativá-los em Aparência.

Contagem de follows PRO BETA

Com o Pro, a aba Canais das configurações mostra quantos follows cada canal em destaque recebeu pelos botões Seguir da extensão, nos últimos 30 dias e no total. Os follows são contados para todos os canais, mesmo com os alertas de follow desligados, então o histórico já está lá quando você virar Pro. É um beta: os números e o layout ainda podem mudar.

A Twitch não deixa extensões confirmarem um follow, então a contagem vem do navegador dos espectadores e é uma estimativa. Cada espectador conta no máximo uma vez por canal por minuto, e follows feitos fora da extensão (na página do canal, por exemplo) não entram.

Destaque com Bits

Logo depois de seguir, o espectador pode usar Bits (10, 100, 250 ou 500, como você escolher) para mostrar a todos um "acabou de seguir!" em destaque com o nome dele por alguns segundos. Na sobreposição, isso também mostra os botões dos canais por um instante.

Comandos de chatbot

Deixe seus mods mudarem os canais em destaque pelo chat. Na aba Integração das configurações, copie o comando para o seu bot e cole no chat:

• Nightbot e StreamElements: comandos !featured prontos, só para moderadores.
• Outros bots: chame o seu link de comando com o texto do comando no final, por exemplo …/bot/<token>/nome1,nome2. A resposta é texto puro para o bot mostrar.

Ative Anunciar no chat para a extensão postar a nova lista no chat depois de uma mudança. A mensagem começa com "Featured channels:", a não ser que você defina o seu próprio Início da mensagem no chat. As respostas do chatbot são em inglês.

Stream Deck e outras ferramentas

O link de comando é um endereço web normal, então qualquer coisa que abra uma URL pode usá-lo: uma ação Website do Stream Deck (com "GET request in background"), Touch Portal, Streamer.bot ou um script.

https://featuredchannels.furious.pro/bot/<token>/show 30
https://featuredchannels.furious.pro/bot/<token>/nome1,nome2,nome3

Tudo o que dá para chamar está na referência da API, onde você também pode testar.

Pro PRO

Seja sub do FURiOUS na Twitch (qualquer tier) com a sua conta de streamer para ajudar a pagar os custos do servidor e liberar todos os recursos Pro. Nas configurações, clique em Verificar de novo depois de se inscrever. A inscrição é verificada de novo todo dia, e o Pro continua ativo por 48 horas se a Twitch não responder.

• Tema personalizado: fundo, linhas dos canais e botão Seguir, cada um em cor sólida ou gradiente; cores do texto; opacidade das linhas.
• Fontes: qualquer Google Font, uma fonte separada para o título, e tamanho do texto.
• Caixas posicionadas na sobreposição de vídeo (abaixo).
• Contagem de follows por canal em destaque (beta, acima).
• Mostrar a sobreposição quando quiser pela aba Personalizar sobreposição, pelo chat ou por um Stream Deck: por um tempo, até ocultar, ou ocultar.

Se a inscrição acabar, suas configurações são mantidas, mas as opções Pro voltam ao visual padrão até você se inscrever de novo.

Caixas posicionadas

Em Personalizar sobreposição, coloque uma caixa sobre o lugar de cada canal em destaque no layout da sua live, como a webcam ou a plaquinha de nome de um convidado. Os espectadores veem "Seguir {nome}" nela e clicam na caixa para seguir.

1. Clique em Usar uma captura de tela e escolha uma captura da sua live, para ver o seu layout atrás das caixas.
2. Adicione uma caixa por canal, ou Uma caixa para cada canal.
3. Arraste para mover e arraste o canto para redimensionar. As setas movem a caixa selecionada, e Alt + setas redimensionam.
4. Escolha o que a sobreposição mostra: as caixas, a lista de canais ou os dois.
5. Escolha o estilo: borda com o nome em cima, ou só o nome; cor da caixa, cor do texto do nome, largura da borda, preenchimento e brilho.

As caixas são posicionadas em relação à imagem do vídeo, então ficam alinhadas em qualquer tamanho de player, no modo cinema e em tela cheia.

Posicionar caixas por código PRO

Defina as caixas posicionadas por um script, um Stream Deck ou qualquer ferramenta, com o token do seu link de comando. Envie um array JSON com o canal, a posição e o tamanho de cada caixa, em porcentagem da imagem do vídeo: x/y é o canto superior esquerdo, w/h a largura e a altura.

curl -X PUT "https://featuredchannels.furious.pro/api/boxes/<token>?mode=both"   -H "Content-Type: application/json"   -d '[{"login":"aurora_plays","x":5,"y":10,"w":20,"h":20},
       {"login":"pixelpanda","x":75,"y":10,"w":20,"h":20}]'

Até 12 caixas. PUT substitui todas (envie [] para remover), GET lê as caixas, e o mode opcional (list, hotspots ou both) define o que a sobreposição mostra. Os espectadores veem a mudança na hora. Detalhes e um formulário de teste estão na referência da API.

Deck e OBS PRO

O Deck é uma página de controle para o seu celular ou para um dock do OBS. Abra https://featuredchannels.furious.pro/deck#<token> com o token da aba Integração (ou cole o seu link de comando na página, que guarda ele). Trate o link como uma senha: qualquer pessoa com ele pode mudar o seu canal. O Deck é em inglês.

• Slots: cada canal em destaque é um botão grande. Arraste um bloco sobre outro para movê-lo para lá (em tela de toque, arraste os pontinhos no canto dele), toque em um e depois em outro para trocar os dois, ou use as setas. Também dá para adicionar, remover e desfazer, além de Show 30 s, Keep shown, Hide e o modo da sobreposição (os quatro últimos são Pro).
• As caixas seguem os slots: a caixa 1 fica sobre o canal 1, a caixa 2 sobre o canal 2, e assim por diante. Quando você reordena os canais, cada caixa fica no lugar e os canais trocam entre elas: coloque o primeiro canal em segundo e ele vai para a segunda caixa.
• Posicionar caixas na mão: a prévia mostra um quadro da sua live (enquanto você está ao vivo) com as caixas por cima. Arraste uma caixa para mover, arraste o canto para redimensionar, ou use as setas (Shift para passos maiores, Alt para redimensionar), como nas configurações da extensão. Uma caixa movida na mão vale mais que a fonte do OBS dela até essa fonte se mover de novo.
• Ligação com o OBS: no OBS, ative Ferramentas → Configurações do servidor WebSocket → Ativar servidor WebSocket e adicione o Deck como dock de navegador personalizado (Docks → Docks de navegador personalizados). Abra o painel OBS no Deck, informe a porta e a senha, conecte e escolha uma cena e uma fonte para cada slot. Mover ou redimensionar essa fonte no OBS agora move a caixa dela na sobreposição dos espectadores.

A conexão com o OBS é feita pelo navegador que mostra o Deck, direto para o OBS no mesmo computador, e a senha fica nesse navegador. Um celular pode reordenar os canais, mas não alcança o OBS; o dock no seu PC mantém as posições das caixas sincronizadas. O Deck não recarrega sozinho: aperte Refresh para trazer as mudanças feitas em outro aparelho, no chat ou nas configurações da extensão. Se o navegador pedir permissão para acessar dispositivos na sua rede local, permita. O Deck usa /api/deck, que está na referência da API.

Idiomas

Os espectadores veem a extensão no idioma da Twitch deles: inglês, português, espanhol, alemão, francês, italiano, russo, japonês, coreano, chinês (simplificado e tradicional), turco e polonês. A página de configurações está em inglês, português (Brasil), espanhol, alemão e francês. As respostas do chatbot são em inglês.

Solução de problemas

A sobreposição não aparece

A sobreposição de vídeo só aparece enquanto o espectador passa o mouse no player, e só enquanto você está ao vivo. Confira se ela está ativada como sobreposição no seu Painel do Criador. Com o Pro, use Mostrar por 30 s para testar.

O chatbot diz que o link é inválido

O link foi gerado de novo, ou foi copiado pela metade. Copie o comando de novo na aba Integração.

O Pro aparece bloqueado depois de me inscrever

Clique em Verificar de novo nas configurações. A inscrição precisa estar na conta do canal onde a extensão está instalada.

Minhas cores ou fonte não aparecem para os espectadores

O tema personalizado e as fontes são Pro. Sem o Pro, os espectadores veem o visual da Twitch. Confira também se você clicou em Salvar alterações; a prévia atualiza antes de salvar.

Outra coisa?

Pergunte no chat em twitch.tv/furious.