菜单

iOS SDK 6.5.91 迁移说明

iOS SDK 6.5.91 迁移说明

适用于从 6.5.90 及更早 升级到 6.5.91。本版本新增加载回调线程配置,默认将加载成功 / 失败回调改为异步执行于后台线程。代理方法签名未变。

1. 变更摘要

项目 说明
新增属性 SDMBaseAd.callbackOnMainThread
默认值 NO:onAdLoaded: / onAdLoadFail:error:(含开屏 onAdLoaded:isTimeout:)异步回调到后台线程
设为 YES 上述回调异步回调到主线程,可在回调中直接更新 UI
开屏 onAdLoadTimeout: 仍在主线程,不受该属性影响
横幅 / 原生 界面相关回调仍在主线程

2. 既有用法是否需要调整

既有用法 是否需要调整
加载成功 / 失败回调中仅处理业务逻辑(日志、统计、触发下次 load 等),不更新 UI 可不调整
在 onAdLoaded: / onAdLoadFail:error:(含开屏 onAdLoaded:isTimeout:)中更新 UI 需在 load 前设置 callbackOnMainThread = YES,或自行切换到主线程后再更新 UI
主要使用横幅 / 原生广告的展示相关回调 可不调整

3. 推荐写法

在调用 load 之前设置:

objc 复制代码
SDMInterstitialAd *interstitialAd = [[SDMInterstitialAd alloc] initAdWithPlacementId:@"placement_id"];
interstitialAd.loadDelegate = self;
interstitialAd.showDelegate = self;

// 6.5.91+:在加载回调中更新 UI 时设为 YES;默认 NO,回调在后台线程异步执行
interstitialAd.callbackOnMainThread = YES;

[interstitialAd load];

激励视频、开屏同理:

objc 复制代码
rewardedVideoAd.callbackOnMainThread = YES;
[rewardedVideoAd load];

splashAd.callbackOnMainThread = YES;
[splashAd load];

若保持默认 NO,又需在回调中更新 UI,可自行切换到主线程:

objc 复制代码
- (void)onAdLoaded:(SDMBaseAd *)item {
    dispatch_async(dispatch_get_main_queue(), ^{
        // 更新 UI
    });
}

4. 使用注意

  1. 成功与失败回调共用同一配置。
  2. 无论主线程或后台线程,回调均为异步。
  3. 属性须在 load 前设置;加载开始后再修改可能导致行为不符合预期。
  4. 该属性仅影响加载成功 / 失败回调(含开屏 onAdLoaded:isTimeout:)。展示、点击、关闭、Deeplink 及开屏 onAdLoadTimeout: 等不受影响。

5. 升级验证建议

  • 插屏 / 激励:分别验证默认与 callbackOnMainThread = YES 下,成功与失败回调均可正常收到;需更新 UI 时界面表现正常。
  • 开屏:加载成功回调行为符合预期;onAdLoadTimeout: 仍在主线程。
  • 横幅 / 原生:展示与界面相关回调仍在主线程。
最近修改: 2026-11-19Powered by