strAImer strAImer
Entrar

Catálogo de Módulos

As pessoas perguntam isso como

O que tem nesta página

Catálogo de Módulos na barra lateral é onde os módulos são instalados, ligados e desligados, revertidos e removidos. Ele tem duas telas: Integrados — tudo o que o instalador trouxe, e Extensões — o resto, que é baixado de straimer.com quando você pede.

Cada módulo que você tem fica em uma dessas duas telas como um cartão: o nome, um selo pequeno com o tipo do módulo (connector, widget, settings-ui e parecidos — palavras internas, que ficam em inglês em todos os idiomas), a descrição, a versão e os botões do que dá para fazer com ele. Um módulo instalado mostra ainda Módulo está em execução ou Módulo está desligado — o trabalho em segundo plano está em pausa, com um interruptor ao lado.

Atualizar, no canto superior direito, relê a lista. A resposta do servidor fica guardada por cerca de um minuto, então apertar logo depois de a sua conexão mudar pode devolver a mesma imagem.

O que é integrado e o que é baixado

Extensões oferece estes cartões:

Todo o resto está em Integrados e não precisa de download nenhum. Isso inclui os conectores da Twitch, do YouTube e do Kick, o DonationAlerts e o DonatePay, os alertas, as sobreposições de chat, as metas de doações, as listas, os comandos e os temporizadores do chat, as recompensas de pontos do canal, os cenários, as estatísticas, as taxas de câmbio, o agente de IA, o controle do OBS, a página do streamer e cinco dos blocos do Painel de Controle. Um módulo pode passar de uma tela para a outra entre versões, então a palavra final é das próprias duas telas.

A bolinha ao lado de Catálogo de Módulos

Uma bolinha fica ao lado de Catálogo de Módulos na barra lateral e ao lado de Extensões dentro dele. Ela diz uma de duas coisas, e a dica que aparece ao passar o mouse esclarece qual:

Ao abrir Extensões a bolinha se apaga, e tudo o que essa tela mostrou conta como visto dali em diante. Conta mesmo quando a lista não carregou e também quando ela estava vazia: você foi e olhou. Abrir Integrados não apaga a bolinha, porque ela fala da outra tela.

Os cartões que a acenderam levam um selo Novo ao lado do nome. Duas coisas nunca são novidade, cada uma pelo seu motivo:

Em que ordem os cartões ficam

Primeiro o novo, depois por nome. O alfabeto é o dos nomes escritos nos cartões, então a ordem muda de um idioma de interface para outro, e é justamente essa a ideia: a gente procura um módulo pelo nome que consegue ver.

Os pacotes ficam nesse mesmo alfabeto, e não em um bloco próprio, assim um módulo avulso recém-chegado fica no topo da tela e não embaixo de todos os pacotes.

A tela Integrados é ordenada por nome do mesmo jeito. Lá não há selos Novo: o que está nela chegou junto com o aplicativo, e não pode ser novidade.

Instalando um módulo

  1. Abra Catálogo de Módulos → Extensões. Em Integrados não há nada para instalar — esses módulos já estão aqui.
  2. Ache o cartão e aperte Instalar. Ele mostra Instalando… enquanto o pacote é baixado, conferido e descompactado; um segundo ou dois é normal.
  3. Um módulo instalado pela primeira vez fica ligado e começa a funcionar na hora: a página dele aparece na barra lateral, os blocos dele ficam disponíveis no Painel de Controle e o trabalho em segundo plano começa sem reiniciar. Versões anteriores à 0.19.1 só começavam esse trabalho depois que o strAImer era reiniciado: se um módulo instalado em uma dessas versões não faz nada, reinicie o aplicativo ou atualize-o.

Instalado significa que os arquivos estão neste computador, não que o aplicativo saiba do módulo. Configurações trazidas de outro computador chegam sem arquivos, então o catálogo oferece Instalar para um módulo cujas configurações já estão aqui — e as aproveita assim que ele é instalado.

Ligando e desligando um módulo

O interruptor fica no cartão do módulo, nas duas telas. Desligar para o trabalho em segundo plano do módulo e também tira a página dele da barra lateral e os blocos dele do Painel de Controle. Esse é o motivo comum de uma seção "sumir": nada foi apagado, o interruptor está desligado.

Se a página do próprio módulo estiver aberta nesse momento, aparece uma faixa nela — Módulo está desligado — o trabalho em segundo plano está em pausa, com um botão Onde ligá-lo que leva de volta a este cartão.

Módulos integrados são desligados do mesmo jeito que as extensões. Desligar não apaga nada: arquivos, configurações e acessos às plataformas ficam onde estão.

Atualização

Um cartão com uma versão mais nova diz Instalado: v1.2.0 e, depois de uma seta, v1.3.0 disponível; o botão vira Atualizar. As mesmas atualizações estão reunidas em uma lista só em Configurações → Atualizações — essa página está descrita no guia "Atualizações".

Uma atualização pode existir no site e não ser oferecida aqui, e há dois motivos comuns:

Revertendo

O aplicativo guarda os dois pacotes mais recentes de cada módulo, então um módulo atualizado oferece Reverter para 1.2.0 — a versão que você tinha antes desta. Acontece na hora, sem confirmação, e as configurações do módulo são mantidas.

Um módulo integrado tem um segundo caminho de volta, e ele não precisa de pacote guardado: Restaurar versão incluída joga fora a cópia baixada e devolve a versão que veio com o aplicativo. O botão aparece assim que esse módulo foi atualizado pelo menos uma vez — sem cópia baixada não há o que jogar fora.

Uma extensão sem nada no cache não tem nenhum dos dois botões — a versão que você tem é a única no disco.

Removendo

Só extensões podem ser removidas, pelo ícone de lixeira no cartão. Ele pergunta antes, e é sério mesmo: as configurações do módulo e os acessos guardados às plataformas vão junto, e isso não dá para desfazer.

Módulos integrados não têm lixeira — os arquivos deles ficam dentro do próprio programa, e o aplicativo se recusa a apagá-los. Desligar e Restaurar versão incluída é o que eles têm no lugar.

Pacotes

Algumas coisas não são um módulo só. O leilão é um motor, três sobreposições para OBS e cinco blocos do Painel de Controle; separados eles não fazem nada — um motor sem sobreposição não mostra nada, uma sobreposição sem motor não tem o que mostrar. Conjuntos assim aparecem em Extensões como um único cartão marcado pacote e instalam com um aperto só.

Os membros instalam um depois do outro, com uma linha de progresso que nomeia cada um. Se um deles falha, os outros instalam mesmo assim, e as falhas são listadas no fim.

A linha embaixo do nome diz em que pé o pacote está. Com um pacote de nove módulos ela se lê 9 módulos em uma instalação antes de haver qualquer coisa, Pacote 1.0.0 · 9 módulos quando o conjunto inteiro está nas versões que aquele lançamento fixou, e totalmente instalado (9 módulos) para um pacote que ainda não tem lançamentos próprios.

Os membros do pacote não ganham cartões próprios em Extensões: instalação, atualização, reversão e remoção acontecem todas no cartão do pacote.

Só uma parte está instalada

Quando parte do conjunto está faltando, o cartão diz parcialmente instalado: 2 de 9 e o botão vira Instalação completa — ele busca o que falta e deixa em paz todo membro que já está na versão que o pacote espera. A lixeira também está ali: um pacote instalado pela metade é removido como um inteiro, já que os módulos dele não funcionam separados.

A conta é feita pelos arquivos no disco, não pelos registros no aplicativo. Um computador que recebeu configurações de um backup tem registro de cada módulo e nenhum arquivo, então o pacote conta como não instalado — o que é a verdade: não há nada ali para rodar.

O interruptor só alcança os módulos que estão realmente aqui, e conta esses, não o conjunto inteiro: com dois de nove instalados e um deles rodando, ele se lê 1 de 2 funcionando. Um aperto sempre leva o pacote inteiro para um mesmo estado. Ligar um pacote instalado pela metade inicia o que está presente e depois diz Alguns módulos não estão instalados aqui — as configurações deles já foram restauradas, e instalar o pacote as aproveita.

O conjunto não corresponde a nenhum lançamento

Instalar, atualizar ou reverter membros um por um deixa uma combinação que ninguém testou junta. O cartão então diz Composição alterada manualmente — não corresponde ao pacote 1.0.0 e oferece Restaurar a composição do pacote, que coloca cada membro na versão que aquele lançamento fixou.

A outra ponta do mesmo caso não tem botão: quando cada membro é mais novo que tudo o que o pacote já lançou, não há para onde restaurar, e o cartão diz Os membros estão à frente do pacote 1.0.0 — aguardando sua próxima versão.

Instalação recusada

A mensagem nomeia o motivo. Os comuns:

Extensões não mostra nada

Sem conexão com straimer.com a lista de módulos disponíveis não pode ser exibida, e a tela diz isso no lugar da lista. Isso não afeta os módulos instalados — eles são lidos do banco de dados local e continuam funcionando, e Integrados continua cheio. Nessa tela o aplicativo acrescenta uma linha em vez disso: Sem conexão com straimer.com: atualizações não foram verificadas — "não há atualizações" e "não foi olhado" são coisas diferentes.

O que esta página não faz