2016-05-27 02:21:04 +00:00
|
|
|
|
# iOS tutorial 5: A Complete media player
|
2016-05-16 14:30:34 +00:00
|
|
|
|
|
2016-06-17 19:32:33 +00:00
|
|
|
|
## Goal
|
|
|
|
|
|
|
|
|
|
|
|
![screenshot0]
|
|
|
|
|
|
![screenshot1]
|
2016-05-16 14:30:34 +00:00
|
|
|
|
|
|
|
|
|
|
This tutorial wants to be the “demo application” that showcases what can
|
|
|
|
|
|
be done with GStreamer on the iOS platform.
|
|
|
|
|
|
|
|
|
|
|
|
It is intended to be built and run, rather than analyzed for its
|
|
|
|
|
|
pedagogical value, since it adds very little GStreamer knowledge over
|
2016-11-05 08:18:49 +00:00
|
|
|
|
what has already been shown in [](tutorials/ios/a-basic-media-player.md).
|
2016-05-16 14:30:34 +00:00
|
|
|
|
|
|
|
|
|
|
It demonstrates the main functionality that a conventional media player
|
|
|
|
|
|
has, but it is not a complete application yet, therefore it has not been
|
|
|
|
|
|
uploaded to the AppStore.
|
|
|
|
|
|
|
2016-06-17 19:32:33 +00:00
|
|
|
|
## Introduction
|
2016-05-16 14:30:34 +00:00
|
|
|
|
|
|
|
|
|
|
The previous tutorial already implemented a basic media player. This one
|
|
|
|
|
|
simply adds a few finishing touches. In particular, it adds the
|
|
|
|
|
|
capability to choose the media to play, and disables the screensaver
|
|
|
|
|
|
during media playback.
|
|
|
|
|
|
|
|
|
|
|
|
These are not features directly related to GStreamer, and are therefore
|
|
|
|
|
|
outside the scope of these tutorials. Only a few implementation pointers
|
|
|
|
|
|
are given here.
|
|
|
|
|
|
|
2016-06-17 19:32:33 +00:00
|
|
|
|
## Selecting the media to play
|
2016-05-16 14:30:34 +00:00
|
|
|
|
|
|
|
|
|
|
A new `UIView` has been added, derived from `UITableViewController`
|
|
|
|
|
|
which shows a list of clips. When one is selected, the
|
2016-11-05 08:18:49 +00:00
|
|
|
|
`VideoViewController` from [](tutorials/ios/a-basic-media-player.md) appears
|
2016-05-16 14:30:34 +00:00
|
|
|
|
and its URI property is set to the URI of the selected clip.
|
|
|
|
|
|
|
|
|
|
|
|
The list of clips is populated from three sources: Media from the
|
|
|
|
|
|
device’s Photo library, Media from the application’s Documents folder
|
|
|
|
|
|
(accessible through iTunes file sharing) and a list of hardcoded
|
|
|
|
|
|
Internet addresses, selected to showcase different container and codec
|
|
|
|
|
|
formats, and a couple of bogus ones, to illustrate error reporting.
|
|
|
|
|
|
|
2016-06-17 19:32:33 +00:00
|
|
|
|
## Preventing the screen from turning off
|
2016-05-16 14:30:34 +00:00
|
|
|
|
|
|
|
|
|
|
While watching a movie, there is typically no user activity. After a
|
|
|
|
|
|
short period of such inactivity, iOS will dim the screen, and then turn
|
2016-06-17 19:32:33 +00:00
|
|
|
|
it off completely. To prevent this, the `idleTimerDisabled` property of
|
|
|
|
|
|
the `UIApplication` class is used. The application sets it to YES
|
2016-05-16 14:30:34 +00:00
|
|
|
|
(screen locking disabled) when the Play button is pressed, so the screen
|
|
|
|
|
|
is never turned off, and sets it back to NO when the Pause button is
|
|
|
|
|
|
pressed.
|
|
|
|
|
|
|
2016-06-17 19:32:33 +00:00
|
|
|
|
## Conclusion
|
2016-05-16 14:30:34 +00:00
|
|
|
|
|
|
|
|
|
|
This finishes the series of iOS tutorials. Each one of the preceding
|
|
|
|
|
|
tutorials has evolved on top of the previous one, showing how to
|
|
|
|
|
|
implement a particular set of features, and concluding in this Tutorial
|
|
|
|
|
|
5. The goal of Tutorial 5 is to build a complete media player which can
|
|
|
|
|
|
already be used to showcase the integration of GStreamer and iOS.
|
|
|
|
|
|
|
2016-06-17 19:32:33 +00:00
|
|
|
|
It has been a pleasure having you here, and see you soon!
|
2016-05-16 14:30:34 +00:00
|
|
|
|
|
2016-11-05 08:18:49 +00:00
|
|
|
|
[screenshot0]: images/tutorials/ios-a-complete-media-player-screenshot-0.png
|
|
|
|
|
|
[screenshot1]: images/tutorials/ios-a-complete-media-player-screenshot-1.png
|
