Packageflash.events
Classepublic class NetStatusEvent
HéritageNetStatusEvent Inheritance Event Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Un objet NetConnection, NetStream ou SharedObject distribue des objets NetStatusEvent lorsqu'il signale son état. Il n'existe qu'un seul type d'événement status : NetStatusEvent.NET_STATUS.

Consulter les exemples

Voir aussi

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


Propriétés publiques
 PropriétéDéfini par
 Inheritedbubbles : Boolean
[lecture seule] Indique si un événement peut se propager vers le haut (bubbling).
Event
 Inheritedcancelable : Boolean
[lecture seule] Indique si le comportement associé à l'événement peut être annulé.
Event
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
 InheritedcurrentTarget : Object
[lecture seule] L'objet qui traite activement l'objet Event avec un écouteur d'événements.
Event
 InheritedeventPhase : uint
[lecture seule] Phase actuelle du flux d'événements.
Event
  info : Object
Objet associé à des propriétés décrivant son état ou indiquant une erreur.
NetStatusEvent
 Inheritedprototype : Object
[statique] Référence à l'objet prototype d'un objet de classe ou fonction.
Object
 Inheritedtarget : Object
[lecture seule] Cible de l'événement.
Event
 Inheritedtype : String
[lecture seule] Type d'événement.
Event
Méthodes publiques
 MéthodeDéfini par
  
NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)
Crée un objet événement contenant des informations sur les événements netStatus.
NetStatusEvent
  
Crée une copie de l'objet NetStatusEvent et définit la valeur de chaque propriété de sorte qu'elle corresponde à la valeur d'origine.
NetStatusEvent
 Inherited
formatToString(className:String, ... arguments):String
Fonction d'un utilitaire permettant d'implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées.
Event
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Vérifie si la méthode preventDefault() a été appelée pour l'événement.
Event
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
 Inherited
Annule le comportement par défaut d'un événement si cette opération est possible.
Event
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Bloque le traitement des écouteurs d'événement dans le nœud actuel et les suivants dans le flux d'événements.
Event
 Inherited
Bloque le traitement des écouteurs d'événement dans les nœuds qui suivent le nœud actuel dans le flux d'événements.
Event
  
Renvoie une chaîne répertoriant toutes les propriétés de l'objet NetStatusEvent.
NetStatusEvent
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
 InheritedACTIVATE : String = "activate"
[statique] La constante ACTIVATE définit la valeur de la propriété type d'un objet événement activate.
Event
 InheritedADDED : String = "added"
[statique] La constante Event.ADDED définit la valeur de la propriété type d'un objet événement added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[statique] La constante Event.ADDED_TO_STAGE définit la valeur de la propriété type d'un objet d'événement addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[statique] La constante Event.CANCEL définit la valeur de la propriété type d'un objet événement cancel.
Event
 InheritedCHANGE : String = "change"
[statique] La constante Event.CHANGE définit la valeur de la propriété type de l'objet d'événement change.
Event
 InheritedCLEAR : String = "clear"
[statique] La constante Event.CLEAR définit la valeur de la propriété type d'un objet événement clear.
Event
 InheritedCLOSE : String = "close"
[statique] La constante Event.CLOSE définit la valeur de la propriété type d'un objet événement close.
Event
 InheritedAIR-only CLOSING : String = "closing"
[statique] La constante Event.CLOSING définit la valeur de la propriété type d'un objet événement closing.
Event
 InheritedCOMPLETE : String = "complete"
[statique] La constante Event.COMPLETE définit la valeur de la propriété type d'un objet événement complete.
Event
 InheritedCONNECT : String = "connect"
[statique] La constante Event.CONNECT définit la valeur de la propriété type d'un objet événement connect.
Event
 InheritedCOPY : String = "copy"
[statique] Définit la valeur de la propriété type d'un objet d'événement copy.
Event
 InheritedCUT : String = "cut"
[statique] Définit la valeur de la propriété type d'un objet d'événement cut.
Event
 InheritedDEACTIVATE : String = "deactivate"
[statique] La constante Event.DEACTIVATE définit la valeur de la propriété type d'un objet événement deactivate.
Event
 InheritedDISPLAYING : String = "displaying"
[statique] La constante Event.DISPLAYING définit la valeur de la propriété type d'un objet événement displaying.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[statique] La constante Event.ENTER_FRAME définit la valeur de la propriété type d'un objet événement enterFrame.
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[statique] La constante Event.EXIT_FRAME définit la valeur de la propriété type d'un objet événement exitFrame.
Event
 InheritedAIR-only EXITING : String = "exiting"
[statique] La constante Event.EXITING définit la valeur de la propriété type de l'objet d'événement exiting.
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[statique] La constante Event.FRAME_CONSTRUCTED définit la valeur de la propriété type d'un objet événement frameConstructed.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[statique] La constante Event.FULL_SCREEN définit la valeur de la propriété type d'un objet événement fullScreen.
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[statique] La constante Event.HTML_BOUNDS_CHANGE définit la valeur de la propriété type d'un objet événement htmlBoundsChange.
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[statique] La constante Event.HTML_DOM_INITIALIZE définit la valeur de la propriété type d'un objet événement htmlDOMInitialize.
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[statique] La constante Event.HTML_RENDER définit la valeur de la propriété type d'un objet événement htmlRender.
Event
 InheritedID3 : String = "id3"
[statique] La constante Event.ID3 définit la valeur de la propriété type d'un objet événement id3.
Event
 InheritedINIT : String = "init"
[statique] La constante Event.INIT définit la valeur de la propriété type d'un objet événement init.
Event
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[statique] La constante Event.LOCATION_CHANGE définit la valeur de la propriété type d'un objet événement locationChange.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[statique] La constante Event.MOUSE_LEAVE définit la valeur de la propriété type d'un objet événement mouseLeave.
Event
  NET_STATUS : String = "netStatus"
[statique] Définit la valeur de la propriété type d'un objet événement netStatus.
NetStatusEvent
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[statique] La constante Event.NETWORK_CHANGE définit la valeur de la propriété type d'un objet événement networkChange.
Event
 InheritedOPEN : String = "open"
[statique] La constante Event.OPEN définit la valeur de la propriété type d'un objet événement open.
Event
 InheritedPASTE : String = "paste"
[statique] La constante Event.PASTE définit la valeur de la propriété type d'un objet événement paste.
Event
 InheritedREMOVED : String = "removed"
[statique] La constante Event.REMOVED définit la valeur de la propriété type d'un objet événement removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[statique] La constante Event.REMOVED_FROM_STAGE définit la valeur de la propriété type d'un objet événement removedFromStage.
Event
 InheritedRENDER : String = "render"
[statique] La constante Event.RENDER définit la valeur de la propriété type d'un objet événement render.
Event
 InheritedRESIZE : String = "resize"
[statique] La constante Event.RESIZE définit la valeur de la propriété type d'un objet événement resize.
Event
 InheritedSCROLL : String = "scroll"
[statique] La constante Event.SCROLL définit la valeur de la propriété type d'un objet événement scroll.
Event
 InheritedSELECT : String = "select"
[statique] La constante Event.SELECT définit la valeur de la propriété type d'un objet événement select.
Event
 InheritedSELECT_ALL : String = "selectAll"
[statique] La constante Event.SELECT_ALL définit la valeur de la propriété type d'un objet événement selectAll.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[statique] La constante Event.SOUND_COMPLETE définit la valeur de la propriété type d'un objet événement soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[statique] La constante Event.TAB_CHILDREN_CHANGE définit la valeur de la propriété type d'un objet événement tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[statique] La constante Event.TAB_ENABLED_CHANGE définit la valeur de la propriété type d'un objet événement tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[statique] La constante Event.TAB_INDEX_CHANGE définit la valeur de la propriété type d'un objet événement tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[statique] La constante Event.UNLOAD définit la valeur de la propriété type d'un objet événement unload.
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[statique] La constante Event.USER_IDLE définit la valeur de la propriété type d'un objet événement userIdle.
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[statique] La constante Event.USER_PRESENT définit la valeur de la propriété type d'un objet événement userPresent.
Event
Détails de la propriété
infopropriété
info:Object  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Objet associé à des propriétés décrivant son état ou indiquant une erreur.

L'objet d'informations peut avoir une propriété code contenant une chaîne représentant un événement spécifique ou une propriété level contenant une chaîne "status" ou "error".

L'objet d'informations peut également être différent. Les propriétés code et level peuvent ne pas fonctionner pour certaines implémentations et certains serveurs peuvent envoyer des objets différents.

Les connexions P2P envoient des messages à un objet NetConnection avec un paramètre stream dans l'objet d'informations désignant le NetStream que le message concerne.

Le tableau suivant répertorie les valeurs possibles des propriétés code et level.

Propriété du codePropriété de niveauSignification
"NetStream.Buffer.Empty" "status" Les données ne sont pas reçues suffisamment rapidement pour remplir le tampon. Le flux de données est interrompu tant que la mémoire tampon n'est pas rechargée : une fois l'opération terminée, un message NetStream.Buffer.Full est envoyé et la lecture du flux continu reprend.
"NetStream.Buffer.Full" "status" La mémoire tampon est pleine et la lecture du flux continu commence.
"NetStream.Buffer.Flush" "status" Le flux de données est terminé et le tampon restant va être vidé.
"NetStream.Failed" "erreur"Flash Media Server uniquement. Une erreur s'est produite pour une raison autre que celles énumérées dans d'autres codes d'événement.
"NetStream.Publish.Start" "status" La publication a abouti.
"NetStream.Publish.BadName" "error" Tentative de publication d'un flux continu qui est en cours de publication par une autre personne.
"NetStream.Publish.Idle" "status" La publication du flux est inactive et ne transmet pas de données.
"NetStream.Unpublish.Success" "status" L'opération d'annulation de la publication a abouti.
"NetStream.Play.Start" "status" La lecture a repris.
"NetStream.Play.Stop" "status" La lecture s'est arrêtée.
"NetStream.Play.Failed" "error" Une erreur est survenue pendant la lecture, pour une autre raison que celles énumérées dans ce tableau, par exemple l'abonné n'a pas d'accès en lecture.
"NetStream.Play.StreamNotFound" "error" Le fichier FLV transmis à la méthode play() est introuvable.
"NetStream.Play.Reset" "status" Causé par une réinitialisation de la liste de lecture.
"NetStream.Play.PublishNotify" "status" La publication initiale dans un flux continu est envoyée à tous les abonnés.
"NetStream.Play.UnpublishNotify" "status" Une annulation de la publication dans un flux continu est envoyée à tous les abonnés.
"NetStream.Play.InsufficientBW" "avertissement"Flash Media Server uniquement. Le client ne dispose pas de suffisamment de bande passante pour lire les données à la vitesse normale.
"NetStream.Play.FileStructureInvalid" "error" L'application détecte une structure de fichiers non valide et n'essaie pas de lire ce type de fichier. Pour AIR et Flash Player 9.0.115.0 et versions ultérieures.
"NetStream.Play.NoSupportedTrackFound" "error" L'application ne détecte aucune piste prise en charge (vidéo, audio ou données) et n'essaie pas de lire le fichier. Pour AIR et Flash Player 9.0.115.0 et versions ultérieures.
"NetStream.Play.Transition" "status" Flash Media Server uniquement. Le flux transite vers un autre après un basculement du flux de débit. Ce code indique un événement de réussite pour que l'appel de NetStream.play2() initie un basculement du flux. Si le basculement est un échec, le serveur envoie à la place un événement NetStream.Play.Failed. Pour Flash Player 10 et les versions ultérieures.
"NetStream.Play.Transition" "status" Flash Media Server 3.5 et versions ultérieures uniquement. Suite au changement de débit du flux continu, le serveur a reçu une commande de transition vers un autre flux continu. Ce code indique un événement de réussite pour que l'appel de NetStream.play2() initie un basculement du flux. Si le basculement est un échec, le serveur envoie à la place un événement NetStream.Play.Failed. Si le changement du flux se produit, un événement onPlayStatus dont le code est "NetStream.Play.TransitionComplete" est distribué. Pour Flash Player 10 et les versions ultérieures.
"NetStream.Pause.Notify" "status" Le flux continu est en pause.
"NetStream.Unpause.Notify" "status" Le flux continu a repris.
"NetStream.Record.Start" "status" L'enregistrement a commencé.
"NetStream.Record.NoAccess" "error" Il s'est produit une tentative d'enregistrement d'un flux continu dont la lecture n'est pas terminée, ou le client ne dispose pas de droits d'accès.
"NetStream.Record.Stop" "status" L'enregistrement s'est arrêté.
"NetStream.Record.Failed" "error" Une tentative d'enregistrement d'un flux continu a échoué.
"NetStream.Seek.Failed" "error" La recherche a échoué. Cette erreur se produit s'il est impossible d'effectuer des recherches dans le flux continu.
"NetStream.Seek.InvalidTime" "error" Pour une vidéo chargée avec un chargement progressif, l'utilisateur a tenté de rechercher ou de lire au-delà des données vidéo déjà chargées, ou après la fin de la vidéo lorsque le fichier a été totalement chargé. La propriété message.details contient un code de temps qui indique la dernière position valide de recherche utilisateur.
"NetStream.Seek.Notify" "status" L'opération de recherche est terminée.
"NetConnection.Call.BadVersion" "error" Paquet codé dans un format non identifié.
"NetConnection.Call.Failed" "error" La méthode NetConnection.call n'a pas pu appeler la méthode ou la commande côté serveur.
"NetConnection.Call.Prohibited" "error" Une opération AMF (Action Message Format) est bloquée pour des raisons de sécurité. Soit l'URL AMF n'est pas dans le même domaine que le fichier contenant le code appelant la méthode NetConnection.call(), soit le serveur AMF n'a pas de fichier de régulation qui approuve le domaine du fichier contenant le code appelant la méthode NetConnection.call().
"NetConnection.Connect.Closed" "status" La fermeture de la connexion a abouti.
"NetConnection.Connect.Failed" "error" La tentative de connexion a échoué.
"NetConnection.Connect.Success" "status" La tentative de connexion a abouti.
"NetConnection.Connect.Rejected" "error" La tentative de connexion n'avait pas accès à l'application.
"NetStream.Connect.Closed" "status" La connexion P2P a bien été fermée. La propriété info.stream indique le flux qui a été fermé.
"NetStream.Connect.Failed" "error" Echec de la tentative de connexion P2P. La propriété info.stream désigne le flux qui a échoué.
"NetStream.Connect.Success" "status" La tentative de connexion P2P a réussi. La propriété info.stream désigne le flux qui a réussi.
"NetStream.Connect.Rejected" "error" La tentative de connexion P2P ne disposait pas des autorisations nécessaires pour accéder à l'autre homologue. La propriété info.stream désigne le flux qui a été rejeté.
"NetConnection.Connect.AppShutdown" "error" L'application spécifiée se ferme.
"NetConnection.Connect.InvalidApp" "error" Le nom d'application spécifié lors de la connexion n'est pas valide.
"SharedObject.Flush.Success" "status" L'état « en attente » est résolu et l'appel SharedObject.flush() a abouti.
"SharedObject.Flush.Failed" "error" L'état « en attente » est résolu, mais l'appel SharedObject.flush() a échoué.
"SharedObject.BadPersistence" "error" Un objet partagé doté d'indicateurs de persistance a été demandé, mais la requête ne peut pas être accordée car l'objet a déjà été créé avec d'autres indicateurs.
"SharedObject.UriMismatch" "error" Une tentative de connexion à un objet NetConnection ne possédant pas la même URI (URL) que l'objet partagé a été effectuée.

Si vous recevez systématiquement des erreurs concernant la mémoire tampon, tentez de modifier celle-ci à l'aide de la propriété NetStream.bufferTime.



Implémentation
    public function get info():Object
    public function set info(value:Object):void

Voir aussi

Détails du constructeur
NetStatusEvent()Constructeur
public function NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Crée un objet événement contenant des informations sur les événements netStatus. Les objets Event sont transmis en tant que paramètres aux écouteurs d'événements.

Paramètres
type:String — Type de l'événement. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété type héritée. Il n'existe qu'un seul type d'événement status : NetStatusEvent.NET_STATUS.
 
bubbles:Boolean (default = false) — Détermine si l'objet Event prend part à la phase de propagation vers le haut (bubbling) du flux d'événements. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété bubbles héritée.
 
cancelable:Boolean (default = false) — Détermine si l'objet Event peut être annulé. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété cancelable héritée.
 
info:Object (default = null) — Objet contenant des propriétés décrivant son état. Les écouteurs d'événement peuvent accéder à cet objet par le biais de la propriété info.

Voir aussi

Détails de la méthode
clone()méthode
override public function clone():Event

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Crée une copie de l'objet NetStatusEvent et définit la valeur de chaque propriété de sorte qu'elle corresponde à la valeur d'origine.

Valeur renvoyée
Event — Nouvel objet NetStatusEvent dont les propriétés ont la même valeur que celles de l'objet d'origine.
toString()méthode 
override public function toString():String

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Renvoie une chaîne répertoriant toutes les propriétés de l'objet NetStatusEvent. La chaîne est écrite au format suivant :

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

Valeur renvoyée
String — Chaîne répertoriant toutes les propriétés de l'objet NetStatusEvent.
Détails de la constante
NET_STATUSConstante
public static const NET_STATUS:String = "netStatus"

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Définit la valeur de la propriété type d'un objet événement netStatus.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
currentTarget L'objet qui traite activement l'objet Event avec un écouteur d'événements.
info Objet associé à des propriétés décrivant son état ou indiquant une erreur.
target Objet NetConnection ou NetStream publiant son état.

Voir aussi

Exemples Utilisation des exemples
NetStatusEventExample.as

L'exemple suivant utilise un objet Video avec les classes NetConnection et NetStream pour charger et lire un fichier FLV.

Dans cet exemple, la méthode netStatusHandler est enregistrée en tant qu'écouteur de l'événement NetStatusEvent NetConnection.netStatus. Lorsque l'état (réussite ou échec) de la tentative de NetConnection.connect() est connu, l'événement netStatus déclenche cette méthode. Si la tentative de connexion à l'objet NetConnection est réussie (en d'autres termes, si la propriété info de l'objet NetStatusEvent distribué par l'événement netStatus possède une propriété code indiquant un succès), le code crée les objets Video et NetStream et appelle les méthodes Video.attachNetStream() et NetStream.play().

Remarque : pour exécuter cet exemple, vous devez disposer d'un fichier FLV dont le nom et l'emplacement correspondent à la variable transmise à videoURL ; dans ce cas, un fichier FLV nommé Video.flv et situé dans le même répertoire que le fichier SWF.

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.
        }

    }
 }