Deprecated MPMoviePlayerController Methods

A method identified as deprecated has been superseded and may become unsupported in the future.

Available in iOS 2.0 through iOS 3.1

backgroundColor

The color of the background area behind the movie. (Available in iOS 2.0 through iOS 3.1. Get the view from the backgroundView property and set its color directly.)

@property (nonatomic, retain) UIColor *backgroundColor
Discussion

You should avoid using this property. It is available only when you use the initWithContentURL: method to initialize the movie player controller object.

The receiver fades to and from the background color when transitioning to and from playback. Whenever the movie does not fill the screen exactly, this color is used to fill the area between the movie’s frame and the edges of the screen.

The default color for this property is black. You can change this to other colors (including clear) to provide a more appropriate transition from your app’s content to the movie content.

Availability
  • Available in iOS 2.0 through iOS 3.1.
Declared In
MPMoviePlayerController.h

movieControlMode

The user controls to display. (Available in iOS 2.0 through iOS 3.1. Use the controlStyle property instead.)

@property (nonatomic) MPMovieControlMode movieControlMode
Discussion

Avoid using this property. It is available only when you use the initWithContentURL: method to initialize the movie player controller object.

Determines the control (if any) the user has over movie playback. Different modes give the user access to different sets of playback controls, some of which allow the user to pause and resume playback and some of which do not.

This property is set to MPMovieControlModeDefault by default. See the “MPMovieControlMode” enumeration for the available control modes.

Availability
  • Available in iOS 2.0 through iOS 3.1.
Declared In
MPMoviePlayerController.h

Deprecated in iOS 6.0

useApplicationAudioSession

A Boolean value that indicates whether the movie player should use the app’s audio session. (Deprecated in iOS 6.0. There is not replacement for this property and its use is discouraged.)

@property (nonatomic) BOOL useApplicationAudioSession
Discussion

The default value of this property is YES. Setting this property to NO causes the movie player to use a system-supplied audio session with a non-mixable playback category.

When this property is YES, the movie player shares the app’s audio session. This give you control over how the movie player content interacts with your audio and with audio from other apps, such as the iPod. For important guidance on using this feature, see “Working with Movies and iPod Music” in Audio Session Programming Guide.

Changing the value of this property does not affect the currently playing movie. For the new setting to take effect, you must stop playback and then start it again.

Special Considerations

In iOS 3.1 and earlier, a movie player always uses a system-supplied audio session. To obtain that same behavior in iOS 3.2 and newer, you must set this property’s value to NO.

Availability
  • Available in iOS 3.2 and later.
  • Deprecated in iOS 6.0.
Related Sample Code
Declared In
MPMoviePlayerController.h

Deprecated in iOS 7.0

thumbnailImageAtTime:timeOption:

Captures and returns a thumbnail image from the current movie. (Deprecated in iOS 7.0.)

- (UIImage *)thumbnailImageAtTime:(NSTimeInterval)playbackTime timeOption:(MPMovieTimeOption)option
Parameters
playbackTime

The time at which to capture the thumbnail image. The time value represents the number of seconds from the beginning of the current movie.

option

The option to use when determining which specific frame to use for the thumbnail image. For a list of possible values, see “MPMovieTimeOption.”

Return Value

An image object containing the image from the movie or nil if the thumbnail could not be captured.

Discussion

This method captures the thumbnail image synchronously from the current movie (which is accessible from the MPMovieSourceTypeUnknown property).

Availability
  • Available in iOS 3.2 and later.
  • Deprecated in iOS 7.0.
Declared In
MPMoviePlayerController.h