Implement UserActive events

This change introduces the UserActiveTimer,  which tracks voice activity
and emits UserActive events.

UserActiveTimer is basically a fancy wrapper around a context with
a deadline and cancelFunc. When a user joins a voice channel, a
UserActiveTimer is started.

If the user stays in the voice channel for an amount of time defined in the configs,
the timer context's deadline trips and a UserActive event is emitted. A new timer is then started.

If instead the user leaves the voice channel, the timer's context is
cancelled.

This change introduces two config values to manage this process:

VoiceActivityThresholdSeconds defines the length of time a user is
required to stay in vc before a UserActive event is generated.

VoiceActivityTimerSleepInterval defines how long the timer sleeps at any
one time. After this interval, it wakes up to check if its context has
been cancelled.

This change also changes the state package's UserEvent validation to
remove an import loop. We will now assume that the discord package
has already validated any UIDs it passes along to the state package.
This commit is contained in:
Piper Pentagram 2024-11-13 16:32:58 -08:00
parent 8110037ddf
commit 9b00241d2b
5 changed files with 219 additions and 16 deletions

View file

@ -3,4 +3,19 @@ log_dir: "log"
log_max_size_mb: 500
log_max_backups: 3
log_max_age_days: 365
log_compression: false
log_compression: false
# how long (in seconds) a user needs to be in vc
# in order to generate a UserActive event
voice_activity_threshold_seconds: 600
# how long (in milliseconds) a voice activity timer sleeps at a time between
# context cancellation checks.
# a higher value means the function sleeps longer which could be
# useful for some reason in the future
# a higher value also means that the timer could take longer to cancel.
# current recommended value is 1000ms.
voice_activity_timer_sleep_interval_millis: 1000