O que você precisa
Você precisa de uma conta Govee Home e de luzes Govee que mudem de cor, se conectem ao Wi-Fi e já estejam configuradas no aplicativo Govee Home. As luzes que usam apenas Bluetooth não funcionam, porque a API da Govee não consegue alcançá-las. Também precisa de um canal da Twitch que possa criar recompensas de pontos do canal. A página Pontos do canal do painel indica que a Twitch só deixa canais afiliados e parceiros criarem essas recompensas. Os espectadores gastam pontos do canal para mudar a cor das suas luzes.
O painel tem um botão «Peça ajuda à sua IA» em cada etapa da configuração. Ele copia uma mensagem curta com a etapa atual, para que um assistente de IA possa ler este guia e ajudar você. Nunca cole sua chave de API da Govee em uma IA.
Obter sua chave de API da Govee
- Abrir o aplicativo Govee Home
Abra o aplicativo Govee Home no seu celular e entre na conta que tem as suas luzes.
- Ir ao formulário de chave
Vá em Perfil → Configurações → «Apply for API Key». Em algumas versões do aplicativo, essa opção fica em Sobre.
- Preencher o formulário curto
Preencha o formulário curto e envie.
- Aguardar o e-mail
A Govee normalmente envia a chave por e-mail, para o endereço da sua conta Govee. Se ela não chegar, confira a pasta de spam e depois refaça o pedido.
Conectar a chave no painel
Abra a página Luzes Govee no painel. O assistente tem quatro etapas: «O que você precisa», «Obtenha sua chave», «Cole sua chave» e «Suas luzes».
- Iniciar o assistente
Em «O que você precisa», escolha «Configurar luzes Govee».
- Conferir o caminho
Em «Obtenha sua chave», o painel mostra o mesmo caminho descrito acima em «No aplicativo Govee Home». Ele também diz: «Uma nova chave desativa todas as chaves antigas da sua conta Govee.» Escolha «Já tenho minha chave» quando o e-mail chegar.
- Colar sua chave
Em «Cole sua chave», cole a chave do e-mail da Govee no campo «Chave de API da Govee». A chave é armazenada criptografada e nunca é exibida novamente.
- Salvá-la
Escolha «Salvar e continuar». O painel verifica a chave com a Govee antes de você continuar.
- Ver suas luzes
Em «Suas luzes», o painel mostra «Luzes com suporte a cores encontradas» e a quantidade de luzes. Escolha «Configurar recompensas» para continuar.
Duas mensagens podem aparecer ao salvar. Elas não significam a mesma coisa:
- «A Govee não aceitou esta chave. Verifique-a e tente novamente.» A chave não foi salva. Cole-a novamente.
- «Chave salva, mas a Govee não respondeu, então ainda não foi verificada. Suas luzes vão funcionar assim que a Govee voltar. Se não funcionarem, cole a chave novamente.» A chave está salva e você pode continuar.
Criar a recompensa de pontos do canal
- Abrir a página Luzes Govee
Ative «Ativar luzes Govee» se estiver desativado. Em «Suas luzes», cada luz mostra «Não configurada» até ter uma recompensa.
- Escolher uma luz
Escolha a luz que você quer deixar os espectadores controlarem. O editor de recompensa será aberto.
- Preencher a recompensa
Preencha o «Título da recompensa», o «Custo (pontos)», a «Cor do bloco» e o «Intervalo entre usos» (0 = desativado). O campo «Resposta no chat» é opcional.
- Escolher o que acontece após o resgate
Em «Após o resgate», escolha «Concluir», «Devolver os pontos» ou «Deixar para um moderador».
- Criá-la
Escolha «Criar recompensa». O bot cria a recompensa na Twitch. Para editá-la depois, altere os campos e escolha «Salvar alterações».
O que os espectadores digitam
Quando um espectador resgata a recompensa, ele digita uma cor. Um nome de cor em inglês funciona, como blue.
Um código hexadecimal também funciona, como #00ccff. Se você ativar «Permitir que os espectadores apaguem a luz»,
um espectador pode digitar off para apagar a luz.
Em caso de problema
Nas linhas de chat abaixo, @viewer representa o nome do espectador que resgatou a recompensa. Cada linha de reembolso
significa que o bot devolveu os pontos.
| O que você vê | O que isso significa | O que fazer |
|---|---|---|
| «A Govee não aceitou esta chave. Verifique-a e tente novamente.» | A Govee recusou a chave. A chave não foi salva. | Copie a chave novamente do e-mail da Govee, sem espaços a mais. Se você pediu uma chave mais recente depois, use a mais recente. As chaves antigas deixam de funcionar quando você gera uma nova. |
| «Chave salva, mas a Govee não respondeu, então ainda não foi verificada. Suas luzes vão funcionar assim que a Govee voltar. Se não funcionarem, cole a chave novamente.» | A chave foi salva, mas a Govee não respondeu quando o painel tentou verificá-la. | Continue. Tente a recompensa um pouco mais tarde. Se as luzes não mudarem, cole a chave novamente. |
| «Não foi possível salvar a chave.» | O painel não conseguiu armazenar a chave. | Tente novamente em instantes. |
| «A Govee não aceita mais esta chave de API. Escolha Remover chave e cole uma nova chave do aplicativo Govee Home.» | A chave estava salva, mas a Govee agora a recusa. Uma causa possível é uma chave mais recente na mesma conta, que desativa as antigas. | Escolha «Remover chave», peça uma nova chave no aplicativo Govee Home e cole-a. |
| «Não foi possível carregar suas luzes Govee. Verifique sua chave de API e tente novamente.» | O painel não conseguiu obter sua lista de luzes da Govee. A chave pode estar incorreta, ou a Govee não respondeu. | Escolha «Tentar novamente». Se falhar de novo, escolha «Remover chave» e cole a chave outra vez. |
| «Nenhum dispositivo Govee encontrado nesta conta.» | A Govee não retornou nenhum dispositivo para esta chave. As luzes podem não estar adicionadas a esta conta Govee, ou podem usar apenas Bluetooth. | Adicione suas luzes no aplicativo Govee Home, conecte-as ao Wi-Fi e depois escolha «Atualizar luzes». |
| «Nenhuma luz Govee com suporte a cores foi encontrada nesta conta.» | A Govee retornou dispositivos, mas nenhum consegue mudar de cor. Só aparecem modelos com suporte a cores. | Adicione uma luz colorida à sua conta Govee no aplicativo Govee e depois escolha «Atualizar luzes». |
| «Não foi possível conectar ao servidor. Tente novamente em instantes.» | O painel não conseguiu contatar o ItsBagelBot. | Recarregue a página em instantes. |
| «Reconecte-se para autorizar o acesso aos pontos do canal.» | O bot precisa de acesso aos pontos do canal para criar recompensas no seu canal da Twitch. | Escolha «Reconectar» e aprove o acesso na Twitch. |
| Digite sua chave de API da Govee. | O campo da chave estava vazio ao salvar. | Cole a chave do e-mail da Govee e escolha «Salvar e continuar» novamente. |
| Dê um título à recompensa. | O campo Título da recompensa está vazio. | Digite um título e salve a recompensa novamente. |
| Digite um número inteiro de pontos, no mínimo 1. | O Custo (pontos) não é um número inteiro de pelo menos 1. | Digite um número inteiro, 1 ou mais. |
| Digite um intervalo entre 0 segundo e 7 dias. | O Intervalo entre usos está fora da faixa permitida. | Digite um intervalo de 0 segundo (desativado) a 7 dias. |
| Não foi possível alternar as luzes Govee. | A opção Ativar luzes Govee não foi salva. | Recarregue a página, confira a opção e tente novamente. |
| Não foi possível remover a chave. | A chave salva não pôde ser removida. | Aguarde um instante e escolha «Remover chave» novamente. |
| «Não foi possível salvar a recompensa.» | A recompensa não foi criada nem atualizada. Uma causa possível é um canal que não é afiliado nem parceiro da Twitch, já que o painel indica que a Twitch só permite que esses canais criem recompensas. | Confira o título e o custo e tente novamente. Se ainda falhar, confirme que o seu canal é afiliado ou parceiro da Twitch. |
| Não foi possível remover a recompensa. | A recompensa não pôde ser removida. | Aguarde um instante e tente novamente. |
| «@viewer as luzes só mudam durante uma transmissão ao vivo, seus pontos foram devolvidos.» | Um espectador resgatou a recompensa enquanto você estava offline e «Somente ao vivo» está ativado. | Nada. Inicie sua live, ou desative «Somente ao vivo» se quiser mudanças offline. |
| «@viewer essa cor não foi reconhecida, seus pontos foram devolvidos. Tente um nome como blue ou um código hexadecimal como #00ccff.» | O espectador digitou algo que não é um nome de cor conhecido nem um código hexadecimal. | Peça ao espectador para digitar um nome de cor em inglês, como blue, ou um código hexadecimal, como #00ccff. |
| «@viewer as luzes ainda não estão configuradas, seus pontos foram devolvidos.» | O bot não encontrou uma configuração Govee funcional para esta luz no momento do resgate. | Abra a página Luzes Govee. Confira se «Chave salva» aparece e se a luz tem uma recompensa. |
| «@viewer as luzes estão mudando com frequência demais, seus pontos foram devolvidos. Tente novamente em instantes.» | Chegaram mudanças de cor demais ao mesmo tempo, então o bot segurou esta. | Peça ao espectador para tentar de novo em instantes. Adicione um «Intervalo entre usos» à recompensa para espaçar as mudanças. |
| «@viewer não foi possível alcançar as luzes, seus pontos foram devolvidos.» | A Govee ou a luz não respondeu. | Confirme que a luz está ligada e online no aplicativo Govee Home. Depois tente novamente. |