Reverter a versão de um plugin

Se uma atualização recente de plugin quebrou a iluminação do seu dispositivo, a Reversão de Plugin permite voltar para uma versão anterior diretamente no SignalRGB. Sem troca manual de arquivos e sem reiniciar. Este guia mostra como usar o recurso e o que fazer quando algo dá errado.

Lista de Verificação Rápida

Antes de solucionar problemas, verifique se estes requisitos foram atendidos:

• O SignalRGB está atualizado. A Reversão de Plugin foi introduzida na versão 2.5.74. Reinicie o aplicativo para executar o serviço de atualização automática e confira os registros de alterações para ver a versão mais recente.
• Seu dispositivo é detectado. O dispositivo precisa aparecer na sua lista de dispositivos. Se ele não aparecer, veja Dispositivo Não Detectado antes de continuar.
• Seu dispositivo usa um plugin de CDN. A reversão só está disponível para plugins distribuídos pela rede de plugins do SignalRGB. Plugins integrados, addons e plugins de usuário instalados manualmente mostram informações nas configurações, mas não permitem selecionar a versão.
• O SignalRGB tem conexão ativa com a internet. O aplicativo busca as versões disponíveis nos servidores quando você abre a lista de versões. Um problema de rede pode impedir o carregamento.

Se todos os requisitos acima forem atendidos e o problema continuar, siga para as soluções abaixo.

Como usar a Reversão de Plugin

1. Abra o SignalRGB e vá para a aba Dispositivos.
2. Clique no seu dispositivo e abra a aba Configurações dele.
3. Role até a seção Plugin. Você verá o nome do plugin, o tipo de origem (Built-in, Addon, CDN ou User Plugin) e, se a reversão estiver disponível, um menu suspenso de versões.
4. Clique no menu suspenso para carregar a lista de versões.
5. Selecione qualquer versão para aplicá-la imediatamente. O plugin recarrega, sem precisar reiniciar.

Problemas Comuns e Soluções

A opção de reversão não aparece nas configurações do dispositivo

Sintomas: Você vê a seção Plugin nas configurações do dispositivo, mas não há menu suspenso de versões, só existe uma opção de plugin, o menu está esmaecido, ou o rótulo de origem aparece mas nenhum seletor surge abaixo dele.

Soluções:

• Verifique o rótulo de origem. Se estiver escrito Built-in, Addon ou User Plugin, a reversão não está disponível para esse plugin. Apenas plugins marcados como Source: CDN permitem selecionar versão.

• Existe apenas uma versão deste plugin. Se o SignalRGB publicou só uma versão desde o lançamento do recurso, não há para onde reverter.
• A lista de versões ainda está carregando. Abra o menu suspenso e aguarde um instante. Se aparecer “Loading versions…” por mais de 30 segundos, verifique sua conexão com a internet e tente de novo.

A reversão não resolveu o problema

Sintomas: Você selecionou uma versão anterior, o plugin recarregou, mas o dispositivo continua com o mesmo problema: cores erradas, sem iluminação, piscando ou sem resposta.

Soluções:

• Desconecte e reconecte o dispositivo após reverter. Em alguns casos o dispositivo não reinicializa por completo durante o recarregamento do plugin. Desconectar e reconectar pode limpar esse estado.
• O problema pode não estar relacionado ao plugin. Piscar, cores travadas e falta de resposta também podem vir da conexão USB, de softwares RGB conflitantes ou de problemas de driver. Veja Dispositivo Não Detectado e Programas Conflitantes para descartar essas causas.
• O problema pode ser anterior às versões novas. Se todas as versões se comportam igual, o problema não foi introduzido por uma atualização de plugin. Envie um relatório de bug ou veja Quando e Como Contatar o Suporte para mais opções.

A reversão voltou atrás após reiniciar

Sintomas: Você reverteu para uma versão anterior e estava funcionando, mas depois de reiniciar o SignalRGB o dispositivo voltou para a versão mais recente do plugin.

Explicação: Isso é esperado. Quando o SignalRGB publica uma nova versão de plugin, qualquer reversão salva para aquele plugin é limpa automaticamente na próxima inicialização. O sistema assume que a nova versão corrige o que motivou a reversão.

O que fazer: Se a nova versão ainda apresentar o problema, reverta novamente pelas configurações do dispositivo.

”Applying…” aparece mas a reversão nunca termina

Sintomas: Depois de selecionar uma versão, o menu suspenso mostra “Applying…” e permanece assim por mais de um minuto.

Soluções:

• Verifique sua conexão com a internet. O SignalRGB baixa a versão selecionada dos servidores. Uma conexão lenta ou interrompida trava o download.
• Reinicie o SignalRGB e tente de novo. Feche o aplicativo por completo, abra novamente e reselecione a versão nas configurações do dispositivo.
• Tente de novo em alguns minutos. Se os servidores de plugins estiverem temporariamente indisponíveis, o download pode falhar silenciosamente. Uma espera curta normalmente resolve.

Solução de Problemas Avançada

Restaurar a versão mais recente sem reiniciar

Se você quiser voltar para a versão mais recente do plugin antes que um novo lançamento limpe a reversão automaticamente:

1. Abra a aba Configurações do seu dispositivo.
2. Na seção Plugin, abra o menu suspenso de versões.
3. Selecione a entrada marcada como current, a primeira da lista.

O SignalRGB reaplica a versão mais recente do CDN imediatamente e limpa a reversão salva.

Confirmar qual versão do plugin está carregada

Se você não tem certeza se há uma reversão ativa ou qual versão está rodando, verifique a seção Plugin nas configurações do dispositivo. O hash CRC e a data de publicação da versão carregada aparecem ali. Se a data for mais antiga do que o esperado, pode haver uma reversão ativa.

Substituição manual do plugin

Como último recurso, se a Reversão de Plugin não estiver disponível para o seu dispositivo ou se todas as versões tiverem o mesmo problema, você pode instalar manualmente uma versão específica colocando-a na sua pasta de plugins de usuário. Isso ignora o CDN por completo e persiste entre atualizações, então remova o arquivo assim que uma correção oficial for lançada.

Para ver os passos, consulte Substituindo um Arquivo de Plugin.

Reportando Problemas

Se você já tentou estes passos e o dispositivo continua sem funcionar corretamente, envie um relatório de bug para nossa equipe investigar:

O que incluir no relatório de bug:

• O nome e modelo do seu dispositivo
• O tipo de origem do plugin mostrado nas configurações do dispositivo (CDN, Built-in, etc.)
• O hash CRC da versão para a qual você reverteu (visível na seção Plugin)
• O que o dispositivo está fazendo: piscando, sem iluminação, cores erradas ou sem resposta
• Se a reversão pareceu ser aplicada (o plugin recarregou após selecionar uma versão?)
• O que você já tentou deste guia

Como enviar:

• Use o ícone de bug no aplicativo (canto superior direito)
• Envie um relatório de bug
• Contatar o Suporte ao Cliente

Nossa equipe de suporte entrará em contato e trabalhará com você para resolver o problema!

Artigos Relacionados

• Dispositivo Não Detectado — se o seu dispositivo não aparecer de jeito nenhum
• Programas Conflitantes — se outro software RGB pode estar interferindo no seu dispositivo
• Substituindo um Arquivo de Plugin — como carregar um plugin manualmente
• Quando e Como Contatar o Suporte — informações sobre como falar com nossa equipe de suporte