initializeWithConfiguration:completion:
SDK 初始化
初始化 SUDOP SDK 环境。该方法是使用 SDK 所有功能的前置条件,必须在调用其他 API(如 authWithUserSignature: 或 startGame:)之前调用。建议在应用启动时(例如 application:didFinishLaunchingWithOptions:)进行初始化。
方法声明
objectivec
/**
Initialize the SDK.
@param configuration The configuration used to initialize the SDK environment.
@param completion Called when initialization finishes.
*/
+ (void)initializeWithConfiguration:(SUDOPSDKConfiguration *)configuration
completion:(nullable SUDOPCompletionBlock)completion;参数说明
| 参数名 | 类型 | 必传 | 描述 |
|---|---|---|---|
| configuration | SUDOPSDKConfiguration * | 是 | 包含 appId、appKey 和可选 privacyConfig 的配置对象。 |
| completion | SUDOPCompletionBlock | 否 | 异步初始化完成后的回调。如果初始化失败,error 对象将包含具体错误信息。 |
SUDOPSDKConfiguration 属性详情
- appId: 必填。在控制台申请的唯一应用标识。
- appKey: 必填。用于请求签名的加密密钥。
- privacyConfig: 可选,类型为 SUDOPPrivacyConfig。用于设置宿主已确认的广告隐私状态;
nil表示不设置。
返回值
无(通过 completion block 异步返回结果)。
代码示例
objectivec
SUDOPSDKConfiguration *config = [[SUDOPSDKConfiguration alloc] init];
config.appId = @"your_app_id";
config.appKey = @"your_app_key";
// 以下状态仅演示写法,请替换为宿主实际确认的状态。
// 从宿主隐私流程取得已确认的选择;以下值仅演示写法,不能直接作为默认授权。
// 只赋值宿主已确认的状态;未赋值的字段保持默认 Unset,不应用到广告 SDK。
// 枚举直接赋值,无需 @() 包装。
// Unset 表示不主动设置,不代表拒绝、撤回,也不保证清除第三方 SDK 已有状态。
config.privacyConfig = [[SUDOPPrivacyConfig alloc] init];
// GDPR:Granted 已同意;Denied 拒绝或撤回;NotApplicable 不适用,不设置对应状态。
config.privacyConfig.gdprConsentStatus = kSUDOPGdprConsentStatusNotApplicable;
// 销售/共享退出:OptedOut 已退出;NotOptedOut 未退出;NotApplicable 不适用。
config.privacyConfig.doNotSellStatus = kSUDOPDoNotSellStatusNotApplicable;
// 巴西 LGPD:Granted 同意;Denied 拒绝或撤回;NotApplicable 不适用。与 GDPR 独立确认。
config.privacyConfig.lgpdConsentStatus = kSUDOPLgpdConsentStatusNotApplicable;
// 年龄:Child 儿童;Teen 青少年;Unspecified 显式未指定年龄限制,与 Unset 不设置不同。
config.privacyConfig.ageRestrictedTreatment = kSUDOPAgeRestrictedTreatmentUnspecified;
[SUDOP initializeWithConfiguration:config completion:^(NSError * _Nullable error) {
if (error) {
NSLog(@"SDK 初始化失败: %@", error.localizedDescription);
} else {
NSLog(@"SDK 初始化成功");
// 此处可以开始进行后续操作,如 authWithUserSignature:
}
}];注意事项
- 单次调用:SDK 生命周期内通常只需调用一次。
- 线程安全:该方法建议在主线程调用。回调
completion通常也会在主线程触发。 - 网络依赖:初始化过程可能涉及网络请求验证
appId的有效性,请确保设备网络通畅。 - 错误处理:如果收到的
error不为空,请检查网络状态及appId/appKey是否匹配,不要在初始化失败的情况下调用游戏启动接口。 - 广告就绪:OP 初始化回调不表示广告加载成功,游戏侧仍需等待广告对象的
onLoad。
