GUMoreGameSDK 1.0.3

GUMoreGameSDK 1.0.3

×

由taeja维护。

GUMoreGameSDK 1.0.3

GUMoreGameSDK说明！

这是一个用于显示游戏应用视频的开发包。

GUMoreGameSDK使用！

开始使用GUMoreGameSDK

在您开始集成SDK之前，请检查您的本地配置。目前GUMoreGameSDK支持iOS 10.0及以上版本，Xcode支持9.0及以上版本。

第一步：将GUAdsSDK添加到project中

GUMoreGameSDK支持CocoaPods，因此可以使用CocoaPods集成，当然也可以手动集成。

使用CocoaPods快速集成SDK：

CocoaPods是Objective-C或Swift的依赖管理工具，使用CocoaPods可以自动化集成三方依赖。想要更深入了解CocoaPods，请访问Cocoapods官网。使用CocoaPods快速集成GUMoreGameSDK，首先打开Terminal，然后输入以下命令，进入项目根目录，

cd /your project full path.

然后输入以下命令，创建并编辑Podfile，

pod init

open Podfile

然后复制粘贴以下内容

platform :ios, '10.0'

target 'YOUR_PROJECT_NAME' do
  
  use_frameworks!

  pod 'GUMoreGameSDK', '~> 1.0.2'  //最新版本为1.0.2

end

保存并退出，在终端下进入工程目录，输入命令pod install，开始安装GUMoreGameSDK。安装成功后，输入open yourProjectName.xcworkpeace，打开Xcode。

手动集成SDK

  1. 点击下载GUMoreGameSDK

  2. 下载GUMoreGameSDK，然后将GUMoreGameSDK.framework拖到你的工程目录中去。

  3. 由于GUMoreGameSDK中使用到了Categroy，所以我们需要在项目中配置Other linker Flag。具体步骤为： Build Settings --> Linking --> Other Linker Flags: -ObjC

  4. 由于GUMoreGameSDK不支持bitcode，我们还需要在项目配置中将Enable bitcode设置为NO。具体步骤为： Build Settings --> bitcode --> Enable bitcode: NO。

  5. 传输安全设置，在项目目录中找到info.plist文件，点击鼠标右键，选择Open as，继续选择Source code，然后复制粘贴以下xml代码：

<key>NSAppTransportSecurity</key>
	<dict>
		<key>NSAllowsArbitraryLoads</key>
		<true/>
	</dict>

至此，你已经成功创建并配置好了一个空的GUMoreGameSDK测试工程。🍺😃！

第二步： 初始化GUMoreGameSDK

1. iOS13的适配

打开上面创建好的空的测试工程，按Command + R编译工程，此时在AppDelegate.m和SceneDelegate.m(Swift工程则是AppDelegate.swift和SceneDelegate.swift)文件中有几个报错，这是因为在iOS13中，苹果为了优化app启动速度，引入了一种新的多场景切换机制。如果想要了解更多，可以查阅官方文档，这里不再赘述。上述报错的处理方法：由于我们的GUMoreGame最低支持iOS 10.0，所以建议开发者，将Target --> General --> Deployment info中的target版本修改为iOS10.0，然后在AppDelegate.m和SceneDelegate.m中报错的方法名后面添加

API_AVAILABLE(ios(13.0))

如果是Swift，则在AppDelegate.swift和SceneDelegate.swift中报错的方法名上面添加

@available(iOS 13.0, *)

然后按Command + B，编译就会成功了。（备注：实际上，点击报错方法名后面的红圈，然后点击fix按钮，上述版本标识会自动添加。）

最后，由于我们的测试应用是单场景应用，所以我们需要在AppDelegate.h中添加一个UIWindow属性，确保工程启动会自动加载main.storyboard。如果是Swift则在AppDelegate.swift中添加UIWindow属性。代码如下：

#Objective-C
#import <UIKit/UIKit.h>

@interface AppDelegate : UIResponder <UIApplicationDelegate>

@property (nonatomic, strong) UIWindow *window;

@end

#Swift
import UIKit

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?
    //Application life cycle functions
	...
}

2. SDK的初始化

在AppDelegate.m或AppDelegate.swift中，引入SDK头文件，然后初始化SDK。如果你只想用于测试，这里我们提供一个测试api_key

api_key: Jmwy7JqsZ3kX6YEDpzzpS6V9oex7CvQG

#Objective-C
#import <GUMoreGameSDK/GUMoreGameSDK.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    [[GUMGManager shared] startMoreGameWithApiKey:@"YOUR_APIKEY"];
    return YES;
}

#Swift
import GUMoreGameSDK

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // Override point for customization after application launch.
        
        GUMGManager.shared().startMoreGame(withApiKey: "YOUR_APIKEY")
        return true
    }
}

初始化方法调用之后，按Command + R运行工程，如果控制台打印出以下内容，说明你已经成功集成了GUMoreGameSDK。

2019-10-24 17:01:57.286659+0800 GUMoreGameSDK[3016:429131] ---------- Success message! ----------
2019-10-24 17:01:57.286748+0800 GUMoreGameSDK[3016:429131] GUMoreGameSDK initialize success!
2019-10-24 17:01:57.286780+0800 GUMoreGameSDK[3016:429131] The SDK version is 1.0.0
2019-10-24 17:01:57.286812+0800 GUMoreGameSDK[3016:429131] --------------------------------------

3. 播放广告视频

在UIViewController.m或UIViewController.swift中，然后在viewDidLoad中添加如下代码

#Objective-C
#import <GUMoreGameSDK/GUMoreGameSDK.h>

- (void)viewDidLoad {
    [super viewDidLoad];
    self.view.backgroundColor = [UIColor whiteColor];
    
    //如果你想自定义尺寸
    //GUMGSize size = GUMGSizeFromCGSize(CGSizeMake(180, 210));
    [[GUMGManager shared] setMoreGameShowProductStyle:GUMGShowProductStyleNative];
    //在showVideo之前，建议先隐藏之前的video，此步骤是为了确保videoPlayer被完全释放。
    [[GUMGManager shared] hideMoreGameVideoADs];
    [[GUMGManager shared] showMoreGameVideoAdsWithAdsSit:self.adsSit size:kGUMGSizeNormal position:GUMGPositionMiddleCenter rootViewController:self];
    //如果你想自定义位置，上面position参数你就需要传:GUMGPositionCustom，然后下面一行代码的注释打开
    //[[GUMGManager shared] setCustomPosition:CGPointMake(0, 200)];
}


#Swift
import GUMoreGameSDK

override func viewDidLoad() {
	super.viewDidLoad()
    view.backgroundColor = .white

    //如果你想自定义尺寸，在代开下行注释代码，并修改你想自定义的size的值
    //let size = GUMGSizeFromCGSize(CGSize(width: 180, height: 210))
	GUMGManager.shared().setMoreGameShowProductStyle(.native)
	//在showVideo之前，建议先隐藏之前的video，此步骤是为了确保videoPlayer被完全释放。
	GUMGManager.shared().hideMoreGameVideoADs()

	GUMGManager.shared().showMoreGameVideoAds(withAdsSit: "ADS_SITE", size: kGUMGSizeNormal, position: .middleCenter, rootViewController: self)
	//如果你想自定义位置，上面position参数你就需要传:GUMGPositionCustom，然后下面一行代码的注释打开
	//GUMGManager.shared().setCustomPosition(CGPoint(x: 0, y: 200))
}

OK，到了这一步，编译运行你的项目，视图上将播放精彩的more game广告视频，尽情享受。😃