[BCLOUD-14918] Added EOS Auth Support + Updating AppStore Comments for epicGames and xsolla + General Clean-Up

include/braincloud/AuthenticationType.h

@@ -26,6 +26,7 @@ namespace BrainCloud
         static const AuthenticationType & GameCenter;
         static const AuthenticationType & Steam;
         static const AuthenticationType & Apple;
+        static const AuthenticationType & EpicGames;
         static const AuthenticationType & Google;
         static const AuthenticationType & GoogleOpenId;
         static const AuthenticationType & Twitter;

include/braincloud/BrainCloudAppStore.h

@@ -34,6 +34,8 @@ namespace BrainCloud
         * - windows
         * - windowsPhone
         * - googlePlay
+        * - epicGames
+        * - xsolla
         * @param receiptData the specific store data required
         * @param callback The method to be invoked when the server response is received
         */
@@ -64,6 +66,8 @@ namespace BrainCloud
         * - windows
         * - windowsPhone
         * - googlePlay
+        * - epicGames
+        * - xsolla
         * @param userCurrency The currency type to retrieve the sales inventory for.
         * @param callback The method to be invoked when the server response is received
         */
@@ -84,6 +88,8 @@ namespace BrainCloud
         * - windows
         * - windowsPhone
         * - googlePlay
+        * - epicGames
+        * - xsolla
         * @param userCurrency The currency type to retrieve the sales inventory for.
         * @param category The product category
         * @param callback The method to be invoked when the server response is received
@@ -96,14 +102,7 @@ namespace BrainCloud
         * Service Name - appStore
         * Service Operation - START_PURCHASE
         *
-        * @param storeId The store platform. Valid stores are:
-        * - itunes
-        * - facebook
-        * - appworld
-        * - steam
-        * - windows
-        * - windowsPhone
-        * - googlePlay
+        * @param storeId The store id. Currently only accepts "steam".
         * @param purchaseData specific data for purchasing 2 staged purchases
         * @param callback The method to be invoked when the server response is received
         */
@@ -115,14 +114,7 @@ namespace BrainCloud
         * Service Name - appStore
         * Service Operation - FINALIZE_PURCHASE
         *
-        * @param storeId The store platform. Valid stores are:
-        * - itunes
-        * - facebook
-        * - appworld
-        * - steam
-        * - windows
-        * - windowsPhone
-        * - googlePlay
+        * @param storeId The store id. Currently only accepts "steam".
         * @param transactionId the transactionId returned from start Purchase
         * @param transactionData specific data for purchasing 2 staged purchases
         * @param callback The method to be invoked when the server response is received
@@ -154,6 +146,8 @@ namespace BrainCloud
         * - windows
         * - windowsPhone
         * - googlePlay
+        * - epicGames
+        * - xsolla
         * @param transactionId the transactionId returned from start Purchase
         * @param transactionData specific data for purchasing 2 staged purchases
         * @param callback The method to be invoked when the server response is received

include/braincloud/BrainCloudAuthentication.h

@@ -195,18 +195,31 @@ namespace BrainCloud
 		void authenticateSteam(const char * userId, const char * sessionticket, bool forceCreate, IServerCallback * callback = NULL);
 
 		/**
-		* Authenticate the user using a google userid(email address) and google authentication token.
+		* Authenticate the user using their Apple account and identityToken.
 		*
 		* Service Name - authenticationV2
 		* Service Operation - AUTHENTICATE
 		*
 		* @param appleUserId String of the apple accounts user Id OR email
-		* @param identityToken The authentication token confirming users identity
+		* @param identityToken The identityToken confirming users identity
 		* @param forceCreate Should a new profile be created for this user if the account does not exist?
 		* @param callback The method to be invoked when the server response is received
 		*/
 		void authenticateApple(const char * appleUserId, const char * identityToken, bool forceCreate, IServerCallback * callback = NULL);
 
+		/**
+		* Authenticate the user using an epicAccountId and their authIdToken.
+		*
+		* Service Name - authenticationV2
+		* Service Operation - AUTHENTICATE
+		*
+		* @param epicAccountId LocalUserId retrieved from the EOS AuthInterface's Login method.
+		* @param authIdToken IdToken string from the EOS AuthInterface's CopyIdToken method.
+		* @param forceCreate Should a new profile be created for this user if the account does not exist?
+		* @param callback The method to be invoked when the server response is received
+		*/
+		void authenticateEpicGames(const char * epicAccountId, const char * authIdToken, bool forceCreate, IServerCallback * callback = NULL);
+
 		/**
 		* Authenticate the user using a google userid(email address) and google authentication token.
 		*

include/braincloud/BrainCloudIdentity.h

@@ -294,6 +294,54 @@ namespace BrainCloud
 		 */
 		void detachAppleIdentity(const char * appleId, bool continueAnon, IServerCallback * callback = NULL);
 
+		/**
+		 * Attach the user's EpicGames credentials to the current profile.
+		 *
+		 * Service Name - identity
+		 * Service Operation - ATTACH
+		 *
+		 * @param epicAccountId LocalUserId retrieved from the EOS AuthInterface's Login method.
+		 * @param authIdToken IdToken string from the EOS AuthInterface's CopyIdToken method.
+		 * @param callback The method to be invoked when the server response is received
+		 *
+		 * Errors to watch for:  SWITCHING_PROFILES - this means that the EpicGames identity you provided
+		 * already points to a different profile.  You will likely want to offer the user the
+		 * choice to *SWITCH* to that profile, or *MERGE* the profiles.
+		 *
+		 * To switch profiles, call ClearSavedProfileID() and call AuthenticateEpicGames().
+		 */
+		void attachEpicGamesIdentity(const char * epicAccountId, const char * authIdToken, IServerCallback * callback = NULL);
+
+		/**
+		 * Merge the profile associated with the provided EpicGames credentials with the
+		 * current profile.
+		 *
+		 * Service Name - identity
+		 * Service Operation - MERGE
+		 *
+		 * @param epicAccountId LocalUserId retrieved from the EOS AuthInterface's Login method.
+		 * @param authIdToken IdToken string from the EOS AuthInterface's CopyIdToken method.
+		 * @param callback The method to be invoked when the server response is received
+		 *
+		 */
+		void mergeEpicGamesIdentity(const char * epicAccountId, const char * authIdToken, IServerCallback * callback = NULL);
+
+		/**
+		 * Detach the EpicGames identity from this profile.
+		 *
+		 * Service Name - identity
+		 * Service Operation - DETACH
+		 *
+		 * @param epicAccountId LocalUserId retrieved from the EOS AuthInterface's Login method.
+		 * @param continueAnon Proceed even if the profile will revert to anonymous?
+		 * @param callback The method to be invoked when the server response is received
+		 *
+		 * Watch for DOWNGRADING_TO_ANONYMOUS_ERROR - occurs if you set continueAnon to false, and
+		 * disconnecting this identity would result in the profile being anonymous (which means that
+		 * the profile wouldn't be retrievable if the user loses their device)
+		 */
+		void detachEpicGamesIdentity(const char * epicAccountId, bool continueAnon, IServerCallback * callback = NULL);
+
         /**
          * Attach the user's Ultra credentials to the current profile.
          *