System API

System API

디바이스 및 시스템 정보를 조회합니다.

getSystemInfoSync()

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

반환값:

필드	타입	설명
platform	string	플랫폼 ('ios' | 'android')
brand	string	디바이스 브랜드
model	string	디바이스 모델
system	string	OS 및 버전
pixelRatio	number	디바이스 픽셀 비율
screenWidth	number	화면 너비 (px)
screenHeight	number	화면 높이 (px)
windowWidth	number	사용 가능한 창 너비 (px)
windowHeight	number	사용 가능한 창 높이 (px)
safeArea	SafeArea	안전 영역 정보
language	string	언어 설정
theme	string	테마 ('light' | 'dark')
deviceOrientation	string	화면 방향 ('portrait' | 'landscape')
SDKVersion	string	SDK 버전
version	string	서비스 버전
environment	string	접속 환경 ('prod' | 'dev'). 리소스 CDN 주소 분기 등에 활용 가능
benchmarkLevel	number	성능 등급 (Android)
wifiEnabled	boolean	Wi-Fi 활성화 상태

const info = TudadaSDK.getSystemInfoSync();
console.log('플랫폼:', info.platform);
console.log('화면:', info.windowWidth, 'x', info.windowHeight);
console.log('SafeArea:', info.safeArea);

getSystemInfo(options?)

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

옵션:

파라미터	타입	필수	설명
success	function	-	성공 콜백
fail	function	-	실패 콜백
complete	function	-	완료 콜백

성공 응답:

getSystemInfoSync()의 반환값과 동일합니다.

TudadaSDK.getSystemInfo({
  success: (res) => console.log('시스템 정보:', res),
});

활용 팁: environment 필드를 사용하여 환경별로 리소스 CDN 주소를 분기할 수 있습니다.

const info = TudadaSDK.getSystemInfoSync();
const cdnBase = info.environment === 'prod'
  ? 'https://cdn.example.com/prod'
  : 'https://cdn.example.com/dev';

getWindowInfo()

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

반환값:

필드	타입	설명
pixelRatio	number	디바이스 픽셀 비율
screenWidth	number	화면 너비 (px)
screenHeight	number	화면 높이 (px)
windowWidth	number	사용 가능한 창 너비 (px)
windowHeight	number	사용 가능한 창 높이 (px)
safeArea	SafeArea	안전 영역 정보

const windowInfo = TudadaSDK.getWindowInfo();
console.log('SafeArea:', windowInfo.safeArea);
console.log('픽셀 비율:', windowInfo.pixelRatio);

getWindowInfoAsync(options?)

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

옵션:

파라미터	타입	필수	설명
success	function	-	성공 콜백
fail	function	-	실패 콜백
complete	function	-	완료 콜백

성공 응답:

getWindowInfo()의 반환값과 동일합니다.

SafeArea 구조:

필드	타입	설명
left	number	좌상단 X 좌표
top	number	좌상단 Y 좌표
right	number	우하단 X 좌표
bottom	number	우하단 Y 좌표
width	number	안전 영역 너비
height	number	안전 영역 높이

getAppBaseInfo()

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

반환값:

필드	타입	설명
SDKVersion	string	SDK 버전
version	string	서비스 버전
theme	string	테마 ('light' | 'dark')
language	string	언어 설정
environment	string	접속 환경 ('prod' | 'dev')

const appInfo = TudadaSDK.getAppBaseInfo();
console.log('SDK 버전:', appInfo.SDKVersion);
console.log('테마:', appInfo.theme);
console.log('환경:', appInfo.environment); // 'prod' 또는 'dev'

getAppBaseInfoAsync(options?)

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

옵션:

파라미터	타입	필수	설명
success	function	-	성공 콜백
fail	function	-	실패 콜백
complete	function	-	완료 콜백

성공 응답:

getAppBaseInfo()의 반환값과 동일합니다.

getDeviceInfo()

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

반환값:

필드	타입	설명
brand	string	디바이스 브랜드
model	string	디바이스 모델
system	string	OS 및 버전
platform	string	플랫폼 ('ios' | 'android')
benchmarkLevel	number	성능 등급 (Android)

const deviceInfo = TudadaSDK.getDeviceInfo();
console.log('브랜드:', deviceInfo.brand);
console.log('모델:', deviceInfo.model);
console.log('성능 등급:', deviceInfo.benchmarkLevel);

getDeviceInfoAsync(options?)

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

옵션:

파라미터	타입	필수	설명
success	function	-	성공 콜백
fail	function	-	실패 콜백
complete	function	-	완료 콜백

성공 응답:

getDeviceInfo()의 반환값과 동일합니다.