org.osmf.traits 

org.osmf.traits パッケージは、特定のメディアトレートを作成するための構築ブロックを提供します。トレートでは、メディアエレメントの機能を定義します。

メディアエレメントの実装が異なると、表現するメディアの特性によって、集約するトレートのセットも異なります。例えば、オーディオエレメントでは、IAudible、IPlayable、ITemporal および ILoadable トレートが集約されます。これらの各トレートでは、特定のメディアエレメントの実装には依存せずに、メディアエレメントの機能が定義されます。ILoadable トレートを持つメディアエレメントでは、トレートによってメディアエレメントのロードおよびアンロード機能が提供されます。同様に、IPlayable トレートを実装すると、メディアエレメントを自動的に再生する機能が提供されます。

トレートはエレメントの MediaElement.addTrait() メソッド経由で追加されます。

メディアトレートの実装は、次の原則に基づいています。

• トレートは個々に独立しています。したがって、メディアトレートは別のメディアトレートを拡張しません。
• トレートは自身のイベントを送出します。トレートは MediaTraitBase クラスから派生して実装できます。これにより、EventDispatcher を拡張し、IMediaTrait を実装して、イベントの送出を処理できます。
• トレートは MediaTraitType 列挙クラスによって識別されます。
• トレートは個別のクラスとして実装する必要があります。

トレートインターフェイスは、メディアエレメントのクラスで使用します。これらは、IAudible の volume や pan プロパティのような外部から設定可能なプロパティを必要とするトレートを除き、主に setter なしの getter によって特徴づけられる一般的な外向きのエンティティです。

基本トレートクラスは、MediaElement をサブクラス化する実装で使用します。通常、基本トレートクラスには setter と getter の両方があります。