feat: Add function to get elapsed time of playing audio on VoiceClient

CHANGELOG.md

@@ -22,6 +22,8 @@ These changes are available on the `master` branch, but have not yet been releas
   `tags`. ([#2520](https://github.com/Pycord-Development/pycord/pull/2520))
 - Added `Member.guild_banner` and `Member.display_banner` properties.
   ([#2556](https://github.com/Pycord-Development/pycord/pull/2556))
+- Added `played_time` function to `VoiceClient` to get elapsed time of the playing audio
+  file. ([#2587](https://github.com/Pycord-Development/pycord/pull/2587/))
 
 ### Fixed
 

discord/player.py

@@ -724,6 +724,7 @@ def __init__(self, source: AudioSource, client: VoiceClient, *, after=None):
         self._current_error: Exception | None = None
         self._connected: threading.Event = client._connected
         self._lock: threading.Lock = threading.Lock()
+        self._played_frames: int = 0
 
         if after is not None and not callable(after):
             raise TypeError('Expected a callable for the "after" parameter.')
@@ -755,6 +756,8 @@ def _do_run(self) -> None:
                 self._start = time.perf_counter()
 
             self.loops += 1
+            self._played_frames += 1
+
             # Send the data read from the start of the function if it is not None
             if first_data is not None:
                 data = first_data
@@ -834,3 +837,7 @@ def _speak(self, speaking: bool) -> None:
             )
         except Exception as e:
             _log.info("Speaking call in player failed: %s", e)
+
+    def played_frames(self) -> int:
+        """Gets the number of 20ms frames played since the start of the audio file."""
+        return self._played_frames

discord/voice_client.py

@@ -40,6 +40,7 @@
 from __future__ import annotations
 
 import asyncio
+import datetime
 import logging
 import select
 import socket
@@ -988,3 +989,10 @@ def send_audio_packet(self, data: bytes, *, encode: bool = True) -> None:
             )
 
         self.checked_add("timestamp", opus.Encoder.SAMPLES_PER_FRAME, 4294967295)
+
+    def played_time(self) -> datetime.timedelta:
+        """Gets the elapsed time of the playing audio. Returns 0 if not playing anything."""
+        if self._player:
+            return datetime.timedelta(milliseconds=self._player.played_frames() * 20)
+        else:
+            return datetime.timedelta()