improve: audio ending logic

This commit greatly improves the capabilities and audio sending stability of /voice, allowing it to only force stop sending audio when explictly asked to.

Author: ThePedroo

docs/Connection/play.md

@@ -13,6 +13,9 @@ connection.play(stream)
 > [!WARNING]  
 > The connection must be initialized before calling this function. Always check if `connection.udp != null` before calling this function. Make sure that the stream is an Opus stream.
 
+> [!IMPORTANT]
+> The stream real ending MUST end with 0 (as Buffer), otherwise it will persist with the interval to play packets.
+
 ## Parameters
 
 - `stream` - The stream to play.

index.js

@@ -19,6 +19,7 @@ const DISCORD_CLOSE_CODES = {
   4014: { error: false },
   4015: { reconnect: true }
 }
+const STREAM_END = Buffer.alloc(1)
 
 const ssrcs = {}
 
@@ -411,7 +412,8 @@ class Connection extends EventEmitter {
     this.playInterval = setInterval(() => {
       const chunk = this.audioStream.read(OPUS_FRAME_SIZE)
 
-      if (!chunk) return this.stop('finished')
+      if (chunk === STREAM_END) return this.stop('finished')
+      if (!chunk) return;
 
       this.sendAudioChunk(packetBuffer, chunk)
     }, OPUS_FRAME_DURATION)