본문으로 건너뛰기

CheckFeature API

CheckFeature API

CheckFeature(apiName, onSuccess, onFail)

특정 API가 현재 플랫폼에서 지원되는지 사전에 확인합니다.

파라미터:

파라미터타입필수설명
apiNamestring확인할 API 이름
onSuccessAction<CheckFeatureResult>-기능 지원 시 콜백
onFailAction<CheckFeatureResult>-기능 미지원 시 콜백

성공/실패 응답 (CheckFeatureResult):

필드타입설명
supportedbool기능 지원 여부
statusstring미지원 사유
apiNamestring확인한 API 이름
detailstring상세 설명
StatusEnumCheckFeatureStatusstatus의 enum 변환

CheckFeatureStatus 옵션:

설명
supported기능 지원됨
unknown_apiSDK에 존재하지 않는 API
version_required앱 버전 업데이트 필요
platform_unsupported플랫폼 미지원
device_unsupported디바이스 미지원
permission_denied권한 거부

참고: 성공/실패 모두 CheckFeatureResult 타입으로 전달됩니다. supported 필드 또는 StatusEnum 속성으로 지원 여부를 판단하세요.

using Tudada;

// 기능 확인 후 사용
TudadaSDK.Instance.CheckFeature("startAccelerometerSensor",
onSuccess: (result) => {
Debug.Log($"지원됨: {result.apiName}");
// 가속도계 사용
TudadaSDK.Instance.StartAccelerometerSensor();
},
onFail: (result) => {
Debug.Log($"미지원: {result.apiName}, 사유: {result.status}");
if (result.StatusEnum == CheckFeatureStatus.version_required)
{
// 게임 자체 업데이트 안내 표시
ShowUpdatePrompt();
}
}
);