diff --git a/discord/__init__.py b/discord/__init__.py index 476f24194..b987a0544 100644 --- a/discord/__init__.py +++ b/discord/__init__.py @@ -32,6 +32,7 @@ from .invite import Invite from .object import Object from . import utils from . import opus +from .voice_client import VoiceClient import logging diff --git a/discord/voice_client.py b/discord/voice_client.py index a5da879fe..6e631ea98 100644 --- a/discord/voice_client.py +++ b/discord/voice_client.py @@ -99,6 +99,14 @@ class VoiceClient: This client is created solely through :meth:`Client.join_voice_channel` and its only purpose is to transmit voice. + Warning + -------- + In order to play audio, you must have loaded the opus library + through :func:`opus.load_opus`. + + If you don't do this then the library will not be able to + transmit audio. + Attributes ----------- session_id : str @@ -392,6 +400,11 @@ class VoiceClient: | player.is_done() | Returns a bool indicating if the stream is done. | +------------------+--------------------------------------------------+ + The stream must have the same sampling rate as the encoder and the same + number of channels. The defaults are 48000 Mhz and 2 channels. You + could change the encoder options by using :meth:`encoder_options` + but this must be called **before** this function. + Parameters ----------- stream diff --git a/docs/api.rst b/docs/api.rst index 04d006130..42277cca3 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -20,6 +20,19 @@ Client .. autoclass:: Client :members: + +Voice +----- + +.. autoclass:: VoiceClient + :members: + + +Opus Library +~~~~~~~~~~~~~ + +.. autofunction:: opus.load_opus + .. _discord-api-events: Event Reference