호환성 어댑터 - HyperX Docs

호환성 어댑터는 기존 BackEnd 네임스페이스 스타일 코드를 큰 폭으로 고치지 않고 HyperX Core에 연결하기 위한 별도 패키지입니다. 새 프로젝트는 기본 HyperX SDK의 HyperX.Core와 PlayerSession 사용을 권장합니다.

패키지 구성

Unity Assets/Plugins에는 두 DLL을 함께 넣습니다.

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

어댑터는 내부적으로 기본 HyperX SDK를 호출합니다. 게임 코드에서는 BackEnd 네임스페이스를 유지할 수 있지만, 런타임에는 기본 HyperX DLL이 필요합니다.

초기화

using BackEnd;

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

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

clientAppID에는 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은 update 호출에서 기존 row를 읽고 값을 계산한 뒤 저장하는 방식으로 동작합니다.

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

지원 범위

초기화, 회원 로그인, 유저 정보, 닉네임, 토큰 갱신, 로그아웃, 현재 유저 데이터 CRUD, 공유 데이터 조회, 차트/설정, 확률, 랭킹, 쿠폰, 우편, 공지/이벤트/정책, 푸시 디바이스, 길드, 문의 흐름을 제공합니다. 표현할 수 없는 호출은 실패처럼 보이지 않도록 UnsupportedOperation이 담긴 BackendReturnObject를 반환합니다.

빌드

로컬 패키지를 만들 때는 저장소에서 다음 명령을 실행합니다.

cd dotnet-sdk-backnd-compatible
make package

생성된 zip 안에는 Unity Assets/Plugins에 복사할 DLL 묶음과 smoke sample이 포함됩니다.

​패키지 구성

​초기화

​로그인과 데이터

​지원 범위

​빌드

패키지 구성

초기화

로그인과 데이터

지원 범위

빌드