Add support for leasing and starting remote sessions

This will introduce a slightly new design for an SDK future in that we
only provide 1 method that will automatically handle the complete flow.

Author: Erik Bylund

Runtime/Client/LootLockerEndPoints.cs

@@ -23,6 +23,11 @@ public class LootLockerEndPoints
         public static EndPointClass appleGameCenterSessionRequest = new EndPointClass("session/apple/game-center", LootLockerHTTPMethod.POST);
         public static EndPointClass googleSessionRequest = new EndPointClass("session/google", LootLockerHTTPMethod.POST);
 
+        // Remote Sessions
+        [Header("Remote Sessions")]
+        public static EndPointClass leaseRemoteSession = new EndPointClass("session/remote/lease", LootLockerHTTPMethod.POST);
+        public static EndPointClass startRemoteSession = new EndPointClass("session/remote", LootLockerHTTPMethod.POST);
+
         // White Label Login
         [Header("White Label Login")]
         public static EndPointClass whiteLabelSignUp = new EndPointClass("white-label-login/sign-up", LootLockerHTTPMethod.POST);

Runtime/Game/LootLockerSDKManager.cs

@@ -4,10 +4,8 @@
 using UnityEngine;
 using System.Text;
 using LootLocker.LootLockerEnums;
-using static LootLocker.LootLockerConfig;
 using System.Linq;
 using System.Security.Cryptography;
-using static LootLocker.Requests.CurrentPlatform;
 #if UNITY_EDITOR
 using UnityEditor;
 #endif
@@ -808,6 +806,37 @@ public static void ClearLocalSession()
         }
         #endregion
 
+        #region Remote Sessions
+        /// <summary>
+        /// Start a remote session
+        /// If you want to let your local user sign in using another device then you use this method. First you will get the lease information needed to allow a secondary device to authenticate.
+        /// While the process is ongoing, the remoteSessionLeaseStatusUpdate action (if one is provided) will be invoked intermittently to update you on the status of the process.
+        /// When the process has come to an end (whether successfully or not), the onComplete action will be invoked with the updated information.
+        /// </summary>
+        /// <param name="remoteSessionLeaseInformation">Will be invoked once to provide the lease information that the secondary device can use to authenticate</param>
+        /// <param name="remoteSessionLeaseStatusUpdate">Will be invoked intermittently to update the status lease process</param>
+        /// <param name="onComplete">Invoked when the remote session process has run to completion containing either a valid session or information on why the process failed</param>
+        public static Guid StartRemoteSession(Action<LootLockerLeaseRemoteSessionResponse> remoteSessionLeaseInformation, Action<LootLockerRemoteSessionStatusPollingResponse> remoteSessionLeaseStatusUpdate, Action<LootLockerStartRemoteSessionResponse> onComplete)
+        {
+            if (!CheckInitialized(true))
+            {
+                onComplete?.Invoke(LootLockerResponseFactory.SDKNotInitializedError<LootLockerStartRemoteSessionResponse>());
+                return Guid.Empty;
+            }
+
+            return LootLockerAPIManager.RemoteSessionPoller.GetInstance().StartRemoteSessionWithContinualPolling(remoteSessionLeaseInformation, remoteSessionLeaseStatusUpdate, onComplete);
+        }
+
+        /// <summary>
+        /// Cancel an ongoing remote session process
+        /// </summary>
+        /// <param name="guid">The guid of the remote session process that you want to cancel</param>
+        public static void CancelRemoteSessionProcess(Guid guid)
+        {
+            LootLockerAPIManager.RemoteSessionPoller.GetInstance().CancelRemoteSessionProcess(guid);
+        }
+        #endregion
+
         #region White Label
 
         /// <summary>

Runtime/Game/Platforms/PlatformManager.cs

@@ -22,6 +22,7 @@ public enum Platforms
         ,Google
         ,Epic
         ,Meta
+        ,Remote
     }
 
     public class CurrentPlatform
@@ -55,6 +56,7 @@ static CurrentPlatform()
             ,"google_sign_in" // Google
             ,"epic_games" // Epic Online Services / Epic Games
             ,"meta" // Meta
+            ,"remote" // Remote (leased) session
         };
 
         private static readonly string[] PlatformFriendlyStrings = new[]
@@ -73,6 +75,7 @@ static CurrentPlatform()
             ,"Google" // Google
             ,"Epic Online Services" // Epic Online Services / Epic Games
             ,"Meta" // Meta
+            ,"Remote" // Remote (leased) session
         };
 
         public struct PlatformRepresentation

Runtime/Game/Requests/LootLockerSessionRequest.cs

@@ -46,18 +46,57 @@ public LootLockerWhiteLabelSessionRequest()
     [Serializable]
     public class LootLockerSessionResponse : LootLockerResponse
     {
+        /// <summary>
+        /// The session token that can now be used to use further LootLocker functionality. We store and use this for you.
+        /// </summary>
         public string session_token { get; set; }
+        /// <summary>
+        /// The player id
+        /// </summary>
         public int player_id { get; set; }
+        /// <summary>
+        /// Whether this player has been seen before (true) or is new (false)
+        /// </summary>
         public bool seen_before { get; set; }
+        /// <summary>
+        /// The public UID for this player
+        /// </summary>
         public string public_uid { get; set; }
+        /// <summary>
+        /// The player ULID for this player
+        /// </summary>
         public string player_ulid { get; set; }
+        /// <summary>
+        /// The creation time of this player
+        /// </summary>
         public DateTime player_created_at { get; set; }
+        /// <summary>
+        /// Whether this player has new information to check in grants
+        /// </summary>
         public bool check_grant_notifications { get; set; }
+        /// <summary>
+        /// Whether this player has new information to check in deactivations
+        /// </summary>
         public bool check_deactivation_notifications { get; set; }
+        /// <summary>
+        /// Whether this player has new information to check in dlcs
+        /// </summary>
         public int[] check_dlcs { get; set; }
+        /// <summary>
+        /// The current xp of this player
+        /// </summary>
         public int xp { get; set; }
+        /// <summary>
+        /// The current level of this player
+        /// </summary>
         public int level { get; set; }
+        /// <summary>
+        /// The level_thresholds that the level and xp data relates to
+        /// </summary>
         public LootLockerLevel_Thresholds level_thresholds { get; set; }
+        /// <summary>
+        /// The current balance in this account
+        /// </summary>
         public int account_balance { get; set; }
     }