NetStreamPlayOptions  - AS3

Durée de la lecture, en secondes, du flux spécifié dans streamName. La valeur par défaut est -1, et signifie que Flash Player lit un flux en direct jusqu’à ce qu’il ne soit plus disponible ou lit un flux enregistré jusqu’à la fin. Si vous transmettez 0 pour len, Flash Player lit l’unique image située à start secondes du début d’un flux enregistré (en supposant que start est égal ou supérieur à 0).

Si vous transmettez un nombre positif pour len, Flash Player lit un flux en direct pendant len secondes lorsqu’il devient disponible, ou lit un flux enregistré pendant len secondes (si le flux se termine avant len secondes, la lecture prend fin en même temps que le flux).

Si vous transmettez un nombre négatif autre que -1 pour len, Flash Player interprète la valeur comme s’il s’agissait de -1.

Eléments de l’API associés

Heure absolue à laquelle le serveur commute les flux de débits différents pour la diffusion en continu dynamique de Flash Media Server. La propriété offset est utilisée lors d’un appel de la méthode NetStream.play2() avec le mode de transition NetStreamPlayTransitions.SWITCH. Il existe deux modes de commutation : commutation rapide et commutation standard. La valeur par défaut de offset est -1, qui correspond au mode de commutation rapide. Ecrivez la logique ActionScript pour décider quand utiliser la commutation rapide et quand utiliser la commutation standard.

Commutation rapide

En mode de commutation rapide, Flash Media Server bascule sur le nouveau flux sans attendre de lire les données dans la mémoire tampon. Toutes les données mises en mémoire tampon à partir de l’ancien flux après le décalage (offset) sont effacées. La commutation rapide est plus rapide que la commutation standard, car il n’est pas nécessaire de lire les données mises en mémoire tampon à partir de l’ancien flux.

La valeur par défaut de offset est -1, qui correspond au mode de commutation rapide. Lorsque la propriété offset est définie sur -1, la commutation se produit à la première image-clé disponible après netstream.time + 3, c’est-à-dire environ 3 secondes plus tard que le point où la lecture s’est arrêtée. Vous pouvez également définir la propriété offset sur n’importe quelle valeur supérieure à netstream.time. Par exemple, pour activer la commutation rapide 5 secondes après le point où s’est arrêtée la lecture, définissez la propriété offset sur Netstream.time + 5. Si la valeur de la propriété offset est inférieure à netstream.time, un événement d’état NetStream.Play.Failed est envoyé.

Remarque : la propriété offset dépend de l’heure absolue du flux, elle n’est pas un décalage à partir du point où s’est arrêtée la lecture. Par exemple, pour activer la commutation 5 secondes à partir du point où s’est arrêtée la lecture, définissez la propriété offset sur netstream.time + 5 et non sur 5.

Commutation standard

Pour utiliser la commutation standard au lieu de la commutation rapide, définissez la propriété offset sur une valeur supérieure à netstream.time + netstream.bufferLength.

Utilisez la commutation standard lorsque le client dispose d’un débit élevé dans la mémoire tampon et souhaite basculer sur une bande passante inférieure en raison d’une perte de la bande passante (et non en raison d’une perte d’images ou de problèmes au niveau de l’unité centrale). Le client peut utiliser le débit le plus élevé aussi longtemps que possible et basculer sur un débit inférieur à la fin du tampon (comme dans le cas de la commutation standard).

Pour plus d’informations, voir la section "Commutation rapide entre les flux" du Guide du développeur d’Adobe Flash Media Server.

Eléments de l’API associés

Nom de l’ancien flux ou du flux à partir duquel s’effectue la transition. Lorsque la méthode NetStream.play2() n’est utilisée que pour lire un flux (sans effectuer de transition), la valeur de cette propriété doit être null ou undefined. Sinon, spécifiez le flux à partir duquel s’effectue la transition.

Eléments de l’API associés

Instant de départ, en secondes, pour streamName. Les valeurs valides sont -2, -1 et 0.

La valeur par défaut de start est -2, ce qui signifie que Flash Player tente d’abord de lire le flux en direct spécifié dans streamName. Lorsque aucun flux en direct portant ce nom n’est détecté, Flash Player lit le flux enregistré spécifié dans streamName. Lorsque aucun flux en direct ou enregistré n’est détecté, Flash Player ouvre un flux en direct nommé streamName, même lorsque personne ne publie sur ce dernier. Lorsque quelqu’un démarre une publication sur ce flux, Flash Player commence à le lire.

Si vous transmettez -1 pour start, Flash Player ne lit que le flux en direct spécifié dans streamName. Lorsque aucun flux en direct n’est détecté, Flash Player l’attend indéfiniment si len est défini sur -1 ; si len est défini sur une autre valeur, Flash Player attend pendant len secondes avant de commencer la lecture du prochain élément dans la liste.

Si vous transmettez 0 ou un nombre positif pour start, Flash Player lit uniquement un flux enregistré nommé streamName, en commençant à start secondes à partir du début du flux. Si aucun flux enregistré n’est détecté, Flash Player commence immédiatement la lecture du prochain élément dans la liste de lecture.

Si vous transmettez un nombre négatif autre que -1 ou -2 pour start, Flash Player interprète la valeur comme s’il s’agissait de -2.

Eléments de l’API associés

Nom du nouveau flux vers lequel doit s’effectuer la transition ou à lire. Lorsque oldStreamName est null ou undefined, un appel à NetStream.play2() commence simplement la lecture de streamName. Si oldStreamName est spécifié, un appel à NetStream.play2() entraîne une transition de oldStreamName vers streamName avec le mode de transition spécifié dans la propriété transition.

Eléments de l’API associés

Mode dans lequel le streamName est lu ou transité vers. Les valeurs possibles sont des constantes de la classe NetStreamPlayTransitions. Selon si la méthode Netstream.play2() est appelée pour lire ou faire transiter un flux, le mode de transition entraîne des comportement différents. Pour plus d’informations sur les modes de transition, voir la classe NetStreamPlayTransitions.

Eléments de l’API associés

Crée un objet NetStreamPlayOptions pour spécifier les options transmises à la méthode NetStream.play2().

Eléments de l’API associés