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 的枚举转换 |
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();
}
}
);