スクリーンタイムとオンライン状態の統計
スクリーンタイムモジュールは、メンバーが Discord でどれだけの時間アクティブだったかを、メンバーごとに見やすくまとめます。おなじみの年間まとめのような振り返りをヒントに、週ごとまたは日ごとのすっきりしたグラフ付きのカードをチャンネルに直接投稿します。
スクリーンタイムはバックグラウンドで自動的に記録する機能ですが、条件が 1 つあります。オンライン状態の記録はオプトイン制です。Levlix がステータスの変化を記録するのは、/privacy の ステータス記録、またはダッシュボードの プライバシーとデータ ページの オンライン状態の記録 を自分でオンにしたメンバーだけです。
[!IMPORTANT]
メンバーが /privacy の ステータス記録、またはダッシュボードの プライバシーとデータ ページの オンライン状態の記録 をオンにするまで、何も記録されません。再びオフにすると、記録されたスクリーンタイムはすべてすぐに削除されます。
セットアップと導入
スクリーンタイムには、モジュールのスイッチ以外のサーバー設定は必要ありません。オンライン状態を記録するかどうかは、メンバーがそれぞれ自分で決めます。記録は、Discord の /privacy の ステータス記録、または Web ダッシュボードの プライバシーとデータ ページの オンライン状態の記録 をオンにするまでオフのままです。
| 要件 | 詳細 |
|---|---|
| ボットの権限 | 既定の権限以外は不要です。カードはコマンドへの返信として表示されます。 |
| メンバーのオプトイン | メンバー自身が /privacy の ステータス記録、または プライバシーとデータ ページの オンライン状態の記録 をオンにします。集計は約 5 分以内、メンバーの次のステータス変化から始まります。 |
| ダッシュボードのスイッチ | モジュールページの 統計 モジュールです。オフの間、Levlix はそのサーバーでオンライン状態を記録せず、/screentime も使えません。モジュールがオンのサーバーをほかに共有していないメンバーは、5 分以内に集計の対象から外れます。 |
データは Discord の公開されたオンライン状態(オンライン、退席中、取り込み中、オフライン)に基づくため、ステータスを「オンライン状態を隠す」にしているメンバーは、その間の時間が自分のグラフに表示されません。これは意図した動作で、Discord のプライバシーの考え方を尊重しています。
スクリーンタイムはサーバーではなくメンバーのものです。モジュールがオンのすべてのサーバーでのステータスをまとめて数えるので、カードにはどのサーバーでも同じ数字が表示されます。
コマンドの使い方
メンバーは誰でも、いつでも自分のスクリーンタイムのグラフを作成できます。
/screentime
コマンドを実行すると、チャンネルにカードが投稿されます。カードはサーバーの言語で表示され、2 つのタブがあります。
| タブ | 表示内容 |
|---|---|
| 週 | 直近 7 日間を日ごと、ステータスの色ごとに分けて表示し、1 日の平均と、その前の 7 日間との比較を示します |
| 今日 | 今日のアクティビティを時間ごとに分けて表示し、ここまでの合計と、昨日との比較を示します |
カードには、グラフが画像で、主な数字がテキストで表示されます。コマンドを実行した時点までに数えられたすべての分が含まれます。チャンネルの全員がカードを見られますが、タブを切り替えられるのはあなただけです。自分の言語で表示 を押すと、読んだ人それぞれにカードのテキストの非公開のコピーが自分の言語で表示されます。コピーには数字は含まれますが、グラフの画像は含まれません。
グラフでは、アクティブな時間として数える 3 つのステータスに、Discord 本来のステータスの色を使います。
| ステータス | 意味 |
|---|---|
| オンライン | メンバーが Discord を実際に使っていた |
| 退席中 | メンバーは離れていたが接続していた |
| 取り込み中 | メンバーは接続していたが、対応できない状態にしていた |
オフラインの時間は数えられず、グラフにも表示されません。
使える人
| 操作 | 権限 |
|---|---|
/screentime の実行 |
すべてのメンバー |
| ほかのメンバーのスクリーンタイムの表示 | 対応していません。グラフは本人専用です |
| 自分のスクリーンタイムのデータの削除 | メンバーが /privacy の ステータス記録、または プライバシーとデータ ページの オンライン状態の記録 をオフにすると、スクリーンタイムがすべてすぐに削除されます。アカウントを削除した場合も削除されます。 |
週と今日を切り替えられるのは、コマンドを実行したメンバーだけです。ほかの人がタブをクリックすると、代わりに短い非公開のメッセージが表示されます。
仕組み
スクリーンタイムは 2 つの段階で動きます。
- 軽量な オンライン状態トラッカー が、オプトインしたメンバーのステータスの変化に気づき、経過した分数をメモリに保持します。
- Levlix は 5 分ごとに、その分数を日、時間、ステータスごとにまとめて保存します。
/screentimeは先に保留中の分数を保存するので、カードは常に最新です。
この設計により、この機能がイベントごとに加える負荷はほぼゼロで、メンバーのグラフはステータス変化をすべて記録したログではなく、これらの合計から作られます。
例外的なケースと重要な注意点
- オンライン状態を隠している間は記録されません。 Discord は、オンライン状態を隠しているメンバーをオフラインとして報告するため、その時間は数えられません。
- 記録はオプトイン制です。 記録をオンにしていないメンバーは一切記録されません。そのメンバーのカードは空のままで、記録をオンにする方法が表示されます。
- メンバーが Levlix から見える必要があります。 モジュールがオンのサーバーを Levlix と共有していない場合や、何らかの理由で Levlix がメンバーのオンライン状態を見られない場合は、統計に抜けが出ます。
- グラフは本人専用です。 ランキングや比較の機能は意図的にありません。スクリーンタイムは自分を振り返るためのツールで、順位を競うためのツールではありません。
- データの保持。 オンライン状態の分数は 90 日間 保持された後、自動で削除されます。カード自体が使うのは直近 14 日分だけです。
/privacyの ステータス記録、またはダッシュボードの オンライン状態の記録 をオフにすると、それまでに記録されたものはすべて削除され、再びオンにするとゼロから始まります。すべての保持期間については データ保持とプライバシー をご覧ください。 - 日と時間は UTC に従います。 「今日」は UTC の午前 0 時に始まり、今日のグラフの時間も UTC です。
- 短い時間は数えません。 1 分未満しか続かなかったステータスは数えられず、1 分に満たない端数は切り捨てられます。
トラブルシューティング
グラフがほとんど空です。
カードに記録がオフだと表示されている場合は、/privacy の ステータス記録、または プライバシーとデータ ページの オンライン状態の記録 をオンにしてください。オフのままでは Levlix は何も記録しません。オンになっている場合、集計はオンにした後の次のステータス変化、たとえば退席中になったときやオンラインに戻ったときから始まります。オンにしてから 5 分ほど待ち、いつもどおり Discord を使ってから、もう一度試してください。
アクティブだったのにグラフでオフラインになっています。
Discord のステータスが「オンライン状態を隠す」になっていなかったか確認してください。オンライン状態を隠しているメンバーを Discord がオンラインとして報告することはないため、Levlix はその時間を記録できません。
タブが反応しません。
タブを切り替えられるのは、コマンドを実行したメンバーだけです。ほかの人のカードをクリックした場合は、自分で /screentime を実行して自分のカードを使ってください。また、10 分間クリックがないとタブは使えなくなります。新しいカードを出すには、もう一度コマンドを実行してください。
関連する機能
- XP とレベル: ボイスの時間は XP システムでも記録され、メンバーのレベルの進行につながります。
- アクティビティの記録: メンバーごとのメッセージ、ボイス、リアクションの数。
- マイルストーン: ボイスの分数やメッセージ数を使って、コミュニティ全体の目標を設定できます。