VideoOS-iOS-SDK 1.1.0

VideoOS-iOS-SDK 1.1.0

×

Maintained by JingShengshan.

VideoOS-iOS-SDK 1.1.0

  • By
  • VideoPls

VideoOS iOS SDK

SDK集成

有两种方式将VideoOS添加到你的工程：

  • 使用CocoaPods
  • 手动添加framework

使用CocosPods

CocoaPods 是 Objective-C 的依赖管理工具, 利用它可以让在项目中使用第三方库的过程变成简单和自动化。具体请参考 Get Started。

Podfile
platform :ios, '8.0'
pod 'VideoOS-iOS-SDK'

如果你使用的是swift开发，请确保添加 use_frameworks!

platform :ios, '8.0'
use_frameworks!

手动添加framework

快速集成SDK

  1. 将下载的SDK解压后导入您的工程中 (注:请务必在此步骤中选择“Create groups”单选按钮组, 因该SDK体积过大，不要勾选“Copy items if needed”。用这种方式仅引用该SDK,避免引起项目体积过大的问题)

  1. 设置项目的Framework Search Paths (注:由于我们采用了Reference的方式，所以此处必须在Framework Search Paths里面添加SDK在本机所在的路径，路径从Users开始),如图：

  1. 添加依赖库(Xcode 7 下 *.dylib 库后缀名更改为 *.tbd ),请确保已添加以下 依赖库:
libz.tbd
libsqlite3.tbd
MediaPlayer.framework
WebKit.framework
ImageIO.framework
Security.framework
CoreMedia.framework
AVFoundation.framework
MobileCoreService.framework
Accelerate.framework
CoreTelephony.framework
SystemConfiguration.framework
AssetsLibrary.framework
Photos.framework
  1. 设置 Other Linker flags.
    在 Other Linker Flags 中添加 –ObjC,如图(注意:如果项目中加载多个静态库有冲突，并使用了-force_load 的，不能添加-ObjC，且相 应此库也需要加入 force_load，对应路径需要指定到 VideoPlsCytronSDK.framework/VideoPlsCytronSDK.h):

  1. 可能依赖的第三方库(具体视平台不同而不一致)
'AFNetworking' 
'SDWebImage', '4.2.2' #如果用最新版本SDWebImage，请确认gif是否可以播放

互动层对接

SDK初始化

在 AppDelegate.m 文件中导入 <VideoPlsInterfaceControllerSDK/VPIConfigSDK.h> ，并在 application:didFinishLaunchingWithOptions: 方法中初始化SDK，SaaS版本需要设置AppKey和AppSecret，开源版本不需要。

示例代码：

#import <VideoPlsInterfaceControllerSDK/VPIConfigSDK.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{ 
    //other code
    [VPIConfigSDK setAppKey:@"550ec7d2-6cb0-4f46-b2df-2a1505ec82d8" appSecret:@"d0bf7873f7fa42a6"];//SaaS版本需要设置AppKey和AppSecret，开源版本不需要
    [VPIConfigSDK initSDK];
    //other code
}

对接VPInterfaceController

  1. 根据需要接入的SDK创建VPInterfaceControllerConfig，将SDK需要的信息配置在config中。

    • identifier 为点播视频url或直播房间号
    • types 为视频类型（点播or直播），默认为点播，默认是地那波（注：VPInterfaceControllerTypeVideoOS 表示点播，VPInterfaceControllerTypeLiveOS 表示直播）

  2. 利用生成的config初始化InterfaceController， interfaceController.view就是生成的互动层，将这个view添加到播放器层之上就可以了。根据接入的SDK的需求可能有一些特殊的接口，放在相应的文件中，如需要调用，将对应文件import就可以调用了,详细作用请看注释。

    //配置信息
    VPInterfaceControllerConfig *config = [[VPInterfaceControllerConfig alloc] init];
    config.identifier = videoUrl; //or roomId
    config.types = VPInterfaceControllerTypeVideoOS; //or VPInterfaceControllerTypeLiveOS
    //扩展信息
    NSMutableDictionary *dict = [NSMutableDictionary dictionaryWithCapacity:0];
    [dict setObject:@"lol" forKey:@"category"];
    config.extendDict = dict;
    
    //播放器size
    CGSize screenSize = [UIScreen mainScreen].bounds.size;
    VPIVideoPlayerSize *videoPlayerSize = [[VPIVideoPlayerSize alloc] init];
    videoPlayerSize.portraitFullScreenWidth = screenSize.width < screenSize.height ? screenSize.width : screenSize.height;
    videoPlayerSize.portraitFullScreenHeight = screenSize.width < screenSize.height ? screenSize.height : screenSize.width;
    videoPlayerSize.portraitSmallScreenHeight = videoPlayerSize.portraitFullScreenWidth * 9.0/16.0;
    videoPlayerSize.portraitSmallScreenOriginY = 0.0;
    
    VPInterfaceController  *interfaceController = [[VPInterfaceController alloc] initWithFrame:self.view.bounds config:config videoPlayerSize:videoPlayerSize];
    
    interfaceController.delegate = self;
    interfaceController.userDelegate = self;
    interfaceController.videoPlayerDelegate = self;
    
    [self.view addSubview:interfaceController.view];
  1. 接着，设置当前互动层显示区域，代码如下所示
    [interfaceController notifyVideoScreenChanged:type];

互动层加载完成、视频加载完成，建议调用更新方法，旋转横竖屏之后必须调用更新方法

  1. 全部完成之后调用start，开启互动层。
  2. 获取互动层状态信息需要遵守VPInterfaceStatusNotifyDelegate协议，详见注释
  3. 如需深度对接账号系统需要遵守VPUPUserLoginInterface协议，详见注释
  4. 如退出播放页面或直播间，调用stop方法

用户对接相关

  1. VPIUserLoginInterface 和 VPIUserInfo, VPIUserInfo用来组装用户实例, VPIUserLoginInterface 用来获取关于用户数据的回调;
    • - (VPIUserInfo *)vp_getUserInfo 通过平台方得到你们的userInfo
    • - (void)vp_userLogined:(VPIUserInfo *) userInfo 通过sdk的webView登陆后会给你们对应的用户信息
    • - (void)vp_notifyScreenChange:(NSString *)url 当需要切成竖屏时会发出这个通知,传入的url需要打开 VPIPubWebView 并调用loadUrl

获取互动层状态信息

VPInterfaceStatusNotifyDelegate - (void)vp_interfaceActionNotify, 会回传互动层状态和需要的操作

  • adID 为广告的唯一标识
  • adName 为广告名
  • eventType 为广告触发的事件，包括展示、点击、关闭等
  • actionType 为对接方需要做的操作，包括打开外链，暂停视频，播放视频
  • url 为外链地址

注意事项

  1. VPInterfaceControllerConfig identifier参数为视频的标识(原url),可以用url作为参数 或 使用拼接 ID的方式来识别。
  2. 文档中的代码仅供参考，实际参数请根据项目自行配置。
  3. 互动层会向下层 view 发放点击手势，不用担心控制器界面会被阻挡手势。
  4. 请将互动层置于合适位置以防阻挡手势。
  5. 最佳位置为加载控制栏的下方,并且于手势层的上方,请不要将 cytronView 放 入包含手势操作的 View 中。
  6. SDK目前支持系统为 ios8 以上。
  7. 存在bundle包时请将bundle包放入资源文件中,使SDK能正常调用。

本地化部署配置（开源版本）

host配置

修改VPLuaSDK.m中的host地址

注：现在VPLuaSDK.m中的host为SaaS版本的地址

加密key设置

修改VPLuaCommonInfo.m中的加密key