01O que você precisa
Você precisa de uma conta Govee Home e de luzes Govee já configuradas no aplicativo Govee Home. As luzes que usam apenas Bluetooth podem não aparecer. 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.
02Obter 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.
03Conectar 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.
04Criar 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.
05Em 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. |