flash.media.Video (Flex™ 2 リファレンスガイド)

パッケージ	flash.media
	public class Video
継承	Video DisplayObject EventDispatcher Object

Video クラスを使用すると、SWF ファイルに埋め込むことなく、ライブストリーミングビデオをアプリケーションで表示することができます。Camera.getCamera() メソッドを使用して、ライブビデオをキャプチャして再生できます。また、Video クラスを使用して、HTTP 経由またはローカルファイルシステムから Flash^® Video (FLV) ファイルを再生することもできます。詳細については、NetConnection クラスと NetStream クラスを参照してください。

Flash Player 9 では、Sorenson または On2 VP6 コーデックでエンコーディングされた FLV ファイルのパブリッシュと再生をサポートし、アルファチャネルもサポートしています。On2 VP6 ビデオコーデックは、古いテクノロジよりも少ない帯域幅を使用し、追加の非ブロックフィルタとリンギング除去フィルタを提供します。

表示リスト上の他の表示オブジェクトと同様に、Video オブジェクトの各種プロパティを制御できます。たとえば、x および y プロパティを使用してステージ上で Video オブジェクトを移動したり、height および width プロパティを使用してサイズを変更することもできます。

ビデオストリームを再生するには、.attachCamera() メソッドまたは .attachNetStream() メソッドを使用してビデオを Video オブジェクトに関連付け、addChild() を使用してその Video オブジェクトを表示リストに追加します。

[ライブラリ] パネルを表示していない場合は、[ウィンドウ]-[ライブラリ] を選択して表示します。
[ライブラリ] パネルのタイトルバーの右側にあるオプションメニューをクリックして [新規ビデオ] を選択し、埋め込み Video オブジェクトをライブラリに追加します。
Video オブジェクトをステージにドラッグし、プロパティインスペクタを使用して一意のインスタンス名 (my_video など) を設定します。"Video" という名前にはしないでください。

メモ : Video クラスは InteractiveObject クラスのサブクラスではないため、マウスイベントを送出できません。ただし、Video オブジェクトを格納した表示オブジェクトコンテナの addEventListener() メソッドを使用できます。

パブリックプロパティ

継承されるパブリックプロパティの非表示

継承されるパブリックプロパティの表示

	プロパティ		定義
		accessibilityProperties : AccessibilityProperties この表示オブジェクトの現在のアクセシビリティオプションです。	DisplayObject
		alpha : Number 指定されたオブジェクトのアルファ透明度値を示します。	DisplayObject
		blendMode : String 使用するブレンドモードを指定する BlendMode クラスの値です。	DisplayObject
		cacheAsBitmap : Boolean `true` に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash Player にキャッシュされます。	DisplayObject
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		deblocking : int 事後処理中に、デコードされたビデオに適用されるフィルタのタイプを示します。	Video
		filters : Array 表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。	DisplayObject
		height : Number 表示オブジェクトの高さを示します (ピクセル単位)。	DisplayObject
		loaderInfo : LoaderInfo この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。	DisplayObject
		mask : DisplayObject 呼び出し元の表示オブジェクトは、指定された `mask` オブジェクトによってマスクされます。	DisplayObject
		mouseX : Number マウス位置の x 座標を示します (ピクセル単位)。	DisplayObject
		mouseY : Number マウス位置の y 座標を示します (ピクセル単位)。	DisplayObject
		name : String DisplayObject のインスタンス名を示します。	DisplayObject
		opaqueBackground : Object 表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。	DisplayObject
		parent : DisplayObjectContainer この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。	DisplayObject
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		root : DisplayObject ロードされた SWF ファイル内の表示オブジェクトの場合、`root` プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。	DisplayObject
		rotation : Number DisplayObject インスタンスの元の位置からの回転角を度単位で示します。	DisplayObject
		scale9Grid : Rectangle 現在有効な拡大 / 縮小グリッドです。	DisplayObject
		scaleX : Number 基準点から適用されるオブジェクトの水平スケール (`percentage`) を示します。	DisplayObject
		scaleY : Number オブジェクトの基準点から適用されるオブジェクトの垂直スケール (`percentage`) を示します。	DisplayObject
		scrollRect : Rectangle 表示オブジェクトのスクロール矩形の境界。	DisplayObject
		smoothing : Boolean ビデオを拡大・縮小する際にスムージング (補間) するかどうかを指定します。	Video
		stage : Stage 表示オブジェクトのステージ。	DisplayObject
		transform : Transform 表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクト。	DisplayObject
		videoHeight : int [read-only] ビデオストリームの高さをピクセル単位で指定する整数です。	Video
		videoWidth : int [read-only] ビデオストリームの幅をピクセル単位で指定する整数です。	Video
		visible : Boolean 表示オブジェクトが可視かどうかを示します。	DisplayObject
		width : Number 表示オブジェクトの幅を示します (ピクセル単位)。	DisplayObject
		x : Number 親 DisplayObjectContainer のローカル座標を基準にした DisplayObject インスタンスの x 座標を示します。	DisplayObject
		y : Number 親 DisplayObjectContainer のローカル座標を基準にした DisplayObject インスタンスの y 座標を示します。	DisplayObject

パブリック Methods

継承されるパブリックメソッドの非表示

継承されるパブリックメソッドの表示

	メソッド		定義
		Video(width:int = 320, height:int = 240) 新しい Video インスタンスを作成します。	Video
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void リスナーがイベントの通知を受け取るように、イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録します。	EventDispatcher
		attachCamera(camera:Camera):void アプリケーションウィンドウ内の Video オブジェクトの境界内に表示するカメラからのビデオストリームを指定します。	Video
		attachNetStream(netStream:NetStream):void アプリケーションウィンドウ内の Video オブジェクトの境界内に表示するビデオストリームを指定します。	Video
		clear():void Video オブジェクトに現在表示されているイメージをクリアします。	Video
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle `targetCoordinateSpace` オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。	DisplayObject
		getRect(targetCoordinateSpace:DisplayObject):Rectangle シェイプ上の線を除き、`targetCoordinateSpace` パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。	DisplayObject
		globalToLocal(point:Point):Point `point` オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。	DisplayObject
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指定されたプロパティがオブジェクトに定義されているかどうかを示します。	Object
		hitTestObject(obj:DisplayObject):Boolean 表示オブジェクトを評価して、`obj` 表示オブジェクトと重複または交差するかどうかを調べます。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 表示オブジェクトを評価して、`x` および `y` パラメータで指定されたポイントと重複または交差するかどうかを調べます。	DisplayObject
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		localToGlobal(point:Point):Point `point` オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。	DisplayObject
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

一覧	定義
activate	Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
added	表示オブジェクトが表示リストに追加されたときに送出されます。	DisplayObject
addedToStage	表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。	DisplayObject
deactivate	Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
enterFrame	再生ヘッドが新しいフレームに入るときに送出されます。	DisplayObject
removed	表示オブジェクトが表示リストから削除されようとしているときに送出されます。	DisplayObject
removedFromStage	表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。	DisplayObject
render	表示リストが更新およびレンダリングされようとしているときに送出されます。	DisplayObject

プロパティの詳細

deblocking

プロパティ

deblocking:int [read-write]

事後処理中に、デコードされたビデオに適用されるフィルタのタイプを示します。デフォルト値の 0 に設定すると、ビデオコンプレッサは必要に応じて非ブロックフィルタを適用します。

ビデオの圧縮によって、好ましくない生成結果となる場合があります。deblocking プロパティを使用して、ブロッキングと、On2 コーデックを使用して圧縮されたビデオのリンギングを低減するフィルタを設定できます。

ブロッキングとは、各ビデオフレームを構成するブロックの境界と境界の間に見られる不具合のことです。リンギングとは、ビデオイメージ内の要素の周囲が歪曲することです。

Sorenson コーデックと On2 VP6 コーデック内にある 2 つの非ブロックフィルタを使用できます。さらに、On2 VP6 コーデックを使用する際にはリンギング除去フィルタを使用できます。フィルタを設定するには、次のいずれかの値を使用します。

0—ビデオコンプレッサは必要に応じて非ブロックフィルタを適用します。
1—非ブロックフィルタを使用しません。
2—Sorenson 非ブロックフィルタを使用します。
3—On2 ビデオにのみ、On2 非ブロックフィルタを使用し、リンギング除去フィルタは使用しません。
4—On2 ビデオにのみ、On2 非ブロックフィルタとリンギング除去フィルタを使用します。
5—On2 ビデオにのみ、On2 非ブロックフィルタとパフォーマンスが向上した On2 リンギング除去フィルタを使用します。

Sorenson コーデックの使用時にビデオに 2 より大きい値を選択すると、Sorenson デコーダはデフォルトで 2 になります。

非ブロックフィルタを使用すると、全体的な再生のパフォーマンスに影響します。高帯域幅のビデオには、通常は必要ありません。非ブロックフィルタを有効にしたビデオは、低性能のシステムでは再生が困難なことがあります。

実装
public function get deblocking():int
public function set deblocking(value:int):void

smoothing

プロパティ

smoothing:Boolean [read-write]

ビデオを拡大・縮小する際にスムージング (補間) するかどうかを指定します。スムージングを行うには、Flash Player が高品質モードである必要があります。デフォルト値は false (スムージングなし) です。

実装
public function get smoothing():Boolean
public function set smoothing(value:Boolean):void

videoHeight

プロパティ

videoHeight:int [read-only]

ビデオストリームの高さをピクセル単位で指定する整数です。ライブストリームの場合、この値はビデオストリームをキャプチャしている Camera オブジェクトの Camera.height プロパティと同じです。FLV ファイルの場合、この値は FLV として書き出されたファイルの高さになります。

このプロパティは、ステージ上の実際の Video オブジェクトのサイズとは関係なく、キャプチャしたのと同じサイズでユーザーに対してビデオを表示する場合などに使用します。

実装
public function get videoHeight():int

関連項目

flash.media.Camera.height

videoWidth

プロパティ

videoWidth:int [read-only]

ビデオストリームの幅をピクセル単位で指定する整数です。ライブストリームの場合、この値はビデオストリームをキャプチャしている Camera オブジェクトの Camera.width プロパティと同じです。FLV ファイルの場合、この値は FLV ファイルとして書き出されたファイルの幅になります。

実装
public function get videoWidth():int

関連項目

flash.media.Camera.width

コンストラクタの詳細

Video

()

コンストラクタ

public 関数 Video(width:int = 320, height:int = 240)

新しい Video インスタンスを作成します。width パラメータと height パラメータの値が指定されていない場合は、デフォルト値が使用されます。Video オブジェクトの初期構築後に、Video.width と Video.height を使用して幅と高さのプロパティを設定することもできます。新しい Video オブジェクトを作成する際に、幅または高さに 0 は設定できません。0 を渡すと、デフォルト値が適用されます。

Video オブジェクトの作成後、DisplayObjectContainer.addChild() メソッドまたは DisplayObjectContainer.addChildAt() メソッドを呼び出して、親 DisplayObjectContainer オブジェクトに Video オブジェクトを追加できます。

パラメータ

	`width:int` (default = `320`) — ビデオの幅 (ピクセル単位) です。

	`height:int` (default = `240`) — ビデオの高さ (ピクセル単位) です。

メソッドの詳細

attachCamera

()

メソッド

public function attachCamera(camera:Camera):void

アプリケーションウィンドウ内の Video オブジェクトの境界内に表示するカメラからのビデオストリームを指定します。

パラメータ

camera:Camera — ビデオデータをキャプチャする Camera オブジェクトです。Video オブジェクトへの接続を閉じるには、null を渡します。

attachNetStream

()

メソッド

public function attachNetStream(netStream:NetStream):void

アプリケーションウィンドウ内の Video オブジェクトの境界内に表示するビデオストリームを指定します。ビデオストリームは、NetStream.play() コマンドを使用して表示される FLV ファイル、Camera オブジェクト、または null のいずれかになります。netStream パラメータの値に null を指定すると、オブジェクト内でビデオが再生されなくなります。

FLV ファイルにオーディオしか含まれない場合は、このメソッドを使用する必要はありません。FLV ファイルのオーディオは、NetStream.play() メソッドが呼び出されると自動的に再生されます。FLV ファイルに関連付けられたオーディオを制御するには、NetStream オブジェクトの soundTransform プロパティを使用します。このオブジェクトは、FLV ファイルを再生します。

パラメータ

netStream:NetStream — NetStream オブジェクトです。Video オブジェクトへの接続を閉じるには、null を渡します。

clear

()

メソッド

public function clear():void

Video オブジェクトに現在表示されているイメージをクリアします。このメソッドは、Video オブジェクトを非表示にせずにスタンバイ情報を表示したい場合に便利です。

関連項目

Video.attachCamera()

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class Video	プロパティ \| メソッド \| イベント