메인 콘텐츠로 건너뛰기
HyperX는 유저 프로필에 국가와 언어를 저장합니다. 이 값은 운영 콘텐츠 노출, 알림 언어, 지역별 이벤트 분리에 사용할 수 있습니다.

국가와 언어

국가는 ISO 3166-1 alpha-2 코드, 언어는 ISO 639-1 2글자 코드를 사용합니다.
var countries = await HyperX.Core.Region.Countries();
var detected = await HyperX.Core.Region.Detect();

var player = await HyperX.Core.Users.StartGuestSession(
    SystemInfo.deviceUniqueIdentifier,
    country: detected.Country,
    language: detected.Language
);
감지 값은 자동으로 계정에 저장되지 않습니다. 회원가입이나 Region.Update 호출에서 게임 정책에 맞게 저장하세요.
var current = await player.Region();
var updated = await player.UpdateRegion(
    country: "KR",
    language: "ko"
);

서버 시간과 SDK 정보

var serverTime = await HyperX.Core.Utils.GetServerTime();
var sdkVersion = HyperX.Core.Utils.SdkVersion;
var runtime = HyperX.Core.Utils.RuntimeEnvironment;
서버 시간은 출석, 이벤트 종료, 쿨다운처럼 클라이언트 기기 시간에 의존하면 안 되는 기능에 사용합니다.

Unity 저장 경로

string path = HyperX.Core.Utils.ResolvePersistentDataPath("saves/slot-1.json");
Unity에서는 Application.persistentDataPath 아래 경로로 변환됩니다. 일반 .NET 런타임에서는 입력한 경로를 그대로 반환합니다.

콜백 스타일

SDK API는 기본적으로 Task 기반입니다. 콜백이 더 편한 Unity 코드에서는 ToCallback을 사용할 수 있습니다.
HyperX.Core.Utils.ToCallback(
    player.Region(),
    region => Debug.Log(region.Country),
    error => Debug.LogWarning(error.Message)
);