播放器 SDK iOS

第三方播放器 iOS 插件为云点播提供给客户希望使用第三方播放器或自研播放器开发的对接云 PaaS 资源的播放器插件，常用于有自定义播放器功能需求的用户。
SDK下载
第三方播放器 iOS 插件和 Demo 项目，请参见 TXCPlayerAdapterSDK_iOS。 
更新情况可查看 更新日志。 
集成指引
环境要求
配置支持 HTTP 请求，需要在项目的 info.plist 文件中添加 App Transport Security Settings->Allow Arbitrary Loads 设置为 YES。
组件依赖
添加 GCDWebServer 组件依赖。   
pod "GCDWebServer", "~> 3.0"
GCDWebServer 是一个轻量的 HTTP server，它基于 GCD 并可用于 OS X & iOS，该库还实现了基于 Web 的文件上传以及 WebDAV server 等扩展功能。
使用播放器
变量声明，播放器主类为 TXCPlayerAdapter，创建后即可播放视频。
fileId 一般是在视频上传后，由服务器返回：
1.1 客户端视频发布后，服务器会返回 fileId 到客户端。
1.2 服务端视频上传，在 确认上传 的通知中包含对应的 fileId。
如果文件已存在腾讯云，则可以进入 控制台 ，找到对应的文件。点开后在右侧视频详情中，可以看到相关参数。
NSInteger appId; ////appid 在腾讯云点播申请
NSString *fileId;
//psign 即播放器签名，签名介绍和生成方式参见链接：https://cloud.tencent.com/document/product/266/42436
NSString *pSign = self.pSignTextView.text;
﻿
TXCPlayerAdapter *adapter = [TXCPlayerAdapter shareAdapterWithAppId:appId];
请求视频信息和播放：
id<ITXCPlayerAssistorProtocol> assistor = [TXCPlayerAdapter createPlayerAssistorWithFileId:fileId pSign:pSign];
[assistor requestVideoInfo:^(id<ITXCPlayerAssistorProtocol> response, NSError *error) {
    if (error) {
        NSLog(@"create player assistor error : %@",error);
        [self.view makeToast:error.description duration:5.0 position:CSToastPositionBottom];
        return;
    }
    [weakSelf avplayerPlay:response]; //播放视频
}];
﻿
﻿
﻿
- (void)avplayerPlay:(id<ITXCPlayerAssistorProtocol>)response
{
    AVPlayerViewController *playerVC = [[AVPlayerViewController alloc] init];
    self.playerVC = playerVC;
    TXCStreamingInfo *info = response.getStreamingInfo;
    AVPlayer *player = [[AVPlayer alloc] initWithURL:[NSURL URLWithString:info.playUrl]];
    playerVC.player = player;
    playerVC.title = response.getVideoBasicInfo.name;
    [self.navigationController pushViewController:playerVC animated:YES];
﻿
    [player addObserver:self forKeyPath:@"status" options:NSKeyValueObservingOptionNew context:nil];
}
使用完后销毁 Player：
[TXCPlayerAdapter destroy];
使用图片解密
当图片 URL 中的 QueryString 的 content_encrypt 参数被设置为 on 时，点播 CDN 会对内容进行 AES-128 加密，经过加密的图片需要经过解密后才能正常使用。
//创建TXCPlayerAdapter，使用图片解密时，AppId传入0
TXCPlayerAdapter *adapter = [TXCPlayerAdapter shareAdapterWithAppId:0];
通过 getImageLocalUrl 接口获取 imageUrl 的 LocalUrl。
//创建assistor
id<ITXCPlayerAssistorProtocol> assistor = [TXCPlayerAdapter createPlayerAssistor];
//把imageUrl转换成LocalUrl
NSString *localUrl = [assistor getImageLocalUrl:ImageUrl];
使用LocalUrl
//显示图片
[_imageView sd_setImageWithURL:[NSURL URLWithString:localUrl]];
SDK 接口说明
初始化 Adapter
初始化 Adapter，单例。
接口
+ (instancetype)shareAdapterWithAppId:(NSUInteger)appId;
参数说明
appId：填写 appid（如果使用了子应用，则填 subappid，如果是图片解密，则填0）。
销毁 Adapter
销毁 Adapter，当程序退出后调用。
接口
+ (void)destroy;
创建播放器辅助类
通过播放器辅助类可以获取播放 fileId 相关信息以及处理 DRM 加密接口等。
接口
+ (id<ITXCPlayerAssistorProtocol>)createPlayerAssistorWithFileId:(NSString *)fileId
                                                           pSign:(NSString *)pSign;
参数说明
参数名
类型
描述
fileId
String
要播放的视频 fileId
pSign
String
播放器签名
创建图片解密辅助类
通过图片辅助类可以获取加密图片的 localUrl。
接口
+ (id<ITXCPlayerAssistorProtocol>)createPlayerAssistor;
请求视频播放信息
本接口会请求腾讯云点播服务器，获取播放视频的流信息等。
接口
- (void)requestVideoInfo:(ITXCRequestVideoInfoCallback)completion;
参数说明
参数名
类型
描述
completion
ITXCRequestVideoInfoCallback
异步回调函数
获取图片的 localUrl
接口
﻿
/// 请求图片的localUrl接口
﻿
- (NSString *)getImageLocalUrl:(NSString *)imageURL;
销毁播放器辅助类
销毁辅助类，在退出播放器或者切换了下一个视频播放的时候调用。
接口
+ (void)destroyPlayerAssistor:(id<ITXCPlayerAssistorProtocol>)assistor;
获取视频的基本信息
获取视频信息， 必须是在 id<ITXCPlayerAssistorProtocol>.requestVideoInfo 回调之后才生效。
接口
- (TXCVideoBasicInfo *)getVideoBasicInfo;
参数说明
TXCVideoBasicInfo 参数如下：
参数名
类型
描述
name
String
视频名称
size
Int
视频大小，单位：字节
duration
Float
视频时长，单位：秒
description
String
视频描述
coverUrl
String
视频封面
获取视频流信息
获取视频流信息列表，必须是在 id<ITXCPlayerAssistorProtocol>.requestVideoInfo 回调之后才生效。
接口
- (TXCStreamingInfo *)getStreamingInfo;
参数说明
TXCStreamingInfo 参数如下：
参数名
类型
描述
playUrl
String
播放 URL
subStreams
List
自适应码流子流信息，类型为 TXCSubStreamInfo﻿
﻿TXCSubStreamInfo
 参数如下：
参数名
类型
描述
type
String
子流的类型，目前可能的取值仅有 video
width
Int
子流视频的宽，单位：px
height
Int
子流视频的高，单位：px
resolutionName
String
子流视频在播放器中展示的规格名
获取关键帧打点信息
获取视频关键帧打点信息，必须是在 id<ITXCPlayerAssistorProtocol>.requestVideoInfo 回调之后才生效。
接口
- (NSArray<TXCKeyFrameDescInfo *> *)getKeyFrameDescInfos;
参数说明
TXCKeyFrameDescInfo 参数如下：
参数名
类型
描述
timeOffset
Float
1.1
content
String
"片头开始..."
获取缩略图信息
获取缩略图信息，必须是在 id<ITXCPlayerAssistorProtocol>.requestVideoInfo 回调之后才生效。
接口
- (TXCImageSpriteInfo *)getImageSpriteInfo;
参数说明
TXCImageSpriteInfo 参数如下：
参数名
类型
描述
imageUrls
List
缩略图下载 URL 数组，类型为 String
webVttUrl
String
缩略图 VTT 文件下载 URL
﻿
参数名	类型	描述
fileId	String	要播放的视频 fileId
pSign	String	播放器签名
iOS

本页目录：

SDK下载

集成指引

环境要求

组件依赖

使用播放器

使用图片解密

SDK 接口说明

初始化 Adapter

销毁 Adapter

创建播放器辅助类

创建图片解密辅助类

请求视频播放信息

获取图片的 localUrl

销毁播放器辅助类

获取视频的基本信息

获取视频流信息

获取关键帧打点信息

获取缩略图信息
