One thing that was always a cool idea was playing cinematics and, intro movies in an iPhone game. Up until now there have been people planning to add it but i had already started so here it is.

Notes

The code is asynchronous - Meaning that the game/other stuff still runs in the background. This is great for loading stuff in the background while the movie is playing :) One thing i will add is that a movieID will be returned, and call the console function for movieDidFinishPlayback(%ID), so that you can time things better.

Todo
make it use ~/ paths.
maybe add datablocks for videos

"Installation"

Step 1 : , you need to add the two files to your project tree.






Step 2 : , you need to add the MediaPlayer Framework.

On the target -> Right click -> Get Info
Select the general tab
Make sure you are adding from the iPhoneOS SDK




Step 3 : , Build and go.

Usage

NO EXTENSION is passed in, m4v is the only one atm, it looks in the bundle based on the file name, starting at / (which is "Resources" in XCode.

Someone asked about it being modal and not dismissable, if you set the controlsMode to hidden or volume only there is no way to dismiss the movie (meaning you can force them to watch it). The other thing i will add is the callback for handling when they are attempting to dismiss the video from modal mode as well - So that you can perhaps show another loading screen if your background loading is not complete.

There is only one function needed. The scalemode and controlMode are from the OS :

For scaling - None, Aspect Fit, Aspect Fill, Fill
For controls - Default controls, Volume Only, Hidden

Code side :

//If you going to code it, just look at the parameters in the code :)
#include "platformiPhone/iPhoneMoviePlayback.h"

playMovie(...);

Script Side

//You will have to use numbers or constants here for now
playiPhoneMovie( %filename, %scaleMode, %controlMode );

Creating a movie for the game

Quite simple , just use iTunes.

Step 1 : ,

Add a video file by opening it in iTunes


Step 2 : ,

Change the view to be this view, so you can see the "Movies" tab on the left, and the items in a list format.


Step 3 : ,

Right click the video and convert it to iPhone/iPod version





Always check the settings!


Step 4 : ,

Rinse and repeat :)

Downloads

Download