org.osmf.traits 

The org.osmf.traits package provides the building blocks for creating specific media traits. Traits define the capabilities of a media element.

Different implementations of a media element aggregate different sets of traits, depending on the characteristics of the media they represent. For example, an audio element may aggregate the IAudible, IPlayable, ITemporal and ILoadable traits. These individual traits define the capabilities of the media element independently of the specific media element implementation. For a media element that has the ILoadable trait, the trait provides the media element's load and unload capability. Similarly, the implementation of the IPlayable trait provides media element's ability to play itself.

A trait is added to a media element through the element's MediaElement.addTrait() method.

Implementation of media traits is predicated on the following principles:

• Traits are independent of one another. Therefore, a media trait does not extend another media trait.
• Traits dispatch their own events. Trait implementations can derive from the MediaTraitBase class, which extends EventDispatcher and implements IMediaTrait, to handle event dispatching.
• Traits are identified by the MediaTraitType enumeration class.
• Traits should be implemented as separate classes.

The traits interfaces are intended for use by media element classes. They are generic outward-facing entities characterized primarily by getters without setters, except for traits that require externally settable properties, such as the volume or pan properties of an IAudible.

The base trait classes are intended for use by implementations that subclass MediaElement. They generally have both setters and getters.