パッケージflash.events
クラスpublic class NetStatusEvent
継承NetStatusEvent Inheritance Event Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

NetStatusEvent オブジェクトは、NetConnection、NetStream または SharedObject オブジェクトが自身のステータスを報告するときに送出されます。 ステータスイベントのタイプは NetStatusEvent.NET_STATUS の 1 つのみです。

例を表示

関連項目

flash.net.NetConnection
flash.net.NetStream
flash.net.SharedObject
NetStatusEvent.NET_STATUS


パブリックプロパティ
 プロパティ定義元
 Inheritedbubbles : Boolean
[読み取り専用] イベントがバブリングイベントかどうかを示します。
Event
 Inheritedcancelable : Boolean
[読み取り専用] イベントに関連付けられた動作を回避できるかどうかを示します。
Event
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 InheritedcurrentTarget : Object
[読み取り専用] イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
Event
 InheritedeventPhase : uint
[読み取り専用] イベントフローの現在の段階です。
Event
  info : Object
オブジェクトのステータスまたはエラー状態を記述するプロパティを持つオブジェクトです。
NetStatusEvent
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 Inheritedtarget : Object
[読み取り専用] イベントターゲットです。
Event
 Inheritedtype : String
[読み取り専用] イベントのタイプです。
Event
パブリックメソッド
 メソッド定義元
  
NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)
netStatus イベントに関する情報を含んでいる Event オブジェクトを作成します。
NetStatusEvent
  
[override] NetStatusEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。
NetStatusEvent
 Inherited
formatToString(className:String, ... arguments):String
カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。
Event
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。
Event
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。
Event
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。
Event
  
[override] NetStatusEvent オブジェクトのすべてのプロパティを含むストリングを返します。
NetStatusEvent
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
パブリック定数
 定数定義元
 InheritedACTIVATE : String = "activate"
[静的] ACTIVATE 定数は、type プロパティ(activate イベントオブジェクト)の値を定義します。
Event
 InheritedADDED : String = "added"
[静的] Event.ADDED 定数は、added イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[静的] Event.ADDED_TO_STAGE 定数は、type プロパティ (addedToStage イベントオブジェクト) の値を定義します。
Event
 InheritedCANCEL : String = "cancel"
[静的] Event.CANCEL 定数は、cancel イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCHANGE : String = "change"
[静的] Event.CHANGE 定数は、type プロパティ (change イベントオブジェクト) の値を定義します。
Event
 InheritedCLEAR : String = "clear"
[静的] Event.CLEAR 定数は、clear イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCLOSE : String = "close"
[静的] Event.CLOSE 定数は、close イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only CLOSING : String = "closing"
[静的] Event.CLOSING 定数は、closing イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCOMPLETE : String = "complete"
[静的] Event.COMPLETE 定数は、complete イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCONNECT : String = "connect"
[静的] Event.CONNECT 定数は、connect イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCOPY : String = "copy"
[静的] copy イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedCUT : String = "cut"
[静的] cut イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedDEACTIVATE : String = "deactivate"
[静的] Event.DEACTIVATE 定数は、deactivate イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedDISPLAYING : String = "displaying"
[静的] Event.DISPLAYING 定数は、displaying イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedENTER_FRAME : String = "enterFrame"
[静的] Event.ENTER_FRAME 定数は、enterFrame イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[静的] Event.EXIT_FRAME 定数は、exitFrame イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only EXITING : String = "exiting"
[静的] Event.EXITING 定数は、type プロパティ (exiting イベントオブジェクト) の値を定義します。
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[静的] Event.FRAME_CONSTRUCTED 定数は、frameConstructed イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedFULLSCREEN : String = "fullScreen"
[静的] Event.FULL_SCREEN 定数は、fullScreen イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[静的] Event.HTML_BOUNDS_CHANGE 定数は、htmlBoundsChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[静的] Event.HTML_DOM_INITIALIZE 定数は、htmlDOMInitialize イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[静的] Event.HTML_RENDER 定数は、htmlRender イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedID3 : String = "id3"
[静的] Event.ID3 定数は、id3 イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedINIT : String = "init"
[静的] Event.INIT 定数は、init イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[静的] Event.LOCATION_CHANGE 定数は、locationChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[静的] Event.MOUSE_LEAVE 定数は、mouseLeave イベントオブジェクトの type プロパティの値を定義します。
Event
  NET_STATUS : String = "netStatus"
[静的] netStatus イベントオブジェクトの type プロパティ値を定義します。
NetStatusEvent
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[静的] Event.NETWORK_CHANGE 定数は、networkChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedOPEN : String = "open"
[静的] Event.OPEN 定数は、open イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedPASTE : String = "paste"
[静的] Event.PASTE 定数は、paste イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedREMOVED : String = "removed"
[静的] Event.REMOVED 定数は、removed イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[静的] Event.REMOVED_FROM_STAGE 定数は、removedFromStage イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedRENDER : String = "render"
[静的] Event.RENDER 定数は、render イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedRESIZE : String = "resize"
[静的] Event.RESIZE 定数は、resize イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSCROLL : String = "scroll"
[静的] Event.SCROLL 定数は、scroll イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSELECT : String = "select"
[静的] Event.SELECT 定数は、select イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSELECT_ALL : String = "selectAll"
[静的] Event.SELECT_ALL 定数は、selectAll イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[静的] Event.SOUND_COMPLETE 定数は、soundComplete イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[静的] Event.TAB_CHILDREN_CHANGE 定数は、tabChildrenChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[静的] Event.TAB_ENABLED_CHANGE 定数は、tabEnabledChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[静的] Event.TAB_INDEX_CHANGE 定数は、tabIndexChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedUNLOAD : String = "unload"
[静的] Event.UNLOAD 定数は、unload イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[静的] Event.USER_IDLE 定数は、userIdle イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[静的] Event.USER_PRESENT 定数は、userPresent イベントオブジェクトの type プロパティの値を定義します。
Event
プロパティの詳細
infoプロパティ
info:Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

オブジェクトのステータスまたはエラー状態を記述するプロパティを持つオブジェクトです。

情報オブジェクトは、特定のイベントを表すストリングを含む code プロパティ、または level プロパティ("status""error" のいずれかのストリングを含む)を保持することがあります。

また、情報オブジェクトがこれ以外のプロパティを保持することもあります。code プロパティと level プロパティは、一部の実装では機能せず、一部のサーバーでは別のオブジェクトが送られることがあります。

P2P 接続は、NetConnection にメッセージを送信します。この場合、情報オブジェクトの stream パラメータには、メッセージが関係する NetStream が示されます。たとえば、Flex Data Services では、code プロパティまたは level プロパティにアクセスしようとすると、型変換エラーを引き起こす Message オブジェクトが送信されます。

次の表に、code プロパティと level プロパティに含まれる可能性のあるストリング値を示します。

code プロパティlevel プロパティ説明
"NetStream.Buffer.Empty""status"データを十分な速度で受信していないので、バッファを満たしていません。バッファが再び満たされるまでデータのフローは中断されます。バッファが満たされた時点で NetStream.Buffer.Full メッセージが送信され、再びストリームの再生が開始されます。
"NetStream.Buffer.Full""status"バッファが満たされ、ストリームの再生が開始されます。
"NetStream.Buffer.Flush""status"データのストリームが終了しました。残りのバッファは空になります。
"NetStream.Failed" "error"Flash Media Server のみ。他のイベントコードに一覧表示されている以外の理由でエラーが発生しました。
"NetStream.Publish.Start""status"パブリッシュが正常に行われました。
"NetStream.Publish.BadName""error"その他のユーザーが既にパブリッシュしているストリームをパブリッシュしようとしています。
"NetStream.Publish.Idle""status"ストリームの発行者はアイドル状態で、データを伝送していません。
"NetStream.Unpublish.Success""status"アンパブリッシュ操作が正常に行われました。
"NetStream.Play.Start""status"再生が開始されました。
"NetStream.Play.Stop""status"再生が停止されました。
"NetStream.Play.Failed""error"この表に示している以外の理由で再生中にエラーが発生しました。例えば、サブスクライバに読み取りアクセスがない場合などが該当します。
"NetStream.Play.StreamNotFound""error"play() メソッドに渡した FLV が見つかりません。
"NetStream.Play.Reset""status"再生リストのリセットが原因です。
"NetStream.Play.PublishNotify""status"ストリームへの最初のパブリッシュがすべてのサブスクライバに送信されます。
"NetStream.Play.UnpublishNotify""status"ストリームからのアンパブリッシュがすべてのサブスクライバに送信されます。
"NetStream.Play.InsufficientBW" "warning"Flash Media Server のみ。クライアントに、データを通常の速度で再生するために十分な帯域幅がありません。
"NetStream.Play.FileStructureInvalid""error"アプリケーションで無効なファイル構造が検出され、このタイプのファイルが再生されません。AIR および Flash Player 9.0.115.0 以降の場合です。
"NetStream.Play.NoSupportedTrackFound""error"アプリケーションでサポートされているトラック (ビデオ、オーディオまたはデータ) が検出されず、ファイルが再生されません。AIR および Flash Player 9.0.115.0 以降の場合です。
"NetStream.Play.Transition""status"Flash Media Server のみ。 ビットレートストリーム切り替えの結果として、ストリームが別のストリームに移行します。このコードは、ストリーム切り替えを開始する NetStream.play2() 呼び出しの成功ステータスのイベントを示します。切り替えが成功しない場合、サーバーは代わりに NetStream.Play.Failed イベントを送信します。Flash Player 10 以降。
"NetStream.Play.Transition""status"Flash Media Server 3.5 以降のみ。サーバーは、ビットレートストリーム切り替えの結果として、別のストリームに移行するコマンドを受信しました。このコードは、ストリーム切り替えを開始する NetStream.play2() 呼び出しの成功ステータスのイベントを示します。切り替えが成功しない場合、サーバーは代わりに NetStream.Play.Failed イベントを送信します。ストリーム切り替えが発生したときは、"NetStream.Play.TransitionComplete" コードを持つ onPlayStatus イベントが送出されます。Flash Player 10 以降。
"NetStream.Pause.Notify""status"ストリームが一時停止されます。
"NetStream.Unpause.Notify""status"ストリームが再開されます。
"NetStream.Record.Start""status"録音が開始されました。
"NetStream.Record.NoAccess""error"まだ再生しているストリームまたはクライアントがアクセス権を持たないストリームを録音しようとしています。
"NetStream.Record.Stop""status"録音が停止されました。
"NetStream.Record.Failed""error"ストリームの録音試行が失敗しました。
"NetStream.Seek.Failed""error"シークが失敗します。これは、ストリームがシーク可能でない場合に発生します。
"NetStream.Seek.InvalidTime""error"プログレッシブダウンロードでダウンロードされたビデオに対して、ユーザーが現時点でダウンロード済みのビデオデータの末尾を超えて再生またはシークしようとしました。または、ファイル全体のダウンロード後にビデオの末尾を超えて再生またはシークしようとしました。message.details プロパティには、ユーザーがシークできる有効な末尾を示す時間コードが含まれています。
"NetStream.Seek.Notify""status"シーク操作が完了しました。
"NetConnection.Call.BadVersion""error"識別できない形式でパケットがエンコードされています。
"NetConnection.Call.Failed""error"NetConnection.call メソッドが、サーバー側のメソッドまたはコマンドを呼び出すことができませんでした。
"NetConnection.Call.Prohibited""error"セキュリティ上の理由で AMF(Action Message Format)操作が実行できません。AMF URL が NetConnection.call() メソッドを呼び出すコードを含むファイルと同じドメインにないか、AMF サーバーに NetConnection.call() メソッドを呼び出すコードを含むファイルのドメインを信頼しているポリシーファイルがありません。
"NetConnection.Connect.Closed""status"接続が正常に切断されました。
"NetConnection.Connect.Failed""error"接続試行が失敗しました。
"NetConnection.Connect.Success""status"接続試行が成功しました。
"NetConnection.Connect.Rejected""error"接続試行がアプリケーションにアクセスする許可を得られませんでした。
"NetStream.Connect.Closed""status"P2P 接続が正常に切断されました。info.stream プロパティは、切断されたストリームを示します。
"NetStream.Connect.Failed""error"P2P 接続試行が失敗しました。info.stream プロパティは、失敗したストリームを示します。
"NetStream.Connect.Success""status"P2P 接続試行が成功しました。info.stream プロパティは、成功したストリームを示します。
"NetStream.Connect.Rejected""error"P2P 接続試行がもう一方のピアーにアクセスする許可を得られませんでした。info.stream プロパティは、拒否されたストリームを示します。
"NetConnection.Connect.AppShutdown""error"指定したアプリケーションが終了中です。
"NetConnection.Connect.InvalidApp""error"接続時に指定されたアプリケーション名が無効です。
"SharedObject.Flush.Success""status""pending" ステータスが解決され、SharedObject.flush() の呼び出しが成功しました。
"SharedObject.Flush.Failed""error""pending" ステータスが解決されていますが、SharedObject.flush() は失敗しました。
"SharedObject.BadPersistence""error"永続性フラグを含む共有オブジェクトが要求されましたが、別のフラグを含むオブジェクトが既に作成されていたため、要求が許可されません。
"SharedObject.UriMismatch""error"共有オブジェクトと異なる URI (URL) を持つ NetConnection オブジェクトへの接続が試行されました。

バッファに関するエラーが繰り返し表示される場合は、NetStream.bufferTime プロパティを使用してバッファを変更してみてください。



実装
    public function get info():Object
    public function set info(value:Object):void

関連項目

コンストラクタの詳細
NetStatusEvent()コンストラクタ
public function NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

netStatus イベントに関する情報を含む Event オブジェクトを作成します。イベントリスナーには Event オブジェクトがパラメータとして渡されます。

パラメータ
type:String — イベントのタイプです。イベントリスナーは、継承された type プロパティを通じてこの情報にアクセスできます。ステータスイベントのタイプは NetStatusEvent.NET_STATUS の 1 つのみです。
 
bubbles:Boolean (default = false) — Event オブジェクトがイベントフローのバブリング段階で処理されるかどうかを判断します。イベントリスナーは、継承された bubbles プロパティを通じてこの情報にアクセスできます。
 
cancelable:Boolean (default = false) — Event オブジェクトがキャンセル可能かどうかを判断します。イベントリスナーは、継承された cancelable プロパティを通じてこの情報にアクセスできます。
 
info:Object (default = null) — オブジェクトのステータスを記述するプロパティを含むオブジェクトです。イベントリスナーは、info プロパティを通じてこのオブジェクトにアクセスできます。

関連項目

メソッドの詳細
clone()メソッド
override public function clone():Event

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

NetStatusEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。

戻り値
Event — 元のオブジェクトと同じプロパティ値を含む新しい NetStatusEvent オブジェクトです。
toString()メソッド 
override public function toString():String

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

NetStatusEvent オブジェクトのすべてのプロパティを含むストリングを返します。ストリングは次の形式です。

[NetStatusEvent type=value bubbles=value cancelable=value info=value]

戻り値
String — NetStatusEvent オブジェクトのすべてのプロパティを含むストリングです。
定数の詳細
NET_STATUS定数
public static const NET_STATUS:String = "netStatus"

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

type プロパティ (netStatus イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
infoオブジェクトのステータスまたはエラー状態を記述するプロパティを持つオブジェクトです。
targetそのステータスを報告する NetConnection または NetStream オブジェクトです。

関連項目

例の使用法
NetStatusEventExample.as

次の例では、Video オブジェクトを NetConnection クラスおよび NetStream クラスと共に使用して、FLV ファイルをロードして再生します。

この例では、netStatusHandler メソッドを NetStatusEvent イベント NetConnection.netStatus のリスナーとして登録します。 NetConnection.connect() のステータス(成功または失敗)が特定されると、netStatus イベントによりこのメソッドがトリガされます。NetConnection オブジェクトへの接続が成功した場合、つまり、NetStatusEvent オブジェクトの info プロパティ(NetStatusEvent オブジェクトは netStatus イベントによって送出)に含まれている code プロパティが成功を示していた場合、Video オブジェクトと NetStream オブジェクトが作成され、Video.attachNetStream() メソッドと NetStream.play() メソッドが呼び出されます。

注意:この例を実行するには、videoURL に渡される変数と、ファイル名および場所が一致する FLV ファイルが必要です。この場合は、SWF ファイルと同じディレクトリにある Video.flv という名前の FLV ファイルです。


 package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;

    public class NetStatusEventExample extends Sprite {
        private var videoURL:String = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        public function NetStatusEventExample() {
            connection = new NetConnection();
            connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            connection.connect(null);
        }

        private function netStatusHandler(event:NetStatusEvent):void {
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    connectStream();
                    break;
                case "NetStream.Play.StreamNotFound":
                    trace("Unable to locate video: " + videoURL);
                    break;
            }
        }

        private function connectStream():void {
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler);
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
        
        private function asyncErrorHandler(event:AsyncErrorEvent):void {
            // ignore AsyncErrorEvent events.
        }

    }
 }




 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/events/NetStatusEvent.html