feat(api): add AudioSourceWriteEvent

api/client/src/main/kotlin/su/plo/voice/api/client/event/audio/source/AudioSourceWriteEvent.kt

@@ -0,0 +1,13 @@
+package su.plo.voice.api.client.event.audio.source
+
+import su.plo.voice.api.client.audio.device.source.DeviceSource
+import su.plo.voice.api.client.audio.source.ClientAudioSource
+import su.plo.voice.api.event.EventCancellableBase
+
+/**
+ * This event is fired when the [ClientAudioSource] is about to write audio samples to [DeviceSource].
+ */
+data class AudioSourceWriteEvent(
+    val source: ClientAudioSource<*>,
+    val samples: ShortArray
+) : EventCancellableBase()

client/src/main/kotlin/su/plo/voice/client/audio/source/BaseClientAudioSource.kt

@@ -28,6 +28,7 @@ import su.plo.voice.api.client.event.audio.device.source.AlStreamSourceStoppedEv
 import su.plo.voice.api.client.event.audio.source.AudioSourceClosedEvent
 import su.plo.voice.api.client.event.audio.source.AudioSourceInitializedEvent
 import su.plo.voice.api.client.event.audio.source.AudioSourceResetEvent
+import su.plo.voice.api.client.event.audio.source.AudioSourceWriteEvent
 import su.plo.voice.api.encryption.Encryption
 import su.plo.voice.api.encryption.EncryptionException
 import su.plo.voice.api.event.EventPriority
@@ -463,6 +464,8 @@ abstract class BaseClientAudioSource<T>(
     }
 
     private fun write(samples: ShortArray, sequenceNumber: Long) {
+        if (!voiceClient.eventBus.fire(AudioSourceWriteEvent(this, samples))) return
+
         if (!activated.get()) {
             source.write(AudioUtil.fadeIn(samples, source.channels))
         } else if (sequenceNumber + 1 == endSequenceNumber) {

protocol/src/main/java/su/plo/voice/proto/packets/udp/clientbound/SelfAudioInfoPacket.java

@@ -28,6 +28,9 @@ public final class SelfAudioInfoPacket implements Packet<ClientPacketUdpHandler>
     @Getter
     private short distance;
 
+    /**
+     * Returns data only if it has been changed on the server.
+     */
     public Optional<byte[]> getData() {
         return Optional.ofNullable(data);
     }