Social SDK 1.6 changelog (#7861)

* added Social SDK 1.6 changelog

* Update release notes

* Fix title

* Add autogenerated reference

* Fix links

Author: anthonydiscord

docs/change-log/2025-09-26-discord-social-sdk-1.6.md

@@ -0,0 +1,55 @@
+---
+title: "Discord Social SDK Release 1.6"
+date: "2025-09-26"
+topics:
+  - "Discord Social SDK"
+---
+
+A new release of the Discord Social SDK is now available, with the following updates:
+
+### ✨ New Features
+
+- When calling [`Client::GetGuildChannels`], channels are now sorted by their `position` field, which matches how they are sorted in the Discord client.
+- Messages received via the Social SDK, no longer create notifications in a Discord client for the same user, to avoid double notification on the same machine.
+
+**This release adds features to support upcoming Discord experiments that will enhance how games integrate with user profiles and authentication:**
+
+- **Game Profile Integration**: New functionality to display game data on Discord user profiles. This includes `UserApplicationProfile` support with two new methods: `Client::GetUserApplicationProfiles` and `Client::GetUserApplicationProfilesNoLock` on the Users class, which retrieve game identity data from external authentication providers.
+- **In-Discord Authentication Flow**: Support for users to start account linking directly from Discord (rather than having to initiate it from within your game). Added [`Client::RegisterAuthorizeRequestCallback`] and [`Client::RemoveAuthorizeRequestCallback`] methods to handle authentication requests that originate from various Discord entry points. These functions support upcoming Discord client experiments that will be gradually rolled out to users over time.
+
+### ⚠️ Deprecations
+
+This deprecation aims to improve consistence across the SDK’s API surface as well as provide a safer implementation that has fewer edge cases and less potential for accidental misuse.
+
+- Deprecated [`Client::GetCurrentUser`] API in favor of [`Client::GetCurrentUserV2`] which returns optional values instead of potentially invalid handles.
+
+### 🚀 Performance Improvements
+
+- This update implements caching capabilities for the [`Client::GetUserMessagesWithLimit`] function to avoid unnecessary remote API calls when sufficient messages are already cached locally.
+
+### 🎤 Voice Communications Fixes and Improvements
+
+Fixes several critical bugs with the voice communications system, as well as improved overall reliability, and noise and echo suppression and cancellation.
+
+- Fixed an issue where voice calls would sometimes transition to `Disconnected` state instead of reconnecting properly after a network interruption.
+- Extended AGC2 (Automatic Gain Control 2) support to mobile platforms
+
+### 🐛 General Stability and Bug Fixes
+
+Multiple general critical bugs that can cause crashes and panics. We highly recommend upgrading to 1.6 to avoid them in your game.
+
+- Fixed critical bug where activity party privacy wasn't properly set, causing "ask to join" to appear instead of "join" for public parties.
+- Fixed critical memory safety issue preventing connection objects from being deallocated during timer callbacks.
+- Fixed C# marshaling alignment bugs and double-free crashes.
+- Improved gateway resilience with fallback to generic URLs on zonal gateway failures.
+- Fixed WebSocket write-after-close errors preventing connection issues.
+
+To learn more about building with the Discord Social SDK, check out the [Discord Social SDK Overview](https://discord.com/developers/docs/discord-social-sdk/overview), and if you have questions, feel free to drop them in [#social-sdk-dev-help](https://discord.com/channels/613425648685547541/1350223314307776592)!
+
+<!-- Autogenerated Reference Links -->
+[`Client::GetCurrentUser`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a7edea2a3dfe9ae560d5fa5ba8663b5cc
+[`Client::GetCurrentUserV2`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#ae52259570ba657252d91f5580636fe5d
+[`Client::GetGuildChannels`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#adba1e5a83c219a9c4f6dab1657778017
+[`Client::GetUserMessagesWithLimit`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a054a758a76c5873b38a4d79651a5f26c
+[`Client::RegisterAuthorizeRequestCallback`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a5f34b873e127a446c9ab549e4588ccd7
+[`Client::RemoveAuthorizeRequestCallback`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#ab7e48864b0cedf3e8572a228ca401f2a

docs/discord-social-sdk/development-guides/account-linking-with-discord.mdx

@@ -322,4 +322,4 @@ Now that you've successfully implemented account linking with Discord, you can i
 [`Client::GetDefaultPresenceScopes`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a7648bd1d2f7d9a86ebd0edb8bef12b5c
 [`Client::GetToken`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#aaee636f91fb1ea3465157c20313b702c
 [`Client::RefreshToken`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a187af0f99f94b3b9a4ad4302f6a443e7
-[`Client::UpdateToken`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a606b32cef7796f7fb91c2497bc31afc4
+[`Client::UpdateToken`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a606b32cef7796f7fb91c2497bc31afc4

docs/discord-social-sdk/development-guides/using-provisional-accounts.mdx

@@ -619,4 +619,4 @@ Now that you've set up provisional accounts for your game, you can explore more
 [`Client::GetTokenFromProvisionalMerge`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a41062b7dafa331ddd2320daf1b4b273b
 [`Client::SetTokenExpirationCallback`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#aab5bfc76809ea22e79f2f7a067ac4519
 [`Client::UnmergeIntoProvisionalAccount`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a2da21ae8a3015e0e5e42c1a7226b256f
-[`Client::UpdateProvisionalAccountDisplayName`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a7485979ab2d4c533b75f8efd5e50bc60
+[`Client::UpdateProvisionalAccountDisplayName`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a7485979ab2d4c533b75f8efd5e50bc60

tools/doxygen/social-sdk-mappings.json

@@ -48,6 +48,8 @@
   "discordpp::ActivityAssets::SetSmallText": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1ActivityAssets.html#aae2b92760fb365439e8ad38444acdebb",
   "discordpp::ActivityAssets::SmallUrl": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1ActivityAssets.html#a862e2fe4b209d18f7633c3436af2860c",
   "discordpp::ActivityAssets::SetSmallUrl": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1ActivityAssets.html#afd3ed179bf1924a49631eebeaa1f6493",
+  "discordpp::ActivityAssets::InviteCoverImage": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1ActivityAssets.html#a0910e12ce7708db7aee9296cc56d947c",
+  "discordpp::ActivityAssets::SetInviteCoverImage": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1ActivityAssets.html#ad0106c55fa323b8520efd77cbd0b0d4f",
   "discordpp::ActivityButton::ActivityButton": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1ActivityButton.html#a04bc93c6984c61a23dbbcf27ad4819d4",
   "discordpp::ActivityButton::operator=": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1ActivityButton.html#a523e2457c808c8f5b2e89d5b8efaed50",
   "discordpp::ActivityButton::operator bool": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1ActivityButton.html#aae08573498def90bc33dca67fda690bb",
@@ -246,6 +248,8 @@
   "discordpp::Client::OpenAuthorizeDeviceScreen": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#af29a13acc992a75fc0870051ff68575b",
   "discordpp::Client::ProvisionalUserMergeCompleted": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#af836d40617bb6d74648309c768234184",
   "discordpp::Client::RefreshToken": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a187af0f99f94b3b9a4ad4302f6a443e7",
+  "discordpp::Client::RegisterAuthorizeRequestCallback": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a5f34b873e127a446c9ab549e4588ccd7",
+  "discordpp::Client::RemoveAuthorizeRequestCallback": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#ab7e48864b0cedf3e8572a228ca401f2a",
   "discordpp::Client::RevokeToken": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a30ccea6366efaf0b884efcdcc28a6f2d",
   "discordpp::Client::SetAuthorizeDeviceScreenClosedCallback": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a27d1ac5d868a93a141254c59023a13bb",
   "discordpp::Client::SetGameWindowPid": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#aae200241796a779e4b9e8cb2d22138c2",
@@ -398,6 +402,12 @@
   "discordpp::GuildChannel::SetId": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#a54d49b0f134e4b88bf30f2ad4bc5af53",
   "discordpp::GuildChannel::Name": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#a60ea639d62e0a24b2a59ff7afce35a97",
   "discordpp::GuildChannel::SetName": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#a32e619dcb109fe8af27de24c0196a0f5",
+  "discordpp::GuildChannel::Type": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#a9cf329c0ae46c5509666543839cbfa33",
+  "discordpp::GuildChannel::SetType": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#a6fbbd299823f1e1342f424daf0d27c1b",
+  "discordpp::GuildChannel::Position": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#ae0749779d6a9b708af2bfa1c06bc40ba",
+  "discordpp::GuildChannel::SetPosition": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#a81853ebe5e40edb347ce10e289f8e781",
+  "discordpp::GuildChannel::ParentId": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#a56a251fe1df193a95de654df96e0b8bf",
+  "discordpp::GuildChannel::SetParentId": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#af789881615443c828d3c4b73ee34ba48",
   "discordpp::GuildChannel::IsLinkable": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#ad69573b499384939e41cc45e6cbc151c",
   "discordpp::GuildChannel::SetIsLinkable": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#a07c70db9e7d0093cc2e68aa8c9cf2d4f",
   "discordpp::GuildChannel::IsViewableAndWriteableByAllMembers": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1GuildChannel.html#a0a5655eda07dea3fc4b8643334fdee28",
@@ -473,6 +483,15 @@
   "discordpp::RelationshipHandle::Id": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1RelationshipHandle.html#a3a14b6cfa9a9fffc61e500d8329be587",
   "discordpp::RelationshipHandle::IsSpamRequest": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1RelationshipHandle.html#acf4d21fb62cf80ac10afa9d10308777a",
   "discordpp::RelationshipHandle::User": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1RelationshipHandle.html#ad87172b7df999ab56991c1be598e995e",
+  "discordpp::UserApplicationProfileHandle::UserApplicationProfileHandle": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserApplicationProfileHandle.html#a479b07c5bae65ca04771ca0f05c6ebdd",
+  "discordpp::UserApplicationProfileHandle::operator=": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserApplicationProfileHandle.html#a93ab72bd482c41ae7c931776da25dfa7",
+  "discordpp::UserApplicationProfileHandle::operator bool": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserApplicationProfileHandle.html#a3557027837de41303aa5a43dff06e84d",
+  "discordpp::UserApplicationProfileHandle::AvatarHash": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserApplicationProfileHandle.html#aa71e13c943d4b296aa22891a88a87a82",
+  "discordpp::UserApplicationProfileHandle::Metadata": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserApplicationProfileHandle.html#a3a2482dcae30353630ceab2e2508673e",
+  "discordpp::UserApplicationProfileHandle::ProviderId": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserApplicationProfileHandle.html#acc5774b55ad2a83a7cd985bdc4a0cd07",
+  "discordpp::UserApplicationProfileHandle::ProviderIssuedUserId": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserApplicationProfileHandle.html#a90a1a48c9f290f9d89c7da626623dcbb",
+  "discordpp::UserApplicationProfileHandle::ProviderType": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserApplicationProfileHandle.html#af42fdb09666b62865c9ff2ed58df78be",
+  "discordpp::UserApplicationProfileHandle::Username": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserApplicationProfileHandle.html#a2d7c710f95968dc9c5391bb2207bed3b",
   "discordpp::UserHandle::AvatarType": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserHandle.html#a9cbf5933bc6181eb1900574f6eda9b18",
   "discordpp::UserHandle::UserHandle": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserHandle.html#a587bcc838e42dc5c56f840a350070707",
   "discordpp::UserHandle::operator=": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserHandle.html#a08cacd9bb2ced65159c10e144e115e07",
@@ -486,6 +505,7 @@
   "discordpp::UserHandle::IsProvisional": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserHandle.html#aa2999e91f84540d9bd957d9d0d294c95",
   "discordpp::UserHandle::Relationship": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserHandle.html#affa211bcf6a19a17f188f142168c2288",
   "discordpp::UserHandle::Status": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserHandle.html#a3ec233e43f67892c3ff22eb4199e6590",
+  "discordpp::UserHandle::UserApplicationProfiles": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserHandle.html#a64b7fee0afff58b87b63ac385ef13866",
   "discordpp::UserHandle::Username": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserHandle.html#a0eda41fe18b50bce373fb5a1b88cb411",
   "discordpp::UserHandle::AvatarTypeToString": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserHandle.html#ae8c9b5d2edc5fc9a53baf74060ba7185",
   "discordpp::UserMessageSummary::UserMessageSummary": "https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1UserMessageSummary.html#a7284a4debea92bfffc4db7781874449a",
@@ -515,11 +535,12 @@
   "discordpp::HttpStatusCode": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#a12b04d48d8ea98ec007270a10e0c88ba",
   "discordpp::AuthenticationCodeChallengeMethod": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#a1c123930bb42c6f9f77f18b5593ad876",
   "discordpp::IntegrationType": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#a5307c5c42ea96ec19f79e679a47c84be",
+  "discordpp::ChannelType": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#a1b68b260e8659da9a7792b2b2046fe58",
   "discordpp::AdditionalContentType": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#aee4b786af6ac9cd4ade73eb2f873177b",
   "discordpp::AudioSystem": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#a566c99cfc3b8ee94ca322d35bc008633",
   "discordpp::AudioModeType": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#ad12f4e0df799c97f417320ef861fcffb",
-  "discordpp::ChannelType": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#a1b68b260e8659da9a7792b2b2046fe58",
   "discordpp::RelationshipType": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#a28fc5199b9211c24124c06f30c1d0cbb",
+  "discordpp::ExternalIdentityProviderType": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#aa206a1e72b76e940f53bb3ff0dbca6ca",
   "discordpp::StatusType": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#a7e874dde2b41420ed5d26d4bc3ea5b43",
   "discordpp::DisclosureTypes": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#a0d3a4099faa1d5870eb8a49828e05d34",
   "discordpp::AuthorizationTokenType": "https://discord.com/developers/docs/social-sdk/namespacediscordpp.html#a1968a8b2eabcbe41a254cc88ab330a89",