本章节为您介绍拉流基础功能的接入方法，根据文档提供的操作步骤进行配置，您可接入直播拉流播放控制能力。

前提条件 #

已集成并初始化 iOS 拉流 SDK。详见集成 iOS 拉流 SDK 和初始化 iOS 拉流 SDK。

注意事项 #

真机调试：由于 SDK 使用了大量 iOS 系统的音视频接口，这些接口在模拟器下可能会出现异常，推荐您使用真机进行代码调试。

功能接入 #

本节为您详细介绍如何通过拉流 SDK 实现直播拉流播放控制的能力，包括但不限于创建播放器、初始化配置、事件监听、配置渲染 View、配置播放地址。

创建播放器 #

iOS 拉流 SDK 的播放器类为 TVLManager。您可以参考以下代码创建播放器。

// 创建播放器
TVLManager *livePlayer = [[TVLManager alloc] init];

初始化配置 #

您可以通过 VeLivePlayerConfiguration 配置播放器的初始化参数，并调用 setConfig: 接口应用配置。请在调用 play 接口前完成播放器初始化配置。详细参数说明如下表所示。

您可以参考以下代码示例进行初始化配置。

// 创建配置
VeLivePlayerConfiguration *config = [[VeLivePlayerConfiguration alloc] init];
// 打开周期性回调
config.enableStatisticsCallback = YES;
// 打开 Local DNS 预解析
config.enableLiveDNS = YES;
// 初始化播放器
[self.livePlayer setConfig:config];

配置事件监听 #

您可以调用 setObserver: 接口设置播放器回调，并通过 VeLivePlayerObserver 监听播放器状态、错误信息、音视频首帧事件以及周期性统计数据等。请在调用 play 接口前完成配置。代码示例如下所示。

1. 配置播放器回调。

   @interface VeLivePullViewController () <VeLivePlayerObserver>
   @end
   
   // 配置播放器回调
   [self.livePlayer setObserver:self];
   

2. 播放器回调处理。

   - (void)onError:(TVLManager *)player error:(VeLivePlayerError *)error {
       // 错误回调
   }
   
   - (void)onInfo:(TVLManager *)player info:(VeLivePlayerError *)info {
       // 播放器信息回调
   }
   
   - (void)onFirstVideoFrameRender:(TVLManager *)player isFirstFrame:(BOOL)isFirstFrame {
       // 视频首帧回调
   }
   
   - (void)onFirstAudioFrameRender:(TVLManager *)player isFirstFrame:(BOOL)isFirstFrame {
       // 音频首帧回调
   }
   
   - (void)onStallStart:(TVLManager *)player {
       // 卡顿开始回调
   }
   
   - (void)onStallEnd:(TVLManager *)player {
       // 卡顿结束回调
   }
   
   - (void)onVideoRenderStall:(TVLManager *)player stallTime:(int64_t)stallTime  {
       // 视频卡顿回调
   }
   
   - (void)onAudioRenderStall:(TVLManager *)player stallTime:(int64_t)stallTime  {
       // 音频卡顿回调
   }
   
   - (void)onResolutionSwitch:(TVLManager *)player resolution:(VeLivePlayerResolution)resolution error:(VeLivePlayerError *)error reason:(VeLivePlayerResolutionSwitchReason)reason  {
       // 播放档位变化回调
   }
   
   - (void)onVideoSizeChanged:(TVLManager *)player width:(int)width height:(int)height  {
       // 分辨率变化回调
   }
   
   - (void)onReceiveSeiMessage:(TVLManager *)player message:(NSString *)message  {
       // 字符串 SEI 消息回调
   }
   
   - (void)onReceiveBinarySeiMessage:(TVLManager *)player message:(NSData *)message  {
       // 二进制 SEI 消息回调。需先开启 enableBinarySei，开启后字符串 SEI 消息回调不再触发
   }
   
   - (void)onMainBackupSwitch:(TVLManager *)player streamType:(VeLivePlayerStreamType)streamType error:(VeLivePlayerError *)error  {
       // 主备切换回调
   }
   
   - (void)onStreamFormatSwitch:(TVLManager *)player fromStreamFormat:(VeLivePlayerFormat)fromStreamType toStreamFormat:(VeLivePlayerFormat)toStreamType error:(VeLivePlayerError *)error extraInfo:(NSDictionary *)extraInfo {
       // 流格式切换回调
   }
   
   - (void)onPlayerStatusUpdate:(TVLManager *)player status:(VeLivePlayerStatus)status  {
       // 播放器状态变化回调
   }
   
   - (void)onPlayerStatusUpdate:(TVLManager *)player status:(VeLivePlayerStatus)status extraInfo:(NSDictionary *)extraInfo  {
       // 播放器状态变化回调，包含当前播放流的补充信息
   }
   
   - (void)onStatistics:(TVLManager *)player statistics:(VeLivePlayerStatistics *)statistics {
       // 周期性回调
   }
   
   - (void)onSnapshotComplete:(TVLManager *)player image:(UIImage *)image  {
       // 截图回调
   }
   
   - (void)onRenderVideoFrame:(TVLManager *)player videoFrame:(VeLivePlayerVideoFrame *)videoFrame  {
       // 视频帧订阅回调
   }
   
   - (void)onRenderAudioFrame:(TVLManager *)player audioFrame:(VeLivePlayerAudioFrame *)audioFrame  {
       // 音频帧订阅回调
   }
   
   - (void)onStreamFailedOpenSuperResolution:(TVLManager *)player error:(VeLivePlayerError *)error {
       // 超分开启失败回调
   }
   

配置渲染 View #

播放器的视图以 UIView 的形式呈现，内部会创建一个 playerView，视频播放时会在该 playerView 上进行渲染。使用时，只需将 playerView 添加到您的自定义 UIView 上即可。

// 配置 Metal 渲染
self.livePlayer.playerViewRenderType = TVLPlayerViewRenderTypeMetal;

// 配置 playerView 尺寸
self.livePlayer.playerView.frame = UIScreen.mainScreen.bounds;

// 将 playerView 添加到您的自定义 view 上
[self.view addSubview:self.livePlayer.playerView];

配置播放地址 #

通过 setPlayUrl: 接口配置单一播放地址，支持 RTMP、FLV、HLS 等直播协议地址。调用该接口时，请将示例地址替换为实际的直播播放地址，并在调用 play 接口前完成配置。代码示例如下所示。

NSString *playUrl = @"http://pull.example.com/live/stream.flv";
[self.livePlayer setPlayUrl:playUrl]; // 配置播放地址

调整播放画面 #

您可以通过以下接口调整播放画面的填充模式、镜像和旋转角度，以获得更好的观看体验。

配置填充模式

通过播放器的 setRenderFillMode: 接口可以配置播放画面的填充模式，播放器支持以下 3 种填充模式。

您可以参考以下代码示例配置填充模式。

// 配置填充模式
[self.livePlayer setRenderFillMode:VeLivePlayerFillModeAspectFill];

配置镜像

通过播放器的 setRenderMirror: 接口可以配置播放画面的镜像模式，播放器支持以下 3 种镜像模式。

您可以参考以下代码示例配置镜像。

// 配置水平镜像
[self.livePlayer setRenderMirror:VeLivePlayerMirrorHorizontal];

配置旋转

通过播放器的 setRenderRotation: 接口可以配置播放画面的旋转角度，播放器支持以下 4 种旋转角度。

您可以参考以下代码示例配置旋转角度。

// 配置画面旋转 90 度
[self.livePlayer setRenderRotation:VeLivePlayerRotation90];

开始播放 #

调用播放器的 play 接口开始播放。代码示例如下所示。

[self.livePlayer play]; // 开始播放

调用播放器的 isPlaying 接口可以获取当前的播放状态。代码示例如下所示。

BOOL isPlaying = [self.livePlayer isPlaying]; // 获取播放状态

停止播放 #

调用播放器的 stop 接口停止播放。调用该接口不会销毁播放器。代码示例如下所示。

[self.livePlayer stop]; // 停止播放

销毁播放器 #

停止播放后，如不再使用播放器，调用 destroy 接口销毁播放器并释放内存。代码示例如下所示。

[self.livePlayer destroy]; // 销毁播放器并释放相关内存

前后台切换 #

应用进入后台后，播放器默认会继续播放音频。如不希望音频在后台继续播放，请在应用进入后台时停止播放，并在应用回到前台时恢复播放。代码示例如下所示。

// 应用回到前台通知
[NSNotificationCenter.defaultCenter addObserver:self
                  selector:@selector(applicationDidBecomeActive:)
            name:UIApplicationDidBecomeActiveNotification
            object:nil];
// 应用进入后台通知
[NSNotificationCenter.defaultCenter addObserver:self
                  selector:@selector(applicationWillResignActive:)
                  name:UIApplicationWillResignActiveNotification
            object:nil];

- (void)applicationDidBecomeActive:(NSNotification *)notification {
    [self.livePlayer play]; // 应用回到前台，继续播放
}

// 退到后台处理
- (void)applicationWillResignActive:(NSNotification *)notification {
    [self.livePlayer stop]; // 应用进入后台，停止播放
}

静音配置 #

调用播放器的 setMute: 接口可以控制是否静音播放。代码示例如下所示。

[self.livePlayer setMute:YES]; // 配置静音播放

调用播放器的 isMute 接口可以获取当前是否为静音状态。代码示例如下所示。

BOOL isMute = [self.livePlayer isMute]; // 获取静音状态

配置播放音量 #

设置播放器的 volume 属性可以控制播放音量。该属性的默认值为 1.0，取值范围为 [0.0, 1.0]。代码示例如下所示。

[self.livePlayer setVolume:0.5]; // 配置播放音量

日志级别 #

您可以通过调用 setLogLevel: 设置打印到控制台的日志级别，代码示例如下：

// 输出 INFO、WARNING 和 ERROR 级别的日志
[TVLManager setLogLevel:VeLivePlayerLogLevelInfo];