메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.hyperx.dev/llms.txt

Use this file to discover all available pages before exploring further.

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 session = await HyperX.Core.Users.StartGuest(
    SystemInfo.deviceUniqueIdentifier,
    country: detected.Country,
    language: detected.Language
);
감지 값은 자동으로 계정에 저장되지 않습니다. 회원가입이나 Region.Update 호출에서 게임 정책에 맞게 저장하세요. 
var current = await HyperX.Core.Region.Me(session.AccessToken);
var updated = await HyperX.Core.Region.Update(
    session.AccessToken,
    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(
    HyperX.Core.Region.Me(session.AccessToken),
    region => Debug.Log(region.Country),
    error => Debug.LogWarning(error.Message)
);