NetStreamPlayOptions

Paket	flash.net
Klasse	public dynamic class NetStreamPlayOptions
Vererbung	NetStreamPlayOptions EventDispatcher Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 10, AIR 1.5, Flash Lite 4

Die NetStreamPlayOptions-Klasse legt die verschiedenen Optionen fest, die an die NetStream.play2()-Methode übergeben werden können. Sie übergeben ein NetStreamPlayOptions-Objekt an play2() und die Eigenschaften der Klasse legen die verschiedenen Optionen fest. Der primäre Zweck dieser Klasse ist, dynamisch Übergänge zwischen Streams zu implementieren, entweder, um zu Streams mit anderen Bitraten und Größen zu wechseln oder um anderen Inhalt in einer Wiedergabeliste auszuwählen.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		len : Number Die Wiedergabedauer in Sekunden für den Stream, der in streamName festgelegt wird.	NetStreamPlayOptions
		offset : Number Die absolute Streamzeit, bei der der Server zwischen Streams verschiedener Bitrate für Flash Media Server Dynamic Streaming wechselt.	NetStreamPlayOptions
		oldStreamName : String Der Name des alten Streams oder des Streams, von dem aus der Übergang stattfinden soll.	NetStreamPlayOptions
		start : Number Die Startzeit für streamName in Sekunden.	NetStreamPlayOptions
		streamName : String Der Name des neuen Streams, zu welchem der Übergang stattfinden soll oder der wiedergegeben werden soll.	NetStreamPlayOptions
		transition : String Der Modus, in dem streamName wiedergegeben wird oder in welchem zu streamName übergegangen wird.	NetStreamPlayOptions

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		NetStreamPlayOptions() Erstellt ein NetStreamPlayOptions-Objekt, um die Optionen festzulegen, die an die NetStream.play2()-Methode übergeben werden.	NetStreamPlayOptions
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Ereignis		Übersicht	Definiert von
		activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
		deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher

Eigenschaftendetails

len	Eigenschaft

public var len:Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 10, AIR 1.5, Flash Lite 4

Die Wiedergabedauer in Sekunden für den Stream, der in streamName festgelegt wird. Der Standardwert ist -1. Hiermit spielt Flash Player entweder einen Live-Stream ab, bis er nicht mehr verfügbar ist, oder einen aufgenommenen Stream, bis er endet. Wenn Sie für len0 angeben, spielt Flash Player den einen Frame ab, der sich start-Sekunden vom Anfang eines aufgenommenen Streams befindet (angenommen, dass start gleich oder größer als 0 ist).

Wenn Sie für len eine positive Zahl eingeben, spielt Flash Player len-Sekunden lang eine Live-Stream ab, nachdem er verfügbar wird, oder len-Sekunden lang einen aufgenommenen Stream ab. (Wenn ein Stream vor den len-Sekunden endet, endet die Wiedergabe, wenn der Stream endet.)

Wenn Sie für len eine andere negative Zahl als -1 eingeben, interpretiert Flash Player den Wert so, als wäre er -1.

Verwandte API-Elemente

NetStream.play()
NetStream.play2()
start

offset

Eigenschaft

public var offset:Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 10.1, AIR 2, Flash Lite 4

Die absolute Streamzeit, bei der der Server zwischen Streams verschiedener Bitrate für Flash Media Server Dynamic Streaming wechselt. Die offset-Eigenschaft wird verwendet, wenn ein NetStream.play2()-Aufruf mit dem Übergangsmodus NetStreamPlayTransitions.SWITCH erfolgt. Es gibt zwei Wechselmodi: schneller Wechsel und Standardwechsel. Der Standardwert von offset ist -1, was den schnellen Wechsel angibt. Schreiben Sie ActionScript-Code, um festzulegen, wann der schnelle Wechsel und wann der Standardwechsel verwendet wird.

Schneller Wechsel

Im schnellen Wechselmodus wechselt Flash Media Server zum neuen Stream, ohne zu warten, bis die Daten im Puffer abgespielt wurden. Alle aus dem alten Stream gepufferten Daten nach offset werden entfernt. Der schnelle Wechsel ist schneller als der Standardwechsel, da die gepufferten Daten aus dem alten Stream nicht abgespielt werden müssen.

Der Standardwert von offset ist -1, was den schnellen Wechsel angibt. Wenn offset den Wert -1 hat, erfolgt der Wechsel im ersten verfügbaren Schlüsselbild nach netstream.time + 3, was ungefähr 3 Sekunden später als der Wiedergabepunkt ist. Sie können die offset-Eigenschaft auf einen beliebigen Wert einstellen, der größer als netstream.time ist. Um zum Beispiel einen schnellen Wechsel 5 Sekunden nach dem Wiedergabepunkt auszuführen, legen Sie die offset-Eigenschaft auf netstream.time + 5 fest. Wenn der Wert von offset kleiner als netstream.time ist, wird ein NetStream.Play.Failed-Statusereignis gesendet.

Hinweis: Die offset-Eigenschaft ist die absolute Streamzeit, kein Offset vom Wiedergabepunkt aus. Um zum Beispiel 5 Sekunden nach dem Wiedergabepunkt zu wechseln, stellen Sie die offset-Eigenschaft auf netstream.time + 5, nicht auf 5 ein.

Standardwechsel

Um statt des schnellen Wechsels den Standardwechsel zu verwenden, stellen Sie offset auf einen Wert, der größer ist als netstream.time + netstream.bufferLength.

Verwenden Sie den Standardwechsel, wenn der Client eine hohe Bitrate im Puffer hat und aufgrund von Bandbreitenverringerung (und nicht aufgrund von CPU-Problemen oder ausgelassenen Bildern) zu einer niedrigeren Bandbreite wechseln möchte. Der Client kann die höhere Bandbreite so lange wie möglich abspielen und dann am Ende des Puffers zu der niedrigeren Bandbreite wechseln (wie beim Standardwechsel).

Weitere Informationen finden Sie unter „Fast switching between streams“ im Adobe Flash Media Server Developer's Guide.

Verwandte API-Elemente

start
NetStream.play()
NetStream.play2()
NetStream.time
NetStreamPlayTransitions.SWITCH

oldStreamName

Eigenschaft

public var oldStreamName:String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 10, AIR 1.5, Flash Lite 4

Der Name des alten Streams oder des Streams, von dem aus der Übergang stattfinden soll. Wenn NetStream.play2() verwendet wird, um nur einen Stream abzuspielen (und keinen Übergang durchzuführen), muss der Wert dieser Eigenschaft entweder null oder undefiniert sein. Geben Sie andernfalls den Stream an, von dem der Übergang erfolgen soll.

Verwandte API-Elemente

streamName
NetStream.play()
NetStream.play2()

start

Eigenschaft

public var start:Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 10, AIR 1.5, Flash Lite 4

Die Startzeit für streamName in Sekunden. Gültige Werte sind -2, -1 und 0.

Der Standardwert für start ist -2. Bei diesem Wert versucht Flash Player zuerst, den in streamName angegebenen Live-Stream abzuspielen. Wenn kein Live-Stream mit diesem Namen gefunden wird, spielt Flash Player den in streamName angegebenen aufgenommenen Stream ab. Wenn weder ein Live- noch ein aufgenommener Stream gefunden wird, öffnet Flash Player einen Live-Stream mit dem Namen streamName, obgleich niemand etwas auf diesem Stream veröffentlicht hat. Wenn jemand beginnt, auf diesem Stream zu veröffentlichen, beginnt Flash Player, diesen Stream abzuspielen.

Wenn Sie für start -1 eingeben, spielt Flash Player nur den in streamName angegebenen Live-Stream ab. Wenn kein Live-Stream gefunden wird, wartet Flash Player unendlich lange auf ihn, sofern len auf -1 gesetzt ist. Ist len auf einen anderen Wert gesetzt, wartet Flash Player len-Sekunden, bevor es beginnt, den nächsten Stream in der Wiedergabeliste abzuspielen.

Wenn Sie für start eine 0 oder eine positive Zahl eingeben, spielt Flash Player nur einen aufgenommenen Stream mit dem Namen streamName ab und beginnt bei start-Sekunden vom Beginn des Streams. Wenn kein aufgenommener Stream gefunden wird, beginnt Flash Player, sofort den nächsten Stream in der Wiedergabeliste abzuspielen.

Wenn Sie für start eine andere negative Zahl als -1 oder -2 eingeben, interpretiert Flash Player den Wert so, als wäre er -2.

Verwandte API-Elemente

NetStream.play()
NetStream.play2()
len

streamName

Eigenschaft

public var streamName:String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 10, AIR 1.5, Flash Lite 4

Der Name des neuen Streams, zu welchem der Übergang stattfinden soll oder der wiedergegeben werden soll. Wenn oldStreamName 0 oder undefiniert ist, beginnt NetStream.play2() einfach mit der Wiedergabe vonstreamName. Wenn oldStreamName angegeben ist und NetStream.play2() aufgerufen wird, geht oldStreamName zu streamName (über den in der transition-Eigenschaft angegebenen Übergangsmodus) über.

Verwandte API-Elemente

oldStreamName
NetStream.play()
NetStream.play2()

transition

Eigenschaft

public var transition:String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 10, AIR 1.5, Flash Lite 4

Der Modus, in dem streamName wiedergegeben wird oder in welchem zu streamName übergegangen wird. Mögliche Werte sind Konstanten von der NetStreamPlayTransitions-Klasse. Der Übergangsmodus resultiert abhängig davon, ob Netstream.play2() zur Wiedergabe oder zum Übergang eines Streams aufgerufen wird, in unterschiedlichen Verhaltensweisen. Weitere Informationen zu Übergangsmodi finden Sie unter „NetStreamPlayTransitions-Klasse“.

Verwandte API-Elemente

NetStreamPlayTransitions
NetStream.play2()

Konstruktordetails

()

Konstruktor

public function NetStreamPlayOptions()

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 10, AIR 1.5, Flash Lite 4

Erstellt ein NetStreamPlayOptions-Objekt, um die Optionen festzulegen, die an die NetStream.play2()-Methode übergeben werden.

Verwandte API-Elemente

NetStream.play2()

Rechtliche Hinweise | Onlinedatenschutzerklärung

NetStreamPlayOptions - AS3

Paketex

Sprachelemente

Anhänge

Paket flash.net

len

offset

oldStreamName

start

streamName

transition

NetStreamPlayOptions