disagreement/docs/voice_client.md

VoiceClient

VoiceClient provides a minimal interface to Discord's voice gateway. It handles the WebSocket handshake and lets you stream audio over UDP.

Basic Usage

import asyncio
import os
import disagreement

vc = disagreement.VoiceClient(
    os.environ["DISCORD_VOICE_ENDPOINT"],
    os.environ["DISCORD_SESSION_ID"],
    os.environ["DISCORD_VOICE_TOKEN"],
    int(os.environ["DISCORD_GUILD_ID"]),
    int(os.environ["DISCORD_USER_ID"]),
)

asyncio.run(vc.connect())

After connecting you can send raw Opus frames:

await vc.send_audio_frame(opus_bytes)

Or stream audio using an :class:AudioSource:

from disagreement import FFmpegAudioSource

source = FFmpegAudioSource("welcome.mp3")
await vc.play(source)

You can switch sources while connected:

await vc.play(FFmpegAudioSource("other.mp3"))

Call await vc.close() when finished.

Fetching Available Voice Regions

Use :meth:Client.fetch_voice_regions to list the voice regions that Discord currently offers. The method returns a list of :class:VoiceRegion values.

regions = await client.fetch_voice_regions()
for region in regions:
    print(region.value)