Unity Ads iOS SDK API 参考 - Swift
通过访问 Unity Ads SDK 公共 API 参考，可以查看在 Swift 中可用于集成和控制 iOS 应用广告行为的类、方法和属性。
阅读时间33 分钟最后更新于 1 个月前
在将 Unity Ads 集成到 iOS 应用程序时，请使用 Swift 中的 Unity Ads Android SDK API 参考此参考。
使用此 API 之前，请确保已导入库以便在 app 中启用 Monetization。请参阅导入 UnityAds 库以了解更多信息。
UnityAds类
UADSBannerAd
UADSBannerAdload(_:completion)
public 类 UADSBannerAd：NSObject { public static func 加载(_ 配置：UADSBannerLoadConfiguration、 完成：@escaping (UADSBannerAd?、UnityAdsError?) -> Void)}
加载具有指定配置的横幅广告。
参数 | 描述 |
|---|---|
| 配置 | 加载横幅广告的选项。 |
| 完成 | 加载横幅时调用的回调。如果加载成功，则返回加载的 UADSBannerAd 实例，如果加载失败，则返回 UnityAdsError。 |
onAdExpired
public var onAdExpired：（(UADSBannerAd) -> Void）？
广告到期时触发的回调。将此属性设置为在加载的横幅广告过期且不再有效时收到通知。
视图
public 类 UADSBannerAd：UIView { public var 视图：UIView}
用于访问横幅广告实例的视图属性。使用此属性可将横幅广告插入到app的现有视图层级视图视图中所需的位置。
UADSBannerView
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用 。请参阅 iOS 弃用 API 以了解迁移详细信息。
UADSBannerAdUADSBannerViewUADSBannerViewDelegate
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用 。请参阅 iOS 弃用 API 以了解迁移详细信息。
UADSBannerAdDelegateUADSBannerViewDelegateUADSBannerLoadConfiguration
UADSBannerLoadConfigurationpublic 类 UADSBannerLoadConfiguration：NSObject { @objc public 私有变量 var placementId：字符串 @objc public 私有变量 var adMarkup：字符串？ @objc public 私有变量 var bannerSize：CGSize @objc public 私有变量 var delegate：UADSBannerAdDelegate @objc public 私有变量 var mediationAdUnitId：字符串？ @objc public 私有变量 var mediationInfo：UADSMediationInfo？ @objc public 私有变量 var extras：[字符串：字符串]}
属性 | 描述 | 必需 |
|---|---|---|
| Unity Monetization（变现）后台中定义的放置/位置 ID。 | 是 |
| 通过竞价加载广告时使用的广告标记数据。 | 否 |
| 横幅广告的大小。 | 是 |
| 委托处理横幅广告事件。 | 是 |
| 聚合合作伙伴后台中定义的广告单元或放置/位置 ID。 | 否 |
| 指定有关聚合集成的详细信息。 | 否 |
| 其他自定义键值对。 | 否 |
UADSBannerLoadConfigurationBuilder
使用 创建并返回 类的实例。
UADSBannerLoadConfigurationBuilderUADSBannerLoadConfigurationinit(placementId, bannerSize, delegate)
public init(placementId：字符串、 bannerSize：CGSize、 delegate：UADSBannerAdDelegate)
创建新的 实例。
UADSBannerLoadConfigurationBuilder属性 | 描述 | 必需 |
|---|---|---|
| Unity Monetization（变现）后台中定义的放置/位置 ID。 | 是 |
| 横幅广告的大小。 | 是 |
| 委托处理横幅广告事件。 | 是 |
返回： 实例。
UADSBannerLoadConfigurationBuilderwith(adMarkup:)_
public func with(adMarkup:字符串) -> 自我
向添加 adMarkup。
UADSBannerLoadConfigurationBuilder参数 | 描述 |
|---|---|
| adMarkup | 通过竞价加载广告时使用的广告标记数据。 |
返回：更新的实例。
UADSBannerLoadConfigurationBuilderwith(mediationAdUnitId:)_
public func with(mediationAdUnitId:字符串) -> 自我
向添加聚合广告单元 ID。
UADSBannerLoadConfigurationBuilder参数 | 描述 |
|---|---|
| mediationAdUnitId | 聚合合作伙伴后台中定义的广告单元或放置/位置 ID。 |
返回：更新的实例。
UADSBannerLoadConfigurationBuilderwith(mediationInfo:)_
public func with(mediationInfo:UADSMediationInfo) -> 自我
向添加聚合信息。
UADSBannerLoadConfigurationBuilder参数 | 描述 |
|---|---|
| mediationInfo | 有关聚合集成的详细信息（名称、版本、适配器版本）。 |
返回：更新的实例。
UADSBannerLoadConfigurationBuilderwith(extras:)_
public func with(extras: [字符串：字符串]) -> 自我
向添加额外的键值参数。
UADSBannerLoadConfigurationBuilder参数 | 描述 |
|---|---|
| extras | 横幅加载的自定义参数。 |
返回：更新了 UADSBannerLoadConfigurationBuilder 实例。
build()_
public func 构建() -> UADSBannerLoadConfiguration
构建并返回 实例。
UADSBannerLoadConfiguration返回： 实例。
UADSBannerLoadConfigurationUADSBannerLoadOptions
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
UADSBannerLoadOptionsUADSInitializationConfiguration
public 类 UADSInitializationConfiguration：NSObject { @objc public 私有变量 var gameId：字符串 @objc public 私有变量 var isTestModeEnabled：布尔 @objc public 私有变量 var logLevel：UADSLogLevel @objc public 私有变量 var mediationInfo：UADSMediationInfo？ @objc public 私有变量 var extras：[字符串：字符串]}
UADSInitializationConfiguration属性 | 描述 | 必需 |
|---|---|---|
| Unity Ads Monetization（变现）后台中的唯一游戏标识符。 | 是 |
| 启用测试模式的布尔值。如果为 true，则仅显示测试广告服务。默认为 false。 | 否 |
| 指定日志输出的细节级别。默认为 INFO。 | 否 |
| 包含有关聚合集成信息的对象。 | 否 |
| 用于自定义配置的其他键值参数的映射。 | 否 |
UADSInitializationConfigurationBuilder
使用 创建并返回 类的实例。
UADSInitializationConfigurationBuilderUADSInitializationConfigurationInitialize
public static func initialize(_ 配置：UADSInitializationConfiguration、 完成：@escaping (UnityAdsError?) -> Void)
使用指定配置初始化 Unity Ads SDK。当初始化以成功或失败完成时，将调用完成处理程序。
参数 | 描述 |
|---|---|
| 配置 | UADSInitializationConfiguration 对象，其中包含初始化 SDK 的必要设置。 |
| 完成 | 完成时调用完成回调，指示成功或详细说明失败原因并报错和报错代码。 |
init(gameId:)_
public init(gameId：字符串)
创建新的 实例。
UADSInitializationConfigurationBuilder参数 | 描述 |
|---|---|
| gameId | 游戏的唯一标识符，由 Unity Ads 管理工具或 Unity 编辑器提供。 |
返回： 实例。
UADSInitializationConfigurationBuilderwith(testMode:)_
public func with(testMode：Bool） -> 自我
设置测试模式。
参数 | 描述 |
|---|---|
| testMode | 将此标志设置为 |
返回：更新的实例。
UADSInitializationConfigurationBuilderwith(logLevel:)_
public func with(logLevel:UADSLogLevel） -> 自
设置日志级别（定义日志中包含的细节量），从 None 到 Full 调试信息。
参数 | 描述 |
|---|---|
| logLevel | 指定日志输出的细节级别。 |
返回：更新的实例。
UADSInitializationConfigurationBuilderwith(mediationInfo:)_
public func with(mediationInfo:UADSMediationInfo) -> 自我
设置聚合信息，提供有关 app 聚合集成的详细信息，包括聚合名称、版本和适配器版本。
参数 | 描述 |
|---|---|
| mediationInfo | 指定有关聚合集成的详细信息。 |
返回：更新的实例。
UADSInitializationConfigurationBuilderwith(extras:)_
public func with(extras: [字符串：字符串]) -> 自我
设置其他参数。
参数 | 描述 |
|---|---|
| extras | 用于自定义配置的其他键值对。 |
返回：更新的实例。
UADSInitializationConfigurationBuilderbuild()
public func build() -> UADSInitializationConfiguration
构建并返回 实例。
UADSInitializationConfiguration返回： 实例。
UADSInitializationConfigurationUADSInterstitialAd
UADSInterstitialAdload(_:completion)
public 类 UADSInterstitialAd：NSObject { public static func 加载(_ 配置：UADSLoadConfiguration、 完成：@escaping (UADSInterstitialAd?、UnityAdsError?) -> Void)}
加载具有指定配置的插页式广告。
参数 | 描述 |
|---|---|
| 配置 | 包含广告加载选项的 UADSLoadConfiguration 实例。 |
| 完成 | 加载过程完成后调用的回调。如果成功，则返回 UADSInterstitialAd 实例，如果加载失败，则返回 UnityAdsError。 |
show(_:delegate:)
public 类 UADSInterstitialAd：NSObject { public func show(_ 配置：UADSShowConfiguration? = nil, delegate：UADSInterstitialShowDelegate)}
显示加载的插页式广告。
参数 | 描述 |
|---|---|
| 配置 | 用于展示广告的可选配置。 |
| delegate | 符合 UADSInterstitialShowDelegate 的委托来处理广告事件。 |
onAdExpired
注册在广告到期时触发的回调。
public 类 UADSInterstitialAd：NSObject { public var onAdExpired：（(UnityAd) -> Void）？}
UADSLoadConfiguration
UADSLoadConfigurationpublic 类 UADSLoadConfiguration：NSObject { @objc public 私有变量 var placementId：字符串 @objc public 私有变量 var adMarkup：字符串？ @objc public 私有变量 var mediationAdUnitId：字符串？ @objc public 私有变量 var mediationInfo：UADSMediationInfo？ @objc public 私有变量 var extras：[字符串：字符串]}
创建新的 实例。
UADSLoadConfiguration属性 | 描述 | 必需 |
|---|---|---|
| Unity Monetization（变现）后台中定义的放置/位置 ID。 | 是 |
| 通过竞价加载广告时使用的广告标记数据。如果为零，则为瀑布流。 | 否 |
| 聚合合作伙伴后台中使用的放置/位置 ID。 | 否 |
| 指定有关聚合集成的详细信息。 | 否 |
| 用于配置的其他自定义键值对。 | 否 |
**注意：**所有竞价实现都需要 adMarkup 属性。对于瀑布流实现，可将 adMarkup 设置为 nil。 |
UADSLoadConfigurationBuilder
使用 创建并返回 类的实例。
UADSLoadConfigurationBuilderUADSLoadConfigurationinit(placementId:)
public init(placementId：字符串)
创建新的 实例。
UADSLoadConfigurationBuilder参数 | 描述 |
|---|---|
| Unity Monetization（变现）后台中定义的放置/位置 ID。 |
返回： 实例。
UADSLoadConfigurationBuilderwith(adMarkup:)_
public func with(adMarkup:字符串) -> 自我
向添加 adMarkup。
UADSLoadConfigurationBuilder参数 | 描述 |
|---|---|
| adMarkup | 通过竞价加载广告时使用的广告标记数据。如果为 null，则广告请求使用瀑布流。 |
返回：更新的实例。
UADSLoadConfigurationBuilderwith(mediationAdUnitId:)_
public func with(mediationAdUnitId:字符串) -> 自我
将聚合广告单元 ID 添加到。
UADSLoadConfigurationBuilder属性 | 描述 |
|---|---|
| 聚合合作伙伴后台中使用的放置/位置 ID。 |
返回：更新的实例。
UADSLoadConfigurationBuilderwith(mediationInfo:)_
public func with(mediationInfo:UADSMediationInfo) -> 自我
向添加聚合信息。
UADSLoadConfigurationBuilder参数 | 描述 |
|---|---|
| mediationInfo | 指定有关聚合集成的详细信息（名称、版本、适配器版本）。 |
返回：更新的实例。
UADSLoadConfigurationBuilderwith(extras:)_
public func with(extras: [字符串：字符串]) -> 自我
向添加额外的配置键值对。
UADSLoadConfigurationBuilder参数 | 描述 |
|---|---|
| extras | 用于广告加载的自定义参数的字典。 |
返回：更新的实例。
UADSLoadConfigurationBuilderbuild()
public func 构建() -> UADSLoadConfiguration
构建并返回 实例。
UADSLoadConfiguration返回： 实例。
UADSLoadConfigurationUADSLoadOptions
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用 。请参阅 iOS 弃用 API 以了解迁移详细信息。
UADSLoadConfigurationBuilderUADSLoadOptionsUADSMediationInfo
指定有关聚合集成的详细信息。
public 类 UADSMediationInfo：NSObject { public init(name:字符串，版本：字符串、 adapterVersion：字符串)}
参数 | 描述 |
|---|---|
| name | app 中集成的聚合平台的名称。 |
| 版本 | app 中集成的聚合 SDK 版本。 |
| adapterVersion | 聚合合作伙伴的 Unity Ads 适配器版本。 |
返回： 实例。
UADSMediationInfoUADSMediationMetaData
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用 。请参阅 iOS 弃用 API 以了解迁移详细信息。
UADSMediationInfoUADSMediationMetaData隐私
Privacy 是一组枚举和一类提供 API 来管理 Unity Ads 的隐私设置和用户同意。这使开发者能够处理符合 GDPR、PIPL 和其他法规的各种隐私设置和同意。
public 类 Privacy：NSObject { public static func set(privacy：PrivacyFlag，值：PrivacyValue) {} public static func set(consent:PrivacyConsent，值：PrivacyConsentValue) {} // 设置新标志，如果写入现有标志，则抛出异常 public static func setPrivacy(_ flag:字符串，同意：PrivacyConsentValue) throws {} public static func setPrivacy(_ flag:字符串，值：PrivacyValue) 抛出 {}
UADSMetaData
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
在 上使用键入的隐私方法：、 和 。请参阅 iOS 弃用 API 以了解迁移详细信息。
UnityAdssetUserConsent()setUserOptOut()setNonBehavioral()UADSMetaDataUADSRewardedAd
UADSRewardedAdload(_:completion)_
public 类 UADSRewardedAd：NSObject { public static func 加载(_ 配置：UADSLoadConfiguration、 完成：@escaping (UADSRewardedAd?、UnityAdsError?) -> Void)}
加载具有指定选项的奖励广告。
参数 | 描述 |
|---|---|
| 配置 | 包含广告加载选项的 UADSLoadConfiguration 实例。 |
| 完成 | 在广告加载完成后调用的回调。如果成功，则返回 UADSRewardedAd 实例，如果加载失败，则返回报错。 |
show(_:delegate:)
public 类 UADSRewardedAd：NSObject { public func show(_ 配置：UADSShowConfiguration? = nil, delegate：UADSRewardedShowDelegate）}
显示加载的奖励广告。
参数 | 描述 |
|---|---|
| 配置 | 显示广告的可选设置。 |
| delegate | 一种可选的委托，用于处理奖励广告事件。 |
onAdExpired
注册在广告到期时触发的回调。
public 类 UADSRewardedAd：NSObject { public var onAdExpired：（(UnityAd) -> Void）？}
UADSShowConfiguration
UADSShowConfigurationpublic 类 UADSShowConfiguration：NSObject { @objc public 私有变量 var viewController：UIViewController？ @objc public 私有变量 var customRewardString：字符串？ @objc public 私有变量 var extras：[字符串：字符串]}
使用可选的附加参数创建一个新的实例。
UADSShowConfiguration属性 | 描述 | 必需 |
|---|---|---|
| 用于展示广告的视图控制器。 | 否 |
| 广告展示的自定义奖励标识符。 | 否 |
| 在展示广告时要包含的其他键值参数。默认为空字典。 | 否 |
UADSShowConfigurationBuilder
使用 创建并返回 类的实例。
UADSShowConfigurationBuilderUADSShowConfiguration*init()
public init()
创建 UADSShowConfigurationBuilder 的新实例。
with(viewController:)
public func with(viewController：UIViewController) -> 自
设置展示广告的视图控制器。
参数 | 描述 |
|---|---|
| 展示广告的视图控制器。 |
返回：更新的 UADSShowConfigurationBuilder 实例。
with(customRewardString:)
public func with(customRewardString：字符串) -> 自我
为广告展示设置自定义奖励标识符。
参数 | 描述 |
|---|---|
| 广告展示的唯一奖励 ID。 |
返回：更新的实例。
UADSShowConfigurationBuilderwith(extras:)
public func with(extras: [字符串：字符串]) -> 自我
在展示广告时添加额外的键值参数。
参数 | 描述 |
|---|---|
| 广告展示的自定义参数。 |
返回：更新的实例。
UADSShowConfigurationBuilderbuild()
public func 构建() -> UADSShowConfiguration
构建并返回 实例。
UADSShowConfiguration返回： 实例。
UADSShowConfigurationUADSShowOptions
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用 。请参阅 iOS 弃用 API 以了解迁移详细信息。
UADSShowConfigurationBuilderUADSShowOptionsUADSTokenConfiguration
public 类 UADSTokenConfiguration：NSObject { @objc public 私有变量 var adFormat：UADSAdFormat @objc public 私有变量 var mediationInfo：UADSMediationInfo？ @objc public 私有变量 var mediationAdUnitId：字符串？ @objc public 私有变量 var placementId：字符串？ @objc public 私有变量 var bannerSize：CGSize? @objc public 私有变量 var extras：[字符串：字符串] = [:]}
UADSTokenConfiguration属性 | 描述 | 必需 |
|---|---|---|
| 要为其生成令牌的广告格式类型。 | 是 |
| 指定有关聚合集成的详细信息。 | 否 |
| 聚合合作伙伴后台中使用的放置/位置 ID。 | 否 |
| Unity Monetization（变现）后台中定义的放置/位置 ID。 | 否 |
| 横幅广告的大小（如果令牌请求横幅广告）。 | 否 |
| 用于自定义配置的其他键值对。 | 否 |
UADSTokenConfigurationBuilder
使用 创建并返回 类的实例。
UADSTokenConfigurationBuilderUADSTokenConfigurationinit(adFormat:)
public init(adFormat：UADSAdFormat）
创建新的 实例。
UADSTokenConfigurationBuilder参数 | 描述 |
|---|---|
| adFormat | UADSAdFormat 的实例，指定广告类型（插页式、奖励式、横幅广告）。 |
返回： 实例。
UADSTokenConfigurationBuilderwith(mediationInfo:)
public func with(mediationInfo:UADSMediationInfo) -> 自我
指定有关聚合集成的详细信息。
参数 | 描述 |
|---|---|
| mediationInfo | 指定有关聚合集成的详细信息。 |
返回：更新的实例。
UADSTokenConfigurationBuilderwithMediationAdUnitId:_
public func with(mediationAdUnitId:字符串) -> 自我
将聚合广告单元 ID 添加到。
UADSTokenConfiguration属性 | 描述 |
|---|---|
| 聚合合作伙伴后台中使用的放置/位置 ID。 |
返回：更新的实例。
UADSUADSTokenConfigurationBuilderwithPlacementId:_
public func with(placementId:字符串) -> 自我
指定 Unity Monetization Dashboard（变现后台）中定义的放置/位置 ID。
参数 | 描述 |
|---|---|
| placementId | Unity Monetization（变现）后台中定义的放置/位置 ID。 |
返回：更新的实例。
UADSUADSTokenConfigurationBuilderwithBannerSize:_
public func with(bannerSize:CGSize） -> 自我
如果令牌请求横幅广告，指定横幅广告的大小。
参数 | 描述 |
|---|---|
| bannerSize | 横幅广告的大小（如果有令牌请求横幅广告）。 |
返回：更新的实例。
UADSUADSTokenConfigurationBuilderwith(extras:)
public func with(extras: [字符串：字符串]) -> 自我
指定用于自定义配置的其他键值对。
参数 | 描述 |
|---|---|
| extras | 用于自定义配置的其他键值对。 |
返回：更新的实例。
UADSTokenConfigurationBuilderbuild()
public func 构建() -> UADSTokenConfiguration
构建并返回 实例。
UADSTokenConfiguration返回： 实例。
UADSTokenConfigurationUnityAds
UnityAds初始化
initialize(_, completion:)
使用指定配置初始化 Unity Ads SDK。当初始化以成功或失败完成时，将调用完成代码块。
public static func initialize(_ 配置：UADSInitializationConfiguration，完成：@escaping (UnityAdsError?) -> Void)
参数 | 描述 |
|---|---|
| 配置 | UADSInitializationConfiguration 对象，其中包含初始化 SDK 所需的设置。 |
| 完成 | 在 SDK 初始化完成后调用的回调。如果初始化失败，则返回 UnityAdsError。 |
GetToken
getToken(_, completion:)
根据提供的获取竞价令牌并将其传递给完成代码块。
UADSTokenConfigurationpublic static func getToken(_ 配置：UADSTokenConfiguration，完成：@escaping（字符串？） -> Void）
参数 | 描述 |
|---|---|
| 配置 | 一个 |
| 完成 | 如果已成功获取，则使用令牌调用完成代码块，如果发生报错，则为 null。 |
静态变量
IsInitialized
一个布尔属性，用于确定 Unity Ads SDK 是否成功初始化。
@objc public static func isInitialized() -> 工具
返回：如果，Unity Ads 已成功初始化。
truegetVersion
一个字字符串属性，用于确定当前使用的 Unity Ads SDK 版本。
public static func getVersion() -> 字符串
返回：Unity Ads SDK 的当前安装版本。
userIdentifier
为 app 的每个用户设置唯一 ID。
public static var userIdentifier：字符串
隐私
setUserConsent()
显示用户对个性化广告服务的选择。
public static func setUserConsent(_ consentGranted:Bool）
setUserOptOut()
为用户提供了退出数据收集和个性化广告服务的选项。
public static func setUserOptOut(_ optOut:Bool）
setNonBehavioral()
启用上下文（非个性化）广告服务的显示。
public static func setNonBehavioral(_ nonBehavioral:Bool）
UnityAdsInitializationDelegate
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用带有 的完成代码块。请参阅 iOS 弃用 API 以了解迁移详细信息。
UnityAds.initialize(_:completion:)UnityAdsInitializationDelegateUnityAdsLoadDelegate
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用带有 或 的完成代码块。请参阅 iOS 弃用 API 以了解迁移详细信息。
UADSInterstitialAd.load(_:completion:)UADSRewardedAd.load(_:completion:)UnityAdsLoadDelegateUnityAdsShowDelegate
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
UnityAdsShowDelegate枚举
UADSAdFormat
定义 Unity Ads 支持的不同类型的广告格式。
public enum UADSAdFormat：Int {int case specified = 0, interstitial, reward, banner}
参数 | 描述 |
|---|---|
| 未指定 | 没有指定的广告格式。 |
| interstitial | 在 app 中的自然暂停时显示的全屏广告服务。 |
| 奖励 | 在完成后向用户授予奖励的广告服务。 |
| banner | App 布局中显示的矩形广告服务，通常锚定在屏幕顶部或底部。 |
UnityAdsAdFormat
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用 。请参阅 iOS 弃用 API 以了解迁移详细信息。
UADSAdFormatUnityAdsAdFormatUADSLogLevel
定义 Unity Ads 的日志记录级别。
public enum UADSLogLevel：Int {int 已禁用案例、报错、信息、调试}
参数 | 描述 |
|---|---|
| 已禁用 | 无日志输出。 |
| 报错 | 仅记录初始化/加载/显示操作中的关键错误和失败。 |
| info | 记录关键操作事件（例如初始化开始/完成、加载开始/完成、显示开始/完成以及令牌生成）。 |
| debug | 记录所有信息以及详细的内部操作，例如网络请求和内部错误。 |
UADSShowFinishState
表示广告展示后的完成状态。
public enum UADSShowFinishState：Int {int case skipped = 0，已完成}
参数 | 描述 |
|---|---|
| 跳过 | 用户在广告结束之前关闭或跳过了广告。 |
| 已完成 | 广告一直播放到最后。 |
协议
UADSBannerAdDelegate
public protocol UADSBannerAdDelegate：NSObjectProtocol { func bannerImpression(_ banner：UADSBannerAd) func bannerDidClick(_ banner:UADSBannerAd) func bannerDidFailShow(_ banner:UADSBannerAd，报错：UnityAdsError)}
方法 | 描述 |
|---|---|
| 成功显示横幅广告（记录展示量）时调用。 |
| 用户点击横幅广告时调用。 |
| 如果横幅无法显示，则调用，并带有解释失败的 |
UADSInterstitialShowDelegate
public protocol UADSInterstitialShowDelegate：NSObjectProtocol { func showDidStart(_ unityAd:UADSInterstitialAd) func showDidClick(_ unityAd:UADSInterstitialAd) func showDidComplete(_ unityAd:UADSInterstitialAd，状态为：UADSShowFinishState） func showDidFailed(_ unityAd:UADSInterstitialAd，报错：UnityAdsError)}
方法 | 描述 |
|---|---|
| 在插页式广告开始显示时调用。 |
| 在点击插页式广告时调用。 |
| 在广告展示完成时调用。提供 |
| 如果广告无法显示，则调用 ，并带有解释失败的 |
UADSRewardedShowDelegate
public protocol UADSRewardedShowDelegate：NSObjectProtocol { func showDidStart(_ unityAd:UADSRewardedAd) func showDidClick(_ unityAd:UADSRewardedAd) func showDidComplete(_ unityAd:UADSRewardedAd，状态为：UADSShowFinishState） func showDidFailed(_ unityAd:UADSRewardedAd，报错：UnityAdsError) func showDidReceiveReward(_ unityAd:UADSRewardedAd)}
方法 | 描述 |
|---|---|
| 奖励广告开始展示时调用。 |
| 在点击奖励广告时调用。 |
| 在广告展示完成时调用。提供 |
| 如果广告无法显示，则调用 ，并带有解释失败的 |
| 当用户从广告中获取奖励时调用。 |
UnityAdsError
public protocol UnityAdsError { var 代码：Int { get } var 消息：字符串 { get }}
参数 | 描述 |
|---|---|
| code | 一个数字报错代码，用于标识 Unity Ads 报错的类型。 |
| 消息 | 报错消息，提供有关报错的其他详细信息。 |
UADSBannerErrorCode
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用 协议。请参阅 iOS 弃用 API 以了解迁移详细信息。
UnityAdsErrorUADSBannerErrorCodeUnityAdsInitializationError
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用 协议。请参阅 iOS 弃用 API 以了解迁移详细信息。
UnityAdsErrorUnityAdsInitializationErrorUnityAdsLoadError
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用 协议。请参阅 iOS 弃用 API 以了解迁移详细信息。
UnityAdsErrorUnityAdsLoadErrorUnityAdsShowError
警告
在版本 4.19.0 中已弃用。计划在版本 5.0.0 中删除。
请改用 协议。请参阅 iOS 弃用 API 以了解迁移详细信息。
UnityAdsErrorUnityAdsShowError