Conteúdo
Estatísticas de tempo de tela e presença
O módulo de tempo de tela dá a cada membro um resumo pessoal e visual de quanto tempo ele passou ativo no Discord. Inspirado nas clássicas retrospectivas de fim de ano, ele publica direto no canal um cartão com um gráfico semanal ou diário bem limpo.
O tempo de tela é um recurso passivo com uma condição: o rastreamento de presença só funciona para quem optar por ele. O Levlix só registra as mudanças de status dos membros que ativaram o Rastreamento de presença para si mesmos.
[!IMPORTANT]
Nada é registrado até que um membro ative o Rastreamento de presença com /privacy ou na página Privacidade e dados do painel. Desativá-lo de novo apaga na hora todo o tempo de tela registrado desse membro.
Configuração e instalação
O tempo de tela não precisa de nenhuma configuração no servidor além da chave do módulo. Cada membro decide por si se a sua presença é registrada: o Rastreamento de presença fica desligado até que ele o ative, com /privacy no Discord ou na página Privacidade e dados do painel web.
| Requisito | Detalhes |
|---|---|
| Permissões do bot | Nenhuma além das padrão. O cartão é a resposta ao comando. |
| Opção do membro | Rastreamento de presença ativado pelo próprio membro (/privacy ou Privacidade e dados). A contagem começa em cerca de cinco minutos, na próxima mudança de status do membro. |
| Chave no painel | O módulo Estatísticas na página Módulos. Enquanto ele está desligado, o Levlix não registra presença nesse servidor e o /screentime não fica disponível lá. Um membro que não compartilha nenhum outro servidor com o módulo ligado deixa de ser contado em até cinco minutos. |
Como os dados se baseiam na presença pública do Discord (Online, Ausente, Não perturbe, Offline), os membros com o status definido como "Invisível" não aparecem nos próprios gráficos durante os períodos invisíveis. Isso é intencional e respeita as expectativas de privacidade do Discord.
O tempo de tela pertence ao membro, não a um servidor: ele conta o status do membro em todos os servidores em que o módulo está ligado, e o cartão mostra os mesmos números em cada um deles.
Usando o comando
Qualquer membro pode gerar o próprio gráfico de tempo de tela a qualquer momento.
/screentime
O comando publica um cartão no canal. Ele usa o idioma do servidor e tem duas abas:
| Aba | O que mostra |
|---|---|
| Semana | Os últimos sete dias divididos por dia e pela cor de cada status, com a sua média diária e a variação em relação aos sete dias anteriores |
| Hoje | A atividade de hoje dividida por hora, com o seu total até agora e a variação em relação a ontem |
O cartão mostra o gráfico como imagem e os números principais como texto. Ele inclui cada minuto contado até o momento em que você executa o comando. Todos no canal o veem, mas só você pode trocar as abas. No meu idioma dá a qualquer leitor uma cópia privada do cartão em texto, no idioma dele; a cópia traz os números, mas não a imagem do gráfico.
O gráfico usa as cores de status nativas do Discord para os três status que contam como tempo ativo:
| Status | Significado |
|---|---|
| Online | O membro estava usando o Discord ativamente |
| Ausente | O membro estava longe, mas conectado |
| Não perturbe | O membro estava conectado, mas marcado como indisponível |
O tempo offline não é contado e não aparece no gráfico.
Quem pode usar
| Ação | Permissão |
|---|---|
Executar /screentime |
Qualquer membro |
| Ver o tempo de tela de outro membro | Não é possível, os gráficos são só pessoais |
| Apagar os dados pessoais de tempo de tela | O membro desliga o Rastreamento de presença (/privacy ou Privacidade e dados), o que apaga na hora todo o tempo de tela dele. Excluir a conta também apaga esses dados. |
Só o membro que executa o comando pode alternar entre Semana e Hoje. As outras pessoas que clicarem em uma aba recebem uma breve nota privada no lugar.
Como funciona
O tempo de tela funciona em duas etapas:
- Um rastreador de presença leve percebe quando o status de um membro que optou pelo recurso muda e mantém os minutos em andamento na memória.
- A cada cinco minutos, o Levlix salva esses minutos, agrupados por dia, hora e status. O
/screentimesalva primeiro os minutos pendentes, então o cartão está sempre atualizado.
Com esse modelo, o recurso quase não adiciona carga a cada evento, e o gráfico de um membro é sempre montado a partir desses totais, e não de um registro de cada mudança de status.
Casos especiais e notas importantes
- O status invisível não é registrado. O Discord informa um membro invisível como Offline, então esse tempo não é contado.
- O rastreamento é opcional. Os membros que não ativaram o Rastreamento de presença nunca são registrados. O cartão deles fica vazio e explica como ativar o rastreamento.
- O membro precisa estar visível para o Levlix. Se o Levlix não compartilha um servidor com o módulo ligado, ou não consegue ver a presença do membro por algum motivo, as estatísticas mostram lacunas.
- O gráfico é pessoal. Não há ranking nem comparação, de propósito. O tempo de tela é uma ferramenta de autorreflexão, não de classificação.
- Retenção de dados. Os minutos de presença ficam guardados por 90 dias e depois são apagados automaticamente; o cartão em si só usa os últimos 14 dias. Desligar o Rastreamento de presença apaga tudo o que foi registrado até então, e ativá-lo de novo começa do zero. Veja Retenção de dados e privacidade para todos os prazos de retenção.
- Os dias e as horas seguem o UTC. "Hoje" começa à meia-noite UTC, e as horas do gráfico Hoje são horas UTC.
- Períodos curtos são descartados. Um status que dura menos de um minuto não é contado, e minutos incompletos são arredondados para baixo.
Solução de problemas
O meu gráfico está quase vazio.
Se o cartão diz que o Rastreamento de presença está desligado, ative-o (/privacy ou Privacidade e dados): sem ele, o Levlix não registra nada. Se ele estiver ligado, a contagem começa na sua próxima mudança de status depois da ativação, por exemplo quando você fica ausente ou volta a ficar online. Espere cerca de cinco minutos depois de ativá-lo, use o Discord normalmente e tente de novo.
O meu gráfico me mostra como Offline quando eu estava ativo.
Confira se o seu status no Discord não estava definido como Invisível. O Discord nunca informa membros invisíveis como online, então o Levlix não consegue registrar esse tempo.
As abas não respondem.
Só o membro que executou o comando pode trocar as abas. Se você clicou no cartão de outra pessoa, execute /screentime você mesmo e use o seu próprio cartão. As abas também param de funcionar depois de 10 minutos sem nenhum clique; execute o comando de novo para ter um cartão novo.
Recursos relacionados
- XP e níveis - O tempo em voz também é registrado pelo sistema de XP e recompensa os membros com progresso de nível.
- Rastreamento de atividade - Contagem de mensagens, voz e reações por membro.
- Marcos - Use os minutos em voz e a contagem de mensagens para definir metas de toda a comunidade.