Author Archive: Brian Riggs

OSMF v0.5 released

We’re excited to announce the release of the latest OSMF milestone, version 0.5.  This is definitely the most feature-rich release yet, and contains a number of core building blocks for creating media experiences in AS3.  Here are the highlights:

  • Dynamic streaming support, via the new DynamicStreamingResource class.
  • SWF support, via the new SWFElement and SWFLoader classes.
  • Advanced metadata support, via integration of the Metadata class with MediaElement to enable dynamic metadata.
  • Layout API, enabling the positioning of visual media in relation to each other through metadata.
  • Advanced plugin support, including plugins controlling the player (or other plugins).
  • Progressive audio support, via the new SoundLoader class.

We’ve also included a number of sample applications to demonstrate these (and other features).  Here’s a sample app that shows the wide range of media experiences that OSMF is capable of presenting.  Each item in the list on the left is a MediaElement, but each one represents a completely different type or manner of presenting media.  (You can see the source for these MediaElements here.)

Last, we have one significant development process announcement to make, namely that all daily development for OSMF is now taking place in the public SVN repository.  If you want to see the new features in their rawest form, just sync to the public trunk or subscribe to our commit notifications feed.  (If you just want a stable build, look for the most recent stable tag, e.g. “tags/sprint5-stable”.)


OSMF v0.4 now available

We’ve pushed version 0.4 of the Open Source Media Framework to the public SVN repository, and posted ZIPs for the source (+SWC) and ASDocs.  New features in this release include:

  • Error handling framework
  • Support for NetConnection reuse and port/protocol negotiation, and much better error handling when using NetConnections and NetStreams
  • Initial support for metadata, in the form of a metadata object model and resource-level metadata
  • More robust URL parsing, including FMS URLs

We’re also pretty excited to include the first “official” plugin, courtesy of Akamai.  The plugin handles connect-level and play-level authentication, as well as live stream playback for content from the Akamai network.

The source ZIP includes a handful of sample apps that demonstrate the new features.

If you’re curious about what’s coming next, be sure to take a look at our Features page, which shows our roadmap for the next few months.


Technical Intro to OSMF

(Cross-posted from the forums.)

There’s a lot about OSMF for newcomers to digest, so I thought I’d share the thinking behind the core design of the media framework.  Let’s start with a use case:  how would you build a video experience like that of, Hulu, or some other premium content publisher?  The first thing to acknowledge is that consumer video sites like Hulu are not just about video. They provide multimedia experiences:  video is choreographed with images (companion ads), overlays (SWFs), and even the branding of the underlying HTML page. And the experience is seldom confined to visual media alone; typically, the playback of the media happens in conjunction with CDN requests, ad server interactions, and tracking & reporting calls.  There’s a lot happening under the hood.

So the core of a media framework needs to be a) supportive of any and all media types, and b) flexible in how it can integrate backend server calls that enable and complement the media experience.

With OSMF, we’re attempting to solve this problem by defining three key classes at the heart of the framework.  First, a MediaElement represents a unified media experience.  A MediaElement might represent something as simple as a single video, or it could represent the entire choreographed experience of a web video site.  But given the dynamic nature of a site like MTV’s, if a MediaElement is going to represent the media experience as a whole, it too needs to be very dynamic.  That’s where the second key class in the framework, IMediaTrait, comes in.  A media trait represents a fundamental capability of a piece of media, without making any assumptions about the type of the media or how the media achieves that capability.  Examples of traits include IPlayable, IViewable, IAudible, and ITemporal.  A MediaElement that represents an image (ImageElement) would only contain the IViewable trait, whereas a MediaElement for a video (VideoElement) would have that trait plus IPlayable, IAudible, and ITemporal.  An audio-specific MediaElement (AudioElement) would have IPlayable, IAudible, and ITemporal, but not IViewable (since it has no visual representation).  Traits can come and go dynamically over time, which is the key to representing a unified media experience as a MediaElement.  Taken as a whole, the complete set of traits makes up the vocabulary of the system.  If you can map the behavior of a media type into this vocabulary, then it can leverage all of the functionality of the framework.

But what about non-visual media, such as integration of CDNs or tracking servers?  Here’s the key:  the trait-based vocabulary of the system applies to both visual and non-visual media.  In other words, everything that a CDN or ad server needs to do can be expressed through one or more traits.  For example, one of the traits in the framework is ILoadable, which represents the process needed to transform an input (such as a URL) into ready-to-play media — i.e. the load process.  But if a CDN plugin needs to do authentication or other custom logic, all it needs to do is map that custom logic into the ILoadable API.  Under the hood, the load process (as represented by ILoadable) can work with NetConnections and NetStreams, or with Flash’s Loader class, or with the Sound/SoundChannel API, or with custom RTMP or HTTP requests and responses.  In a sense, OSMF is taking all of the idiosyncracies and incompatibilities of the different media-specific Flash APIs and abstracting them into a common API.

Hopefully by now it’s at least somewhat clear how to represent a single piece of media.  But for complex media experiences with many moving parts, we need the third key class in the framework.  A CompositeElement is a MediaElement that represents a composition of multiple MediaElements.  The two specific examples are SerialElement, which represents a set of MediaElements that play in sequence;  and ParallelElement, which represents a set of MediaElements that play simultaneously.  These two classes allow you to build complex media experiences with many different MediaElements.  I could go on about this, but it’s probably more instructive to post a code snippet:

// Create a root-level parallel element.
var parallel:ParallelElement = new ParallelElement();

// Add a sequence of videos to the root.
var videoSequence:SerialElement = new SerialElement();
videoSequence.addChild(new VideoElement(new VideoLoader(),new URLResource("")));
videoSequence.addChild(new VideoElement(new VideoLoader(),new URLResource("")));
videoSequence.addChild(new VideoElement(new VideoLoader(),new URLResource("")));

// Add a sequence of rotating banners in parallel:
// - The first banner doesn't appear until five seconds have passed.
// - Each banner shows for 20 seconds.
// - There is a 15 second delay before a subsequent image shows.
var imageSequence:SerialElement = new SerialElement();
imageSequence.addChild(new TemporalProxyElement(5));
imageSequence.addChild(new TemporalProxyElement(20, new ImageElement(new ImageLoader(),new URLResource("")));
imageSequence.addChild(new TemporalProxyElement(15));
imageSequence.addChild(new TemporalProxyElement(20, new ImageElement(new ImageLoader(),new URLResource("")));
imageSequence.addChild(new TemporalProxyElement(15));
imageSequence.addChild(new TemporalProxyElement(20, new ImageElement(new ImageLoader(),new URLResource("")));

// Add the whole thing to the MediaPlayer. = parallel;

There, in about twenty lines of code, is your (basic) multimedia experience.  (Note that I haven’t covered everything that’s in the code in this post — checkout the developer documentation to learn about the rest.)  Yes, we’re still a far cry from reproducing Hulu or MTV.  But this is just a warmup.  Hope you’ll stick around to see where we’re going with this, and help us get there.