Flash CS4 Professional ActionScript 2.0

Classe Media

Héritage MovieClip > Classe UIObject > Classe UIComponent > Media

Noms de classe ActionScript mx.controls.MediaController, mx.controls.MediaDisplay, mx.controls.MediaPlayback

Toutes les classes de composants ont une propriété version qui correspond à une propriété de classe. Les propriétés de classe sont uniquement disponibles pour la classe elle-même.
La propriété version renvoie une chaîne qui indique la version du composant. Pour accéder à cette propriété, utilisez le code suivant :

trace(mx.controls.MediaPlayback.version);

REMARQUE

 

Le code trace(myMediaInstance.version); renvoie undefined.

Méthodes de la classe Media

Le tableau suivant répertorie les méthodes de la classe Media.

Méthode

Composants

Description

Media.addCuePoint()

MediaDisplay, MediaPlayback

Ajoute un objet point de repère à l'occurrence du composant.

Media.associateController()

MediaDisplay

Associe une occurrence de MediaDisplay à une occurrence de MediaController.

Media.associateDisplay()

MediaController

Associe une occurrence de MediaController à une occurrence de MediaDisplay.

Media.displayFull()

MediaPlayback

Convertit l'occurrence du composant en mode de lecture plein écran.

Media.displayNormal()

MediaPlayback

Reconvertit l'occurrence de composant à sa taille d'écran originale.

Media.getCuePoint()

MediaDisplay, MediaPlayback

Renvoie un objet point de repère.

Media.pause()

MediaDisplay, MediaPlayback

Met la tête de lecture en pause à son emplacement actuel dans le scénario du support.

Media.play()

MediaDisplay, MediaPlayback

Lit le support associé à l'occurrence de composant à un point de départ donné.

Media.removeAllCuePoints()

MediaDisplay, MediaPlayback

Supprime tous les objets point de repère associés à une occurrence de composant donnée.

Media.removeCuePoint()

MediaDisplay, MediaPlayback

Supprime un point de repère spécifié associé à une occurrence de composant donnée.

Media.setMedia()

MediaDisplay, MediaPlayback

Définit le type et le chemin du support sur le type de support spécifié.

Media.stop()

MediaDisplay, MediaPlayback

Arrête la tête de lecture et la déplace à la position 0, qui correspond au début du support.

Propriétés de la classe Media

Le tableau suivant répertorie les propriétés de la classe Media.

Propriété

Composants

Description

Media.activePlayControl

MediaController

Détermine l'état du composant lors de son chargement à l'exécution.

Media.aspectRatio

MediaDisplay, MediaPlayback

Détermine si l'occurrence du composant conserve les proportions de sa vidéo.

Media.autoPlay

MediaDisplay, MediaPlayback

Détermine si l'occurrence du composant est immédiatement mise en mémoire tampon et lue.

Media.autoSize

MediaDisplay, MediaPlayback

Détermine la taille de la portion d'affichage de support du composant MediaDisplay ou MediaPlayback.

Media.backgroundStyle

MediaController

Détermine si l'occurrence du composant dessine son arrière-plan chromé.

Media.bytesLoaded

MediaDisplay, MediaPlayback

Lecture seule ; le nombre d'octets chargés pouvant être lus.

Media.bytesTotal

MediaDisplay, MediaPlayback

Nombre d'octets à charger dans l'occurrence du composant.

Media.contentPath

MediaDisplay, MediaPlayback

Chaîne contenant le chemin relatif et le nom de fichier du support devant être diffusé en flux continu et lu.

Media.controllerPolicy

MediaController, MediaPlayback

Détermine si le contrôleur est masqué lorsqu'il est instancié et n'est affiché que lorsque l'utilisateur fait passer la souris sur l'état réduit du contrôleur.

Media.controlPlacement

MediaPlayback

Détermine l'endroit où les contrôles du composants sont positionnés.

Media.cuePoints

MediaDisplay, MediaPlayback

Tableau d'objets point de repère ayant été associés à une occurrence de composant donnée.

Media.horizontal

MediaController

Détermine l'orientation de l'occurrence du composant.

Media.mediaType

MediaDisplay, MediaPlayback

Détermine le type de support à lire.

Media.playheadTime

MediaDisplay, MediaPlayback

Contient la position actuelle de la tête de lecture (en secondes) pour le scénario de support en cours de lecture.

Media.playing

MediaDisplay, MediaPlayback, MediaController

Pour MediaDisplay et MediaPlayback, cette propriété est en lecture seule et renvoie une valeur booléenne pour indiquer si une occurrence de composant donnée lit un support. Pour MediaController, cette propriété a un accès en lecture/écriture et contrôle l'image (en cours de lecture ou en pause) affichée sur le bouton Lire/Pause du contrôleur.

Media.preferredHeight

MediaDisplay, MediaPlayback

Valeur par défaut de la hauteur d'un fichier FLV.

Media.preferredWidth

MediaDisplay, MediaPlayback

Valeur par défaut de la largeur d'un fichier FLV.

Media.totalTime

MediaDisplay, MediaPlayback

Nombre entier indiquant la durée totale du support, en secondes.

Media.volume

MediaDisplay, MediaPlayback

Nombre entier de 0 (minimum) à 100 (maximum) représentant le niveau de volume.

Evénements de la classe Media

Le tableau suivant répertorie les événements de la classe Media.

Evénement

Composants

Description

Media.change

MediaDisplay, MediaPlayback

Diffusé en continu pendant la lecture du support.

Media.click

MediaController, MediaPlayback

Diffusé lorsque l'utilisateur clique sur le bouton Lire/Pause.

Media.complete

MediaDisplay, MediaPlayback

Notification indiquant que la tête de lecture a atteint la fin du support.

Media.cuePoint

MediaDisplay, MediaPlayback

Notification indiquant que la tête de lecture a atteint un point de repère donné.

Media.playheadChange

MediaController, MediaPlayback

Diffusé par l'occurrence du composant lorsque l'utilisateur déplace le curseur de lecture ou clique sur le bouton Rembobiner ou Atteindre la fin.

Media.progress

MediaDisplay, MediaPlayback

Généré en continu jusqu'à la fin du téléchargement du support.

Media.scrubbing

MediaController,

MediaPlayback

Généré lorsque l'utilisateur déplace la tête de lecture.

Media.volume

MediaController, MediaPlayback

Diffusé lorsque l'utilisateur règle le volume.