iOS - IJKPlayer二三事

前言

相信许多iOS开发者都不可避免要接触多媒体的需求。播放器就是其中重要的一环。
关于iOS上的播放器，现有技术方案可以选择的有许多，从简单单一播放功能实现的MPMoviePlayerController，以及可以自定义UI界面，自由度灵活度高的AVPlayer。原生组件下却存在一系列缺点，例如：播放格式兼容性问题，播放监控依赖KVO，能获取的数据限制等等。

令人鼓舞的是，哔哩哔哩开源了他们自家的播放器 - IJKPlayer，播放器底层基于FFMPEG，使用C编写，效率高，并且跨平台。值得肯定。

准备工作

首先从git上下载代码，或者命令行获取也可以。
解压后得到文件以后，打开命令行工具。从git说明文档中可以分别看到iOS端和安卓端的集成方法，这里参照iOS集成方法。

首先第一步cd到目标所在的目录，注意是到解压文件下iOS目录下。
然后执行脚本文件./init-ios.sh
这一步骤其实是下载FFMPEG的组件，根据网络状况吧，组件大概有1G多一些。笔者花了一个小时才下载好。

这一步完成后，接着cd至ios，分别执行两个./compile脚本，这一步是通过对下载好的组件整合打包链接到项目中。

到这，我们就可以运行官方提供的Demo了。Demo中实现的功能比较简单，仅仅作为演示作用。大家可以参考参考。

接入集成

这一步有两个方法，第一种是按照官方的方法，把SDK，add files 到工程里，优点是随时可以在工程里根据自己需求修改SDK的代码，缺点是，Xcode在这种引入下，提示性极差，引入头文件要靠自己敲，并且如果同时打开两个都引用了的工程，会出现后打开的工程无法读取SDK的问题。此方法只是引用地址，并不是文件拷贝，add files完毕之后，SDK还在原来的地方。
第二种方法是将SDK打包成FrameWork的方法，缺点就是SDK完全封闭，日后更新代码，修改代码都必须重新打包。

考虑到工程管理的易用性，在这里笔者选择的是第二种方法。将文件打包成Framework的方法网上已经很多，在这里不赘述。

到这一步完毕，将的到的framwork文件放到工程里，然后添加相应的依赖库。

值得一提的是，IJK提供了两个基于原生组件封装的player，分别是 IJKAVMoviePlayerController 和 IJKMPMoivePlayerController
在播放需求单一，或者业务场景要求简单的时候完全可以采用这两个播放器，一来系统硬解速度快，占用资源小，省电等优点。二来使用起来简洁方便。利用构造方法直接创建播放器就可。

主要的头文件是IJKMediaFramework，在需要的地方导入即可。

其中，IJKFFMonitor是监控类，可以提供fps，码率，网络状况，视频尺寸等信息。

IJKFFMoviePlayerController是播放器类，这个类就是我们主要使用的播放器，基于FFMPEG的软解码播放器。

IJKFFOptions是视频配置类，在初始化播放器的时候，为播放器提供设置的类。

IJKMediaPlayback这个类是播放控制类。提供了播放控制，诸如暂停，开始，停止等播放操作。IJK将播放控制写成了IJKMediaPlayback协议。在我们自己的代码中实现协议即可控制播放器的行为。

使用

• 创建一个播放器

#ifdef DEBUG
    //debug日志模式
    [IJKFFMoviePlayerController setLogReport:YES];
    [IJKFFMoviePlayerController setLogLevel:k_IJK_LOG_DEBUG];
#else
    [IJKFFMoviePlayerController setLogReport:NO];
    [IJKFFMoviePlayerController setLogLevel:k_IJK_LOG_INFO];
#endif
    [IJKFFMoviePlayerController checkIfFFmpegVersionMatch:YES];
    // IJKFFOptions 是对视频的配置信息
    IJKFFOptions *options = [IJKFFOptions optionsByDefault];
    // 配置Player //self.videoURL是视频地址
    _ijkPlayer = [[IJKFFMoviePlayerController alloc] initWithContentURL:self.videoURL withOptions:options];
    _ijkPlayer.view.autoresizingMask = UIViewAutoresizingFlexibleWidth |UIViewAutoresizingFlexibleHeight;
    _ijkPlayer.view.frame = self.bounds;
    _ijkPlayer.scalingMode = self.videoGravity;//控制视频填充模式
    _ijkPlayer.shouldAutoplay = YES;
    [self insertSubview:_ijkPlayer.view atIndex:0];
    [_ijkPlayer prepareToPlay];
    [_ijkPlayer play]
    }

其中VideoURL支持本地和网络，根据需要传入即可
注意，播放器有一个prepareToPlay准备播放方法，记得在播放之前调用。
播放的视图可以通过.view获取到。

• 获取并监控播放器
  IJK使用通知来反馈播放状态。主要以下几个通知

[[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(loadStateDidChange:)
                                                 name:IJKMPMoviePlayerLoadStateDidChangeNotification
                                               object:_ijkPlayer];
    
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(moviePlayBackDidFinish:)
                                                 name:IJKMPMoviePlayerPlaybackDidFinishNotification
                                               object:_ijkPlayer];
    
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(mediaIsPreparedToPlayDidChange:)
                                                 name:IJKMPMediaPlaybackIsPreparedToPlayDidChangeNotification
                                               object:_ijkPlayer];
    
    [[NSNotificationCenter defaultCenter] addObserver:self
                                             selector:@selector(moviePlayBackStateDidChange:)
                                                 name:IJKMPMoviePlayerPlaybackStateDidChangeNotification
                                               object:_ijkPlayer];

首先第一个通知IJKMPMoviePlayerLoadStateDidChangeNotification，返回的缓冲的状态。MPMovieLoadStateStalled表示正在缓冲中，可以在这个状态下加入加载视图，缓冲动画等。MPMovieLoadStatePlaythroughOK代表缓冲完成，可以在这里去移除加载视图。

- (void)loadStateDidChange:(NSNotification*)notification
{
    //    MPMovieLoadStateUnknown        = 0,
    //    MPMovieLoadStatePlayable       = 1 << 0,
    //    MPMovieLoadStatePlaythroughOK  = 1 << 1, // Playback will be automatically started in this state when shouldAutoplay is YES
    //    MPMovieLoadStateStalled        = 1 << 2, // Playback will be automatically paused in this state, if started
    
    IJKMPMovieLoadState loadState = _ijkPlayer.loadState;
    
    if ((loadState & IJKMPMovieLoadStatePlaythroughOK) != 0 || (loadState & MPMovieLoadStatePlayable) != 0) {
        //缓冲完成
        NSLog(@"loadStateDidChange: IJKMPMovieLoadStatePlaythroughOK: %d\n", (int)loadState);
        
    }
    else if ((loadState & IJKMPMovieLoadStateStalled) != 0) {
        //缓冲开始
        NSLog(@"loadStateDidChange: IJKMPMovieLoadStateStalled: %d\n", (int)loadState);
    }
    else {
        NSLog(@"loadStateDidChange: ???: %d\n", (int)loadState);
    }
}

第二个通知IJKMPMoviePlayerPlaybackDidFinishNotification,返回的是播放结束。IJK并没有准备播放错误之类的状态，如果播放结束，不管是以什么情况结束（自然播放结束，用户人为结束，发生错误崩溃结束），都会进入这个方法，我们可以从这个方法中去做相应操作。

- (void)moviePlayBackDidFinish:(NSNotification*)notification
{
    //    MPMovieFinishReasonPlaybackEnded,
    //    MPMovieFinishReasonPlaybackError,
    //    MPMovieFinishReasonUserExited
    int reason = [[[notification userInfo] valueForKey:IJKMPMoviePlayerPlaybackDidFinishReasonUserInfoKey] intValue];
    switch (reason)
    {
        case IJKMPMovieFinishReasonPlaybackEnded:
            NSLog(@"playbackStateDidChange: IJKMPMovieFinishReasonPlaybackEnded: %d\n", reason);
            
            break;
            
        case IJKMPMovieFinishReasonUserExited:
            NSLog(@"playbackStateDidChange: IJKMPMovieFinishReasonUserExited: %d\n", reason);
            break;
            
        case IJKMPMovieFinishReasonPlaybackError:
            NSLog(@"playbackStateDidChange: IJKMPMovieFinishReasonPlaybackError: %d\n", reason);
            break;
            
        default:
            NSLog(@"playbackPlayBackDidFinish: ???: %d\n", reason);
            break;
    }
}

第三个通知IJKMPMoviePlayerPlaybackStateDidChangeNotification,会返回播放状态。在这个通知下我们可以根据状态来做UI的更新。

- (void)moviePlayBackStateDidChange:(NSNotification*)notification
{
    //    MPMoviePlaybackStateStopped,
    //    MPMoviePlaybackStatePlaying,
    //    MPMoviePlaybackStatePaused,
    //    MPMoviePlaybackStateInterrupted,
    //    MPMoviePlaybackStateSeekingForward,
    //    MPMoviePlaybackStateSeekingBackward
    
    switch (_ijkPlayer.playbackState)
    {
        case IJKMPMoviePlaybackStateStopped: {
            NSLog(@"IJKMPMoviePlayBackStateDidChange %d: stoped", (int)_ijkPlayer.playbackState);
            break;
        }
        case IJKMPMoviePlaybackStatePlaying: {
            NSLog(@"IJKMPMoviePlayBackStateDidChange %d: playing", (int)_ijkPlayer.playbackState);
            break;
        }
        case IJKMPMoviePlaybackStatePaused: {
            NSLog(@"IJKMPMoviePlayBackStateDidChange %d: paused", (int)_ijkPlayer.playbackState);
            break;
        }
        case IJKMPMoviePlaybackStateInterrupted: {
            NSLog(@"IJKMPMoviePlayBackStateDidChange %d: interrupted", (int)_ijkPlayer.playbackState);
            break;
        }
        case IJKMPMoviePlaybackStateSeekingForward:
        case IJKMPMoviePlaybackStateSeekingBackward: {
            NSLog(@"IJKMPMoviePlayBackStateDidChange %d: seeking", (int)_ijkPlayer.playbackState);
            break;
        }
        default: {
            NSLog(@"IJKMPMoviePlayBackStateDidChange %d: unknown", (int)_ijkPlayer.playbackState);
            break;
        }
    }
}

第四个通知IJKMPMediaPlaybackIsPreparedToPlayDidChangeNotification,这个通知会在准备播放完毕后调用。例如，播放器有预览图，点击播放按钮后，准备完毕开始播放的时候进入这个方法中可以把预览图移除。

• one more thing
  1，播放器不支持切换URL，如果有切换播放源的需求，需要移除播放器后，重新构造一个新的播放器。
  2，由于1的问题，移除播放器的时候，需要调用shutdown方法来移除，另外要注意循环引用，否则会出现各种问题。
  3，快进快退调用的方法是setCurrentPlaybackTime，需要的参数是NSInteger。
  4，对解码有需求，可以从IJKFFOptions入手。