디바이스 (Device)

현재 기기와 앱에 대한 상세 정보를 조회하는 모듈입니다.

개요

appify.device는 플랫폼, 앱 버전, 기기 식별자 등 런타임 환경 정보를 제공합니다. 플랫폼별 분기 처리, 버전 호환성 확인, 광고 타겟팅이 필요할 때 사용합니다. 광고 식별자 조회는 사용자의 권한 허용이 필요할 수 있습니다.

API

getInfo(): Promise<DeviceInfo>

현재 기기 및 앱의 기본 정보를 조회합니다.

매개변수

없음

반환값: Promise<DeviceInfo> - 기기 및 앱 정보 객체

필드	타입	설명
platform	'ios' | 'android'	운영 체제 플랫폼
appVersion	string	앱 버전 (예: '1.0.2')
uniqueId	string	기기 고유 식별자
deviceName	string	사용자가 설정한 기기 이름
device	string	기기 명
brand	string	기기 브랜드
model	string	기기 모델 명 (예: 'iPhone XR', 'Galaxy S10')

예제

import { appify } from '@nolraunsoft/appify-sdk';

const info = await appify.device.getInfo();
console.log(`플랫폼: ${info.platform}, 버전: ${info.appVersion}`);

---

getIdfaAdid(): Promise<string | null>

광고 식별자를 조회합니다. iOS에서는 IDFA, Android에서는 AAID를 반환합니다.

매개변수

없음

반환값: Promise<string | null> - 광고 식별자 문자열, 권한 거부 또는 조회 불가 시 null

예제

import { appify } from '@nolraunsoft/appify-sdk';

const adid = await appify.device.getIdfaAdid();
if (adid) {
  console.log(`광고 식별자: ${adid}`);
}

플랫폼별 참고사항

• iOS: IDFA 조회 시 앱 추적 투명성(ATT) 권한 요청이 표시됩니다. 사용자가 거부하면 null을 반환합니다.
• Android: AAID는 사용자가 광고 ID를 초기화하거나 추적을 거부한 경우 null을 반환합니다.