Compatibility Adapter

The compatibility adapter is a separate package for projects that need to keep existing BackEnd namespace-style game code while routing calls to HyperX Core. New projects should use the canonical HyperX SDK with HyperX.Core and PlayerSession.

Package Contents

Put both DLLs in Unity Assets/Plugins.

HyperX.BackndCompatible.netstandard2.1.dll
HyperX.netstandard2.1.dll

The adapter calls the canonical HyperX SDK internally. Game code can keep the BackEnd namespace, but the runtime still needs the base HyperX DLL.

Initialization

using BackEnd;

var init = Backend.Initialize(new BackendCustomSetting
{
    clientAppID = "PROJECT_CODE",
    timeOutSec = 10
});

if (!init.IsSuccess())
{
    UnityEngine.Debug.LogError(init.ToString());
}

Set clientAppID to the project code from HyperX Console.

var login = Backend.BMember.CustomLogin("player-id", "password");

var param = new Param();
param.Add("gold", 1200);
param.Add("stage", 3);

var saved = Backend.PlayerData.UpdateMyLatestData("save_state", param);
var loaded = Backend.PlayerData.GetMyData("save_state");
var gold = (int)loaded.FlattenRows()[0]["gold"];

Param.AddCalculation works on update calls by reading the existing row, applying the calculation, and writing the row back.

var delta = new Param();
delta.AddCalculation("gold", CalculationType.Add, 50);
Backend.PlayerData.UpdateMyLatestData("save_state", delta);

Supported Areas

The adapter covers initialization, member login, user info, nickname, token refresh, logout, current-user data CRUD, shared-data reads, chart/config lookup, probability, rankings, coupons, mail, notices/events/policies, push devices, guilds, and support inquiries. Calls that cannot be represented safely return a BackendReturnObject with UnsupportedOperation.

Build

To create a local Unity-ready package:

cd dotnet-sdk-backnd-compatible
make package

The generated zip contains the DLL bundle for Unity Assets/Plugins and a smoke sample.

​Package Contents

​Initialization

​Login And Data

​Supported Areas

​Build

Package Contents

Initialization

Login And Data

Supported Areas

Build