Add support to send voice messages

discord/abc.py

@@ -74,7 +74,7 @@
 T = TypeVar('T', bound=VoiceProtocol)
 
 if TYPE_CHECKING:
     from typing_extensions import Self
 
     from .client import Client
     from .user import ClientUser
@@ -1404,6 +1404,7 @@
         suppress_embeds: bool = ...,
         silent: bool = ...,
         poll: Poll = ...,
+        voice: bool = ...,
     ) -> Message:
         ...
 
@@ -1425,6 +1426,7 @@
         suppress_embeds: bool = ...,
         silent: bool = ...,
         poll: Poll = ...,
+        voice: bool = ...,
     ) -> Message:
         ...
 
@@ -1446,6 +1448,7 @@
         suppress_embeds: bool = ...,
         silent: bool = ...,
         poll: Poll = ...,
+        voice: bool = ...,
     ) -> Message:
         ...
 
@@ -1467,6 +1470,7 @@
         suppress_embeds: bool = ...,
         silent: bool = ...,
         poll: Poll = ...,
+        voice: bool = ...,
     ) -> Message:
         ...
 
@@ -1489,6 +1493,7 @@
         suppress_embeds: bool = False,
         silent: bool = False,
         poll: Optional[Poll] = None,
+        voice: bool = False,
     ) -> Message:
         """|coro|
 
@@ -1579,6 +1584,13 @@
             The poll to send with this message.
 
             .. versionadded:: 2.4
+        voice: :class:`bool`
+            If the message is a voice message.
+
+            .. warning::
+
+                `file` attribute must be a :class:`discord.VoiceMessageFile` for this to work. Content must also be `None`
+            .. versionadded:: 2.6
 
         Raises
         --------
@@ -1624,12 +1636,13 @@
         if view and not hasattr(view, '__discord_ui_view__'):
             raise TypeError(f'view parameter must be View not {view.__class__.__name__}')
 
-        if suppress_embeds or silent:
+        if suppress_embeds or silent or voice:
             from .message import MessageFlags  # circular import
 
             flags = MessageFlags._from_value(0)
             flags.suppress_embeds = suppress_embeds
             flags.suppress_notifications = silent
+            flags.voice = voice
         else:
             flags = MISSING
 

discord/file.py

@@ -27,12 +27,14 @@
 
 import os
 import io
+import base64
 
 from .utils import MISSING
 
 # fmt: off
 __all__ = (
     'File',
+    'VoiceMessageFile',
 )
 # fmt: on
 
@@ -157,3 +159,41 @@ def to_dict(self, index: int) -> Dict[str, Any]:
             payload['description'] = self.description
 
         return payload
+
+
+class VoiceMessageFile(File):
+    """A file object used for sending voice messages.
+
+    This is a subclass of :class:`File` that is specifically used for sending voice messages.
+
+    .. versionadded:: 2.6
+
+    Attributes
+    -----------
+    duration: :class:`float`
+        The duration of the voice message in seconds. Does not need to be accurate
+
+    """
+
+    def __init__(
+        self,
+        fp: Union[str, bytes, os.PathLike[Any], io.BufferedIOBase],
+        duration: float,
+        waveform: Optional[str] = None,
+    ):
+        super().__init__(fp, filename="voice-message.ogg", spoiler=False)
+        self.duration = duration
+        self._waveform = waveform
+
+    def to_dict(self, index: int) -> Dict[str, Any]:
+        payload = super().to_dict(index)
+        payload['duration_secs'] = self.duration
+        payload['waveform'] = self.waveform
+        return payload
+
+    @property
+    def waveform(self) -> str:
+        """:class:`bytes`: The waveform data for the voice message."""
+        if self._waveform is None:
+            return base64.b64encode(os.urandom(256)).decode('utf-8')
+        return self._waveform

discord/http.py

@@ -617,7 +617,6 @@ async def request(
                 headers['X-Audit-Log-Reason'] = _uriquote(reason, safe='/ ')
 
         kwargs['headers'] = headers
-
         # Proxy support
         if self.proxy is not None:
             kwargs['proxy'] = self.proxy

docs/api.rst

@@ -5632,6 +5632,14 @@ File
 .. autoclass:: File
     :members:
 
+VoiceMessageFile
+~~~~~~~~~~~~~~~~~
+
+.. attributetable:: VoiceMessageFile
+
+.. autoclass:: VoiceMessageFile
+    :members:
+
 Colour
 ~~~~~~