/JPVideoPlayer

Automatic play video & cache video data in UITableView like Weibo and Douyin.

Primary LanguageObjective-CMIT LicenseMIT

license pod pod pod

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

Features

  • Cache video data at playing.
  • Seek time support(new).
  • Breakpoint continuingly support(new).
  • Landscape auto-layout support(new).
  • Custom player controlView support(new).
  • Excellent performance!
  • A guarantee that the same URL won't be downloaded several times
  • A guarantee that main thread will never be blocked
  • Location video play support
  • Swift support

Requirements

  • iOS 8.0 or later
  • Xcode 7.3 or later

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
       configurationCompletion: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
        configurationCompletion: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
   configurationCompletion: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
    configurationCompletion: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
   configurationCompletion: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
    configurationCompletion: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:

  • using CocoaPods
  • by cloning the project into your repository

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

  • If you found a bug, open an issue please.
  • If you have a feature request, open an issue please.
  • If you want to contribute, submit a pull request please.

Licenses

All source code is licensed under the MIT License.

Architecture