Package	org.osmf.elements
Class	public class LightweightVideoElement
Inheritance	LightweightVideoElement LoadableElementBase MediaElement EventDispatcher Object
Subclasses	VideoElement

Language Version:

ActionScript 3.0

Product Version:

OSMF 1.0

Runtime Versions:

Flash Player 10, AIR 1.5

LightweightVideoElement is a media element specifically created for video playback. It supports both streaming and progressive formats.

LightweightVideoElement is a lightweight alternative to VideoElement. Whereas LightweightVideoElement supports only a subset of video delivery modes (specifically progressive and simple RTMP streaming), VideoElement supports all video delivery modes.

The LightweightVideoElement uses a NetLoader class to load and unload its media. Developers requiring custom loading logic for video can pass their own loaders to the LightweightVideoElement constructor. These loaders should subclass NetLoader.

The basic steps for creating and using a LightweightVideoElement are:

1. Create a new URLResource pointing to the URL of the video stream or file containing the video to be loaded.
2. Create a new NetLoader.
3. Create the new LightweightVideoElement, passing the NetLoader and URLResource as parameters.
4. Create a new MediaPlayer.
5. Assign the LightweightVideoElement to the MediaPlayer's media property.
6. Control the media using the MediaPlayer's methods, properties, and events.
7. When done with the LightweightVideoElement, set the MediaPlayer's media property to null. This will unload the LightweightVideoElement.

The LightweightVideoElement supports Flash Media Token Authentication, for passing authentication tokens through the NetConnection.

The LightweightVideoElement has support for the Flash Player's DRM implementation. Note that the startDate, endDate, and period properties of the DRMTrait on this element correspond to the voucher validity before playback starts. Once playback begins, these properties correspond to the playback time window (as found on flash.net.drm.DRMVoucher).

View the examples

Related API Elements

---

package asdoc.org.osmf.elements
{
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    
    import org.osmf.elements.LightweightVideoElement;
    import org.osmf.elements.VideoElement;
    import org.osmf.media.MediaPlayer;
    import org.osmf.media.MediaPlayerSprite;
    import org.osmf.media.URLResource;
    
    public class LightweightVideoElementExample extends Sprite
    {
        public function LightweightVideoElementExample()
        {
            super();
            
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var mediaPlayerSprite:MediaPlayerSprite = new MediaPlayerSprite();
            var videoElement:LightweightVideoElement = new LightweightVideoElement();
            videoElement.resource = new URLResource("http://mediapm.edgesuite.net/strobe/content/test/AFaerysTale_sylviaApostol_640_500_short.flv");
            
            addChild(mediaPlayerSprite);
            mediaPlayerSprite.media = videoElement;    
        }
    }
}