# ctyun-xstore-player-ios

**Repository Path**: ctyun-xstore/ctyun-xstore-player-ios

## Basic Information

- **Project Name**: ctyun-xstore-player-ios
- **Description**: 天翼云云点播产品 IOS 端播放器 SDK。
- **Primary Language**: Objective-C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://vod-console.xstore.ctyun.cn/doc/vod/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-02-20
- **Last Updated**: 2022-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 播放器 IOS SDK 使用文档

## 文档版本信息

| 版本号 | 时间 | 修改内容 |
|---| ---|---|
| 1.0 | 2019.03.07 | 首次发布，实现了基本的功能 |

## 简介

天翼云媒体存储提供了点播的能力，你可以将上传的视频转码成为适合在互联网进行传播的格式，这些格式主要是 H264 编码的 MP4, HLS 和 FLV。你可以在用户控制台或者相关的后台 SDK 中取得这些视频的链接。由于这些视频是标准的视频，许多开源的浏览器均能进行播放。

为了更为方便得使用我们提供的点播功能，我们也提供了我们 IOS 的播放器。以下时本播放器使用的描述。

## 阅读对象

本文档的读者，我们假设你已经具备 IOS 的基础。同时你已经在天翼云媒体存储服务中开通了点播功能，并且已经指导如何从该服务中取得视频的 URL。

## 使用说明
一  获取最新版本的 Xcode
要想使用本开发项目，您需要 8.0 版或更高版本的 Xcode。

二  获取 CocoaPods
本SDK以 CocoaPods pod 形式提供。 CocoaPods 是一种用于 Swift 和 Objective-C Cocoa 项目的开源依赖项管理器。如果您尚未安装 CocoaPods 工具，请在 OS X 上从终端运行以下命令进行安装。 如需了解详情，请参阅 CocoaPods ( https://guides.cocoapods.org/using/getting-started.html )入门指南。

```objc
$ sudo gem install cocoapods
```
三  使用 CocoaPods 安装 SDK
为本 SDK 创建一个 Podfile，并使用它来安装 SDK。
1、创建Podfile文件
在您当前工程文件（.xcodeproj）所在文件夹下创建一个名为 Podfile 的文件。如果您尚未创建 Xcode 项目，请立即创建一个并将其保存到您的本地计算机。 

```objc
$ touch Podfile
```
2、编辑 Podfile 文件
Podfile文件内容如下：

```objc
platform :ios, '8.0'
target 'YourProjectTarget' do 
    pod 'MFPlayer', :git=>'https://gitee.com/ctyun-xstore/ctyun-xstore-player-ios.git', branch:'master'
end
```
注意：使用任何SDK都会自动引入基础 SDK ，本SDK需关联系统依赖库 `libxml2.tdb`，`CoreGraphics.framework`

3、运行 pod install 命令安装SDK

```objc
$pod install --repo-update
```
1.1.0版本的pod，运行pod install 不会自动更新repo，如果下载的不是最新版，可使用pod install —repo-update 更新 或 先运行 pod repo update.
4、重启 Xcode
关闭Xcode，然后打开（双击）您项目的 .xcworkspace 文件以启动 Xcode。 从此刻开始，您必须使用 .xcworkspace 文件打开项目。

## 简单示例

```objc
#import <MFPlayer/MFPlayerManager.h>

@interface ViewController ()
<
    MFPlayerEventListenerDelegate
>

@property (nonatomic, strong) MFPlayerManager * playerManager;//实例化播放器管理类

@end

- (void)initPlayer{
    self.playerManager = [MFPlayerManager shareInstance];

    UIView *containerView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, self.view.frame.size.width, self.view.frame.size.width*9/16)];
    [self.view addSubview:containerView];

    [self.playerManager playerContainerView:containerView];
    self.playerManager.delegate = self;
    [self.playerManager setPoster:@"封面图片地址"];
    [self.playerManager setPausedAd:@"暂停广告图片地址"];
    [self.playerManager setStartAd:@"片头广告链接"];
    [self.playerManager setEndAd:@"片尾广告链接"];
    [self.playerManager setUrl:@"播放链接"];
}

```

其他功能可以克隆本工程到本地参照demo示例CtyunPlayer工程（如工程编译问题可先终端执行pod update指令）git clone https://gitee.com/ctyun-xstore/ctyun-xstore-player-ios.git