什么是USeek？

USeek互动广告解决方案可以将您的视频变成充满奖励的引人入胜体验...

...在搜索创意时提高观众的注意力。

USeek库

USeek库旨在帮助开发者轻松地将USeek的愉悦功能添加到他们自己的应用程序中。

警告

• USeek利用了Safari交互式视频功能，此功能仅从iOS 10.0版本或更高版本可用。

要求

USeek:-

最低iOS目标：iOS 10.0

最低Xcode版本：Xcode 8.0

安装

从CocoaPods中

CocoaPods 是一个 Objective-C 依赖管理器，可以自动化并简化在项目中使用第三方库（如 USeek）的过程。首先，将以下行添加到您的 Podfile

pod 'USeek', :git => 'https://github.com/kronos317/USeek.git'

这将从 master 分支直接拉取。

其次，将 USeek 安装到您的项目中

pod install

Carthage

Carthage 是一个解耦的依赖管理器，它会编译您的依赖项并提供二进制框架。要使用 Carthage 将 USeek 集成到 Xcode 项目中，请在您的 Cartfile 中指定它

github "kronos317/USeekFramework"

运行 carthage update 编译框架，并将构建的 USeek.framework（在 Carthage/Build/iOS 文件夹中）拖到您的 Xcode 项目中（在 Targets 的 Linked Frameworks and Libraries 中）。

手动

• 将 kronos317/USeekFramework 文件夹拖到项目中。
• 注意确保将 USeek.framework 添加到 Targets->Build Phases->Embeded Frameworks。

用法

(请参阅 /USeekDemo 中的示例 Xcode 项目)

有3个主要类。

• USeekManager
• USeekPlayerView
• USeekPlayerViewController

USeekManager 是一个单例类，可以通过它执行以下操作

• 设置/获取发布者 ID
• 请求特定用户的积分

USeekPlayerView 和 USeekPlayerViewController 类旨在加载并播放 UIView 或作为独立的 UIViewController 的嵌入式视频。

设置发布者 ID

[[USeekManager sharedManager] setPublisherId: @"{your publisher ID}"];

如何使用 USeekPlayerViewController

1. 实例化 USeekPlayerViewController

USeekPlayerViewController *vc = [[USeekPlayerViewController alloc] init];

2. 加载视频

[vc loadVideoWithGameId:@"{game id}" UserId:@"{user id, can be empty}"];

3. 自定义视图控制器 [可选]

// show / hide `close` button
[vc setCloseButtonHidden:YES];

// customize loading text
vc.loadingTitleLabel.text = @"Please wait while loading video...";          

// set delegate
vc.delegate = self;

4. 展示视图控制器

dispatch_async(dispatch_get_main_queue(), ^{
    [self presentViewController:vc animated:YES completion:nil];
});

5. 获取 USeekPlayerViewController 关闭通知 [可选]

USeekPlayerViewControllerDelegate 定义了几个有用的代理方法（可选），其中之一是 useekPlayerViewControllerDidClose:，当 USeekPlayerViewController 关闭时将被调用。

- (void)useekPlayerViewControllerDidClose:(USeekPlayerViewController *)playerViewController{
    // Do anything here
}

如何使用 USeekPlayerView

USeekPlayerView 继承自 UIView，因此您可以直接将其添加到 storyboard 或以编程方式添加为子视图。

• 以编程方式添加

USeekPlayerView *playerView = [[USeekPlayerView alloc] initWithFrame:CGRectMake(0, 0, 100, 60)];
[self.view addSubview:playerView];

• 添加到 storyboard

只需在 storyboard 中将视图的类名更改为 USeekPlayerView。现在您可以将其作为 IBOutlet 添加并使用。

如何从服务器获取积分

通过调用 [[USeekManager sharedManager] requestPointsWithGameId:UserId:Success:Failure]，我们可以获取用户在玩游戏视频时获得的积分。

[[USeekManager sharedManager] requestPointsWithGameId:@"game id" UserId:@"user id" Success:^(int points) {
    // Do anything here
} Failure:^(NSError *error) {
    // Do anything here
}];

许可证

USeek 遵循 USEEK 许可证。有关更多信息，请参阅 LICENSE 文件。