Helix media activity: Difference between revisions

From OLPC
Jump to navigation Jump to search
Line 1: Line 1:
=Helix "Watch & Listen" Media Activity =
=Helix "Watch & Listen" Media Activity =


This activity should still be considered ALPHA.
These release notes relate to the "Watch & Listen-1.xo" release

These notes relate to the "Watch & Listen-1.xo" release
of the activity. Currently, the activity is bundled with the
of the activity. Currently, the activity is bundled with the
Helix media engine all in one package for easy installation.
Helix media engine all in one package for easy installation.
Line 7: Line 9:
access to it will be moved to a location allowing easy access
access to it will be moved to a location allowing easy access
from any activity.
from any activity.

==Helix "Watch & Listen" Media Activity Version 1 Installation Notes==

* Download the activity (see the [http://dev.laptop.org/ticket/1205 ticket] for instructions). Then just unzip the activity in /home/olpc/Activities. Restart Sugar.
* Play the test clip via the open location button (see below): rtsp://judas.osuosl.org/olpc.smil clip.



==Helix "Watch & Listen" Media Activity Version 1 Usage Notes==
==Helix "Watch & Listen" Media Activity Version 1 Usage Notes==
Line 25: Line 33:
* Open Location button, this allows you to type in streaming links.
* Open Location button, this allows you to type in streaming links.


The activity has not been tested much, but this version of the engine should support:


* 3GPP-Rel6 file parsing and 3GPP-Rel6 audio and video playback
==Helix "Watch & Listen" Media Activity Version 1 Release Notes==
* 3G2 audio depacketizers and QCelp decoder hooks
* AAC and aacPlus decoder - More info
* AAC and aacPlus playback from .3gp, .m4a, .aac or .ra files and 3GPP, ISMA or ice-cast streams
* AMR-NB and AMR-WB audio playback from .3gp and .amr files and 3GPP streams
* H.261 video from standard RTP streams
* H.263 video from .3gp files and standard RTP streams
* H.264 video from .3gp files and standard H.264 RTP streams
* I420 video rendering
* MJPEG video playback from .avi files
* MP3 audio playback from .mp3 files, standard RTP streams and shout-cast streams
* MP3 playlist parsing and playback
* Helix MP3 Decoder - More Info
* Helix MP3 Encoder - Documentation
* MPEG1/2 file parsing
* MPEG4 audio (no video) playback from .mp4 or .3gp files and ISMA or 3GPP streams
* Ogg Vorbis and Ogg Theora (with some known problems streaming over RTSP).
* Uncompressed PCM from .wav, avi, .aiff or .au files and standard RTP streams
* PCM a-law and u-law from .wav, avi or .au files and standard RTP streams
* RAM metafile parsing and playback
* RGB video from .avi files
* RealAudio/RealVideo Codecs
* RealAudio and RealVideo playback from RealMedia file format and RealMedia streams.
* RealEvents and RealImageMap from .rm files and RealMedia streams
* RealText from .rt files and RealText streams
* SDP file parsing
* SMIL1.0/2.0 multimedia
* Still images (JPEG, GIF, PNG, WBMP)
* Text - plain from .txt files
* TimedText from .3gpp files


==Helix "Watch & Listen" Media Activity Version 1 Bugs==


Here is a list of bugs and limitations of the current implementation.
Here is a list of bugs and limitations of the current implementation.


* Play/Pause button. The graphic will not change between a pause and play graphics as the state of the engine chagnes.
* HTTP streaming has problems. Playing SMIL files over HTTP will result in a hard crash. You currently will not be able to play long videos over HTTP reliably. The work around is to just use RTSP instead, when possible, or wget the clip and play locally. This bug is in work and will be fixed in the next push.
* You can not click and drag or just click in the progress bar to seek a clip.
* Clips will always scale to as much screen as can be used, the engine supports
arbitrary scaling and full screen but we do not yet have GUI controls for it yet.
* Green tint over controls while playing video. This is a hardware issue, as noted in the hardware release notes, and should be resolved in the next revision of the hardware.
* Green tint over controls while playing video. This is a hardware issue, as noted in the hardware release notes, and should be resolved in the next revision of the hardware.
* Some error messages are not in our localized strings resource file (they may be non-obvious)

==Helix "Watch & Listen" Media Activity Version 1 upcoming features ==

* Full screen support and multiple scaling options
* Velocity controls (<1x speed, >1x speed (cpu limited).
* Video color controls (sharpness, contrast, brightness, hue)

Revision as of 07:45, 30 March 2007

Helix "Watch & Listen" Media Activity

This activity should still be considered ALPHA.

These notes relate to the "Watch & Listen-1.xo" release of the activity. Currently, the activity is bundled with the Helix media engine all in one package for easy installation. Eventually this engine, and they python bindings providing access to it will be moved to a location allowing easy access from any activity.

Helix "Watch & Listen" Media Activity Version 1 Installation Notes

  • Download the activity (see the ticket for instructions). Then just unzip the activity in /home/olpc/Activities. Restart Sugar.
  • Play the test clip via the open location button (see below): rtsp://judas.osuosl.org/olpc.smil clip.


Helix "Watch & Listen" Media Activity Version 1 Usage Notes

Please refer to this screen grab of the activity running:

https://olpc-player.helixcommunity.org/images/thumbScreenShot.png

Starting at the upper left and going right you have the following buttons and function:

  • Back button, this seeks the clip back 1/20 of its duration.
  • Play/pause button.
  • Stop button.
  • Forward button, this seeks the clip forward 1/20 of its duration.
  • Progress bar (non-clickable, non-dragable), this shows the current time and total duration of the clip.
  • Open File button.
  • Open Location button, this allows you to type in streaming links.

The activity has not been tested much, but this version of the engine should support:

  • 3GPP-Rel6 file parsing and 3GPP-Rel6 audio and video playback
  • 3G2 audio depacketizers and QCelp decoder hooks
  • AAC and aacPlus decoder - More info
  • AAC and aacPlus playback from .3gp, .m4a, .aac or .ra files and 3GPP, ISMA or ice-cast streams
  • AMR-NB and AMR-WB audio playback from .3gp and .amr files and 3GPP streams
  • H.261 video from standard RTP streams
  • H.263 video from .3gp files and standard RTP streams
  • H.264 video from .3gp files and standard H.264 RTP streams
  • I420 video rendering
  • MJPEG video playback from .avi files
  • MP3 audio playback from .mp3 files, standard RTP streams and shout-cast streams
  • MP3 playlist parsing and playback
  • Helix MP3 Decoder - More Info
  • Helix MP3 Encoder - Documentation
  • MPEG1/2 file parsing
  • MPEG4 audio (no video) playback from .mp4 or .3gp files and ISMA or 3GPP streams
  • Ogg Vorbis and Ogg Theora (with some known problems streaming over RTSP).
  • Uncompressed PCM from .wav, avi, .aiff or .au files and standard RTP streams
  • PCM a-law and u-law from .wav, avi or .au files and standard RTP streams
  • RAM metafile parsing and playback
  • RGB video from .avi files
  • RealAudio/RealVideo Codecs
  • RealAudio and RealVideo playback from RealMedia file format and RealMedia streams.
  • RealEvents and RealImageMap from .rm files and RealMedia streams
  • RealText from .rt files and RealText streams
  • SDP file parsing
  • SMIL1.0/2.0 multimedia
  • Still images (JPEG, GIF, PNG, WBMP)
  • Text - plain from .txt files
  • TimedText from .3gpp files


Helix "Watch & Listen" Media Activity Version 1 Bugs

Here is a list of bugs and limitations of the current implementation.

  • Play/Pause button. The graphic will not change between a pause and play graphics as the state of the engine chagnes.
  • HTTP streaming has problems. Playing SMIL files over HTTP will result in a hard crash. You currently will not be able to play long videos over HTTP reliably. The work around is to just use RTSP instead, when possible, or wget the clip and play locally. This bug is in work and will be fixed in the next push.
  • You can not click and drag or just click in the progress bar to seek a clip.
  • Clips will always scale to as much screen as can be used, the engine supports

arbitrary scaling and full screen but we do not yet have GUI controls for it yet.

  • Green tint over controls while playing video. This is a hardware issue, as noted in the hardware release notes, and should be resolved in the next revision of the hardware.
  • Some error messages are not in our localized strings resource file (they may be non-obvious)

Helix "Watch & Listen" Media Activity Version 1 upcoming features

  • Full screen support and multiple scaling options
  • Velocity controls (<1x speed, >1x speed (cpu limited).
  • Video color controls (sharpness, contrast, brightness, hue)