Open Source Media Framework Release Notes, v 0.5, 9/04/09 ============================= A. Overview The OSMF ZIP file contains source code for the framework, plus a number of sample applications and unit and integration tests. To use OSMF, in most cases you can simply link the MediaFramework.swc file into your Flash or Flex application. If you want to compile and run/debug the sample applications, see the "Installation Instructions" section. Note that a significant number of APIs have changed since the previous release. B. Installation Instructions (Flex Builder) 1. Unzip the OSMF zip file into your Flex Builder workspace folder. 2. In Flex Builder, go to the File menu and select "Import" (or "Import" then "Other"). 3. Select "General", then "Existing Projects into Workspace", and click "Next". 4. Choose "Select root directory" and "Browse". 5. Browse to your Flex Builder workspace folder. 6. Keep the checkbox selected for each project you wish to import. By default, all projects (including sample applications and unit/integration tests) are imported. 7. Click "Finish". This will import the selected projects. 8. Select the "Window" menu, then "Preferences", "General", "Workspace", and "Build Order". Uncheck "Use default build order". Using the "Up" button, move the following four projects (if present) to the top, in the following order: MediaFramework, NetMocker, StrobeUnit, MediaPlayer. (This is to work around a Flex Builder bug in which project dependencies are incorrectly determined.) 9. Build all projects. 10. To run/debug a sample application, be sure to follow the instructions in the readme.txt file at the root of the sample application's project. C. New Features * Dynamic streaming support, via the new DynamicStreamingResource class. Implementation included pluggable switching rules. * SWF support, via the new SWFElement and SWFLoader classes. Samples include reference implementations for a SWF that controls the player and a player that controls the SWF. * 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 support for visual and non-visual plugins controlling or listening to media in the player (or the media of other plugins) via IMediaReferrer and MediaInfoType, a more usable abstraction for loading plugins via PluginManager, and support for prioritizing plugins via IMediaResourceHandlerResolver. * Progressive audio support, via a new SoundLoader class which works with the Flash Sound and SoundChannel APIs. D. Sample Applications The v0.5 drop of OSMF contains a handful of sample applications which demonstrate new and old features. Each sample application is located in apps/samples/framework (for framework samples) or apps/samples/plugins (for plugin samples). The root directory of each sample project holds a readme.txt file with installation and usage instructions. Sample apps include: * DynamicStreamingSample: Demonstrates dynamic streaming support in OSMF. * ExamplePlayer (formerly CompositionPlayer): Demonstrates playback of a wide variety of media. * MetadataSample: Demonstrates how to view and modify the metadata associated with media. * PluginSample: Demonstrates how to load and work with plugins. * ReferenceSample: Demonstrates how to have one piece of media reference another piece, even when the media are in separate plugins. * GGTrackingPlugin: Demonstrates (along with the GGTrackingSample application) the use of a proxy plugin to do non-invasive tracking of another MediaElement using GlanceGuide's tracking service. * GGTrackingSample: Demonstrates the use of a proxy plugin to do non-invasive tracking of another MediaElement using GlanceGuide's tracking service About GlanceGuide: GlanceGuide is a Video Analytics company who have partnered with Nielsen to integrate panel based demographic data with census based video analytics. Through this hybrid approach GlanceGuide is able to provide unparalleled insight not only to audience behavior but also the demographic makeup of your audience. Further GlanceGuide allows publishers and advertisers the ability to understand how advertising is performing in various categories or even particular episodes of online content. The player integration is straight forward and the resulting data powerful. Please contact GlanceGuide for more information: Patrick Dowley VP Sales 415-845-4967 Patrick@glanceguide.com E. Known Issues https://bugs.adobe.com/jira/browse/FM-69 IViewable is not working correctly for some SWF files. - Workaround: Resize the container. https://bugs.adobe.com/jira/browse/FM-72 When plugin?s fail to load due to version mismatch or missing implementation of IPluginInfo error is not dispatched. - Workaround: User can catch that plugin doesn?t load with PluginLoadEvent. https://bugs.adobe.com/jira/browse/FM-73 Scalable sprite Scale Mode and Layout Attribute Scale mode can have conflicts when used in combination. - Workaround: Recommend using the normal sprite class until next drop. https://bugs.adobe.com/jira/browse/FM-74 RegistrationPoint doesn't respect the value correctly. https://bugs.adobe.com/jira/browse/FM-75 ? Resizing a browser repositions a composite layout. https://bugs.adobe.com/jira/browse/FM-76 - Display objects that are larger than the container size or positioned outside of the container will resize other parallel display objects.