Play small mp4 videos with alpha background on iOS. TSHAlphaVideos is powerful, performant and easy to use.
This video is 53kb, way smaller than a PNG series or mov.
If you're on CocoaPods (which you should be), then add this line to your Podfile:
pod 'TSHAlphaVideos'Otherwise just drag and drop the files from here into your project.
Either way, you'll also want to get a copy of alpha_video.rake in your rake path.
You'll want to start with an .mov file that has alpha-channel. AVPlayer would play this file directly, but doing so would likely require bundling or downloading a very large file -- movs with alpha can often approach 100MB per minute or more.
Export your .mov premultiplied (matted) from AfterEffects or your video rendering software of choice. (In AfterEffects, choose the Animation codec which supports alpha, not H264 or any of the others)
Then, with alpha_video.rake in your rake path, run
rake split_mov /path/to/matted/my_awesome_video.movYou'll be prompted to install two dependencies 1 2. The second dependency, AVAnimatorUtils, will require you to download the tarball manually and include the executables in your $PATH
Once you get those installed, the script should run and poop out a set of resulting files. These will look like:
my_awesome_video_audio.wav
my_awesome_video_alpha.mp4
my_awesome_video_rgb.mp4
my_awesome_video_no_audio.mp4
my_awesome_video.mp4
If you don't have the final composited version, that's because your video had no audio. Simply use the composited *_no_audio.mp4 instead. Either way, this will be the file you include in your app bundle.
This file should be significantly smaller than your .mov, perhaps by a factor of 100 or more.
Now that you have your composited side-by-side RGB and Alpha channels, we'll use TSHAlphaVideos to show them to your users. This is a very simple process, as simple as adding a UIImageView to the screen.
TSHAlphaVideoController *myAwesomeVideo = [TSHAlphaVideoController videoWithRGBVideoFile:@"my_awesome_video"
withDelegate:self];
[self.view addSubview:myAwesomeVideo.view];
[myAwesomeVideo play];That's it. TSHAlphaVideoController has a few more configuration flags, like repeats and stopInsteadOfPauseWhenViewEntersBackground that can be set before calling play. The view will be properly sized according to the video file.
The TSHAlphaVideoDelegate responds to a number of useful messages, all optional:
- (void)alphaVideoWillPlay:(TSHAlphaVideoController *)alphaVideo;
- (void)alphaVideoDidPlay:(TSHAlphaVideoController *)alphaVideo;
- (void) alphaVideo:(TSHAlphaVideoController *)alphaVideo
didPlayFrameAtTimeInterval:(NSTimeInterval)timeInterval
previousTimeInterval:(NSTimeInterval)previousTimeInterval;
- (BOOL)alphaVideoShouldStop:(TSHAlphaVideoController *)alphaVideo;
- (void)alphaVideoWillStop:(TSHAlphaVideoController *)alphaVideo;
- (void)alphaVideoDidStop:(TSHAlphaVideoController *)alphaVideo;
- (void)memoryWarningStoppedVideo:(TSHAlphaVideoController *)alphaVideo;