Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
fl.video 

NCManager  - AS3 Flash

Packagefl.video
Classepublic class NCManager
HéritageNCManager Inheritance Object
Implémente INCManager
Sous-classes NCManagerNative

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Crée un objet NetConnection pour la classe VideoPlayer, qui constitue une classe d’aide et d’interaction avec l’utilisateur.

La classe NCManager recherche une URL et repose sur les conditions suivantes :

  • Si l’hôte de la chaîne d’URL commence par un protocole de diffusion en continu FMS valide (tels que rtmp://, rtmps:// ou rtmpt://) l’URL est considérée comme étant diffusée à partir d’un FMS.
  • Si elle n’est pas diffusée à partir d’un FMS et si l’URL contient un point d’interrogation (?), l’URL est considérée comme adressée à un fichier SMIL.
  • Si elle n’est pas diffusée à partir d’un FMS et ne contient pas de point d’interrogation (?), la classe NCManager vérifie si elle se termine par.flv. Si elle se termine par.flv, elle est traitée en tant que téléchargement FLV progressif. Sinon, elle est traitée en tant que fichier SMIL à télécharger et analyser.

Consulter les exemples



Propriétés publiques
 PropriétéDéfini par
  bitrate : Number
Lors de la diffusion continue à partir d’un serveur FMS (Flash Media Server), la propriété bitrate renvoie la valeur calculée par la procédure de détection automatique et non pas celle définie par la propriété bitrate().
NCManager
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  fallbackServerName : String
Expose la propriété fallbackServerName indirectement ou directement.
NCManager
  isRTMP : Boolean
[lecture seule] Indique si l’URL correspond à une diffusion en continu provenant d’un serveur FMS (Flash Media Server) ou d’un téléchargement progressif.
NCManager
  netConnection : NetConnection
[lecture seule] Référence à l’objet NetConnection.
NCManager
  streamHeight : int
[lecture seule] Hauteur du flux, en pixels.
NCManager
  streamLength : Number
[lecture seule] Longueur du flux, en secondes.
NCManager
  streamName : String
[lecture seule] Le nom de flux transmis par la méthode NetStream.play().
NCManager
  streamWidth : int
[lecture seule] Largeur du flux, en pixels.
NCManager
  timeout : uint
Le nombre de millisecondes devant précéder l’arrêt des tentatives de connexion.
NCManager
  videoPlayer : VideoPlayer
L'objet VideoPlayer qui possède cet objet.
NCManager
Méthodes publiques
 MéthodeDéfini par
  
Crée une occurrence de NCManager.
NCManager
  
Ferme NetConnection.
NCManager
  
Appelé par l’objet VideoPlayer si la connexion aboutit alors que le flux reste introuvable.
NCManager
  
Appelé par le lecteur VideoPlayer pour demander une connexion à l’URL.
NCManager
  
getProperty(propertyName:String):*
Permet de récupérer les propriétés fallbackServerName, fpadZone, objectEncoding et proxyType.
NCManager
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
  
helperDone(helper:Object, success:Boolean):void
Appelé par tout objet d’aide effectuant une tâche pour que l’objet NCManager puisse indiquer qu’il a terminé et s’il a réussi.
NCManager
 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
Indique si la propriété spécifiée existe et est énumérable.
Object
  
Appelé par l’objet VideoPlayer pour demander une nouvelle connexion lorsqu’une connexion est interrompue.
NCManager
  
setProperty(propertyName:String, value:*):void
Permet de définir les propriétés fallbackServerName, fpadZone, objectEncoding et proxyType.
NCManager
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
  DEFAULT_TIMEOUT : uint = 60000
Expiration par défaut de la connexion, en millisecondes.
NCManager
  SHORT_VERSION : String = "2.1"
[statique] Déclare une variable indiquant le numéro de version court du composant.
NCManager
  VERSION : String = "2.1.0.23"
[statique] Déclare une variable indiquant le numéro de version long du composant.
NCManager
Détails de la propriété

bitrate

propriété
bitrate:Number

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Lors de la diffusion continue à partir d’un serveur FMS (Flash Media Server), la propriété bitrate renvoie la valeur calculée par la procédure de détection automatique et non pas celle définie par la propriété bitrate().



Implémentation
    public function get bitrate():Number
    public function set bitrate(value:Number):void

Eléments de l’API associés

fallbackServerName

propriété 
public var fallbackServerName:String

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Expose la propriété fallbackServerName indirectement ou directement.

  • Indirectement—Fournit une deuxième balise <meta base> dans le bloc SMIL. La propriété fallbackServerName utilise cet attribut de base. (La propriété fallbackServerName a recours uniquement au nom de serveur, rien d’autre.)
  • Directement—Accède à la propriété ncMgr dans FLVPlayback ou VideoPlayer et définit la propriété fallbackServerName ou utilise la méthode setProperty().

Eléments de l’API associés

isRTMP

propriété 
isRTMP:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Indique si l’URL correspond à une diffusion en continu provenant d’un serveur FMS (Flash Media Server) ou d’un téléchargement progressif. Lorsqu’il s’agit d’un flux RTMP provenant d’un serveur FMS, défini sur true. Si le flux correspond à un téléchargement progressif de type HTTP, local ou autre, défini sur false.



Implémentation
    public function get isRTMP():Boolean

Eléments de l’API associés

netConnection

propriété 
netConnection:NetConnection  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Référence à l’objet NetConnection.



Implémentation
    public function get netConnection():NetConnection

Eléments de l’API associés

streamHeight

propriété 
streamHeight:int  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Hauteur du flux, en pixels. Lorsque la méthode VideoPlayer.ncConnected() est appelée et si la propriété streamHeight est inférieure à 0, ceci indique à l’objet VideoPlayer qu’il ne dispose d’aucune information sur la hauteur du flux. Si la propriété scaleMode de l’objet VideoPlayer est définie sur VideoScaleMode.MAINTAIN_ASPECT_RATIO ou VideoScaleMode.NO_SCALE, cette valeur s’applique et le redimensionnement se produit de façon instantanée, sans avoir à attendre.



Implémentation
    public function get streamHeight():int

Eléments de l’API associés

streamLength

propriété 
streamLength:Number  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Longueur du flux, en secondes. Lorsque la méthode VideoPlayer.ncConnected() est appelée et si elle renvoie undefined, null ou une valeur inférieure à 0, l’objet VideoPlayer ne dispose d’aucune information sur la longueur du flux. Si des informations sur la longueur du flux sont renvoyées, elles remplacent toutes les informations de flux existantes qui sont définies par le paramètre totalTime de la méthode VideoPlayer.play(), par la méthode VideoPlayer.load() ou toute autre information reçue à partir des métadonnées du fichier FLV.



Implémentation
    public function get streamLength():Number

Eléments de l’API associés

streamName

propriété 
streamName:String  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Le nom de flux transmis par la méthode NetStream.play().



Implémentation
    public function get streamName():String

Eléments de l’API associés

streamWidth

propriété 
streamWidth:int  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Largeur du flux, en pixels. Lorsque la méthode VideoPlayer.ncConnected() est appelée et si la propriété streamWidth est inférieure à 0, ceci indique à l’objet VideoPlayer qu’il ne dispose d’aucune information sur la largeur du flux. Si la propriété scaleMode de l’objet VideoPlayer est définie sur VideoScaleMode.MAINTAIN_ASPECT_RATIO ou VideoScaleMode.NO_SCALE, cette valeur s’applique et le redimensionnement se produit de façon instantanée, sans avoir à attendre.



Implémentation
    public function get streamWidth():int

Eléments de l’API associés

timeout

propriété 
timeout:uint

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Le nombre de millisecondes devant précéder l’arrêt des tentatives de connexion.



Implémentation
    public function get timeout():uint
    public function set timeout(value:uint):void

Eléments de l’API associés

videoPlayer

propriété 
videoPlayer:VideoPlayer

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

L'objet VideoPlayer qui possède cet objet.



Implémentation
    public function get videoPlayer():VideoPlayer
    public function set videoPlayer(value:VideoPlayer):void

Eléments de l’API associés

Détails du constructeur

NCManager

()Constructeur
public function NCManager()

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Crée une occurrence de NCManager.

Détails de la méthode

close

()méthode
public function close():void

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Ferme NetConnection.

Eléments de l’API associés

connectAgain

()méthode 
public function connectAgain():Boolean

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Appelé par l’objet VideoPlayer si la connexion aboutit alors que le flux reste introuvable. Si plusieurs interprétations de l’URL RTMP sont possibles, il tente de se connecter de nouveau au serveur avec une URL différente et de livrer un autre nom de flux.

Ceci peut être nécessaire lorsque l’URL ressemble à cet exemple : rtmp://nom_serveur/chemin1/chemin2/chemin3. Lors de la transmission d’un nom d’application et de nom d’occurrence, ouvrez l’objet NetConnection avec rtmp://nom_serveur/chemin1/chemin2 ou utilisez l’occurrence par défaut de façon à ouvrir le flux avec chemin2/chemin3. De manière générale, ceci est possible lorsque le chemin comporte plus de deux parties, mais impossible s’il n’en comporte que deux (il doit en disposer d’au moins une).

Valeur renvoyée
Boolean — En cas de tentative de nouvelle connexion, true. Si une nouvelle tentative a déjà été effectuée ou si aucune autre tentative supplémentaire n’est jugée nécessaire, false.

Eléments de l’API associés

connectToURL

()méthode 
public function connectToURL(url:String):Boolean

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Appelé par le lecteur VideoPlayer pour demander une connexion à l’URL. Une fois la connexion établie ou refusée, appelez la méthode VideoPlayer.ncConnected(). Si la connexion a échoué, définissez nc = null avant de procéder à l’appel.

Paramètres

url:String — L’URL à laquelle l’objet VideoPlayer demande une connexion.

Valeur renvoyée
Boolean — Si la connexion s'établit de façon synchrone, true. Lorsque la tentative se fait de façon asynchrone, l’appelant doit s’attendre à recevoir un événement « connected », false.

Eléments de l’API associés

getProperty

()méthode 
public function getProperty(propertyName:String):*

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Permet de récupérer les propriétés fallbackServerName, fpadZone, objectEncoding et proxyType. Voir la section setProperty() pour plus de détails sur ces propriétés.

Paramètres

propertyName:String — Le nom de la propriété que la méthode getProperty appelle.

Valeur renvoyée
* — Représentation sous forme de chaîne des propriétés fallbackServerName, fpadZone, objectEncoding et proxyType.

Eléments de l’API associés

helperDone

()méthode 
public function helperDone(helper:Object, success:Boolean):void

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Appelé par tout objet d’aide effectuant une tâche pour que l’objet NCManager puisse indiquer qu’il a terminé et s’il a réussi. L’objet NCManager utilise ceci avec SMILManager.

Paramètres

helper:Object — Objet helper.
 
success:Boolean — Paramètre permettant de signaler la fin de la tâche. Si success a la valeur true, la tâche s’est terminée avec succès, false dans le cas contraire.

Eléments de l’API associés

reconnect

()méthode 
public function reconnect():void

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Appelé par l’objet VideoPlayer pour demander une nouvelle connexion lorsqu’une connexion est interrompue. Une fois la connexion établie ou refusée, appelez la méthode VideoPlayer.ncReconnected(). Si la connexion a échoué, définissez nc = null avant d’appeler.

Eléments de l’API associés

setProperty

()méthode 
public function setProperty(propertyName:String, value:*):void

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Permet de définir les propriétés fallbackServerName, fpadZone, objectEncoding et proxyType.

La propriété fallbackServerName spécifie l’URL du serveur FMS (Flash Media Server) à utiliser lorsque l’adresse principale du serveur déduite de l’URL transmise dans connectToURL() ne peut pas être atteinte. Cette propriété peut également être définie directement par la propriété fallbackServerName.

La propriété fpadZone spécifie la propriété fpadZone pour le serveur FMS (Flash Media Server). Lorsque la valeur renvoyée n’est pas un nombre (NaN), aucune zone n’est définie. La propriété fpadZone doit être définie avant le début du processus de connexion. Si vous ne souhaitez pas définir de zone, définissez la propriété fpadZone sur NaN.

La valeur par défaut est NaN.

La propriété objectEncoding spécifie la valeur à utiliser pour la propriété objectEncoding des occurrences de NetConnection. La valeur par défaut est flash.net.ObjectEncoding.AMF0.

La propriété proxyType spécifie la valeur à utiliser pour la propriété proxyType des occurrences de NetConnection. La valeur par défaut est « best ».

Paramètres

propertyName:String — Le nom de la propriété que la méthode setProperty appelle.
 
value:* — Valeur de la propriété.

Eléments de l’API associés

Détails de la constante

DEFAULT_TIMEOUT

Constante
public const DEFAULT_TIMEOUT:uint = 60000

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Expiration par défaut de la connexion, en millisecondes.

Eléments de l’API associés

SHORT_VERSION

Constante 
public static const SHORT_VERSION:String = "2.1"

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Déclare une variable indiquant le numéro de version court du composant. Le numéro de version est utile lorsque vous disposez d’un fichier FLA et devez connaître la version du composant. Pour déterminer la version du composant, tapez le code de suivi ci-dessous dans le fichier FLA :

FLVPlayback.SHORT_VERSION

La variable SHORT_VERSION inclut uniquement la version majeure et secondaire, par exemple, 2.0. La variable VERSION inclut les numéros de version majeure et secondaire, ainsi que la révision et les numéros, par exemple, 2.0.0.11.

Eléments de l’API associés

VERSION

Constante 
public static const VERSION:String = "2.1.0.23"

Version du langage: ActionScript 3.0
Version du produit: Flash CS3
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Déclare une variable indiquant le numéro de version long du composant. Le numéro de version est utile lorsque vous disposez d’un fichier FLA et devez connaître la version du composant. Pour déterminer la version du composant, tapez le code de suivi ci-dessous dans le fichier FLA :

FLVPlayback.VERSION

La variable VERSION inclut les numéros de version majeure et secondaire, ainsi que la révision et les numéros, par exemple, 2.0.0.11. La variable SHORT_VERSION inclut uniquement la version majeure et secondaire, par exemple, 2.0.

Eléments de l’API associés

NCManagerExample.as

Cet exemple indique comment accéder à l’objet NCManager d’un objet VideoPlayer pour déterminer si la vidéo est diffusée en flux continu ou si elle est téléchargée de façon progressive.

Pour exécuter l’exemple, suivez ces étapes :

  1. Ajoutez le composant FLVPlayback dans votre bibliothèque.
  2. Remplacez testVideoPath par un chemin absolu ou relatif vers un fichier FLV.
  3. Enregistrez ce code sous le nom NCManagerExample.as, dans le même répertoire que votre fichier FLA.
  4. Définissez la classe Document dans le fichier FLA sur NCManagerExample.
package
{
    import fl.video.VideoEvent;
    import fl.video.VideoPlayer;
    import flash.display.Sprite;    

    public class NCManagerExample extends Sprite 
    {
        private var videoPath:String = "http://www.helpexamples.com/flash/video/sheep.flv"
        private var player:VideoPlayer;
        
        public function NCManagerExample() {
            player = new VideoPlayer();
            player.play(videoPath);
            player.addEventListener(VideoEvent.READY,announceRTMS);
            addChild(player);
        }
        private function announceRTMS(e:VideoEvent):void {
            var player:VideoPlayer = e.target as VideoPlayer;
            if(player.ncMgr.isRTMP) {
                trace("Video is streaming");
            }
            else {
                trace("Video is progressively downloading");
            }
        }
    }
}




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.