| パッケージ | org.osmf.media |
| クラス | public class MediaElement |
| 継承 | MediaElement  EventDispatcher Object |
| サブクラス | BeaconElement, CompositeElement, HTMLElement, LoadableElementBase, ProxyElement |
| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
プログラム的には、メディアエレメントは一連のメディア特性と状態空間をカプセル化します。メディア特性は、メディアエレメントの機能を表し、性質的に動的なものです。メディアエレメントは、ある瞬間はシーク可能であっても、別の瞬間にはそうでなかったりします。例えば、メディアエレメントが、スキップできない宣伝が含まれたビデオシーケンスの場合にこのような現象が発生します。
メディアエレメントは、メディアリソースで動作します。例えば、メディアエレメントがビデオプレーヤーを表す場合、メディアリソースは、ビデオストリームへの URL をカプセル化します。メディアエレメントが複合メディアコンポジションを表す場合は、メディアリソースの URL が、メディアコンポジションで使用される複数のリソースを参照するドキュメントになることもあります。
関連する API エレメント
MediaTraitBase
MediaResourceBase
MediaResourceBase
パブリックプロパティ
継承されるパブリックプロパティを隠す
継承されるパブリックプロパティを表示| プロパティ | 定義元 | ||
|---|---|---|---|
 | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | |
| container : IMediaContainer [読み取り専用]
このエレメントが使用するメディアコンテナです。 | MediaElement | ||
| metadataNamespaceURLs : Vector.<String> [読み取り専用]
この MediaElement 内に保存されているすべての Metadata オブジェクトの名前空間 URL を含むベクトルです。 | MediaElement | ||
| resource : MediaResourceBase
このメディアエレメントが動作するメディアリソースです。 | MediaElement | ||
| traitTypes : Vector.<String> [読み取り専用]
このメディアエレメントの特性タイプを表す MediaTraitType 値のベクトルです。 | MediaElement | ||
パブリックメソッド
| メソッド | 定義元 | ||
|---|---|---|---|
コンストラクターです。 | MediaElement | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | |
この MediaElement の指定された名前空間 URL の下に Metadata オブジェクトを追加します。 | MediaElement | ||
|
イベントをイベントフローに送出します。 | EventDispatcher | |
この MediaElement の下に保存されている、指定された名前空間 URL の Metadata オブジェクトを返します。 | MediaElement | ||
指定されたタイプのメディア特性を返します。 | MediaElement | ||
|
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | |
|
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
指定されたタイプのメディア特性が、このメディアエレメントにあるかどうかを判別します。 | MediaElement | ||
|
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
|
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
|
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | |
この MediaElement の下に保存されている、指定された名前空間 URL の Metadata オブジェクトを削除します。 | MediaElement | ||
|
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
|
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのストリング表現を返します。 | Object | |
|
指定されたオブジェクトのプリミティブな値を返します。 | Object | |
|
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher | |
プロテクトメソッド
| メソッド | 定義元 | ||
|---|---|---|---|
このメディアエレメントに新しいメディア特性を追加します。 | MediaElement | ||
このメディアエレメントからメディア特性を削除します。 | MediaElement | ||
このメディアエレメントの特性を設定します。 | MediaElement | ||
イベント
| イベント | 概要 | 定義元 | ||
|---|---|---|---|---|
| [ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。 | EventDispatcher | ||
| エレメントのコンテナプロパティが変更されたときに送出されます。 | MediaElement | |||
| [ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。 | EventDispatcher | ||
| メディアエレメントの操作に影響を与えるエラーが発生したときに送出されます。 | MediaElement | |||
| メディア要素の操作に影響を与える情報が提供されたときに送出されます。 | MediaElement | |||
| Metadata オブジェクトがこのメディアエレメントに追加されたときに送出されます。 | MediaElement | |||
| Metadata オブジェクトがこのメディアエレメントから削除されたときに送出されます。 | MediaElement | |||
| 特性がメディアエレメントに追加されたときに送出されます。 | MediaElement | |||
| 特性がメディアエレメントから削除されたときに送出されます。 | MediaElement | |||
プロパティの詳細
container | プロパティ |
container:IMediaContainer [読み取り専用] | 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このエレメントが使用するメディアコンテナです。
実装
public function get container():IMediaContainermetadataNamespaceURLs | プロパティ |
resource | プロパティ |
resource:MediaResourceBase| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このメディアエレメントが動作するメディアリソースです。
実装
public function get resource():MediaResourceBase public function set resource(value:MediaResourceBase):voidtraitTypes | プロパティ |
コンストラクターの詳細
MediaElement | () | コンストラクター |
public function MediaElement()| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
コンストラクターです。
メソッドの詳細
addMetadata | () | メソッド |
public function addMetadata(namespaceURL:String, metadata:Metadata):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
この MediaElement の指定された名前空間 URL の下に Metadata オブジェクトを追加します。
パラメーター
namespaceURL:String — Metadata の保存に使用される名前空間 URL です。
| |
metadata:Metadata — 追加する Metadata です。
|
例外
ArgumentError — namespaceURL または metadata が null の場合。
|
addTrait | () | メソッド |
protected function addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このメディアエレメントに新しいメディア特性を追加します。成功した場合、MediaElementEvent が送出されます。
パラメーター
type:String — 追加するメディア特性の MediaTraitType です。
| |
instance:org.osmf.traits:MediaTraitBase — 追加するメディア特性です。
|
例外
ArgumentError — いずれかのパラメーターが null である場合、指定されたタイプとメディア特性のタイプが一致しない場合、または特定の特性クラスの別のインスタンスが既に追加されていた場合。
|
getMetadata | () | メソッド |
public function getMetadata(namespaceURL:String):Metadata| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
この MediaElement の下に保存されている、指定された名前空間 URL の Metadata オブジェクトを返します。
パラメーター
namespaceURL:String — 取得する Metadata オブジェクトの名前空間 URL です。
|
Metadata |
例外
ArgumentError — namespaceURL が null の場合。
|
getTrait | () | メソッド |
public function getTrait(type:String):org.osmf.traits:MediaTraitBase| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
指定されたタイプのメディア特性を返します。
パラメーター
type:String — 返されるメディア特性の MediaTraitType です。
|
org.osmf.traits:MediaTraitBase — 取得された特性です。そのような特性がこのメディアエレメントに存在しない場合は、null になります。
|
例外
ArgumentError — パラメーターが null の場合。
|
hasTrait | () | メソッド |
public function hasTrait(type:String):Boolean| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
指定されたタイプのメディア特性が、このメディアエレメントにあるかどうかを判別します。
パラメーター
type:String — チェックするメディア特性の MediaTraitType です。
|
Boolean — 指定されたクラスのメディア特性がこのメディアエレメントにある場合は true、それ以外の場合は false です。
|
例外
ArgumentError — パラメーターが null の場合。
|
removeMetadata | () | メソッド |
public function removeMetadata(namespaceURL:String):Metadata| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
この MediaElement の下に保存されている、指定された名前空間 URL の Metadata オブジェクトを削除します。
パラメーター
namespaceURL:String — 削除する Metadata の名前空間 URL です。
|
Metadata |
例外
ArgumentError — namespaceURL が null の場合。
|
removeTrait | () | メソッド |
protected function removeTrait(type:String):org.osmf.traits:MediaTraitBase| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このメディアエレメントからメディア特性を削除します。成功した場合、MediaElementEvent が送出されます。
パラメーター
type:String — 削除するメディア特性の MediaTraitType です。
|
org.osmf.traits:MediaTraitBase — 削除された特性です。削除された特性がない場合は null になります。
|
例外
ArgumentError — パラメーターが null の場合。
|
setupTraits | () | メソッド |
protected function setupTraits():void| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
このメディアエレメントの特性を設定します。構築中に発生します。サブクラスは、このメソッドをオーバーライドして、独自の特性ごとに addTrait を呼び出す必要があります。
イベントの詳細
containerChange | イベント |
イベントオブジェクトの型:
プロパティ ContainerChangeEvent.type =
org.osmf.events.ContainerChangeEventプロパティ ContainerChangeEvent.type =
org.osmf.events.ContainerChangeEvent.CONTAINER_CHANGE| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
エレメントのコンテナプロパティが変更されたときに送出されます。
ContainerChangeEvent.CONTAINER_CHANGE 定数により、イベントオブジェクトの type プロパティ値が containerChange イベント用に定義されます。mediaError | イベント |
イベントオブジェクトの型:
プロパティ MediaErrorEvent.type =
org.osmf.events.MediaErrorEventプロパティ MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_ERROR| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
メディアエレメントの操作に影響を与えるエラーが発生したときに送出されます。
MediaErrorEvent.MEDIA_ERROR 定数により、イベントオブジェクトの type プロパティ値が mediaError イベント用に定義されます。mediaInfo | イベント |
イベントオブジェクトの型:
プロパティ MediaErrorEvent.type =
org.osmf.events.MediaErrorEventプロパティ MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_INFO| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 2.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
メディア要素の操作に影響を与える情報が提供されたときに送出されます。MEDIA_INFO イベントは致命的なエラーではありません。
metadataAdd | イベント |
イベントオブジェクトの型:
プロパティ MediaElementEvent.type =
org.osmf.events.MediaElementEventプロパティ MediaElementEvent.type =
org.osmf.events.MediaElementEvent.METADATA_ADD| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
Metadata オブジェクトがこのメディアエレメントに追加されたときに送出されます。
MediaElementEvent.METADATA_ADD 定数により、イベントオブジェクトの type プロパティ値が metadataAdd イベント用に定義されます。metadataRemove | イベント |
イベントオブジェクトの型:
プロパティ MediaElementEvent.type =
org.osmf.events.MediaElementEventプロパティ MediaElementEvent.type =
org.osmf.events.MediaElementEvent.METADATA_REMOVE| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
Metadata オブジェクトがこのメディアエレメントから削除されたときに送出されます。
MediaElementEvent.METADATA_REMOVE 定数により、イベントオブジェクトの type プロパティ値が metadataRemove イベント用に定義されます。traitAdd | イベント |
イベントオブジェクトの型:
プロパティ MediaElementEvent.type =
org.osmf.events.MediaElementEventプロパティ MediaElementEvent.type =
org.osmf.events.MediaElementEvent.TRAIT_ADD| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
特性がメディアエレメントに追加されたときに送出されます。
MediaElementEvent.TRAIT_ADD 定数により、イベントオブジェクトの type プロパティ値が traitAdd イベント用に定義されます。traitRemove | イベント |
イベントオブジェクトの型:
プロパティ MediaElementEvent.type =
org.osmf.events.MediaElementEventプロパティ MediaElementEvent.type =
org.osmf.events.MediaElementEvent.TRAIT_REMOVE| 言語バージョン: | ActionScript 3.0 |
| 製品バージョン: | OSMF 1.0 |
| ランタイムバージョン: | Flash Player 10, AIR 1.5 |
特性がメディアエレメントから削除されたときに送出されます。
MediaElementEvent.TRAIT_REMOVE 定数により、イベントオブジェクトの type プロパティ値が traitRemove イベント用に定義されます。Tue Jun 12 2018, 10:34 AM Z