Remote Lease Implementation

Remote Sessions

Start Remote Session

Unity

As this function requires three separate callbacks, it is easier to manage them as following:

public void RemoteLease()
{
    LootLockerSDKManager.StartRemoteSession(leaseAction, pollingAction, onComplete);
}

Action<LootLockerLeaseRemoteSessionResponse> leaseAction = (info) => 
{
    if (!info.success)
    {
        Debug.Log("Couldnt start Remote leasing");
        return;
    }
};
Action<LootLockerRemoteSessionStatusPollingResponse> pollingAction = (polling) => 
{
    if(!polling.success)
    {
        Debug.Log("Couldnt poll Remote leasing");
        return;
    }
};
Action<LootLockerStartRemoteSessionResponse> onComplete = (onComplete) =>
{
    if (!onComplete.success)
    {
        Debug.Log("Couldnt start Remote leasing");
        return;
    }
};

Unreal

Blueprint for Starting a Remote Session

REST

curl --location --request POST 'https://api.lootlocker.io/game/session/remote'
--header 'x-session-token: {{session_token}}'
--header 'Content-Type: application/json'

Example response:

{
  "lease_status": "AUTHORIZED",
  "refresh_token": "v4.public.eyJhdWQiOiJodHRwczovL2FwaS5sb290bG9ja2VyLmNvbS9hdXRoL3JlbW90ZSIsImV4cCI6IjIwMjMtMTAtMDZUMDk6Mjg6NTBaIiwiaWF0IjoiMjAyMy0xMC0wNVQwOToyODo1MFoiLCJpc3MiOiJodHRwczovL2FwaS5sb290bG9ja2VyLmNvbSIsInN1YiI6IjAxSDROS0VSRVcySzNRNFc4M1dFSEtZRjAxIn0R2WVh9g_t7CfNUKoVrgOkxZEe8t64mVWquAbfQL381H7DvWDN0yxx5tkf1MDh_cvk0Ewqr9jbaaDXM603musP",
  "session_token": "dd24eb19d82a98ec82407cf708ee05ee8955c6be",
  "player_identifier": "01H4NKEREW2K3Q4W83WEHKYF01",
  "player_id": 6111,
  "player_name": "",
  "player_ulid": "01H4NKEREW2K3Q4W83WEHKYF01",
  "player_created_at": "2023-07-06T12:39:57Z",
  "public_uid": "DAT7M9XS",
  "seen_before": true,
  "check_grant_notifications": false,
  "check_deactivation_notifications": false,
  "check_dlcs": [],
  "success": true
}

Cancel a Lease Process

Unity

LootLockerSDKManager.StartRemoteSession returns a Guid which you can later use to cancel the remote session start process.

public void RemoteLease()
{
    var leasedGuid =  LootLockerSDKManager.StartRemoteSession(leaseAction, pollingAction, onComplete);
    LootLockerSDKManager.CancelRemoteSessionProcess(leasedGuid);
}

Unreal

Blueprint on Cancelling a Remote Session Process

Refresh Lease Session

Unity

LootLockerSDKManager.RefreshRemoteSession((onComplete) => 
{ 
    if(!onComplete.success)
    {
        Debug.Log("Couldnt refresh remote session!");
        return;
    }
});

With manually stored refresh token:

string refreshToken = "";
LootLockerSDKManager.RefreshRemoteSession(refreshToken, (onComplete) => 
{ 
    if(!onComplete.success)
    {
        Debug.Log("Couldnt refresh remote session!");
        return;
    }
});

Unreal

Blueprint on Refreshing a Leased Session