| 패키지 | org.osmf.media |
| 클래스 | public class MediaFactory |
| 상속 | MediaFactory  EventDispatcher Object |
| 하위 클래스 | DefaultMediaFactory |
| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
The factory operation takes a MediaResourceBase as input and produces a MediaElement as output.
The MediaFactory maintains a list of MediaFactoryItem objects, each of which encapsulates all the information necessary to create a specific MediaElement. The MediaFactory relies on the canHandleResourceFunction method of each MediaFactoryItem to find a MediaFactoryItem object that can handle the specified MediaResourceBase.
The factory interface also exposes methods for querying for specific MediaFactoryItem objects, and for loading plugins (which hold MediaFactoryItem objects).
관련 API 요소
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| numItems : int [읽기 전용]
The number of MediaFactoryItems managed by the factory. | MediaFactory | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
Constructor. | MediaFactory | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | |
Adds the specified MediaFactoryItem to the factory. | MediaFactory | ||
Returns a MediaElement that can be created based on the specified
MediaResourceBase. | MediaFactory | ||
|
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | |
Gets the MediaFactoryItem at the specified index. | MediaFactory | ||
Returns the MediaFactoryItem with the specified ID or null if the
specified MediaFactoryItem does not exist in this factory. | MediaFactory | ||
|
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
Load a plugin identified by the specified resource. | MediaFactory | ||
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | |
Removes the specified MediaFactoryItem from the factory. | MediaFactory | ||
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
|
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | |
| 메서드 | 정의 주체 | ||
|---|---|---|---|
Returns the most appropriate MediaFactoryItem for the specified resource
out of the MediaFactoryItems in the specified list. | MediaFactory | ||
| 이벤트 | 요약 | 정의 주체 | ||
|---|---|---|---|---|
| [브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. | EventDispatcher | ||
| [브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. | EventDispatcher | ||
| Dispatched when the MediaFactory has created a MediaElement. | MediaFactory | |||
| Dispatched when the MediaFactory has successfully loaded a plugin. | MediaFactory | |||
| Dispatched when the MediaFactory has failed to load a plugin due to an error. | MediaFactory | |||
numItems | 속성 |
MediaFactory | () | 생성자 |
public function MediaFactory()| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Constructor.
addItem | () | 메서드 |
public function addItem(item:MediaFactoryItem):void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Adds the specified MediaFactoryItem to the factory. After the MediaFactoryItem has been added, for any MediaResourceBase that this MediaFactoryItem can handle, the factory will be able to create the corresponding media element. If a MediaFactoryItem with the same ID already exists in this factory, the new MediaFactoryItem object replaces it.
매개 변수
item:MediaFactoryItem — The MediaFactoryItem to add.
|
오류
ArgumentError — If the argument is null or if the argument
has a null ID field.
|
createMediaElement | () | 메서드 |
public function createMediaElement(resource:MediaResourceBase):MediaElement| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Returns a MediaElement that can be created based on the specified MediaResourceBase.
Returns null if the factory cannot
find a MediaFactoryItem object
capable of creating such a MediaElement in this factory.
매개 변수
resource:MediaResourceBase — The MediaResourceBase for which a corresponding
MediaElement should be created.
|
MediaElement — The MediaElement that was created or null if no such
MediaElement could be created from the resource.
|
getItemAt | () | 메서드 |
public function getItemAt(index:int):MediaFactoryItem| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Gets the MediaFactoryItem at the specified index.
매개 변수
index:int — The index in the list from which to retrieve the MediaFactoryItem.
|
MediaFactoryItem — The MediaFactoryItem at that index or null if there is none.
|
getItemById | () | 메서드 |
public function getItemById(id:String):MediaFactoryItem| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Returns the MediaFactoryItem with the specified ID or null if the
specified MediaFactoryItem does not exist in this factory.
매개 변수
id:String — ID of the MediaFactoryItem to retrieve.
|
MediaFactoryItem — The MediaFactoryItem with the specified ID or null if the specified
MediaFactoryItem does not exist in this factory.
|
loadPlugin | () | 메서드 |
public function loadPlugin(resource:MediaResourceBase):void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Load a plugin identified by the specified resource. The MediaFactory will not reload the plugin if it has already been loaded. Upon successful loading, the MediaFactoryItems within the plugin's PluginInfo property will be added to this MediaFactory, and a MediaFactoryEvent.PLUGIN_LOAD event will be dispatched. OtherwiseIf the load fails, a MediaFactoryEvent.PLUGIN_LOAD_ERROR event will be dispatched.
매개 변수
resource:MediaResourceBase — MediaResourceBase representing the plugin. For remote (dynamic)
plugins, use an URLResource pointing to the remote SWF to load. For local
(static) plugins, use a PluginInfoResource.
|
오류
ArgumentError — If resource is null or resource is neither an URLResource
nor a PluginInfoResource.
|
removeItem | () | 메서드 |
public function removeItem(item:MediaFactoryItem):void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Removes the specified MediaFactoryItem from the factory. If no such MediaFactoryItem exists in this factory, does nothing.
매개 변수
item:MediaFactoryItem — The MediaFactoryItem to remove.
|
오류
ArgumentError — If the argument is null or if the argument
has a null ID field.
|
resolveItems | () | 메서드 |
protected function resolveItems(resource:MediaResourceBase, items:Vector.<MediaFactoryItem>):MediaFactoryItem
Returns the most appropriate MediaFactoryItem for the specified resource
out of the MediaFactoryItems in the specified list.
This method is invoked when createMediaElement is invoked
with a resource that more than one MediaFactoryItem can handle. Subclasses
can override to select the most appropriate one.
The default behavior is to select the first item which is not "native" to
the framework, under the theory that plugins ought to take precedence over
core media types. It makes this decision based on the presence or absence
of an id value which starts with "org.osmf".
매개 변수
resource:MediaResourceBase | |
items:Vector.<MediaFactoryItem> |
MediaFactoryItem |
mediaElementCreate | 이벤트 |
org.osmf.events.MediaFactoryEvent속성 MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.MEDIA_ELEMENT_CREATE| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Dispatched when the MediaFactory has created a MediaElement.
The MediaFactoryEvent.MEDIA_ELEMENT_CREATE constant defines the value of the type property of the event object for a mediaElementCreate event.pluginLoad | 이벤트 |
org.osmf.events.MediaFactoryEvent속성 MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.PLUGIN_LOAD| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Dispatched when the MediaFactory has successfully loaded a plugin.
The MediaFactoryEvent.PLUGIN_LOAD constant defines the value of the type property of the event object for a pluginLoad event.pluginLoadError | 이벤트 |
org.osmf.events.MediaFactoryEvent속성 MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.PLUGIN_LOAD_ERROR| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | OSMF 1.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Dispatched when the MediaFactory has failed to load a plugin due to an error.
The MediaFactoryEvent.PLUGIN_LOAD_ERROR constant defines the value of the type property of the event object for a pluginLoadError event.
package org.osmf.media
{
import flash.display.Sprite;
import org.osmf.events.MediaFactoryEvent;
public class MediaFactoryExample extends Sprite
{
public function MediaFactoryExample()
{
// Construct a media factory, and listen to its plug-in related events:
var factory:MediaFactory = new MediaFactory();
factory.addEventListener(MediaFactoryEvent.PLUGIN_LOAD, onPluginLoaded);
factory.addEventListener(MediaFactoryEvent.PLUGIN_LOAD_ERROR, onPluginLoadError);
// Instruct the factory to load the plug-in at the given url:
factory.loadPlugin(new URLResource("http://myinvalidurl.com/foo.swf"));
}
private function onPluginLoaded(event:MediaFactoryEvent):void
{
// Use the factory to create a media-element related to the plugin:
var factory:MediaFactory = event.target as MediaFactory;
factory.createMediaElement(new URLResource("http://myinvalidurl.com/content"));
}
private function onPluginLoadError(event:MediaFactoryEvent):void
{
// Handle plug-in loading failure:
trace("Plugin failed to load.");
}
}
}
Tue Jun 12 2018, 03:17 PM Z