CheckFeature API
CheckFeature API
CheckFeature(apiName, onSuccess, onFail)
특정 API가 현재 플랫폼에서 지원되는지 사전에 확인합니다.
파라미터:
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
apiName | string | ✅ | 확인할 API 이름 |
onSuccess | Action<CheckFeatureResult> | - | 기능 지원 시 콜백 |
onFail | Action<CheckFeatureResult> | - | 기능 미지원 시 콜백 |
성공/실패 응답 (CheckFeatureResult):
| 필드 | 타입 | 설명 |
|---|---|---|
supported | bool | 기능 지원 여부 |
status | string | 미지원 사유 |
apiName | string | 확인한 API 이름 |
detail | string | 상세 설명 |
StatusEnum | CheckFeatureStatus | status의 enum 변환 |
CheckFeatureStatus 옵션:
| 값 | 설명 |
|---|---|
supported | 기능 지원됨 |
unknown_api | SDK에 존재하지 않는 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();
}
}
);