dito010 / JPVideoPlayer

Automatic play video & cache video data in UITableView like Weibo and Douyin.
http://www.jianshu.com/users/e2f2d779c022/latest_articles
MIT License
2.24k stars 431 forks source link

license pod pod pod

This library provides an video player with cache support in UITableView base on AVPlayer.

Note

This project has abandoned due to personal reason.

由于日常工作比较忙,没有精力继续维护该项目,抱歉。

Features

Requirements

Getting Started

How To Use

01.Play video.

1.1.Mute play video and display progressView on UITableViewCell or any view.


NSURL *url = [NSURL URLWithString:@"http://p11s9kqxf.bkt.clouddn.com/bianche.mp4"];
[aview jp_playVideoMuteWithURL:url
            bufferingIndicator:nil
                  progressView:nil
             configuration:nil];

1.2.Resume mute play from UITableViewController to a detail UIViewControllerwhen user selected a UITableViewCell.


NSURL *url = [NSURL URLWithString:@"http://p11s9kqxf.bkt.clouddn.com/bianche.mp4"];
[aview jp_resumeMutePlayWithURL:url
             bufferingIndicator:nil
                   progressView:nil
              configuration:nil];

1.3.Play video and display controlView & progressView.


NSURL *url = [NSURL URLWithString:@"http://p11s9kqxf.bkt.clouddn.com/bianche.mp4"];
[aview jp_playVideoWithURL:url
        bufferingIndicator:nil
               controlView:nil
              progressView:nil
         configuration:nil];

1.4.Resume play with displaying controlView & progressView.


NSURL *url = [NSURL URLWithString:@"http://p11s9kqxf.bkt.clouddn.com/bianche.mp4"];
[aview jp_resumePlayWithURL:url
         bufferingIndicator:nil
                controlView:nil
               progressView:nil
              configuration:nil];

1.5.Play video without controlView & progressView.


NSURL *url = [NSURL URLWithString:@"http://p11s9kqxf.bkt.clouddn.com/bianche.mp4"];
[aview jp_playVideoWithURL:url
           options:kNilOptions
         configuration:nil];

1.6. Resume play without controlView & progressView.


NSURL *url = [NSURL URLWithString:@"http://p11s9kqxf.bkt.clouddn.com/bianche.mp4"];
[aview jp_resumePlayWithURL:url
            options:kNilOptions
              configuration:nil];

2.Landscape Or Portrait Control

2.1. Go to landscape.


[aview jp_gotoLandscape];

[aview jp_gotoLandscapeAnimated:YES completion:nil];

2.2. Go to portrait.


[aview jp_gotoPortrait];

[aview jp_gotoPortraitAnimated:YES completion:nil];

3. Play video in UITableView like Weibo.

Play video in UITableView support equal height and un-eqaul height cell now, you can use a category method on UITableView directly. You also should set the jp_tableViewVisibleFrame accurately to insure playing video on the cell that closest to the center of the screen.


[tableView jp_playVideoInVisibleCellsIfNeed];

[tableView jp_handleCellUnreachableTypeInVisibleCellsAfterReloadData];

[tableView jp_handleCellUnreachableTypeForCell:cell
                                   atIndexPath:indexPath];

[tableView jp_scrollViewDidScroll];

[tableView jp_scrollViewDidEndDraggingWillDecelerate:decelerate];

[tableView jp_scrollViewDidEndDecelerating];

4. Custom controlView & progressView & bufferingIndicator.

This library offered a basic JPVideoPlayerProgressViewJPVideoPlayerBufferingIndicatorJPVideoPlayerControlView, so you can pass nil in play video method. You can inherit those basic class to custom your own UI, and you also can not inherit it, directly use your own UI, but you must implete the method in JPVideoPlayerControlProgressProtocolJPVideoPlayerBufferingProtocolJPVideoPlayerProtocol.

5. Cache manage.


[JPVideoPlayerCache.sharedCache calculateSizeOnCompletion:^(NSUInteger fileCount, NSUInteger totalSize) {
    // do something.
}];

[JPVideoPlayerCache.sharedCache clearDiskOnCompletion:^{
    // do something
}];

Installation

There are two ways to use JPVideoPlayer in your project:

Installation with CocoaPods

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries in your projects. See the Get Started section for more details.

Podfile

platform :ios, '8.0'
target "YourProjectName" do
pod 'JPVideoPlayer'
end

Communication

Licenses

All source code is licensed under the MIT License.

Architecture