CheckFeature API

CheckFeature API

checkFeature(options)

특정 API가 현재 플랫폼에서 지원되는지 사전에 확인합니다. SDK에 존재하지 않는 API는 플랫폼 통신 없이 즉시 실패합니다.

옵션:

파라미터	타입	필수	설명
apiName	string	✅	확인할 API 이름
success	function	-	기능이 지원되는 경우 콜백
fail	function	-	기능이 미지원되는 경우 콜백
complete	function	-	완료 콜백

성공 응답:

필드	타입	설명
supported	true	기능 지원됨
status	'supported'	지원 상태
apiName	string	확인한 API 이름

실패 응답:

필드	타입	설명
supported	false	기능 미지원
status	string	미지원 사유
apiName	string	확인한 API 이름
detail	string?	상세 설명

status 값:

값	설명
'unknown_api'	SDK에 존재하지 않는 API
'version_required'	앱 버전 업데이트 필요
'platform_unsupported'	플랫폼 미지원
'device_unsupported'	디바이스 미지원
'permission_denied'	권한 거부

TudadaSDK.checkFeature({
  apiName: 'startAccelerometerSensor',
  success: (res) => {
    console.log('지원됨:', res.apiName);
  },
  fail: (res) => {
    console.log('미지원:', res.status);
    if (res.status === 'version_required') {
      showUpdatePrompt(); // 게임 자체 업데이트 안내
    }
  },
});

checkFeatureAsync(apiName)

Promise 기반 기능 확인. 지원/미지원 모두 resolve로 반환합니다.

파라미터:

파라미터	타입	필수	설명
apiName	string	✅	확인할 API 이름

반환값:

필드	타입	설명
supported	boolean	기능 지원 여부
status	string	지원 상태 또는 미지원 사유
apiName	string	확인한 API 이름
detail	string?	상세 설명 (미지원 시)

const result = await TudadaSDK.checkFeatureAsync('startAccelerometerSensor');
if (result.supported) {
  TudadaSDK.startAccelerometerSensor();
} else {
  console.log('미지원 사유:', result.status);
}