Skip to main content

Overview

This guide will help you understand how to install debugging symbols and handle logging to assist in building your Discord Social SDK integration.

Debugging

Debugging symbols are hosted at https://storage.googleapis.com/discord-public-symbols. If using Visual Studio, you can add this link to the pdb locations under Tools > Options > Debugging > Symbols.
Note: You won’t be able to browse files using that link, but that’s ok. Individual files are accessible under the domain, and the URL functions properly as a symbol server, so it works in Visual Studio.

Logging

You can access Discord’s logs with Client::AddLogCallback. We recommend writing logs to a file and, during testing, including verbose logs. The Client::SetLogDir function will write the SDK’s logs to that directory if set.
client->AddLogCallback([](auto message, auto severity) {
  std::cout << "[" << EnumToString(severity) << "] " << message << std::endl;
}, discordpp::LoggingSeverity::Info);

Audio Logging

For diagnosing issues with acoustic echo cancellation (AEC), you can use the Client::SetAecDump function. This enables diagnostic recording of audio input and output waveform data, which can be invaluable when troubleshooting echo, feedback, or other audio processing problems. Client::SetAecDump Enables or disables AEC diagnostic recording. When enabled, the input and output waveform data will be written to the log directory (the same directory specified by Client::SetLogDir).
// Enable AEC diagnostic recording
client->SetAecDump(true);

// ... perform voice chat operations to reproduce the issue ...

// Disable AEC diagnostic recording when done
client->SetAecDump(false);
When to use:
  • Users report echo or feedback during voice chat
  • Audio quality issues that may be related to echo cancellation
  • Testing AEC performance in different environments
  • Debugging audio processing pipeline issues
AEC dump files can become large quickly as they contain raw waveform data. Remember to disable the diagnostic recording once you’ve captured the necessary data for analysis.

Next Steps

Need help? Join the Discord Developers Server and share questions in the #social-sdk-dev-help channel for support from the community. If you encounter a bug while working with the Social SDK, please report it here: https://dis.gd/social-sdk-bug-report

Change Log

DateChanges
March 17, 2025initial release