feat: add get audio functions (#837)

* feat: add audio function

* feat: `get_user_audio`

* chore: make `user` a snowflake

Author: VincentRPS

discord/sinks/core.py

@@ -27,6 +27,7 @@
 import sys
 import threading
 import time
+from ..types import snowflake
 
 from .errors import SinkException
 
@@ -210,4 +211,12 @@ def cleanup(self):
         self.finished = True
         for file in self.audio_data.values():
             file.cleanup()
-            self.format_audio(file)
+            self.format_audio(file)
+
+    def get_all_audio(self):
+        """Gets all audio files."""
+        return [os.path.realpath(x.file) for x in self.audio_data.values()]
+    
+    def get_user_audio(self, user: snowflake.Snowflake):
+        """Gets the audio file(s) of one specific user."""
+        return os.path.realpath(self.audio_data.pop(user))

examples/audio_recording.py

@@ -46,14 +46,15 @@ async def start(ctx: ApplicationContext, encoding: Option(str, choices=["mp3", "
     await ctx.respond("The recording has started!")
 
 
-async def finished_callback(sink, channel, *args):
+async def finished_callback(sink, channel: discord.TextChannel, *args):
 
     recorded_users = [
         f" <@{user_id}> ({os.path.split(audio.file)[1]}) "
         for user_id, audio in sink.audio_data.items()
     ]
     await sink.vc.disconnect()
-    await channel.send(f"Finished! Recorded audio for {', '.join(recorded_users)}.")
+    files = sink.get_all_audio()
+    await channel.send(f"Finished! Recorded audio for {', '.join(recorded_users)}.", files=files)
 
 @bot.command()
 async def stop(ctx):