Nexage Integration SourceKit for MRAID

Nexage Integration SourceKit for MRAID是一个易于使用的库，它实现了IAB MRAID 2.0规范（http://www.iab.net/guidelines/508676/mobile_guidance/mraid）。它是用Objective-C编写的，并在iPhone和iPad应用程序中工作。

特色功能

• MRAID 2实现
• 处理完整的/片段HTML
• 4级日志
• 只需几行代码即可集成
• ARC支持

要求

• iOS 8+
• Xcode: 8.1+
• SourceKitCommon GitHub项目（https://github.com/nexage/sourcekit-common-ios）或Carthage构建（https://github.com/HiddenJester/sourcekit-common-ios）

开始使用

步骤1：将sourcekit-mraid-ios和source-kit-common-ios导入到Cartfile中，如下所示

github "HiddenJester/sourcekit-mraid-ios" >= 1.0.7
github "HiddenJester/sourcekit-common-ios" >= 1.0.4

步骤2：根据以下说明配置carthage：https://github.com/Carthage/Carthage

步骤3：将sourcekit-mraid-ios导入到您的项目中

@import sourcekitMRAID;

步骤4：创建一个SKMRAIDView并将其添加到您的容器视图中，如下例所示

对于横幅

 SKMRAIDView *bannerView = [[SKMRAIDView alloc] initWithFrame:CGRectMake(0, 0, 320, 50)
                                 withHtmlData:htmlData
                                  withBaseURL:bundleUrl
                            supportedFeatures:@[MRAIDSupportsSMS, MRAIDSupportsTel]
                                     delegate:self
                              serviceDelegate:self
                           rootViewController:self];

[self.view addSubview:bannerView];

注意：您必须提供带有baseURL的创意内容字符串。创意可以是HTML片段或完整的HTML。

对于插页式广告

	self.interstitial = [[SKMRAIDInterstitial alloc]
							initWithSupportedFeatures:@[MRAIDSupportsCalendar]
                                		 withHtmlData:htmlData
                                          withBaseURL:bundleUrl
                                             delegate:self
                                      serviceDelegate:self
                                   rootViewController:self];

等待SKMRAIDInterstitialDelegate 'mraidInterstitialAdReady:'回调，当广告准备好在屏幕上显示时，执行以下操作

[mraidInterstitial show];

在播放广告之前检查广告可用性，使用[mraidInterstitial isAdReady]进行。

步骤5：（可选）查看日志

@import SourceKitCommon.SKLogger;

[SKLogger setLogLevel:SourceKitLogLevelDebug];   // select desired log level

步骤6：（可选）如果您希望监听并采取MRAID日历、storePicture、inlineVideo和打开浏览器事件的操作，请实现SKMRAIDServiceDelegate协议。

就是这样！

许可证

版权所有 (c) 2013, Nexage, Inc.
保留所有权利。
在以下BSD-3许可证下提供

重新分配和使用源代码和二进制形式，无论是否修改，只要满足以下条件

1. 源代码重新分配必须保留上述版权声明、本条件列表和以下免责声明。

2. 二进制形式的重新分配必须以文档和/或其他形式复制上述版权声明、本条件列表和以下免责声明。

3. 未经事先书面许可，不得使用Nexage或其贡献者的名称来认可或推广由此软件派生出来的产品。

本软件由版权所有者和贡献者提供“现状”并且不承担任何明确或隐含的保证，包括但不限于适销性保证和针对特定用途的适用性保证。在任何情况下，版权所有者或贡献者均不对因使用本软件而产生的任何直接、间接、偶然、特殊、示范性或后果性损害承担责任，包括但不限于替代商品或服务的采购；使用损失、数据或利润损失；或业务中断。无论出于何种原因，在何种责任理论下，无论在合同、严格责任还是侵权（包括疏忽或不计）等情况下引起，即使已告知可能发生此类损害的可能性。