System API

System API

GetSystemInfoSync()

전체 시스템 정보를 동기적으로 조회합니다.

반환값 (SystemInfo):

필드	타입	설명
platform	string	플랫폼 ("ios" / "android")
brand	string	디바이스 브랜드
model	string	디바이스 모델
system	string	OS 및 버전
pixelRatio	float	픽셀 비율
screenWidth / screenHeight	float	화면 크기 (px)
windowWidth / windowHeight	float	사용 가능 영역 (px)
safeArea	SafeArea	안전 영역 정보
benchmarkLevel	int	성능 등급 (Android)
SDKVersion	string	SDK 버전
wifiEnabled	bool	Wi-Fi 활성화 상태
environment	string	접속 환경 ("prod" / "dev")

SystemInfo info = TudadaSDK.Instance.GetSystemInfoSync();
Debug.Log("플랫폼: " + info.platform);
Debug.Log("화면: " + info.windowWidth + " x " + info.windowHeight);
Debug.Log("SafeArea: " + info.safeArea.width + " x " + info.safeArea.height);
Debug.Log("모델: " + info.model);
Debug.Log("성능 등급: " + info.benchmarkLevel);
Debug.Log("Wi-Fi: " + info.wifiEnabled);
Debug.Log("환경: " + info.environment); // "prod" 또는 "dev"

GetSystemInfo(onSuccess, onFail)

전체 시스템 정보를 비동기적으로 조회합니다.

파라미터:

파라미터	타입	필수	설명
onSuccess	Action<SystemInfo>	-	성공 콜백
onFail	Action<string>	-	실패 콜백

TudadaSDK.Instance.GetSystemInfo(
    onSuccess: (info) => Debug.Log("플랫폼: " + info.platform),
    onFail: (err) => Debug.LogError(err)
);

GetWindowInfo()

창/화면 크기 및 SafeArea를 동기적으로 조회합니다.

반환값 (WindowInfo):

필드	타입	설명
screenWidth	float	화면 너비 (px)
screenHeight	float	화면 높이 (px)
windowWidth	float	사용 가능 영역 너비 (px)
windowHeight	float	사용 가능 영역 높이 (px)
safeArea	SafeArea	안전 영역 정보

WindowInfo windowInfo = TudadaSDK.Instance.GetWindowInfo();
Debug.Log("SafeArea top: " + windowInfo.safeArea.top);
Debug.Log("화면 크기: " + windowInfo.screenWidth + " x " + windowInfo.screenHeight);

GetAppBaseInfo()

앱/SDK 기본 정보를 동기적으로 조회합니다.

반환값 (AppBaseInfo):

필드	타입	설명
SDKVersion	string	SDK 버전
theme	string	테마
environment	string	접속 환경 ("prod" / "dev")

AppBaseInfo appInfo = TudadaSDK.Instance.GetAppBaseInfo();
Debug.Log("SDK 버전: " + appInfo.SDKVersion);
Debug.Log("테마: " + appInfo.theme);
Debug.Log("환경: " + appInfo.environment); // "prod" 또는 "dev"

GetDeviceInfo()

디바이스 하드웨어 정보를 동기적으로 조회합니다.

반환값 (DeviceInfo):

필드	타입	설명
brand	string	디바이스 브랜드
model	string	디바이스 모델

DeviceInfo deviceInfo = TudadaSDK.Instance.GetDeviceInfo();
Debug.Log("브랜드: " + deviceInfo.brand);
Debug.Log("모델: " + deviceInfo.model);

GetMenuButtonBoundingClientRect()

메뉴 버튼 위치를 동기적으로 조회합니다. UI 배치에 활용합니다.

반환값 (MenuButtonRect):

필드	타입	설명
top	float	상단 위치
right	float	우측 위치
bottom	float	하단 위치
left	float	좌측 위치
width	float	너비
height	float	높이

MenuButtonRect rect = TudadaSDK.Instance.GetMenuButtonBoundingClientRect();
Debug.Log("메뉴 버튼 위치: top=" + rect.top + ", right=" + rect.right);