金山云KSYVRPlayer iOS SDK使用手册

阅读对象

本文档面向所有使用该SDK的开发人员, 测试人员等, 要求读者具有一定的iOS编程开发经验。

1. 概述

金山云VR播放内核是基于金山云播放SDK开发的VR播放器 SDK，在保持与播放SDK接口一致的基础上增加全景视频的播放功能。

2. KSYVRPlayer SDK 功能说明

• 支持金山云播放SDK支持的全部音视频格式和封装格式的媒体文件
• 支持单双目播放全景视频的切换
• 支持触摸和运动感应的交互方式的切换

3. 运行环境

KSY VRPlayer iOS SDK可运行于 iPhone/iPod Touch/iPad，支持 iOS 7.0 及以上版本; 支持 armv7/arm64以及虚拟机运行。

4.下载工程

本SDK提供如下两种获取方式：

• 从github下载：https://github.com/ksvc/KVrPlayer_iOS;
• 使用Cocoapods安装;

更新日志查看地址：https://github.com/ksvc/KVrPlayer_iOS/releases;

4.1 github下载SDK

如果获取到zip格式的压缩包，解压缩后包含demo、doc、framework、README.md四个部分, 目录结构如下所示:

• domo/ 目录存放KSYVRPlayerDemo，双击打开KSYPlayerDemo.xcodeproj即可使用iOS示例工程，用于帮助开发都快速了解如何使用SDK。
• doc/ 目录存放接口参考文档，双击打开html/index.html即可看到相关appledoc风格的接口说明，也可以查看在线版。
• framework/ 目录存放了KSYVRPlayer.framework，该库支持armv7/arm64/x86_64和i386四种体系结构。
• README.md 即本文档。

金山云播放SDK未包含在本SDK中，需要单独下载

4.2 Cocoapods安装

通过Cocoapods能将SDK的静态库framework下载到本地，只需要将如下语句加入你的Podfile(播放SDK和VRSDK):

   pod 'KSYVRPlayer_iOS', :git => 'https://github.com/ksvc/KSYMediaPlayer_iOS.git'
   pod 'KSYVRPlayer_iOS', :git => 'https://github.com/ksvc/KVrPlayer_iOS.git'

执行pod install或者pod update后，将SDK加入工程。

4.3 通过oschina下载播放SDK

对于部分地方访问github比较慢的情况，可以从oschina获取播放SDK。只需要将pod中的git地址修以下即可

   pod 'KSYVRPlayer_iOS', :git => 'https://git.oschina.net/ksvc/KSYMediaPlayer_iOS.git'

5. 快速集成

快速集成中提供了集成金山云播放SDK的基本方法。 具体可以参考demo工程中的相应文件。

6. 详细介绍

关于集成本SDK更详细的介绍请参考：https://github.com/ksvc/KSYMediaPlayer_iOS/wiki
主要接口说明请参考：金山云VR播放SDK接口及金山云播放SDK接口

7. 反馈与建议

• 主页：金山云
• 邮箱：[email protected]
• QQ讨论群：574179720
• Issues: https://github.com/ksvc/KVrPlayer_iOS/issues