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

NetConnection、NetStream、または SharedObject オブジェクトがそのステータスをレポートすると、Flash® Player によって NetStatusEvent オブジェクトが送出されます。ステータスイベントのタイプは 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
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 Inheritedtarget : Object
イベントターゲットです。
Event
 Inheritedtype : String
イベントの型です。
Event
パブリックメソッド
 メソッド定義
  NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)
netStatus イベントに関する情報を含む Event オブジェクトを作成します。
NetStatusEvent
  clone():Event
NetStatusEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。
NetStatusEvent
 InheritedformatToString(className:String, ... arguments):String
カスタム Event クラスに toString() メソッドを実装するためのユーティリティ関数です。
Event
 InheritedhasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 InheritedisDefaultPrevented():Boolean
イベントで preventDefault() が呼び出されたかどうかをチェックします。
Event
 InheritedisPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 InheritedpreventDefault():void
イベントのデフォルトビヘイビアをキャンセルできる場合に、そのビヘイビアをキャンセルします。
Event
 InheritedpropertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
Object
 InheritedsetPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 InheritedstopImmediatePropagation():void
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。
Event
 InheritedstopPropagation():void
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。
Event
  toString():String
NetStatusEvent オブジェクトのすべてのプロパティを含むストリングを返します。
NetStatusEvent
 InheritedvalueOf():Object
指定されたオブジェクトのプリミティブ値を返します。
Object
パブリック定数
 定数定義
 InheritedACTIVATE : String = "activate"
[static] activate イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedADDED : String = "added"
[static] added イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCANCEL : String = "cancel"
[static] cancelイベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCHANGE : String = "change"
[static] change イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCLOSE : String = "close"
[static] close イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCOMPLETE : String = "complete"
[static] complete イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCONNECT : String = "connect"
[static] connect イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] deactivate イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] enterFrame イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedID3 : String = "id3"
[static] id3 イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedINIT : String = "init"
[static] init イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] mouseLeave イベントオブジェクトの type プロパティの値を定義します。
Event
  NET_STATUS : String = "netStatus"
[static] netStatus イベントオブジェクトの type プロパティの値を定義します。
NetStatusEvent
 InheritedOPEN : String = "open"
[static] open イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedREMOVED : String = "removed"
[static] removed イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedRENDER : String = "render"
[static] render イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedRESIZE : String = "resize"
[static] resize イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSCROLL : String = "scroll"
[static] scroll イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSELECT : String = "select"
[static] select イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] soundComplete イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] tabChildrenChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] tabEnabledChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] tabIndexChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedUNLOAD : String = "unload"
[static] unload イベントオブジェクトの type プロパティの値を定義します。
Event
プロパティの詳細
infoプロパティ
info:Object  [read-write]

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

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

また、情報オブジェクトがこれ以外のプロパティを保持することもあります。code プロパティと level プロパティは一部の実装では機能せず、一部のサーバーでは別のオブジェクトが送られることがあります。 たとえば、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.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.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" セキュリティ上の理由で Action Message Format (AMF) 操作が実行できません。AMF URL が SWF ファイルと同じドメインにないか、SWF ファイルのドメインを信頼するポリシーファイルが AMF サーバーにありません。
NetConnection.Connect.Closed "status" 接続が正常に切断されました。
NetConnection.Connect.Failed "error" 接続試行が失敗しました。
NetConnection.Connect.Success "status" 接続試行が成功しました。
NetConnection.Connect.Rejected "error" 接続試行がアプリケーションにアクセスする許可を得られませんでした。
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 関数 NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)

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()メソッド
public override function clone():Event

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

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

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

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

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

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

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

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

関連項目


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

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

メモ: この例を実行するには、FLV ファイルが必要です。 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.
        }

    }
 }