!duo e !setduo

Guarda com quem você está jogando e carimba o título da live.

Este comando é chamado por um bot de chat. Se ainda não criou a chave restrita dele, comece em chave e formato para bot de chat.

Os três comandos

# StreamElements — Chatbot → Commands → Custom Commands
!setduo   (Moderators)  $(customapi.https://www.asrus.app/api/v1/duo?format=text&key=SUA_CHAVE&set=$(queryescape $(1:)))
!duo      (Everyone)    $(customapi.https://www.asrus.app/api/v1/duo?format=text&key=SUA_CHAVE)
!semduo   (Moderators)  $(customapi.https://www.asrus.app/api/v1/duo?format=text&key=SUA_CHAVE&clear=1)

# Nightbot — digite no chat
!addcom !setduo -ul=moderator $(urlfetch https://www.asrus.app/api/v1/duo?format=text&key=SUA_CHAVE&set=$(querystring))
!addcom !duo $(urlfetch https://www.asrus.app/api/v1/duo?format=text&key=SUA_CHAVE)
!addcom !semduo -ul=moderator $(urlfetch https://www.asrus.app/api/v1/duo?format=text&key=SUA_CHAVE&clear=1)

O $(queryescape) importa: apelido pode ter espaço e acento, e sem ele o StreamElements descarta os espaços. No Nightbot o $(querystring) já vem codificado.

Nomes e apelidos

O nome sozinho é o login exato da Twitch. Quando o chat conhece a pessoa por outro nome, ponha o login entre parênteses:

o mod digitao chat lê
!setduo justwspeed justwspeed [ https://twitch.tv/justwspeed ]
!setduo Speed (justwspeed) Speed [ https://twitch.tv/justwspeed ]
!setduo Zé da Silva (zedasilva) Zé da Silva [ https://twitch.tv/zedasilva ]

Onde termina cada pessoa

!setduo Speed (justwspeed), Vitu (1vituvitu)
→ Speed [ https://twitch.tv/justwspeed ] • Vitu [ https://twitch.tv/1vituvitu ]
→ título: ... | @justwspeed @1vituvitu

Usar em outro canal

Sem &channel=, o comando age no canal da chave — não no canal onde ele foi digitado. Instalado no chat de outra pessoa sem esse campo, ele grava o duo e carimba o título do dono da chave, e o chat de lá recebe uma confirmação que parece ter funcionado. Acrescente a variável de canal do bot:

# StreamElements
$(customapi.https://www.asrus.app/api/v1/duo?format=text&key=SUA_CHAVE&channel=$(channel)&set=$(queryescape $(1:)))

# Nightbot
!addcom !setduo -ul=moderator $(urlfetch https://www.asrus.app/api/v1/duo?format=text&key=SUA_CHAVE&channel=$(channel)&set=$(querystring))

Com &channel=$(channel) o mesmo comando serve qualquer canal. Mas aqui, diferente do !clip, o dono de lá precisa autorizar: mexer no título é ação no canal dele, não algo que qualquer espectador faz.

Repare que aqui o campo é channel no sentido de qual canal operar. No !clip, &canal= quer dizer outra coisa — o canal a clipar, que não exige autorização de ninguém.

O título da live

O carimbo é sempre | @login no fim — o login, nunca o apelido: ali o nome serve para quem lê achar a pessoa na Twitch, e @Speed não acha ninguém. O apelido aparece no chat, que é onde ele quer dizer algo.

"Rankeada até o Radiante" vira "Rankeada até o Radiante | @justwspeed". Trocar de duo troca o carimbo; !semduo tira só o carimbo e devolve o título como estava.

Antes de soltar para o chat

Quer chamar a rota direto, por HTTP, ou entender por que um GET muda estado? Está em GET /duo.