https://github.com/irons163/irplayer
IRPlayer is a powerful video player framework for iOS.
https://github.com/irons163/irplayer
360-video fisheye ios ipcamera media objective-c player video video-player-framework videoplayer vr
Last synced: about 1 year ago
JSON representation
IRPlayer is a powerful video player framework for iOS.
- Host: GitHub
- URL: https://github.com/irons163/irplayer
- Owner: irons163
- License: mit
- Created: 2019-08-29T09:00:56.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2025-01-27T03:40:50.000Z (over 1 year ago)
- Last Synced: 2025-04-15T12:14:11.413Z (about 1 year ago)
- Topics: 360-video, fisheye, ios, ipcamera, media, objective-c, player, video, video-player-framework, videoplayer, vr
- Language: Objective-C
- Homepage:
- Size: 270 MB
- Stars: 16
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# IRPlayer
### IRPlayer is a powerful video player framework for iOS.
### Swift version in here: [IRPlayer-swift](https://github.com/irons163/IRPlayer-swift)
### This objc project will soon be no longer maintaining.
- Use IRPlayer to play video.
- See demo.
- Use IRPlayer to make video player with custom UI.
- See [IRPlayerUIShell](https://github.com/irons163/IRPlayerUIShell)
- Use IRPlayer to play IP Camera stream.
- See [IRIPCamera](https://github.com/irons163/IRIPCamera)
## Features
- Support Normal video mode.
- Support VR mode.
- Support VR Box mode.
- Support Fisheye mode.
- Support Normal Fisheye mode.
- Support Fisheye to Panorama mode.
- Support Fisheye to Perspective mode.
- Support multi windows.
- Support multi modes selection.
- 0.3.6
- Support set the specific renders to each mode.
- Support custom video input(IRFFVideoInput). See what it works in [IRIPCamera](https://github.com/irons163/IRIPCamera).
- Support custom display view(inherit IRGLView). See what it works in [IREffectPlayer](https://github.com/irons163/IREffectPlayer).
## Install
### Cocoapods
- Add `pod 'IRPlayer', '~> 0.3.2'` in the `Podfile`
- `pod install`
## Usage
- more examples in the demo applications.
### Basic
```obj-c
self.player = [IRPlayerImp player];
[self.mainView insertSubview:self.player.view atIndex:0];
NSURL * normalVideo = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:@"i-see-fire" ofType:@"mp4"]];
NSURL * vrVideo = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:@"google-help-vr" ofType:@"mp4"]];
NSURL * fisheyeVideo = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:@"fisheye-demo" ofType:@"mp4"]];
```
#### Set mode and video source
``` obj-c
switch (self.demoType)
{
case DemoType_AVPlayer_Normal:
[self.player replaceVideoWithURL:normalVideo];
break;
case DemoType_AVPlayer_VR:
[self.player replaceVideoWithURL:vrVideo videoType:IRVideoTypeVR];
break;
case DemoType_AVPlayer_VR_Box:
self.player.displayMode = IRDisplayModeBox;
[self.player replaceVideoWithURL:vrVideo videoType:IRVideoTypeVR];
break;
case DemoType_FFmpeg_Normal:
self.player.decoder.mpeg4Format = IRDecoderTypeFFmpeg;
self.player.decoder.ffmpegHardwareDecoderEnable = NO;
[self.player replaceVideoWithURL:normalVideo];
break;
case DemoType_FFmpeg_Normal_Hardware:
self.player.decoder = [IRPlayerDecoder FFmpegDecoder];
[self.player replaceVideoWithURL:normalVideo];
break;
case DemoType_FFmpeg_Fisheye_Hardware:
self.player.decoder = [IRPlayerDecoder FFmpegDecoder];
[self.player replaceVideoWithURL:fisheyeVideo videoType:IRVideoTypeFisheye];
break;
case DemoType_FFmpeg_Fisheye_Hardware_Modes_Selection:
self.player.decoder = [IRPlayerDecoder FFmpegDecoder];
[self.player replaceVideoWithURL:fisheyeVideo videoType:IRVideoTypeFisheye];
break;
}
```
#### Set custom video source
- See what it works in [IRIPCamera](https://github.com/irons163/IRIPCamera).
``` obj-c
IRFFVideoInput *input = [[IRFFVideoInput alloc] init];
[self.player replaceVideoWithInput:input videoType:IRVideoTypeNormal];
...
IRFFAVYUVVideoFrame * yuvFrame = [[IRFFAVYUVVideoFrame alloc] init];
/*
setup the yuvFrame.
*/
[input updateFrame:frame];
```
### Advanced settings
```obj-c
NSArray *modes = [self createFisheyeModesWithParameter:nil];
self.player.renderModes = modes;
[self.player replaceVideoWithURL:fisheyeVideo videoType:IRVideoTypeCustom];
- (NSArray *)createFisheyeModesWithParameter:(nullable IRMediaParameter *)parameter {
IRGLRenderMode *normal = [[IRGLRenderMode2D alloc] init];
IRGLRenderMode *fisheye2Pano = [[IRGLRenderMode2DFisheye2Pano alloc] init];
IRGLRenderMode *fisheye = [[IRGLRenderMode3DFisheye alloc] init];
IRGLRenderMode *fisheye4P = [[IRGLRenderModeMulti4P alloc] init];
NSArray* modes = @[
fisheye2Pano,
fisheye,
fisheye4P,
normal
];
normal.shiftController.enabled = NO;
fisheye2Pano.contentMode = IRGLRenderContentModeScaleAspectFill;
fisheye2Pano.wideDegreeX = 360;
fisheye2Pano.wideDegreeY = 20;
fisheye4P.parameter = fisheye.parameter = [[IRFisheyeParameter alloc] initWithWidth:0 height:0 up:NO rx:0 ry:0 cx:0 cy:0 latmax:80];
fisheye4P.aspect = fisheye.aspect = 16.0 / 9.0;
normal.name = @"Rawdata";
fisheye2Pano.name = @"Panorama";
fisheye.name = @"Onelen";
fisheye4P.name = @"Fourlens";
return modes;
}
```
## Screenshots
| Normal | VR |
|:---:|:---:|
|  |  |
| VR Box| Fisheye 360 |
|  |  |
| Panorama| Modes Selection |
|  |  |
| Multi Windows | |
| | |
## Copyright
##### This project has some basic codes from [SGPlayer](https://github.com/libobjc/SGPlayer).
Copyright for portions of project IRPlayer are held by Single, 2017.
All other copyright for project IRPlayer are held by irons163, 2019.