Table of Contents

DisCatSharp.Voice Overview

DisCatSharp.Voice is the built-in Discord voice client for DisCatSharp. It supports:

  • Voice gateway signaling (join, move, reconnect)
  • RTP audio send and receive
  • Opus encode/decode
  • Discord transport encryption
  • DAVE end-to-end encryption (when the channel enables it)

Install

Install DisCatSharp.Voice from NuGet.

<PackageReference Include="DisCatSharp.Voice" Version="10.7.0" />

DisCatSharp.Voice.Natives is pulled automatically as a dependency for normal NuGet installs.

Quick Start

using DisCatSharp;
using DisCatSharp.Voice;
using DisCatSharp.Voice.Entities;

var client = new DiscordClient(new DiscordConfiguration
{
    Token = "...",
    TokenType = TokenType.Bot,
    Intents = DiscordIntents.AllUnprivileged | DiscordIntents.GuildVoiceStates
});

client.UseVoice(new VoiceConfiguration
{
    EnableIncoming = true,
    EnableDebugLogging = false
});

// Later, once you have a DiscordChannel (voice/stage):
VoiceConnection connection = await channel.ConnectAsync();
VoiceTransmitSink sink = connection.GetTransmitSink();

// Optional: enable extra diagnostics only for this specific connection.
connection.EnableDebugLogging = true;

DAVE and Runtime Behavior

When Discord enables DAVE for a channel, DisCatSharp negotiates it automatically.

Important runtime flags on VoiceConnection:

  • IsDaveNegotiated
  • IsDaveActive
  • IsE2eeUsableForSend
  • IsE2eeUsableForReceive
  • DaveState

You can also wait for DAVE activation explicitly:

bool active = await connection.WaitForDaveActiveAsync(TimeSpan.FromSeconds(5));

Debug Logging Scope

VoiceConfiguration.EnableDebugLogging sets the default debug/trace behavior for voice connections.

You can override this at runtime per connection using VoiceConnection.EnableDebugLogging.

connection.EnableDebugLogging = true;  // enable only this connection
connection.EnableDebugLogging = false; // disable again

Next Steps

Edit this page