gstreamer/subprojects/gst-docs/markdown/tutorials/ios/a-complete-media-player.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

65 lines
2.6 KiB
Markdown
Raw Normal View History

# 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
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
`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
devices Photo library, Media from the applications 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
[screenshot0]: images/tutorials/ios-a-complete-media-player-screenshot-0.png
[screenshot1]: images/tutorials/ios-a-complete-media-player-screenshot-1.png