Package | flash.events |
Classe | public class NetStatusEvent |
Héritage | NetStatusEvent Event Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
NetStatusEvent.NET_STATUS
.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
bubbles : Boolean [lecture seule]
Indique si un événement peut se propager vers le haut (bubbling). | Event | ||
cancelable : Boolean [lecture seule]
Indique si le comportement associé à l’événement peut être évité. | Event | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
currentTarget : Object [lecture seule]
L’objet qui traite activement l’objet Event avec un écouteur d’événements. | Event | ||
eventPhase : 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 | ||
target : Object [lecture seule]
Cible de l’événement. | Event | ||
type : String [lecture seule]
Type d’événement. | Event |
Méthode | Défini par | ||
---|---|---|---|
NetStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, info:Object = null)
Crée un objet d’événement contenant des informations sur les événements netStatus. | NetStatusEvent | ||
[override]
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 | ||
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Vérifie si la méthode preventDefault() a été appelée pour l’événement. | Event | ||
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 | ||
Annule le comportement par défaut d’un événement si cette opération est possible. | Event | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements. | Event | ||
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 la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
[override]
Renvoie une chaîne répertoriant toutes les propriétés de l’objet NetStatusEvent. | NetStatusEvent | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
Constante | Défini par | ||
---|---|---|---|
NET_STATUS : String = "netStatus" [statique]
Définit la valeur de la propriété type d’un objet d’événement netStatus. | NetStatusEvent |
info | propriété |
info:Object
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 l’objet NetStream
auquel le message appartient.
Par exemple, Flex Data Services envoie des objets Message qui provoquent des erreurs de forçage de type si vous tentez d’accéder au code
ou à la propriété level
.
Le tableau suivant répertorie les valeurs possibles des propriétés code
et level
.
Propriété du code | Propriété de niveau | Signification |
---|---|---|
"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.AppShutdown" | "error" | L’application côté serveur se ferme. |
"NetConnection.Connect.Closed" | "status" | La fermeture de la connexion a abouti. |
"NetConnection.Connect.Failed" | "error" | La tentative de connexion a échoué. |
"NetConnection.Connect.IdleTimeout" | "status" | Flash Media Server a déconnecté le client, car ce dernier est resté inactif plus longtemps que la valeur configurée pour <MaxIdleTime> . Sur Flash Media Server, <AutoCloseIdleClients> est par défaut désactivée. Lorsque cette propriété est activée, la valeur de délai d’attente par défaut est de 3 600 secondes (1 heure). Pour plus d’informations, voir Fermer les connexions inactives. |
"NetConnection.Connect.InvalidApp" | "error" | Le nom d’application spécifié lors de l’appel de NetConnection.connect() n’est pas valide. |
"NetConnection.Connect.NetworkChange" | "status" | Flash Player a détecté un changement au niveau du réseau, notamment une connexion sans fil abandonnée, une connexion sans fil qui a abouti ou la perte d’un câble réseau. Utilisez cet événement pour détecter tout changement dans l’interface réseau. N’utilisez pas cet événement pour implémenter votre logique de reconnexion NetConnection. Pour implémenter votre logique de reconnexion NetConnection, utilisez |
"NetConnection.Connect.Rejected" | "error" | La tentative de connexion n’avait pas accès à l’application. |
"NetConnection.Connect.Success" | "status" | La tentative de connexion a abouti. |
"NetGroup.Connect.Failed" | "error" | La tentative de connexion du groupe réseau a échoué. La propriété info.group indique quel groupe réseau a échoué. |
"NetGroup.Connect.Rejected" | "error" | Le groupe réseau n’est pas autorisé à fonctionner. La propriété info.group indique quel groupe réseau a été rejeté. |
"NetGroup.Connect.Success" | "status" | Le groupe réseau est correctement créé et autorisé à fonctionner. La propriété info.group indique quel groupe réseau a réussi. |
"NetGroup.LocalCoverage.Notify" | "status" | Envoyée lorsqu’une partie de l’espace d’adressage de groupe duquel est responsable ce nœud change. |
"NetGroup.MulticastStream.PublishNotify" | "status" | Envoyée lorsqu’un nouveau flux nommé est détecté dans le groupe de l’objet NetGroupe. La propriété info.name:String correspond au nom du flux détecté. |
"NetGroup.MulticastStream.UnpublishNotify" | "status" | Envoyée lorsqu’un flux nommé n’est plus disponible dans le groupe. La propriété info.name:String correspond au nom du flux qui a disparu. |
"NetGroup.Neighbor.Connect" | "status" | Envoyée lorsqu’un voisin se connecte à ce nœud. La propriété info.neighbor:String correspond à l’adresse de groupe de ce voisin. La propriété info.peerID:String correspond à l’ID homologue de ce voisin. |
"NetGroup.Neighbor.Disconnect" | "status" | Envoyée lorsqu’un voisin se déconnecte de ce nœud. La propriété info.neighbor:String correspond à l’adresse de groupe de ce voisin. La propriété info.peerID:String correspond à l’ID homologue de ce voisin. |
"NetGroup.Posting.Notify" | "status" | Envoyée lors de la réception d’un nouveau groupe de publication. La propriété info.message:Object représente le message. La propriété info.messageID:String correspond à l’ID du message de ce message. |
"NetGroup.Replication.Fetch.Failed" | "status" | Envoyée lorsqu’une demande de récupération d’un objet (précédemment annoncée via NetGroup.Replication.Fetch.SendNotify) échoue ou est refusée. Une nouvelle tentative de demande est effectuée si l’objet est toujours sollicité. La propriété info.index:Number représente l’index de l’objet ayant fait l’objet de la demande. |
"NetGroup.Replication.Fetch.Result" | "status" | Envoyée lorsqu’un voisin a répondu à une demande de récupération. La propriété info.index:Number représente l’index de l’objet de ce résultat. La propriété info.object:Object représente la valeur de cet objet. Cet index est automatiquement supprimé du paramètre Want défini. Si l’objet n’est pas valide, cet index peut être à rajouté au paramètre Want défini avec NetGroup.addWantObjects() . |
"NetGroup.Replication.Fetch.SendNotify" | "status" | Envoyée lorsque le système de réplication d’objets est sur le point d’envoyer une demande d’objet à un voisin. La propriété info.index:Number représente l’index de l’objet qui est demandé. |
"NetGroup.Replication.Request" | "status" | Envoyée lorsqu’un voisin a demandé un objet que ce nœud a annoncé via NetGroup.addHaveObjects() . Il est nécessaire de répondre à cette demande via NetGroup.writeRequestedObject() ou NetGroup.denyRequestedObject() . Notez que la réponse peut être asynchrone. La propriété info.index:Number représente l’index de l’objet ayant fait l’objet de la demande. La propriété info.requestID:int représente l’ID de cette demande devant être utilisé par NetGroup.writeRequestedObject() ou NetGroup.denyRequestedObject() . |
"NetGroup.SendTo.Notify" | "status" | Envoyée lors de la réception d’un message adressé à ce nœud. La propriété info.message:Object représente le message. La propriété info.from:String représente l’adresse de groupe à partir de laquelle le message a été reçu. La propriété info.fromLocal:Boolean est définie sur TRUE si le message a été envoyé par ce nœud (ce qui signifie que le nœud local est le plus proche de l’adresse de groupe de destination), et sur FALSE si le message a été reçu depuis un autre nœud. Pour mettre en œuvre le routage récursif, le message doit être renvoyé avec NetGroup.sendToNearest() si la propriété info.fromLocal est définie sur FALSE . |
"NetStream.Buffer.Empty" | "status" | Flash Player ne reçoit pas les données assez rapidement pour remplir la mémoire 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.Flush" | "status" | Le flux de données est terminé et le tampon restant va être vidé. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.Buffer.Full" | "status" | La mémoire tampon est pleine et la lecture du flux continu commence. |
"NetStream.Connect.Closed" | "status" | La connexion P2P a bien été fermée. La propriété info.stream indique le flux qui a été fermé. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.Connect.Failed" | "error" | Echec de la tentative de connexion P2P. La propriété info.stream désigne le flux qui a échoué. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"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é. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"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. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.DRM.UpdateNeeded" | "status" | Un objet NetStream tente de lire le contenu protégé, mais le module Flash Access requis est manquant, n’est pas autorisé par la stratégie de contenu en cours ou n’est pas compatible avec le lecteur actuel. Pour mettre à jour le module ou le lecteur, utilisez la méthode update() de flash.system.SystemUpdater. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.Failed" | "error" | (Flash Media Server) Une erreur s’est produite pour une raison autre que celles énumérées dans d’autres codes d’événement. |
"NetStream.MulticastStream.Reset" | "status" | Un abonnement multidiffusion a placé le focus sur un autre flux publié avec le même nom dans le même groupe. Les remplacements locaux de paramètres de flux de multidiffusion sont perdus. Appliquez de nouveau les remplacements locaux ou les paramètres par défaut du nouveau flux seront utilisés. |
"NetStream.Pause.Notify" | "status" | Le flux continu est en pause. |
"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. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.Play.FileStructureInvalid" | "error" | (AIR et Flash Player 9.0.115.0) L’application détecte une structure de fichiers non valide et n’essaie pas de lire ce type de fichier. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.Play.InsufficientBW" | "warning" | (Flash Media Server) Le client ne dispose pas de suffisamment de bande passante pour lire les données à la vitesse normale. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.Play.NoSupportedTrackFound" | "status" | (AIR et Flash Player 9.0.115.0) L’application ne détecte aucune piste prise en charge (vidéo, audio ou données) et n’essaie pas de lire le fichier. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.Play.PublishNotify" | "status" | La publication initiale dans un flux continu est envoyée à tous les abonnés. |
"NetStream.Play.Reset" | "status" | Causé par une réinitialisation de la liste de lecture. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.Play.Start" | "status" | La lecture a repris. |
"NetStream.Play.Stop" | "status" | La lecture s’est arrêtée. |
"NetStream.Play.StreamNotFound" | "error" | Le fichier FLV transmis à la méthode NetStream.play() est introuvable. |
"NetStream.Play.Transition" | "status" | (Flash Media Server 3.5) Suite au changement de vitesse de transmission 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. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.Play.UnpublishNotify" | "status" | Une annulation de la publication dans un flux continu est envoyée à tous les abonnés. |
"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.Publish.Start" | "status" | La publication a abouti. |
"NetStream.Record.AlreadyExists" | "status" | Le flux en cours d'enregistrement est mappé vers un fichier déjà enregistré sur un autre flux. La cause peut en être l'existence de répertoires virtuels mal configurés. |
"NetStream.Record.Failed" | "error" | Une tentative d’enregistrement d’un flux continu a échoué. |
"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.Start" | "status" | L’enregistrement a commencé. |
"NetStream.Record.Stop" | "status" | L’enregistrement s’est arrêté. |
"NetStream.SecondScreen.Start" | "status" | Envoyé lorsque la session PlayTo commence. Le champ description associé à cet événement contient le nom du périphérique qui capture la vidéo. S’applique uniquement à Windows 8.1 et IE 11 mode Modern UI. |
"NetStream.SecondScreen.Stop" | "status" | Envoyé lorsque la session PlayTo se termine. S’applique uniquement à Windows 8.1 et IE 11 mode Modern UI. |
"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 progressivement, 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é info.details de l’objet d’événement contient un code temporel qui indique la dernière position valide à laquelle l’utilisateur peut effectuer une recherche. |
"NetStream.Seek.Notify" | "status" | L’opération de recherche est terminée. Envoyé lorsque |
"NetStream.Step.Notify" | "status" | La procédure est terminée. Remarque : non pris en charge dans AIR 3.0 for iOS. |
"NetStream.Unpause.Notify" | "status" | Le flux continu a repris. |
"NetStream.Unpublish.Success" | "status" | L’opération d’annulation de la publication a abouti. |
"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.Flush.Failed" | "error" | L’état « en attente » est résolu, mais l’appel SharedObject.flush() a échoué. |
"SharedObject.Flush.Success" | "status" | L’état « en attente » est résolu et l’appel SharedObject.flush() a abouti. |
"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. |
"NetStream.Video.DimensionChange" | "status" | Les dimensions vidéo sont disponibles ou ont été modifiées. Utilisez la propriété videoWidth/videoHeight de l’objet Video ou StageVideo pour connaître les nouvelles dimensions de la vidéo. Nouveauté dans Flash Player 11.4/AIR 3.4. |
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
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
"NetStream.seek.InvalidTime"
. L’erreur "NetStream.seek.InvalidTime"
se produit lorsque l’utilisateur tente de rechercher au-delà de la fin du flux téléchargé. Cet exemple teste la valeur de la propriété code info.
de l’objet d’événement. Dans le cas où l’erreur se produit, la propriété eventObj.info.details
est affectée à une variable à utiliser comme paramètre pour la méthode seek()
du flux. La propriété eventObj.info.details
contient la dernière position valide disponible pour gérer l’erreur. L’utilisateur se dirige ainsi vers un emplacement valide à la fin du flux téléchargé.
function videoStatus(eventObj:NetStatusEvent):Void { switch(eventObj.info.code) { case "NetStream.Seek.InvalidTime": { var validSeekTime:Number = eventObj.info.details; nStream.seek(validSeekTime); break; } } }
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, Flash Lite 4 |
Crée un objet d’é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.
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 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 .
|
Eléments de l’API associés
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, Flash Lite 4 |
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éeEvent — 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, Flash Lite 4 |
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]
String — Chaîne répertoriant toutes les propriétés de l’objet NetStatusEvent.
|
NET_STATUS | Constante |
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, Flash Lite 4 |
Définit la valeur de la propriété type
d’un objet d’é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. |
Eléments de l’API associés
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 aboutit (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. } } }
Tue Jun 12 2018, 09:30 AM Z