Skip to content

GetSocial Unity SDK Changelog

v7.6.8 - 10 Feb, 2022

  • Fixed: Push Notifications listeners not working correctly on Android 12.
  • Fixed: Overall improvements and bugs related to Android 12.

v7.6.7 - 28 Dec, 2021

  • Fixed: invalid result when calling Notifications.RegisterDevice() method on iOS.

v7.6.6 - 27 Dec, 2021

  • Fixed: added missing PendingIntent.FLAG_IMMUTABLE flag to which caused crash on Android 11.

v7.6.5 - 5 Nov, 2021

  • New: find topics and groups by labels and properties.

v7.6.4 - 3 Nov, 2021

  • Added missing export properties to AndroidManifest.xml on Android.

v7.6.3 - 1 Nov, 2021

  • Fix occassional crash on iOS when sending an invite.
  • Overall improvements.

v7.6.2 - 29 Oct, 2021

  • Fix issue when trying to get a single user by identity.

v7.6.1 - 14 Oct, 2021

  • Fix issue when error callback is invoked incorrectly after canceling option in native share on iOS.

v7.6.0 - 22 Sep, 2021

  • New: added possibility to filter for trending activities, topics and groups.
  • New: added support for trusted identities. read more.

v7.5.2 - 8 Sep, 2021

  • Fixed issue with Communities.areGroupMembers method on Android.
  • Fixed issue with ActivityDetailsView builder, which caused empty feed view on Android.
  • Fixed issue with native share, when Save to option is selected on iOS.
  • Fixed rare crash when switching to remote user identity on iOS.

v7.5.1 - 17 Aug, 2021


  • Issue with incorrect order of invite channels.
  • NPE in Unity Editor when loading activities.

v7.5.0 - 21 Jul, 2021

v7.4.9 - 15 Jul, 2021

  • New: Configurable Push Notification’s priority on Android: read more

v7.4.8 - 6 Jul, 2021


  • Fixed issue with Gradle plugin on Android.

v7.4.7 - 22 Jun, 2021


  • Overall improvements.

v7.4.6 - 4 Jun, 2021


  • Issue when setting status in MembersQuery on iOS.

v7.4.5 - 3 Jun, 2021


  • Fix Gradle conflict issues with other plugins.
  • Fix rare crash on iOS.

v7.4.4 - 18 May, 2021


  • Missing link parameters when creating invite link on iOS.

v7.4.3 - 29 Apr, 2021


  • Background thread issue on Android, when sending an invite fails.

v7.4.2 - 22 Apr, 2021


  • Issue with overwriting LSApplicationQueriesSchemes on iOS.

v7.4.1 - 1 Apr, 2021


  • Added possibility to test referral data listener in Unity Editor: read more.

v7.4.0 - 18 Mar, 2021


v7.3.4 - 3 Mar, 2021


  • Issue with Promo Code creation on iOS.

v7.3.3 - 24 Feb, 2021


  • New method to refresh current user properties.

v7.3.2 - 10 Feb, 2021


  • New methods to increment/decrement public and private user properties.

v7.3.1 - 2 Dec, 2020


  • Issue with topics permissions.

v7.3.0 - 2 Dec, 2020


v7.2.9 - 19 Nov, 2020


  • Issue with Link Parameters when creating invite content.

v7.2.8 - Nov 4, 2020


  • Issue when invite callback.

v7.2.7 - Oct 28, 2020


  • Issue when fetching activities.

v7.2.6 - Sep 15, 2020


  • Issue when sending custom invite content.

v7.2.5 - Sep 14, 2020


  • Issue when adding custom identity on iOS.
  • NPE in Unity Editor when getting announcements.

v7.2.4 - Sep 3, 2020


  • Issue when deleting a comment on Comments view when moderation is turned on, on iOS.
  • Issue on iOS with incorrect Swift runtime versions.

v7.2.3 - 27 Aug, 2020


  • UI issue in landscape mode on iOS 13.


  • Added Copy option to when sending invite using Native Share.


  • Issue when onInitializeListener not invoked if SDK is already initialized.

v7.2.1 - 17 Aug, 2020


  • Minor issue with UserId object.

v7.2.1 - 17 Aug, 2020


  • Minor issue with UserId object.

v7.2.0 - 11 Aug, 2020


  • Added new method to initialize the SDK with an existing identity.

v7.1.2 - 27 Jul, 2020


  • Manual init issue on iOS.

v7.1.1 - 24 Jul, 2020


  • Handling optional values in getsocial.json configuration file.
  • Crash when sending invite without GetSocial UI.

v7.1.0 - 13 Jul, 2020

GetSocial SDK version 7 is a major update that brings a lot of improvements, new features and breaking changes. Follow the guide below to learn about what changed and how to upgrade to SDK v7.


  1. Download and unzip the latest GetSocial Unity SDK archive.
  2. Open your project in the Unity Editor.
  3. In the Project window open GetSocial folder and remove Editor, Plugins and Scripts subfolders (keep Resources subfolder).
  4. In the menu go to AssetsImport PackageCustom Package, open .unitypackage located in the bin folder of downloaded archive.
  5. Import all assets.


All* values should not contain @drawable/, @color/, @string/ or any other prefix, it should be just a name of file without extension. For example, if you had im.getsocial.sdk.LargeNotificationIcon in AndroidManifest.xml with value @drawable/large_notification_icon, it should become with value large_notification_icon.

AndroidManifest.xml Key getsocial.json key


All methods that supported operations by GetSocial User ID now support both GetSocial ID and Identity ID. This is encapsulated in UserId and UserIdList classes for a single and multiple users respectively. Read more about this.

All methods that support pagination are now unified and use the same approach with classes PagingQuery and PagingResult. Read more about this.


WhenInitialized is changed to AddOnInitializedListener. You can add multiple listeners.

SDK v6 Method SDK v7 Method
GetSocial.WhenInitialized GetSocial.AddOnInitializedListener

User Management

Current User

All methods related to the current user were in GetSocial.User class. Now you can get an object of CurrentUser using GetSocial.GetCurrentUser(). This method returns null if SDK is not initialized. When you update user properties like avatar or display name, the object is not automatically updated after operation succeeded. If you switch or reset user, this object is changed to a new one. You will receive the new object in OnCurrentUserChangedListener or you can call GetSocial.GetCurrentUser() again and get the new instance.

All getters should be called on GetSocial.getCurrentUser() instance.
All setters are removed and you should use a single method GetSocial.getCurrentUser().updateDetails(...) instead.

GetSocial.addOnCurrentUserChangedListener can be called multiple times with different listeners. It returns a String - listener ID - which can be used in GetSocial.removeOnCurrentUserChangedListener if you want to remove a certain listener.

SDK v6 Method SDK v7 Method
GetSocial.User.Get* GetSocial.GetCurrentUser().*
GetSocial.User.Set* GetSocial.GetCurrentUser().UpdateDetails
GetSocial.User.AddAuthIdentity GetSocial.GetCurrentUser().AddIdentity
GetSocial.User.RemoveAuthIdentity GetSocial.GetCurrentUser().RemoveIdentity
GetSocial.User.SwitchUser GetSocial.SwitchUser
GetSocial.User.Reset GetSocial.ResetUser
GetSocial.User.SetOnUserChangedListener GetSocial.AddOnCurrentUserChangedListener
GetSocial.User.RemoveOnUserChangedListener GetSocial.RemoveOnCurrentUserChangedListener

Search Users

findUsers returned only the first page of matching users. New Communities.users method supports pagination.
You can also get a number of users that match a certain query using Communities.usersCount.

SDK v6 Method SDK v7 Method
GetSocial.GetUserByID(id), GetSocial.UserWithId(id, providerId) Communities.GetUser(UserId, Action, Action)
GetSocial.GetUsersByIdentities(ids, providerId) Communities.GetUsers(UserIdList, Action>, Action)
GetSocial.FindUsers Communities.GetUsers(PagingQuery, ResultCallback>, Action)


All activities related methods are moved to Communities class.
Like concept is now extended to Reaction and supports multiple reactions, like is one of them.

All GetSocial.Post* methods are replaced with a single Communities.PostActivity method with PostActivityTarget parameter. Read more about new features in Feeds 2.0.

SDK v6 Method SDK v7 Method
GetSocial.PostActivityToFeed, GetSocial.postActivityToGlobalFeed, GetSocial.PostCommentToActivity Communities.PostActivity
GetSocial.LikeActivity(…, true, …) Communities.AddReaction
GetSocial.LikeActivity(…, false, …) Communities.RemoveReaction
GetSocial.GetActivityLikers Communities.GetReactions
GetSocial.FindTags Communities.GetTags


All notifications related methods are moved to Notifications class.

NotificationListener is now split into two: OnNotificationClickedListener and OnNoticationReceivedListener.

OnNotificationReceivedListener is called when application is in foreground and GetSocial Push Notification is received. Note that now it is called even if notifications in foreground are enabled.

Enable Click Listener

In order to make OnNotificationClickedListener being invoked, you have to set Has Custom Notification On Click Listener checked in GetSocial settings in Unity Editor.

OnNotificationClickedListener does not need to return a boolean anymore. If you have a custom listener and want to invoke a default behaviour, you should call GetSocial.Handle(action) in places where you would return false in SDK 6.

SDK v6 Method SDK v7 Method
GetSocial.RegisterForPushNotifications Notifications.RegisterDevice
GetSocial.SetNotificationListener Notifications.SetOnNotificationClickedListener, Notifications.SetOnNotificationReceivedListener
GetSocial.SetPushNotificationTokenListener Notifications.SetOnTokenReceivedListener
GetSocial.User.GetNotifications Notifications.Get
GetSocial.User.GetNotificationsCount Notifications.GetCount
GetSocial.User.SendNotification Notifications.Send
GetSocial.User.SetNotificationsStatus Notifications.SetStatus
GetSocial.User.SetPushNotificationsEnabled Notifications.SetPushNotificationsEnabled
GetSocial.User.IsPushNotificationsEnabled Notifications.ArePushNotificationsEnabled


All invites related methods are moved to Invites class.

Getting list of available invite channels is now asynchronous operation.

To get referral data, you now have a ReferralDataListener, which will be called every time when the new referral data appears after clicking on the link, whether on application launch or if application was running before.

SDK v6 Method SDK v7 Method
GetSocial.IsInviteChannelAvailable Removed. You can get the list of available invite channels and check if invite channel is there.
GetSocial.GetInviteChannels Invites.GetAvailableChannels
GetSocial.SendInvite Invites.Send
GetSocial.RegisterInviteChannelPlugin Currently not supported in Unity.
GetSocial.GetReferralData Invites.SetReferralDataListener
GetSocial.ClearReferralData Removed. You don’t need to clear referral data anymore, as you will receive only the new referral data in the listener.


All analytics methods are moved to Analytics class.

SDK v6 Method SDK v7 Method
GetSocial.TrackCustomEvent Analytics.TrackCustomEvent
GetSocial.TrackPurchaseEvent Analytics.TrackPurchase

Promo Codes

All promo codes methods are moved to PromoCodes class.

SDK v6 Method SDK v7 Method
GetSocial.CreatePromoCode PromoCodes.Create
GetSocial.GetPromoCode PromoCodes.Get
GetSocial.ClaimPromoCode PromoCodes.Claim

Give us your feedback! Was this article helpful?

😀 🙁