NetStream  - AS3

Gibt bei RTMFP-Verbindungen an, ob Audio vollständig zuverlässig gesendet wird. Mit der Einstellung TRUE sind alle über diesen NetStream übertragenen Audiodaten vollständig zuverlässig. Mit der Einstellung FALSE sind die übertragenen Audiodaten nicht vollständig zuverlässig, sondern werden für eine begrenzte Zeit erneut übertragen und dann ausgelassen. Sie können den Wert FALSE verwenden, um die Latenzzeit auf Kosten der Audioqualität zu verringern.

Wenn Sie diese Eigenschaft in einem Netzwerkprotokoll, das teilweise Zuverlässigkeit nicht unterstützt, auf FALSE setzen, wird der Versuch ignoriert und die Eigenschaft wird auf TRUE gesetzt.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Gibt bei RTMFP-Verbindungen an, ob Peer-to-Peer-Abonnenten für diesen NetStream den Audiostream erfassen dürfen. Mit der Einstellung FALSE resultieren Versuche von Abonnenten, den Audiostream zu erfassen, zu Berechtigungsfehlern.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Die Anzahl der Sekunden von zuvor angezeigten Daten, die zurzeit zum Zurückspulen und Abspielen zwischengespeichert werden.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Diese Eigenschaft ist nur verfügbar, wenn Daten von Flash Media Server 3.5.3 oder höher gestreamt werden. Weitere Informationen zu Flash Media Server finden Sie in der Beschreibung der Klasse.

Um anzugeben, wie viele der zuvor angezeigten Daten zwischengespeichert werden, verwenden Sie die Netstream.backBufferTime-Eigenschaft.

Um die Zwischenspeicherung von Daten zu verhindern, setzen Sie die Netstream.inBufferSeek-Eigenschaft auf FALSE.

Verwandte API-Elemente

Gibt an (in Sekunden), wie viele der zuvor abgespielten Daten Flash Player zum Zurückspulen und Abspielen zwischenzuspeichern versucht. Der Standardwert beträgt 30 Sekunden für Desktopanwendungen und 3 Sekunden für mobile Anwendungen.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Diese Eigenschaft ist nur verfügbar, wenn Daten von Flash Media Server Version 3.5.3 oder höher gestreamt werden. Weitere Informationen zu Flash Media Server finden Sie in der Beschreibung der Klasse.

Mit dieser Eigenschaft können Sie die Leistung bei Rücklaufoperationen verbessern, da bereits angezeigte Daten nicht erneut vom Server abgerufen werden müssen. Stattdessen wiederholt der Stream die Wiedergabe der Daten aus dem Puffer. Während der Wiedergabe werden weiterhin Daten vom Server gestreamt, bis der Puffer voll ist.

Wenn die Rücklaufposition weiter zurück liegt als die Daten im Cache, wird der Puffer gelöscht; die Daten werden dann ab der angeforderten Position vom Server gestreamt.

Um diese Eigenschaft zu verwenden, setzen Sie die Netstream.inBufferSeek-Eigenschaft auf TRUE.

Verwandte API-Elemente

Die derzeit im Puffer befindliche Datenmenge, gemessen in Sekunden. Wenn Sie diese Eigenschaft zusammen mit bufferTime verwenden, können Sie einschätzen, wie weit der Zwischenspeicher belegt ist, um beispielsweise eine Rückmeldung für einen Benutzer anzuzeigen, der darauf wartet, dass Daten in den Zwischenspeicher geladen werden.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Bestimmt, wie lange Nachrichten im Zwischenspeicher bleiben, bis mit der Anzeige des Streams begonnen wird.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Der Standardwert ist 0,1 (ein Zehntel einer Sekunde). Mit der Eigenschaft bufferLength können Sie die derzeit im Puffer befindliche Datenmenge (in Sekunden) ermitteln.

Um eine serverseitige Wiedergabeliste abzuspielen, stellen Sie bufferTime auf mindestens 1 Sekunde. Wenn es Probleme mit der Wiedergabe gibt, erhöhen Sie die Länge von bufferTime.

Aufgezeichnete Inhalte Um beim Streaming von aufgezeichneten Inhalten (nicht live) Verzerrungen zu vermeiden, sollten Sie den Wert von Netstream.bufferTime auf 0 setzen. Bei aufgezeichneten Inhalten verwendet die Anwendung standardmäßig einen Eingabepuffer, der die Mediendaten in eine Warteschlange stellt und die Medien korrekt wiedergibt. Verwenden Sie bei aufgezeichneten Inhalten die Standardeinstellung oder erhöhen Sie die Pufferzeit.

Live-Inhalt Beim Streaming von Live-Inhalten setzen Sie die bufferTime-Eigenschaft auf 0.

Beginnend mit Flash Player 9.0.115.0 leert der Flash Player den Puffer nicht mehr, wenn NetStream.pause() aufgerufen wird. In Vorgängerversionen von Flash Player 9.0.115.0 hat Flash Player gewartet, bis der Puffer voll war, bevor die Wiedergabe fortgesetzt wurde, wodurch es häufig zu Verzögerungen kam.

Für eine einzelne Pause hat die NetStream.bufferLength-Eigenschaft ein Limit von 60 Sekunden oder das Doppelte des Werts von NetStream.bufferTime, je nachdem, welcher Wert höher ist. Wenn bufferTime zum Beispiel 20 Sekunden beträgt, puffert Flash Player, bis NetStream.bufferLength den höheren Wert von 20*2 (40) oder 60 hat. In diesem Fall puffer Flash Player, bis bufferLength den Wert 60 hat. Wenn bufferTime 40 Sekunden beträgt, puffert Flash Player, bis bufferLength den höheren Wert von 40*2 (80) oder 60 hat. In diesem Fall puffert Flash Player, bis bufferLength den Wert 80 hat.

Die bufferLength-Eigenschaft hat auch ein absolutes Limit. Wenn ein Aufruf von pause() dazu führt, dass bufferLength auf mehr als 600 Sekunden ansteigt oder der Wert von bufferTime * 2, je nachdem, welcher Wert höher ist, löscht Flash Player den Puffer und setzt bufferLength auf 0 zurück. Wenn bufferTime zum Beispiel 120 Sekunden beträgt, löscht Flash Player den Puffer, wenn bufferLength den Wert 600 Sekunden erreicht; wenn bufferTime 360 Sekunden beträgt, löscht Flash Player den Puffer, wenn bufferLength den Wert 720 Sekunden erreicht.

Tipp: Sie können im Code NetStream.pause() verwenden, um Daten zu puffern, während Betrachter zum Beispiel einen Werbespot sehen, und dann die Pause aufheben, wenn das Hauptvideo beginnt.

Weitere Informationen zum neuen Pausenverhalten finden Sie unter http://www.adobe.com/go/learn_fms_smartpause_de.

Flash Media Server. Das Pufferverhalten ist davon abhängig, ob die Pufferzeit für einen veröffentlichenden oder abonnierenden Stream festgelegt wird. Für einen veröffentlichenden Stream legt bufferTime fest, wie lange der ausgehende Puffer anwachsen kann, bevor die Anwendung beginnt, Bilder zu überspringen. Bei einer Highspeed-Verbindung stellt die Pufferzeit kein Problem dar; Daten werden fast so schnell gesendet, wie die Anwendung sie puffern kann. Bei langsameren Verbindungen kann es jedoch einen erheblichen Unterschied geben zwischen der Geschwindigkeit, mit der die Anwendung Daten puffert, und der Geschwindigkeit, mit der die Daten an den Client gesendet werden.

Für einen abonnierenden Stream legt bufferTime fest, wie lange eingehende Daten gepuffert werden, bevor der Stream angezeigt wird.

Wenn ein aufgezeichneter Stream abgespielt wird und bufferTime den Wert 0 aufweist, stellt Flash einen kleinen Wert ein (ca. 10 Millisekunden). Wenn Live-Stream später abgespielt werden (zum Beispiel von einer Wiedergabeliste) bleibt die Pufferzeit erhalten. Das bedeutet, bufferTime bleibt „nicht null“ für den Stream.

Verwandte API-Elemente

Gibt die maximale Pufferlänge für Live-Streaming-Inhalt in Sekunden an. Der Standardwert ist 0. Die Pufferlänge kann mit der Zeit aufgrund von Netzwerk- und Geräteproblemen zunehmen (zum Beispiel wegen unterschiedlich laufender Uhren bei Sender und Empfänger). Legen Sie diese Eigenschaft fest, um die Pufferlänge für Live-Anwendungen wie Meetings und Überwachung abzudecken.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Wenn bufferTimeMax > 0 und bufferLength >= bufferTimeMax, wird Audio schneller abgespielt, bis bufferLength den Wert von bufferTime erreicht. Wenn ein Live-Stream nur aus Video besteht, wird das Video schneller abgespielt, bis bufferLength den Wert von bufferTime erreicht.

Je nachdem, wie viel der Wiedergabe nachhängt (die Differenz zwischen bufferLength und bufferTime) steuert Flash Player die Aufholrate zwischen 1,5% und 6,25%. Wenn der Stream Audio enthält, wird die schnellere Wiedergabe durch Frequenzdomänen-Downsampling erreicht, wobei die Audioverzerrung minimiert wird.

Legen Sie die bufferTimeMax-Eigenschaft fest, um das Aufholen (Catch-up) bei gepufferten Livestreams in den folgenden Fällen zu ermöglichen:

• Streaming von Live-Medien von Flash Media Server.
• Streaming von Live-Medien im Datengenerierungsmodus (NetStream.appendBytes()).

Verwandte API-Elemente

Die Anzahl der in die Anwendung geladenen Datenbyte. Wenn Sie diese Eigenschaft zusammen mit bytesTotal verwenden, können Sie einschätzen, wie weit der Zwischenspeicher belegt ist, um beispielsweise eine Rückmeldung für einen Benutzer anzuzeigen, der darauf wartet, dass Daten in den Zwischenspeicher geladen werden.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Die Gesamtgröße (in Byte) der in die Anwendung geladenen Datei.

Verwandte API-Elemente

Gibt an, ob die Anwendung vor dem Laden der Videodatei versucht, eine Cross-Domain-Richtliniendatei vom Server der Videodatei herunterzuladen. Verwenden Sie diese Eigenschaft für progressive Videodownloads und zum Laden von Dateien, die sich außerhalb der Domäne der aufrufenden SWF-Datei befinden. Diese Eigenschaft wird ignoriert, wenn Sie RTMP verwenden.

Stellen Sie diese Eigenschaft auf true, um BitmapData.draw() für eine Videodatei aufzurufen, die aus einer Domäne außerhalb der Domäne der aufrufenden SWF-Datei geladen wurde. Die BitmapData.draw()-Methode ermöglicht den Zugriff auf das Video auf Pixelebene. Wenn Sie BitmapData.draw() aufrufen, ohne die Eigenschaft checkPolicyFile zum Ladezeitpunkt auf true zu setzen, wird möglicherweise eine SecurityError-Ausnahme ausgelöst, da die erforderliche Richtliniendatei nicht heruntergeladen wurde.

Setzen Sie diese Eigenschaft nicht auf „true“, es sei denn, Sie wünschen Zugriff auf Pixelebene auf das Video, das Sie laden. Durch die Suche nach einer Richtliniendatei wird Netzwerkbandbreite belegt und der Start des Download-Vorgangs möglicherweise verzögert.

Wenn Sie die Methode NetStream.play() aufrufen und checkPolicyFile auf true gesetzt ist, muss in Flash Player oder der AIR-Laufzeitumgebung vor dem Herunterladen entweder eine entsprechende Cross-Domain-Richtlinie erfolgreich heruntergeladen werden, oder es muss festgestellt werden, dass keine Richtliniendatei vorhanden ist. In Flash Player oder der AIR-Laufzeitumgebung werden die folgenden Aktionen in der angegebenen Reihenfolge ausgeführt, um zu überprüfen, ob eine Richtliniendatei vorhanden ist:

1. Die Anwendung überprüft Richtliniendateien, die bereits heruntergeladen wurden.
2. Die Anwendung versucht, ausstehende Richtliniendateien herunterzuladen, die in Aufrufen von Security.loadPolicyFile() angegeben wurden.
3. Die Anwendung versucht, eine Richtliniendatei vom Standardspeicherort herunterzuladen, der der an NetStream.play() übergebenen URL entspricht, d. h. /crossdomain.xml auf dem gleichen Server wie die URL.

In allen Fällen muss für Flash Player oder Adobe AIR eine entsprechende Richtliniendatei auf dem Server des Videos vorhanden sein, über die anhand ihres Speicherorts auf das Objekt unter der an play() übergebenen URL zugegriffen werden kann und über die die Domäne der aufrufenden Datei über mindestens ein <allow-access-from>-Tag auf das Video zugreifen kann.

Wenn Sie checkPolicyFile auf true setzen, wartet die Anwendung mit dem Laden des Videos, bis die Richtliniendatei überprüft wurde. Warten Sie mit dem Ausführen von Vorgängen auf Pixelebene (z. B. Aufrufen von BitmapData.draw()), bis Sie onMetaData- oder NetStatus-Ereignisse von Ihrem NetStream-Objekt erhalten.

Wenn Sie checkPolicyFile auf true setzen, jedoch keine entsprechende Richtliniendatei gefunden wird, wird eine Fehlermeldung erst dann ausgegeben, wenn Sie einen Vorgang durchführen, der eine Richtliniendatei erfordert. Dann wird in der Anwendung eine SecurityError-Ausnahme ausgegeben.

Beim Herunterladen einer Videodatei von einer URL, bei der serverseitige HTTP-Weiterleitungen verwendet werden, müssen Sie darauf achten, checkPolicyFile richtig zu verwenden. Die Anwendung versucht, Richtliniendateien abzurufen, die der ursprünglichen in NetStream.play() angegebenen URL entsprechen. Wenn die endgültige Videodatei aufgrund von HTTP-Weiterleitungen von einer anderen URL stammt, gelten die ursprünglich heruntergeladenen Richtliniendateien möglicherweise nicht für die endgültige URL der Videodatei. Dies ist jedoch die URL, die bei Sicherheitsentscheidungen von Bedeutung ist.

Weitere Informationen zu Richtliniendateien finden Sie unter „Websitesteuerungen (Richtliniendateien)“ im ActionScript 3.0 Entwicklerhandbuch und im Flash Player Developer Center im Artikel: Sicherheit.

Verwandte API-Elemente

Gibt das Objekt an, für das Rückrufmethoden aufgerufen werden, um Streaming- oder F4V/FLV-Dateidaten zu verarbeiten. Standardeinstellung ist das erstellte NetStream-Objekt this. Wenn Sie die client-Eigenschaft auf ein anderes Objekt setzen, werden Callback-Methoden auf diesem anderen Objekt aufgerufen. Das NetStream.client -Objekt kann die folgenden Funktionen aufrufen und ein verknüpftes Datenobjekt empfangen: onCuePoint(), onImageData(), onMetaData(), onPlayStatus(), onSeekPoint(), onTextData() und onXMPData().

Verknüpfen der client-Eigenschaft mit einer Ereignisprozedur:

1. Erstellen Sie ein Objekt und verknüpfen Sie es mit der client-Eigenschaft des NetStream-Objekts:

        var customClient:Object = new Object();
        my_netstream.client = customClient;
        

2. Verknüpfen Sie eine Ereignisprozedurfunktion für das gewünschte Datenereignis als Eigenschaft des Client-Objekts:

        customClient.onImageData = onImageDataHandler;
        

3. Schreiben Sie die Prozedurfunktion, um das Datenereignisobjekt zu empfangen, z. B.:

         public function onImageDataHandler(imageData:Object):void {
                 trace("imageData length: " + imageData.data.length);
         }
        

Wenn Daten durch den Stream oder während der Wiedergabe übergeben werden, wird das Datenereignisobjekt (in diesem Fall das imageData-Objekt) mit den Daten gefüllt. In der Beschreibung zu onImageData finden Sie ein vollständiges Beispiel eines Objekts, dass mit der client-Eigenschaft verknüpft ist.

Verknüpfen der client-Eigenschaft mit einer Unterklasse:

1. Erstellen Sie eine Unterklasse mit einer Prozedurfunktion, um das Datenereignisobjekt zu empfangen:

        class CustomClient {
           public function onMetaData(info:Object):void {
               trace("metadata: duration=" + info.duration + " framerate=" + info.framerate);
        }
        

2. Verknüpfen Sie eine Instanz der Unterklasse mit der client-Eigenschaft des NetStream-Objekts:

        my_netstream.client = new CustomClient();
        

Wenn Daten durch den Stream oder während der Wiedergabe übergeben werden, wird das Datenereignisobjekt (in diesem Fall das info-Objekt) mit den Daten gefüllt. Im Klassenbeispiel am Ende der NetStream-Klasse können Sie sehen, wie eine Unterklasseninstanz mit der client-Eigenschaft verknüpft wird.

Verwandte API-Elemente

Die Zahl der pro Sekunde angezeigten Bilder. Wenn Sie Videodateien für die Wiedergabe auf verschiedenen Systemen exportieren, können Sie mithilfe dieses Werts beim Testen bestimmen, wie stark die exportierte Datei komprimiert werden soll.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Gibt bei RTMFP-Verbindungen an, ob NetStream.send()-Aufrufe vollständig zuverlässig gesendet werden. Bei der Einstellung TRUE sind Aufrufe von NetStream.send(), die über diesen NetStream übertragen werden, vollständig zuverlässig. Bei der Einstellung FALSE werden Aufrufe von NetStream.send() nicht mit vollständiger Zuverlässigkeit übertragen, sondern für eine begrenzte Zeit erneut übertragen und dann ausgelassen. Sie können diesen Wert auf FALSE setzen, um die Latenzzeit auf Kosten der Datenqualität zu verringern.

Wenn Sie diese Eigenschaft in einem Netzwerkprotokoll, das teilweise Zuverlässigkeit nicht unterstützt, auf FALSE setzen, wird der Versuch ignoriert und die Eigenschaft wird auf TRUE gesetzt.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Bei RTMFP-Verbindungen der Bezeichner des anderen Endes, das mit dieser NetStream-Instanz verbunden ist.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Bei RTMFP- und RTMPE-Verbindungen ein Wert, der vom anderen Ende dieses Streams gewählt wird und für diese Verbindung eindeutig ist. Dieser Wert erscheint am anderen Ende des Streams als nearNonce-Wert

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Gibt an, ob die angezeigten Daten für den intelligenten Suchlauf zwischengespeichert werden (TRUE) oder nicht (FALSE). Der Standardwert lautet FALSE.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Flash Media Server 3.5.3 und Flash Player 10.1 arbeiten zusammen, um den intelligenten Suchlauf zu unterstützen. Beim intelligenten Suchlauf werden Rücklauf- und Vorlaufpuffer verwendet, um Suchläufe auszuführen, ohne Daten vom Server anzufordern. Bei Standardsuchläufen werden die gepufferten Daten gelöscht und neue Daten werden basierend auf der Suchlaufzeit vom Server angefordert.

Rufen Sie NetStream.step() auf, um eine bestimmte Anzahl Bilder vor- oder zurückzugehen. Rufen Sie NetStream.seek() auf, um eine bestimmte Anzahl Sekunden vor- oder zurückzugehen.

Mit intelligenten Suchläufen wird die Serverlast verringert und die Suchlaufleistung verbessert. Stellen Sie inBufferSeek=true ein und rufen Sie step() und seek() auf, um Folgendes zu erstellen:

• Clientseitige DVR-Funktionen. Suchen Sie im clientseitigen Puffer anstatt wegen der Zustellung neuen Videos zum Server zu gehen.
• Trickmodi. Erstellen Sie Player, die bildweise vor- oder zurückgehen, schnellen Rücklauf oder schnellen Vorlauf verwenden oder in Zeitlupe abspielen.

Wenn inBufferSeek=true und ein Aufruf von NetStream.seek() erfolgreich ist, enthält die info.description-Eigenschaft von NetStatusEvent den String "client-inBufferSeek".

Wenn ein Aufruf von NetStream.step() erfolgreich ist, enthält die info.code-Eigenschaft von NetStatusEvent den String "NetStream.Step.Notify".

Verwandte API-Elemente

Gibt ein NetStreamInfo-Objekt zurück, dessen Eigenschaften Statistiken über die Dienstqualität enthalten. Das Objekt ist ein Schnappschuss des aktuellen Status.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Die Datenmenge (in Sekunden) im Zwischenspeicher des abonnierenden Streams im Live-Modus (ohne Puffer). Diese Eigenschaft gibt die aktuelle Netzwerkübertragungsverzögerung an.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Diese Eigenschaft ist für die Verwendung mit einem Server wie Flash Media Server konzipiert. Weitere Informationen finden Sie in der Beschreibung der Klasse.

Mit dem Wert dieser Eigenschaft können Sie die Übertragungsqualität des Streams grob einschätzen und dem Benutzer mitteilen.

Gibt an, wie lange (in Sekunden) Meldungen im Pause-Modus gepuffert werden. Diese Eigenschaft kann verwendet werden, um zu beschränken, wie viel im Pause-Modus gepuffert werden soll. Sobald der Wert für NetStream.bufferLength dieses Limit erreicht hat, werden keine weiteren Daten mehr gepuffert.

Wenn dieser Wert nicht festgelegt ist, wird das Limit auf 60 Sekunden oder auf den doppelten Wert von NetStream.bufferTime auf jeder Pause gesetzt, je nachdem, welcher Wert höher ist.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Gibt bei RTMFP-Verbindungen an, ob Verfügbarkeitsmeldungen für Peer-to-Peer-Multicast-Fragmente an alle Peers oder nur an einen Peer gesendet werden. Der Wert TRUE gibt an, dass die Nachrichten einmal pro angegebenem Intervall an alle Peers gesendet werden. Der Wert FALSE gibt an, dass die Nachrichten einmal pro angegebenem Intervall an einen Peer gesendet werden. Das Intervall wird von der multicastAvailabilityUpdatePeriod-Eigenschaft bestimmt.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Gibt bei RTMFP-Verbindungen das Intervall in Sekunden zwischen Meldungen an, die Peers benachrichtigen, dass beim lokalen Knoten neue Peer-to-Peer-Multicast-Medienfragmente verfügbar sind. Größere Werte können die Batcheffizienz verbessern und die Steuerungslast reduzieren; sie können jedoch auch die Qualität auf Empfängerseite verschlechtern, da die verfügbare Zeit zum Abrufen von Fragmenten, bevor sie verworfen werden, verringert wird. Niedrigere Werte können die Latenzzeit verringern und die Qualität verbessern, sie erhöhen jedoch die Steuerungslast.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Gibt bei RTMFP-Verbindungen die Zeit in Sekunden an, wie lange es ab dem Zeitpunkt, zu dem der lokale Knoten erfährt, dass ein Peer-to-Peer-Multicast-Medienfragment verfügbar ist, dauert, bis er versucht, es von einem Peer abzurufen. Dieser Wert ermöglicht das proaktive Senden des Fragments an den lokalen Knoten, bevor das Abrufen von einem Peer versucht wird. Er lässt auch zu, dass mehrere Peers die Verfügbarkeit des Fragments ankündigen, damit die Abruflast auf mehrere Peers verteilt werden kann.

Größere Werte können den Lastausgleich verbessern und das Peer-to-Peer-Mesh gleichmäßiger belasten, sie verringern jedoch die verfügbare multicastWindowDuration und erhöhen die Latenzzeit. Kleinere Werte können die Latenzzeit verringern, wenn Abrufen erforderlich ist, können aber den redundanten Datenempfang erhöhen und den Lastausgleich im Peer-to-Peer-Mesh verschlechtern.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Gibt bei RTMFP-Verbindungen ein NetStreamMulticastInfo-Objekt zurück, dessen Eigenschaften Statistiken zur Dienstgüte enthalten. Das Objekt ist ein Schnappschuss des aktuellen Status.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Gibt bei RTMFP-Verbindungen die maximale Anzahl von Peers an, an die proaktiv Multicast-Medien geleitet werden können.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Gibt bei RTMFP-Verbindungen die Dauer in Sekunden an, für die Peer-to-Peer-Multicast-Daten verfügbar bleiben, um an Peers gesendet zu werden, die sie nach einer angegebenen Dauer anfordern. Die Dauer wird mit der multicastWindowDuration-Eigenschaft festgelegt.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Gibt bei RTMFP-Verbindungen die Dauer des Peer-to-Peer-Multicastreassembly-Fensters in Sekunden an. Kürzere Werte verringern die Latenzzeit, können aber die Qualität verschlechtern, da nicht genügend Zeit zum Abrufen aller Fragmente gegeben wird. Umgekehrt können größere Werte die Qualität verbessern, da mehr Zeit zum Abrufen aller Fragmente zugelassen wird, was mit einer entsprechend längeren Latenzzeit einhergeht.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Bei RTMFP- und RTMPE-Verbindungen ein Wert, der von diesem Ende des Streams gewählt wird und für diese Verbindung eindeutig ist. Dieser Wert erscheint am anderen Ende des Streams als farNonce-Wert

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Die Objektkodierung (AMF-Version) für dieses NetStream-Objekt. Der objectEncoding-Wert für das NetStream-Objekt wird von dem verknüpften NetConnection-Objekt übernommen. Es ist wichtig, die Funktionsweise dieser Eigenschaft zu kennen, wenn die Kommunikation der ActionScript 3.0-SWF-Datei mit Servern erforderlich ist, die eine ältere Version als Flash Player 9 aufweisen. Weitere Informationen finden Sie in der Beschreibung der Eigenschaft objectEncoding in der NetConnection-Klasse.

Der Wert dieser Eigenschaft hängt davon ab, ob es sich um einen lokalen oder einen Remote-Stream handelt. Lokale Streams, bei denen null an die Methode NetConnection.connect() übergeben wurde, geben den Wert NetConnection.defaultObjectEncoding zurück. Remote-Streams, bei denen Sie eine Verbindung zu einem Server herstellen, geben die Objektkodierung der Serververbindung zurück.

Wenn Sie versuchen, diese Eigenschaft ohne Verbindung zu lesen oder diese Eigenschaft zu ändern, gibt die Anwendung eine Ausnahme aus.

Verwandte API-Elemente

Ein Objekt, das alle abonnierenden NetStream-Instanzen enthält, die diese veröffentlichende NetStream-Instanz überwachen.

Steuert den Sound in diesem NetStream-Objekt. Weitere Informationen hierzu finden Sie im Abschnitt zur SoundTransform-Klasse.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Die Position des Abspielkopfs in Sekunden.

Flash Media Server Bei einem abonnierenden Stream die Anzahl der Sekunden, die der Stream bereits abgespielt wurde. Bei einem veröffentlichenden Stream die Anzahl der Sekunden, die der Stream veröffentlicht wurde. Die Zahl ist bis zur Tausenderdezimalstelle genau; multiplizieren Sie sie mit 1000, um die Anzahl der Millisekunden zu erhalten, die der Stream bereits abgespielt wurde.

Wenn der Server bei einem abonnierenden Stream aufhört, Daten zu senden, aber der Stream offen bleibt, wird der Wert der time-Eigenschaft nicht weiter erhöht. Wenn der Server beginnt, wieder Daten zu senden, wird der Wert von dem Punkt, an dem angehalten wurde (als der Server aufgehört hat, Daten zu senden), weiter erhöht.

Der Wert für time wird weiter erhöht, wenn der Stream von einem Wiedergabeelement zu einem anderen wechselt. Diese Eigenschaft wird auf 0 gesetzt, wenn NetStream.play() aufgerufen wird und dabei reset den Wert 1 oder true aufweist, oder wenn NetStream.close() aufgerufen wird.

Verwandte API-Elemente

Gibt an, ob hardwarebeschleunigte Dekodierung für den Stream verwendet werden soll.

Hinweis: Sie können diese Eigenschaft nicht während der Videowiedergabe festlegen. Sie müssen sie vor dem Aufruf von NetStream.play() festlegen.

Der Standardwert ist true.

Verwandte API-Elemente

Minimiert die Latenz für nicht gepuffertes Live-Streaming (bufferTime = 0). Audionachrichten werden in einem adaptiven Jitter-Puffer platziert, anstatt einen konservativen push-basierten Catchup-Mechanismus zu verwenden. Wenn Audio vom Lautsprechergerät benötigt wird, werden Nachrichten aus dem Jitter-Puffer geholt, dekodiert und abgespielt. Speex und G.711 verwenden immer diesen pull-basierten Ansatz, unabhängig von diesen Einstellungen (useJitterBuffer gibt für Speex/G.711 „true“ zurück). Wenn diese Einstellung im nicht gepufferten Modus aktiviert ist, verwenden alle Codes Jitter-Puffer, zum Beispiel Speex, G.711, Nellymoser, MP3 und AAC. Diese Eigenschaft hat im gepufferten Modus (bufferTime > 0) keine Auswirkungen, deshalb gibt useJitterBuffer „false“ zurück.

Gibt bei RTMFP-Verbindungen an, ob Video vollständig zuverlässig gesendet wird. Mit der Einstellung TRUE sind alle über diesen NetStream übertragenen Videodaten vollständig zuverlässig. Mit der Einstellung FALSE sind die übertragenen Videodaten nicht vollständig zuverlässig, sondern werden für eine begrenzte Zeit erneut übertragen und dann ausgelassen. Sie können den Wert FALSE verwenden, um die Latenzzeit auf Kosten der Videoqualität zu verringern.

Wenn Sie diese Eigenschaft in einem Netzwerkprotokoll, das teilweise Zuverlässigkeit nicht unterstützt, auf FALSE setzen, wird der Versuch ignoriert und die Eigenschaft wird auf TRUE gesetzt.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Gibt bei RTMFP-Verbindungen an, ob Peer-to-Peer-Abonnenten für diesen NetStream den Video-Stream erfassen dürfen. Mit der Einstellung FALSE resultieren Versuche von Abonnenten, den Videostream zu erfassen, in Berechtigungsfehlern.

Hinweis: Diese Eigenschaft wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Verwandte API-Elemente

Legt Eigenschaften für die Streamkomprimierung fest. Weitere Informationen finden Sie unter VideoStreamSettings. Wenn keine Kamera an das System angeschlossen ist, wird null zurückgegeben.

Verwandte API-Elemente

Erstellt einen Stream, mit dem Sie Mediendateien abspielen und Daten über ein NetConnection-Objekt senden können.

Es gilt als ungültig, das netStatus-Ereignis eines NetStream-Objekts nicht zu verarbeiten. Um Fehler zu vermeiden, registrieren Sie einen Listener für netStatus, nachdem Sie das NetStream-Objekt erstellt haben und bevor Sie seine play()-Methode aufrufen.

Verwandte API-Elemente

var my_video:Video = new Video();
addChild(my_video);
var my_nc:NetConnection = new NetConnection();
my_nc.connect(null);
var my_ns:NetStream = new NetStream(my_nc);
my_video.attachNetStream(my_ns);
my_ns.play(videoURL);

var my_video:Video = new Video();
addChild(my_video);
var my_nc:NetConnection = new NetConnection();
my_nc.connect("rtmp://www.yourfmsserver.com/someappname");
var my_ns:NetStream = new NetStream(my_nc, NetStream.CONNECT_TO_FMS);
my_video.attachNetStream(my_ns);
my_ns.play(videoURL);

Übergibt ein ByteArray für die Wiedergabe an einen NetStream. Rufen Sie diese Methode für einen NetStream im Datengenerierungsmodus auf. Um einen NetStream in den Datengenerierungsmodus zu versetzen, rufen Sie NetStream.play(null) für einen NetStream auf, der in einer NetConnection erstellt wurde, die mit null verbunden ist. Das Aufrufen von appendBytes() für einen NetStream, der sich nicht im Datengenerierungsmodus befindet, ist ein Fehler und führt zu einer Ausnahme.

Hinweis: Diese Methode wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Der Byte-Parser versteht eine FLV-Datei mit einem Header. Nachdem der Header analysiert wurde, erwartet appendBytes(), dass alle zukünftigen Aufrufe Fortsetzungen derselben realen oder virtuellen Datei sind. Es wird kein weiterer Header erwartet, sofern nicht appendBytesAction(NetStreamAppendBytesAction.RESET_BEGIN) aufgerufen wird.

Ein NetStream-Objekt hat zwei Pufferspeicher: den FIFO von appendBytes() für den NetStream und den Wiedergabepuffer. Der FIFO ist der Zusammensetzungspuffer für FLV-Teil-Tags und enthält nicht mehr als ein unvollständiges FLV-Tag. Aufrufe von NetStream.seek() leeren beide Pufferspeicher. Rufen Sie nach einem Aufruf von seek() die appendBytesAction()-Methode auf, um die Zeitskala auf den Anfang des Zeitstempels der nächsten angehängten Nachricht zurückzusetzen.

Jeder Aufruf von appendBytes() fügt dem FIFO Bytes hinzu, bis ein FLV-Tag vollständig ist. Wenn ein FLV-Tag vollständig ist, wird es in den Wiedergabepuffer verschoben. Ein Aufruf von appendBytes() kann mehrere FLV-Tags schreiben. Die ersten Bytes vervollständigen ein vorhandenes FLV-Tag (das in den Wiedergabepuffer verschoben wird). Vollständige FLV-Tags werden in den Wiedergabepuffer verschoben. Verbleibende Bytes, die kein vollständiges FLV-Tag bilden, kommen in den FIFO. Bytes im FIFO werden entweder durch einen Aufruf von appendBytes() vervollständigt oder durch einen Aufruf von appendBytesAction() mit dem Argument RESET_SEEK oder RESET_BEGIN entfernt.

Hinweis: Der Byte-Parser kann einen Aufruf von appendBytes() möglicherweise nicht vollständig dekodieren, bis ein nachfolgender Aufruf von appendBytes() erfolgt.

Parameter

Verwandte API-Elemente

Zeigt eine Diskontinuität der Zeitskala an, leert den FIFO und teilt dem Byte-Parser mit, einen Datei-Header oder den Anfang eines FLV-Tags zu erwarten.

Hinweis: Diese Methode wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Aufrufe von NetStream.seek() leeren die NetStream-Pufferspeicher. Der Byte-Parser verbleibt im Leeren-Modus, bis Sie appendBytesAction() aufrufen und das Argument RESET_BEGIN oder RESET_SEEK übergeben. Erfassen Sie das "NetStream.Seek.Notify"-Ereignis, um appendBytesAction() nach einem Suchlauf aufzurufen. Ein neuer Datei-Header kann Wiedergabelisten und Suchläufe unterstützen, ohne NetStream.seek() aufzurufen.

Sie können diese Methode auch aufrufen, um den Bytezähler für den onSeekPoint()-Rückruf zurückzusetzen.

Parameter

Verwandte API-Elemente

Hängt einen Stream an ein neues NetConnection-Objekt an. Rufen Sie diese Methode auf, um einen NetStream an ein neues NetConnection-Objekt anzuhängen, nachdem eine Verbindung getrennt und wieder hergestellt wurde. Flash Player und AIR nehmen das Streaming ab dem Wiedergabepunkt, bei dem die Verbindung unterbrochen wurde, wieder auf. Sie können diese Methode auch verwenden, um Load Balancing (Lastausgleich) zu implementieren.

Für diese Methode ist Flash Media Server Version 3.5.3 oder höher erforderlich.

Informationen zur Verwendung dieser Methode zum Implementieren der Stream-Neuverbindung finden Sie in der Flash Media Server 3.5.3-Dokumentation.

Um mit dieser Methode Lastausgleich zu implementieren, gehen Sie folgendermaßen vor:

1. Fügen Sie einem NetConnection-Objekt auf einem anderen Server einen verbundenen Stream hinzu.
2. Nachdem der Stream erfolgreich der neuen Verbindung hinzugefügt wurde, rufen Sie NetConnection.close() für die frühere Verbindung auf, um zu verhindern, dass Daten austreten.
3. Rufen Sie NetStream.play2() auf und stellen Sie den Wert von NetStreamPlayOptions.transition auf RESUME. Stellen Sie die restlichen Eigenschaften von NetStreamPlayOptions auf dieselben Werte ein, die Sie beim ursprünglichen Aufruf von NetStream.play() oder NetStream.play2() verwendet haben, um den Stream zu starten.

Parameter

Verwandte API-Elemente

Fügt einen über das NetStream-Objekt gesendeten Audiostream einem NetStream-Objekt hinzu, wobei das Microphone-Objekt als Quelle übergeben wurde. Diese Methode ist nur für den Herausgeber des angegebenen Streams verfügbar.

Verwenden Sie diese Methode mit Flash Media Server, um Live-Audio an den Server zu senden. Rufen Sie diese Methode vor oder nach dem Aufruf der publish()-Methode auf.

Stellen Sie die Microphone.rate-Eigenschaft so ein, dass sie der Rate des Sounderfassungsgerät entspricht. Rufen Sie setSilenceLevel() auf, um den Schwellenwert für Stille festzulegen. Um die Soundeigenschaften (Lautstärke und Panning) des Audiostreams zu steuern, verwenden Sie die Microphone.soundTransform-Eigenschaft.

     var nc:NetConnection = new NetConnection();
     nc.connect("rtmp://server.domain.com/app");
     var ns:NetStream = new NetStream(nc);
     
     var live_mic:Microphone = Microphone.get();
     live_mic.rate = 8;
     live_mic.setSilenceLevel(20,200);
     
     var soundTrans:SoundTransform = new SoundTransform();
     soundTrans.volume = 6;
     live_mic.soundTransform = soundTrans;
     
     ns.attachAudio(live_mic);
     ns.publish("mic_stream","live")
     

Um das Audio zu hören, rufen Sie die NetStream.play()-Methode auf. Mit einem Aufruf von DisplayObjectContainer.addChild() leiten Sie das Audio an ein Objekt in der Anzeigeliste.

Parameter

Verwandte API-Elemente

Startet die Erfassung der Videodaten von einer Kamera bzw. stoppt die Erfassung, wenn theCamera auf null gesetzt ist. Diese Methode ist nur für den Herausgeber des angegebenen Streams verfügbar.

Diese Methode ist für die Verwendung mit Flash Media Server konzipiert. Weitere Informationen finden Sie in der Beschreibung der Klasse.

Nachdem Sie die Videoquelle angehängt haben, müssen Sie NetStream.publish() aufrufen, um die Übertragung zu starten. Abonnenten, die das Video anzeigen möchten, müssen die NetStream.play()- und die Video.attachCamera()-Methode aufrufen, um das Video auf der Bühne anzuzeigen.

Mit snapshotMilliseconds können Sie einen einzelnen Schnappschuss (durch Angabe des Werts „0“) oder eine Reihe von Schnappschüssen - die zusammen ein Zeitraffer-Video ergeben - senden. Hierzu geben Sie einen positiven Wert an, der dem Videofeed einen Nachspann anhängt, dessen Dauer der angegebenen Zahl in Millisekunden entspricht. Der Nachspann verlängert die Anzeigezeit der Videonachricht. Wenn wiederholt attachCamera() mit einem positiven Wert für snapshotMilliseconds aufgerufen wird, erzeugt die Sequenz wechselnder Schnappschüsse und Nachspänne ein Zeitraffer-Video. Sie können beispielsweise ein Bild pro Tag erfassen und an eine Videodatei anhängen. Wenn ein Abonnent die Datei wiedergibt, wird jedes Bild für die Dauer der angegebenen Anzahl an Millisekunden angezeigt.

Der Parameter snapshotMilliseconds hat nicht denselben Zweck wie der Parameter fps, den Sie mit Camera.setMode() festlegen können. Durch die Angabe von snapshotMilliseconds steuern Sie, wie viel Zeit zwischen den aufgezeichneten Bildern verstreicht. Durch Angabe von fps mit Camera.setMode() steuern Sie, wie viel Zeit zwischen Aufnahme und Wiedergabe verstreicht.

Beispiel: Sie möchten für insgesamt 100 Schnappschüsse alle fünf Minuten einen Schnappschuss erstellen. Hierzu haben Sie zwei Möglichkeiten:

• Sie können 100-mal den Befehl NetStream.attachCamera(myCamera, 500) ausführen, einmal alle fünf Minuten. So dauert die Aufnahme 500 Minuten, die Wiedergabe der Datei jedoch nur 50 Sekunden (100 Bilder mit 500 Millisekunden pro Bild).
• Sie können den Befehl Camera.setMode() mit einem fps-Wert von 1/300 (1 Bild alle 300 Sekunden, d. h. alle fünf Minuten) und anschließend den Befehl NetStream.attachCamera(source) ausführen, wobei die Kamera 500 Minuten fortlaufend aufzeichnet. Die Wiedergabe der fertigen Datei dauert 500 Minuten (dieselbe Dauer wie für die Aufnahme) und jedes Bild wird fünf Minuten lang angezeigt.

Bei beiden Methoden werden dieselben 500 Bilder erfasst, und beide Ansätze sind nützlich. Es hängt hauptsächlich von Ihren Wiedergabeanforderungen ab, welcher Ansatz für Sie geeigneter ist. Im zweiten Fall hätten Sie beispielsweise die Möglichkeit, über den gesamten Zeitraum Audiodaten aufzuzeichnen. Darüber hinaus haben die beiden Dateien etwa dieselbe Größe.

Parameter

Stoppt die Wiedergabe der Daten im Stream, legt für die Eigenschaft time den Wert 0 fest und macht den Stream für andere Verwendungszwecke verfügbar. Durch diese Methode wird auch die lokale Kopie einer Videodatei gelöscht, die über HTTP heruntergeladen wurde. Auch wenn die Anwendung die lokale Kopie der erstellten Datei löscht, verbleibt möglicherweise eine Kopie im Cache-Verzeichnis des Wenn Sie die Cache- oder lokale Speicherung der Videodatei vollständig vermeiden möchten, verwenden Sie Flash Media Server.

Wenn Flash Media Server verwendet wird, wird diese Methode implizit aufgerufen, wenn Sie NetStream.play() aus einem veröffentlichenden Stream oder NetStream.publish() aus einem abonnierenden Stream aufrufen. Bitte beachten Sie Folgendes:

• Wenn close() von einem veröffentlichenden Stream aufgerufen wird, stoppt der Stream die Veröffentlichung, und der Herausgeber kann den Stream jetzt für andere Zwecke verwenden. Abonnenten erhalten nichts mehr, das im Stream veröffentlicht wurde, da der Stream die Veröffentlichung beendet hat.
• Wenn close() von einem abonnierenden Stream aufgerufen wird, wird das Abspielen des Streams für den Abonnenten gestoppt, und der Abonnent kann den Stream für andere Zwecke verwenden. Andere Abonnenten sind davon nicht betroffen.
• Sie können das Abspielen eines abonnierenden Streams stoppen, ohne den Stream zu schließen oder den Stream-Typ zu ändern, indem Sie flash.net.NetStream.play(false) verwenden.

Verwandte API-Elemente

Gibt alle Ressourcen frei, die vom NetStream-Objekt gehalten werden.

Die dispose()-Methode ähnelt der close-Methode. Der Hauptunterschied zwischen den Methoden ist der, dass dispose() den Speicher freigibt, der für die Anzeige des aktuellen Videobildes verwendet wird. Wird dieses Bild zurzeit auf dem Bildschirm angezeigt, wird die Anzeige leer. Mit der close()-Methode wird der Bildschirm nicht leer, da die Methode diesen Speicher nicht freigibt.

Wird ausgelöst, wenn ein Peer-Publishing-Stream mit einem Peer-Subscribing-Stream übereinstimmt. Bevor der Abonnent mit dem Herausgeber verbunden wird, rufen Sie diese Methode auf, um dem ActionScript-Code eine feine Zugriffskontrolle für Peer-to-Peer-Publishing zu ermöglichen. Der folgende Code zeigt ein Beispiel, wie eine Callback-Funktion für diese Methode erstellt wird:

     var c:Object = new Object;
     c.onPeerConnect = function(subscriber:NetStream):Boolean {
      if (accept)
          return true;
      else
          return false;
      };
      m_netStream.client = c;
     

Wenn ein Peer-Herausgeber diese Methode nicht implementiert, dürfen alle Peers veröffentlichten Inhalt wiedergeben.

Parameter

Hält die Wiedergabe eines Videostreams an. Wenn die Wiedergabe bereits angehalten wurde, hat der Aufruf dieser Methode keine Auswirkung. Rufen Sie resume() auf, um ein angehaltenes Video weiter abzuspielen. Rufen Sie togglePause(), um zwischen dem Anhalten und Abspielen (erst anhalten, dann weiter abspielen) des Videos umzuschalten.

Beginnend mit Flash Player 9.0.115.0 leert der Flash Player den Puffer nicht mehr, wenn NetStream.pause() aufgerufen wird. Dieses Verhalten wird „smart pause“ genannt. In Vorgängerversionen von Flash Player 9.0.115.0 hat Flash Player gewartet, bis der Puffer voll war, bevor die Wiedergabe fortgesetzt wurde, wodurch es häufig zu Verzögerungen kam.

Hinweis: Aus Gründen der Abwärtskompatibilität wird das "NetStream.Buffer.Flush"-Ereignis (siehe NetStatusEvent.info-Eigenschaft) immer noch abgesetzt, obwohl der Server den Puffer nicht leert.

Für eine einzelne Pause hat die NetStream.bufferLength-Eigenschaft ein Limit von 60 Sekunden oder das Doppelte des Werts von NetStream.bufferTime, je nachdem, welcher Wert höher ist. Wenn bufferTime zum Beispiel 20 Sekunden beträgt, puffert Flash Player, bis NetStream.bufferLength den höheren Wert von 20*2 (40) oder 60 hat; in diesem Fall also bis bufferLength den Wert 60 hat. Wenn bufferTime 40 Sekunden beträgt, puffert Flash Player, bis bufferLength den höheren Wert von 40*2 (80) oder 60 hat; in diesem Fall also bis bufferLength den Wert 80 hat.

Die bufferLength-Eigenschaft hat auch ein absolutes Limit. Wenn ein Aufruf von pause() dazu führt, dass bufferLength auf mehr als 600 Sekunden ansteigt oder der Wert von bufferTime * 2, je nachdem, welcher Wert höher ist, löscht Flash Player den Puffer und setzt bufferLength auf 0 zurück. Wenn bufferTime zum Beispiel 120 Sekunden beträgt, löscht Flash Player den Puffer, wenn bufferLength den Wert 600 Sekunden erreicht; wenn bufferTime 360 Sekunden beträgt, löscht Flash Player den Puffer, wenn bufferLength den Wert 720 Sekunden erreicht.

Tipp: Sie können im Code NetStream.pause() verwenden, um Daten zu puffern, während Betrachter zum Beispiel einen Werbespot sehen, und dann die Pause aufheben, wenn das Hauptvideo beginnt.

Verwandte API-Elemente

Spielt eine Mediendatei von einem lokalen Verzeichnis oder einem Webserver ab; spielt eine Mediendatei oder einen Livestream von Flash Media Server ab. Setzt ein NetStatusEvent-Objekt ab, um Status- und Fehlermeldungen zu melden.

Informationen zu unterstützten Codecs und Dateiformaten finden Sie hier:

• Flash Media Server-Dokumentation
• Exploring Flash Player support for high-definition H.264 video and AAC audio
• FLV/F4V open specification documents

Arbeitsablauf beim Abspielen einer Datei oder eines Livestreams

1. Erstellen Sie ein Video-Objekt, das das Video anzeigt, und rufen Sie addChild() auf, um es der Bühne hinzuzufügen.

2. Erstellen Sie ein NetConnection-Objekt und rufen Sie NetConnection.connect() auf.

   Um eine Datei von einem lokalen Verzeichnis oder von einem Webserver abzuspielen, übergeben Sie null.

   Um eine aufgenommene Datei oder einen Livestream von Flash Media Server abzuspielen, übergeben Sie den URI einer Flash Media Server-Anwendung.

3. Rufen Sie die addEventListener()-Methode des NetConnection -Objekts auf, einen Listener für das netStatus-Ereignis (NetStatusEvent.NET_STATUS) hinzuzufügen.
4. Erstellen Sie für NetConnection.Connect.Success ein NetStream-Objekt und übergeben Sie das NetConnection-Objekt an den Konstruktor.
5. Rufen Sie die attachNetStream()-Methode des Video-Objekts auf und übergeben Sie das NetStream-Objekt.

6. Rufen Sie die play()-Methode des NetStream-Objekts auf.

   Um einen Livestream abzuspielen, übergeben Sie den Namen des Streams, der an die NetStream.publish()-Methode übergeben wurde.

   Um eine aufgenommene Datei abzuspielen, übergeben Sie den Dateinamen.

Hinweis: Es hat sich bewährt, immer das Video-Objekt zur Bühne hinzuzufügen, dann das NetStream-Objekt daran anzuhängen, dann die play()-Methode des NetStream-Objekts aufzurufen.

Aktivieren des Datengenerierungsmodus

Rufen Sie play(null) auf, um den Datengenerierungsmodus zu aktivieren. In diesem Modus rufen Sie die appendBytes()-Methode auf, um Daten an NetStream zu senden. Verwenden Sie den Datengenerierungsmodus, um Inhalt über HTTP vom Adobe HTTP Dynamic Streaming Origin Module an einen Apache HTTP-Server zu senden. Clients können beim HTTP Dynamic Streaming schnell einen Suchlauf zu einem beliebigen Punkt in einer Datei ausführen. Das Open Source Media Framework (OSMF) unterstützt HTTP Dynamic Streaming für Video on Demand und Live-Streams. Beispiele zur Verwendung des NetStream-Datengenerierungsmodus können Sie von der OSMF-Quelle herunterladen. Weitere Informationen zu HTTP Dynamic Streaming finden Sie unter HTTP Dynamic Streaming.

Wenn Sie diese Methode ohne Flash Media Server verwenden, gibt es Sicherheitsüberlegungen zu beachten. Eine Datei in der lokal vertrauenswürdigen Sandbox oder der lokalen Sandbox mit Netzwerkzugang kann eine Videodatei aus der remoten Sandbox wiedergeben, aber nicht ohne explizite Erlaubnis in Form einer URL-Richtliniendatei auf die Daten der remoten Datei zugreifen. Sie können auch eine SWF-Datei, die im Flash Player ausgeführt wird, daran hindern, diese Methode aufzurufen, indem Sie auf der HTML-Seite, die den SWF-Inhalt enthält, den Parameter allowNetworking der Tags object und embed festlegen. Weitere Informationen zum Thema Sicherheit finden Sie im Flash Player Developer Center im Abschnitt Sicherheit.

Parameter

Verwandte API-Elemente

     ns.play("mp4:samples/record1.f4v", 0, 100, true);
     

     ns.play("livestream");
     

var MyVideo:Video = new Video();
addChild(MyVideo);
 
var MyNC:NetConnection = new NetConnection();
MyNC.connect(null);
 
var MyNS:NetStream = new NetStream(MyNC);
MyVideo.attachNetStream(MyNS);
MyNS.play("http://www.helpexamples.com/flash/video/clouds.flv");

//the clouds.flv video has metadata we're not using, so create
//an error handler to ignore the message generated by the runtime
//about the metadata
MyNS.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); 

function asyncErrorHandler(event:AsyncErrorEvent):void 
{ 
   //ignore metadata error message
} 

Wechselt nahtlos zwischen Dateien mit mehreren Bitraten und ermöglicht einem NetStream die Wiederaufnahme, wenn eine Verbindung getrennt und wiederhergestellt wurde.

Diese Methode ist eine verbesserte Version von NetStream.play(). Wie die play()-Methode beginnt die play2()-Methode mit der Wiedergabe einer Mediendatei oder setzt Mediendateien in eine Warteschlange, um eine Wiedergabeliste zu erstellen. Wenn sie mit Flash Media Server verwendet wird, kann sie auch anfordern, dass der Server zu einer anderen Mediendatei wechselt. Der Übergang in der Clientanwendung erfolgt nahtlos. Die folgenden Funktionen verwenden play2()-Streamwechsel:

Dynamisches Streaming

Dynamisches Streaming (in Flash Media Server 3.5 und höher unterstützt) ermöglicht Ihnen, einen Stream zu bedienen, der mit mehreren Bitraten kodiert ist. Wenn sich die Netzwerkbedingungen des Betrachters ändern, empfängt er die Bitrate, die die beste Anzeige ermöglicht. Verwenden Sie die NetStreamInfo-Klasse, um Netzwerkbedingungen zu überwachen und Streams basierend auf den Daten zu wechseln. Sie können auch Streams für Clients mit unterschiedlicher Funktionalität wechseln. Weitere Informationen finden Sie unter „Dynamic streaming“ im Handbuch „Adobe Flash Media Server Developer Guide“.

Adobe hat ein benutzerdefinierte ActionScript-Klasse mit dem Namen DynamicStream entwickelt, die die NetStream-Klasse erweitert. Sie können die DynamicStream-Klasse verwenden, um dynamisches Streamen in einer Anwendung zu implementieren, statt eigenen Code zu schreiben, um Netzwerkbedingungen zu erkennen. Selbst wenn Sie sich dazu entscheiden, Ihren eigenen dynamischen Streamingcode zu schreiben, verwenden Sie die DynamicStream-Klasse als Referenzimplementierung. Laden Sie die Klasse und die Klassendokumentation von der Seite Flash Media Server tools and downloads herunter.

Stream-Neuverbindung

Die Stream-Neuverbindung (unterstützt in Flash Media Server 3.5.3 und höher) ermöglicht Benutzern die ununterbrochene Medienanzeige, selbst wenn ihre Verbindung verloren geht. Das Medium verwendet den Puffer zum Abspielen, während Ihre ActionScript-Logik die Verbindung zum Flash Media Server wiederherstellt. Rufen Sie nach der Neuverbindung NetStream.attach() auf, um dasselbe NetStream-Objekt mit der neuen NetConnection zu verwenden. Verwenden Sie die NetStream.attach()-, NetStreamPlayTransitions.RESUME- und NetStreamPlayTrasitions.APPEND_AND_WAIT-APIs, um einen Stream neu zu verbinden. Weitere Informationen finden Sie in der Flash Media Server 3.5.3-Dokumentation.

Parameter

Verwandte API-Elemente

Extrahiert DRM-Metadaten aus einer lokal gespeicherten Mediendatei.

Verwenden Sie zunächst preloadEmbeddedMetaData(), um die für die Offline-Wiedergabe benötigten DRM-Gutscheine herunterzuladen und im Zwischenspeicher abzulegen. Wenn in einer Mediendatei eingebettete DRM-Metadaten entdeckt werden, wird ein DRMContentData-Objekt an die onDRMContentData-Funktion des NetStream-Clients übergeben. Dieses DRMContentData-Objekt enthält die notwendigen Informationen, um den Gutschein zu erhalten, der zur Wiedergabe des Inhalts erforderlich ist. Übergeben Sie das DRMContentDataObject an die loadVoucher()-Methode des DRMManagers, um den Gutschein herunterzuladen.

Die Schritte zum Vorabladen eines DRM-Gutscheins sind:

• Erstellen Sie ein neues NetStream-Objekt zum Vorabladen der Metadaten.

• Verknüpfen Sie eine Callback-Funktion mit der onDRMContentData-Eigenschaft des NetStream-Clients.
• Erstellen Sie ein neues NetStreamPlayOptions-Objekt und setzen Sie seine streamName-Eigenschaft auf den URL-String der lokalen Videodatei.
• Rufen Sie preloadEmbeddedMetadata() auf, um das NetStreamPlayOptions-Objekt zu übergeben.
• Rufen Sie als Antwort auf das onDRMContentData-Callback die loadVoucher()-Methode des DRMManagers auf, um das DRMContentData-Objekt zu übergeben. Wenn die authenticationMethod-Eigenschaft des DRMContentData-Objekts den Wert userNameAndPassWord hat, authentifizieren Sie den Benutzer auf dem Medienrechteserver, bevor Sie den Gutschein laden.
• Schließen Sie den NetStream, der zum Vorabladen verwendet wird.

Hinweis: Um zum Vorabladen von Metadaten und zur Wiedergabe von Inhalt das gleiche NetStream-Objekt zu verwenden, warten Sie, bis der onPlayStatus-Aufruf von der preload-Methode generiert wurde, bevor mit der Wiedergabe begonnen wird.

Heruntergeladene Gutscheine werden in einem lokalen Zwischenspeicher gespeichert. Wenn Inhalt online wiedergegeben wird, werden ebenfalls Gutscheine heruntergeladen und im Zwischenspeicher abgelegt. Wenn eine DRM-geschützte Inhaltsdatei angezeigt wird, wird automatisch ein zwischengespeicherter Gutschein aus dem lokalen Speicher abgerufen. Verwenden Sie den DRMManager, um den Gutschein-Zwischenspeicher zu verwalten.

Hinweise: Das Vorabladen von DRM-Metadaten über HTTP-, HTTPS- oder RTMP-Verbindungen wird nicht unterstützt. Sie können nur Metadaten aus Dateien vorabladen, die im Dateisystem gespeichert sind.

Parameter

Verwandte API-Elemente

Sendet einen Stream mit Audiodaten, Videodaten und Datennachrichten von einem Client an Flash Media Server. Der Stream kann während der Übertragung aufgezeichnet werden. Diese Methode setzt ein NetStatusEvent-Objekt mit Informationen zum Stream ab. Bevor Sie NetStream.publish() aufrufen, erfassen Sie das "NetConnection.Connect.Success"-Ereignis, um zu überprüfen, ob die Anwendung erfolgreich eine Verbindung zu Flash Media Server hergestellt hat.

Beim Veröffentlichen können Sie Dateien im FLV- oder F4V-Format aufnehmen. Wenn Sie eine Datei im F4V-Format aufnehmen, verwenden Sie ein Reduzierungs-Tool, um die Datei in einer anderen Anwendung zu bearbeiten oder abzuspielen. Das Tool kann von www.adobe.com/go/fms_tools_de heruntergeladen werden.

Hinweis:Verwenden Sie diese Methode nicht zum Abspielen eines Streams. Um einen Stream wiederzugeben, verwenden Sie die NetStream.play()-Methode.

Arbeitsablauf beim Veröffentlichen eines Streams

1. Erstellen Sie ein NetConnection-Objekt und rufen Sie NetConnection.connect() auf.
2. Rufen Sie NetConnection.addEventListener() auf, um auf NetStatusEvent-Ereignisse zu warten.
3. Erstellen Sie für das "NetConnection.Connect.Success"-Ereignis ein NetStream-Objekt und übergeben Sie das NetConnection-Objekt an den Konstruktor.
4. Um Audio und Video zu erfassen, rufen Sie die NetStream.attachAudio()- und die NetStream.attachCamera()-Methode auf.
5. Um einen Stream zu veröffentlichen, verwenden Sie die NetStream.play()-Methode. Sie können die veröffentlichten Daten aufzeichnen, sodass Benutzer die Möglichkeit haben, sie zu einem späteren Zeitpunkt wiederzugeben.

Hinweis:Ein NetStream kann einen Stream entweder veröffentlichen oder abspielen, aber nicht beides. Um einen Stream zu veröffentlichen und die Wiedergabe vom Server anzuzeigen, erstellen Sie zwei NetStream-Objekte. Sie können mehrere NetStream-Objekte über ein NetConnection-Objekt senden.

Wenn Flash Media Server einen Stream aufzeichnet, wird eine Datei erstellt. Standardmäßig erstellt der Server ein Verzeichnis mit dem Namen der Anwendung, der an NetConnection.connect() übergeben wurde, und speichert die Datei in dem Verzeichnis. Mit dem folgenden Code wird zum Beispiel eine Verbindung zur Standardinstanz der Anwendung „lectureseries“ hergestellt und ein Stream namens „lecture“ aufgenommen. Die Datei „lecture.flv“ wird im Verzeichnis applications/lectureseries/streams/_definst_ directory aufgenommen:

     var nc:NetConnection = new NetConnection();
     nc.connect("rtmp://fms.example.com/lectureseries");
     nc.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
     
     function netStatusHandler(event:NetStatusEvent):void
     {
       if (event.info.code == "NetConnection.Connect.Success")
       {
            var ns:NetStream = new NetStream(nc);
            ns.publish("lecture", "record");
       }
     }
     

Das folgende Beispiel stellt eine Verbindung zur Instanz „monday“ derselben Anwendung her. Die Datei „lecture.flv“ wird im Verzeichnis /applications/lectureseries/streams/monday aufgenommen:

     var nc:NetConnection = new NetConnection();
     nc.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
     nc.connect("rtmp://fms.example.com/lectureseries/monday");
     
     function netStatusHandler(event:NetStatusEvent):void
     {
       if (event.info.code == "NetConnection.Connect.Success")
       {
            var ns:NetStream = new NetStream(nc);
            ns.publish("lecture", "record");
       }
     }
     

Parameter

Verwandte API-Elemente

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Video;
    import flash.media.Camera;
    import flash.net.NetConnection;
    import flash.net.NetStream;
    import fl.controls.Button;
    import fl.controls.Label;

    public class NetStream_publish extends Sprite {
        private var connectionURL:String = "rtmp://localhost/live/";
        private var videoURL:String = "liveVideo";
        private var nc:NetConnection;
        private var ns_publish:NetStream;
        private var ns_playback:NetStream;
        private var video_publish:Video;
        private var video_playback:Video;
        private var cam:Camera;
        private var b:Button;
        private var l:Label;

        public function NetStream_publish() {
            setUpUI();
            
            nc = new NetConnection();
            nc.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            
            // Add bandwidth detection handlers on the NetConnection Client to
            // prevent Reference Errors at runtime when using the "live" and "vod" applications.          
            var clientObj:Object = new Object();
            clientObj.onBWDone = onBWDone;
            clientObj.onBWCheck = onBWCheck;
            nc.client = clientObj;
            
            // Connect to the "live" application on Flash Media Server.
            nc.connect(connectionURL);
        }

        private function netStatusHandler(event:NetStatusEvent):void {
            trace(event.info.code + " | " + event.info.description);
            switch (event.info.code) {
                case "NetConnection.Connect.Success":
                    // Enable the "Publish" button after the client connects to the server.
                    b.enabled = true;
                    break;
                case "NetStream.Publish.Start":
                    playbackVideo();
                    break;
            }
        }
    
        private function publishVideo(event:MouseEvent):void{
            // Disable the button so that you can only publish once.
            b.enabled = false;
            // Create a NetStream to send video to FMS.
            ns_publish = new NetStream(nc);
            ns_publish.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            // Publish (send) the video to FMS.
            cam = Camera.getCamera();
            ns_publish.attachCamera(cam);
               ns_publish.publish(videoURL);
        }

        private function playbackVideo():void {
            // Create the Video object to show the video on the stage
            video_playback = new Video(cam.width, cam.height);
            video_playback.x = cam.width + 20;
            video_playback.y = 10;
            addChild(video_playback);
            // Create a NetStream to receive the video from FMS.
            ns_playback = new NetStream(nc);
            ns_playback.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            // Display the video that was published to FMS.
                  video_playback.attachNetStream(ns_playback);
            ns_playback.play(videoURL); 
        }
        
        
        private function setUpUI():void { 
      b = new Button(); 
      b.addEventListener(MouseEvent.CLICK, publishVideo);
      b.width = 150;
            b.label = "Publish video to server";
            b.move(10, 150);
            b.enabled = false;
            
            l = new Label();
            l.width = 150;
            l.text = "Playing back from server"
            l.move(190, 150);
            
            addChild(b);
            addChild(l);
        }
        
        // Handlers called by the Flash Media Server "live" and "vod" applications.
        public function onBWDone(... rest):Boolean {
            return true;
        }
        
        public function onBWCheck(... rest):Number {
            return 0;
        }
    }
}

Gibt an, ob eingehende Audiodaten im Stream wiedergegeben werden. Diese Methode ist nur für Clients verfügbar, die den angegebenen Stream abonniert haben. Dem Herausgeber des Streams steht sie nicht zur Verfügung. Rufen Sie diese Methode vor oder nach dem Aufruf der NetStream.play()-Methode auf. Fügen Sie diese Methode zum Beispiel einer Schaltfläche an, mit der der Benutzer den Ton aus- und einschalten kann. Verwenden Sie diese Methode nur bei Unicast-Streams, die von Flash Media Server wiedergegeben werden. Diese Methode funktioniert nicht für RTMFP-Multicast-Streams oder bei Verwendung der NetStream.appendBytes()-Methode.

Parameter

Gibt an, ob eingehende Videodaten im Stream wiedergegeben werden. Diese Methode ist nur für Clients verfügbar, die den angegebenen Stream abonniert haben. Dem Herausgeber des Streams steht sie nicht zur Verfügung. Rufen Sie diese Methode vor oder nach dem Aufruf der NetStream.play()-Methode auf. Fügen Sie diese Methode zum Beispiel einer Schaltfläche an, mit der der Benutzer Video ein- und ausblenden kann. Verwenden Sie diese Methode nur bei Unicast-Streams, die von Flash Media Server wiedergegeben werden. Diese Methode funktioniert nicht für RTMFP-Multicast-Streams oder bei Verwendung der NetStream.appendBytes()-Methode.

Parameter

Gibt die Bildrate für eingehendes Video an. Diese Methode ist nur für Clients verfügbar, die den angegebenen Stream abonniert haben. Dem Herausgeber des Streams steht sie nicht zur Verfügung. Rufen Sie diese Methode vor oder nach dem Aufruf der NetStream.play()-Methode auf. Rufen Sie diese Methode zum Beispiel auf, um Benutzern das Festlegen der Videobildfrequenz zu ermöglichen. Mit NetStream.currentFPS können Sie die aktuelle Bildrate zu bestimmen. Um den Videoempfang zu beenden, übergeben Sie 0.

Wenn Sie einen Wert an den FPS-Parameter übergeben, um die Bildrate des Videos zu begrenzen, versucht Flash Media Server, die Bildrate zu verringern und gleichzeitig die Integrität des Videos zu erhalten. Jeweils zwischen zwei Schlüsselbildern sendet der Server die Mindestanzahl Bilder, um die gewünschte Bildrate zu erreichen. Beachten Sie, dass Zwischenbilder (I-frames) direkt angrenzend gesendet werden müssen, andernfalls ist das Video fehlerhaft. Deshalb wird die gewünschte Anzahl Bilder sofort und angrenzend an einen Keyframe gesendet. Da die Bilder nicht gleichmäßig verteilt sind, erscheint die Bewegung in Segmenten fließend, unterbrochen von kurzen Halts.

Verwenden Sie diese Methode nur bei Unicast-Streams, die von Flash Media Server wiedergegeben werden. Diese Methode funktioniert nicht für RTMFP-Multicast-Streams oder bei Verwendung der NetStream.appendBytes()-Methode.

Parameter

In AIR-Anwendungen werden dadurch alle lokal gespeicherten Digital Rights Management (DRM)-Gutscheindaten gelöscht. Für browserbasierte Anwendungen ist dies nur während 3322-Fehlern verfügbar und funktioniert wie das Einstellungsbedienfeld von Protected Content Playback.

Die Anwendung muss alle erforderlichen Gutscheine erneut vom Medienrechteserver herunterladen, damit der Benutzer auf zugriffsgeschützten Inhalt zugreifen kann. Der Aufruf dieser Funktion hat den gleichen Effekt wie das Aufrufen der resetDRMVouchers()-Funktion des DRMManager-Objekts.

Verwandte API-Elemente

NetStream.resetDRMVouchers();

Setzt die Wiedergabe eines angehaltenen Videostreams fort. Wenn die Wiedergabe bereits läuft, hat der Aufruf dieser Methode keine Auswirkung.

Verwandte API-Elemente

Sucht das Schlüsselbild (in der Videobranche auch „I-Frame“ genannt), das der angegebenen Position am nächsten ist. Das Schlüsselbild wird mit einem Offset (einer Verschiebung) in Sekunden ab dem Beginn des Streams platziert.

Videostreams werden normalerweise mit zwei Arten von Bildern kodiert: Schlüsselbildern (oder I-Frames) und P-Frames. Ein Schlüsselbild enthält ein gesamtes Bild, während ein P-Frame ein Zwischenbild ist, das zusätzliche Videoinformationen zwischen Schlüsselbildern bietet. Ein Video-Stream enthält in der Regel alle 10 bis 50 Bilder ein Schlüsselbild.

Flash Media Server verfügt über verschiedene Arten von Suchlaufverhalten: erweiterter Suchlauf und intelligenter Suchlauf.

Erweiterter Suchlauf

Der erweiterte Suchlauf ist standardmäßig aktiviert. Um den erweiterten Suchlauf zu deaktivieren, stellen Sie auf dem Flash Media Server das EnhancedSeek-Element in der Application.xml-Konfigurationsdatei auf false ein.

Wenn der erweiterte Suchlauf aktiviert ist, generiert der Server ein neues Schlüsselbild bei offset, basierend auf dem vorherigen Schlüsselbild und ggf. dazwischenliegenden P-Frames. Durch das Generieren von Schlüsselbildern wird auf dem Server jedoch eine hohe Verarbeitungslast erzeugt, und im generierten Schlüsselbild kann es zu Verzerrungen kommen. Wenn der Videocodec On2 verwendet wird, werden das Schlüsselbild vor dem Suchpunkt sowie alle P-Frames zwischen dem Schlüsselbild und dem Suchpunkt an den Client gesendet.

Wenn der erweiterte Suchlauf deaktiviert ist, beginnt der Server ab dem nächstliegenden Schlüsselbild mit dem Streaming. Angenommen, ein Video hat Schlüsselbilder bei 0 Sekunden und bei 10 Sekunden. Ein Suchlauf von 4 Sekunden startet die Wiedergabe bei 4 Sekunden unter Verwendung des Schlüsselbilds bei 0 Sekunden. Das Video bleibt stehen, bis das nächste Schlüsselbild bei 10 Sekunden erreicht wird. Um bessere Suchläufe zu erzielen, müssen Sie das Schlüsselbildintervall verringern. Im normalen Suchmodus können Sie das Video nicht an einem Punkt zwischen den Schlüsselbildern starten.

Intelligenter Suchlauf

Um den intelligenten Suchlauf zu aktivieren, stellen Sie NetStream.inBufferSeek auf true ein.

Der intelligente Suchlauf ermöglicht Flash Player, innerhalb eines vorhandenen Rücklauf- und Vorlaufpuffer zu suchen. Wenn der intelligente Suchlauf deaktiviert ist, leert Flash Player bei jedem Aufruf von seek() den Puffer und fordert Daten vom Server an. Weitere Informationen finden Sie im Abschnitt zu NetStream.inBufferSeek.

Suchläufe im Datengenerierungsmodus

Wenn Sie seek() für einen NetStream im Datengenerierungsmodus aufrufen, werden alle an appendBytes() übergebenen Daten verworfen (nicht gepuffert, nicht im Teilnachrichten-FIFO akkumuliert oder nach Suchpunkten analysiert), bis Sie appendBytesAction(NetStreamAppendBytesAction.RESET_BEGIN) oder appendBytesAction(NetStreamAppendBytesAction.RESET_SEEK) aufrufen, um den Parser zurückzusetzen. Informationen zum Datengenerierungsmodus finden Sie unter NetStream.play().

Parameter

Verwandte API-Elemente

Sendet eine Nachricht an alle Clients mit Abonnement über den veröffentlichten Stream. Diese Methode ist nur für den Herausgeber des angegebenen Streams verfügbar. Diese Methode steht nur zur Verwendung mit Flash Media Server zur Verfügung. Erstellen Sie eine Prozedur für das NetStream-Objekt, zum Beispiel ns.HandlerName, um diese Meldung zu verarbeiten und darauf zu reagieren.

Methoden und ihre Daten, Objektprototypvariablen und nicht zählbare Variablen werden in Flash Player oder AIR nicht serialisiert. Zur Anzeige von Objekten serialisiert Flash Player oder AIR lediglich den Pfad.

Sie können die send()-Methode aufrufen, um einem für Flash Media Server veröffentlichten Live-Stream Datenschlüsselbilder hinzuzufügen. Ein Datenschlüsselbild ist eine Meldung, die ein Herausgeber einem Live-Stream hinzufügt. Datenschlüsselbilder werden normalerweise verwendet, um einem Live-Stream Metadaten hinzuzufügen, bevor die Daten von Kamera und Mikrofon für den Stream erfasst werden. Ein Herausgeber kann jederzeit ein Datenschlüsselbild hinzufügen, während der Live-Stream veröffentlicht wird. Das Datenschlüsselbild wird im Speicher des Servers gespeichert, solange der Herausgeber mit dem Server verbunden ist.

Clients, die den Live-Stream vor dem Hinzufügen eines Datenschlüsselbilds abonniert haben, erhalten das Schlüsselbild sobald es hinzugefügt wurde. Clients, die den Live-Stream nach dem Hinzufügen eines Datenschlüsselbilds abonnieren, erhalten das Schlüsselbild sobald sie den Stream abonnieren.

Um einem Live-Stream, der an Flash Media Server gesendet wird, ein Schlüsselbild mit Metadaten hinzuzufügen, verwenden Sie @setDataFrame als Prozedurnamen, gefolgt von zwei zusätzlichen Argumenten, zum Beispiel:

     var ns:NetStream = new NetStream(nc);
     ns.send("@setDataFrame", "onMetaData", metaData);
     

Das Argument @setDataFrame verweist auf eine spezielle Prozedur, die in Flash Media Server integriert ist. Das Argument onMetaData ist der Name einer Callback-Funktion in Ihrer Client-Anwendung, die auf das onMetaData-Ereignis wartet und die Metadaten abruft. Das dritte Element, metaData, ist eine Instanz von Object oder Array mit Eigenschaften, die die Metadatenwerte definieren.

Mit @clearDataFrame löschen Sie ein Schlüsselbild mit Metadaten, das bereits im Stream gesendet wurde:

     ns.send("@clearDataFrame", "onMetaData");
     

Parameter

Verwandte API-Elemente

package {
   import flash.display.Sprite;
   import flash.net.NetConnection;
   import flash.net.NetStream;
   import flash.events.NetStatusEvent;
   import flash.media.Video;
   import flash.utils.setTimeout;

 
   public class TestExample extends Sprite
   {
     var nc:NetConnection = new NetConnection();
     var ns1:NetStream;
     var ns2:NetStream;
     var vid:Video = new Video(300,300);
     var obj:Object = new Object();
 
     public function TestExample() {
        nc.objectEncoding = 0;
        nc.addEventListener("netStatus", onNCStatus);
        nc.connect("rtmp://localhost/FlashVideoApp");
        addChild(vid); 
     }
  
     function onNCStatus(event:NetStatusEvent):void {
       switch (event.info.code) {
           case "NetConnection.Connect.Success":
               trace("You've connected successfully");
               ns1 = new NetStream(nc);
               ns2 = new NetStream(nc);
               
               ns1.client = new CustomClient();
               ns1.publish("dummy", "live");
    
               ns2.client = new CustomClient();
               vid.attachNetStream(ns2);
               ns2.play("dummy");
               setTimeout(sendHello, 3000);
               break;
              
           case "NetStream.Publish.BadName":
               trace("Please check the name of the publishing stream" );
               break;
        }   
     }

     function sendHello():void {
         ns1.send("myFunction", "hello");
     }       
   }
 }
 
 class CustomClient {
    public function myFunction(event:String):void {
       trace(event);
    }
 }

private function netStatusHandler(event:NetStatusEvent):void {
     switch (event.info.code) {  
        case "NetStream.Publish.Start":
            var metaData:Object = new Object();
            metaData.title = "myStream";
            metaData.width = 400;
            metaData.height = 200;
            ns.send("@setDataFrame", "onMetaData", metaData);
            ns.attachCamera( Camera.getCamera() );
            ns.attachAudio( Microphone.getMicrophone() );        
    }
}

 public function onMetaData(info:Object):void {
    trace("width: " + info.width);
    trace("height: " + info.height);
 }

 // Create a NetStream for playing
 var my_ns:NetStream = new NetStream(my_nc);
 my_video.attachNetStream(my_ns);
 
 // Play the stream record1
 my_ns.play("record1", 0, -1, true);
 
 // Switch to the stream live1 and play for 5 seconds.  
 // Since reset is false, live1 will start to play after record1 is done.
 my_ns.play("live1", -1 , 5, false);

 //To play at normal speed
 var my_ns:NetStream = new NetStream(my_nc);
 my_ns.play("log", 0, -1);
 
 //To get the data messages all at once
 my_ns.play("log", 0, -1, 3);

Senden die DRM-Authentifizierungsdaten, die für die Anzeige des verschlüsselten Inhalts erforderlich sind.

Die setDRMAuthenticationCredentials()-Methode muss Benutzerdaten zur Verfügung stellen, die mit denjenigen übereinstimmen, die vom Content Provider oder dem Proxyserver erkannt und akzeptiert werden. Dies sind dieselben Benutzerdaten, die der Benutzer verwendet, um die Berechtigung zum Anzeigen des Inhalts zu bekommen.

Parameter

Verwandte API-Elemente

Geht in Relation zum aktuell angezeigten Bild die angegebene Anzahl von Bildern vor oder zurück. Geben Sie eine positive Zahl an, um vorzugehen, oder eine negative Zahl, um zurückzugehen. Rufen Sie diese Methode auf, um exakte Schnellvorlauf- oder Rücklauffunktionalität zu erstellen.

Hinweis: Diese Methode wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Diese Methode ist nur verfügbar, wenn Daten von Flash Media Server 3.5.3 oder höher gestreamt werden und wenn NetStream.inBufferSeek den Wert true hat. Außerdem muss sich der Ziel-Frame im Puffer befinden. Wenn zum Beispiel das zurzeit angezeigte Bild das Bild mit der Nummer 120 ist und Sie einen Wert von 1000 angeben, schlägt die Methode fehl, wenn sich das Bild mit der Nummer 1120 nicht im Puffer befindet.

Diese Methode ist zur Verwendung mit den Methoden pause() oder togglePause() gedacht. Wenn Sie während der Wiedergabe ohne Pause 10 Bilder vor- oder zurückgehen, bemerken Sie die Schritte möglicherweise nicht oder sie sehen wie eine Störung aus. Wenn Sie pause() oder togglePause aufrufen, wird das Audio unterdrückt.

Wenn der Aufruf von NetStream.step() erfolgreich ist, wird ein NetStatusEvent gesendet, wobei "NetStream.Step.Notify" als Wert für die code-Eigenschaft des Info-Objekts angegeben wird.

Parameter

Verwandte API-Elemente

Hält die Wiedergabe eines Streams an oder setzt sie fort. Beim ersten Aufruf dieser Methode wird die Wiedergabe angehalten und beim zweiten Aufruf fortgesetzt. Mit dieser Methode können Sie Benutzern ermöglichen, die Wiedergabe über dieselbe Schaltfläche anzuhalten und fortzusetzen.

Verwandte API-Elemente

Wird ausgelöst, wenn eine Ausnahme asynchron ausgelöst wird – das heißt, aus nativem asynchronem Code. Dieses Ereignis wird ausgelöst, wenn ein Server eine Methode auf einem Client aufruft, die nicht definiert ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn ein NetStream-Objekt versucht, mit DRM (Digital Rights Management) verschlüsselten Inhalt abzuspielen, für den Benutzerdaten zur Authentifizierung erforderlich sind.

Hinweis: Dieses Ereignis wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Authentifizieren Sie den Benutzer mit der setDRMAuthenticationCredentials()-Methode des NetStream-Objekts. Wenn die Benutzerauthentifizierung fehlschlägt, startet die Anwendung einen neuen Versuch und setzt ein neues DRMAuthenticateEvent-Ereignis für das NetStream-Objekts ab.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn ein NetStream-Objekt versucht, eine mit DRM (Digital Rights Management) verschlüsselte Datei abzuspielen und dabei ein DRM-Fehler auftritt. Ein DRMErrorEvent-Objekt wird zum Beispiel ausgelöst, wenn die Benutzerautorisierung fehlschlägt. Dies kann daran liegen, dass der Benutzer die Berechtigung zum Anzeigen des Inhalts nicht erworben hat oder dass der Content Provider das Anzeigen der Anwendung nicht unterstützt.

Hinweis: Dieses Ereignis wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn der DRM-verschlüsselte Inhalt (Digital Rights Management) abgespielt wird (wenn der Benutzer authentifiziert wurde und berechtigt ist, den Inhalt abzuspielen).

Hinweis: Dieses Ereignis wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Das DRMStatusEvent-Objekt enthält Informationen zum Gutschein, zum Beispiel ob der Inhalt offline verfügbar ist oder wann der Gutschein abläuft und Benutzer den Inhalt nicht mehr anzeigen können.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird beim Auftreten eines I/O-Fehlers ausgelöst, durch den ein Netzwerkvorgang fehlschlägt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird abgesetzt, wenn Video abgespielt wird und bestimmte Meldungstypen verarbeitet werden.

Ein NetDataEvent wird für die folgenden Nachrichten abgesetzt:

• onCuePoint
• onImageData
• onMetaData
• onPlayStatus (für den Code NetStream.Play.Complete)
• onTextData
• onXMPData

Hinweis: Dieses Ereignis wird nicht von Inhalten abgesetzt, die in Flash Player im Browser unter Android oder Blackberry Tablet OS oder in AIR unter iOS ausgeführt werden.

Wird ausgelöst, wenn der Status oder die Fehlerbedingung eines NetStream-Objekts protokolliert wird. Das Ereignis netStatus enthält die Eigenschaft info. Dabei handelt es sich um ein Informationsobjekt mit spezifischen Informationen über das Ereignis, z. B., ob ein Verbindungsversuch erfolgreich war oder fehlgeschlagen ist.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Erstellt einen Listener, der reagiert, wenn während des Abspielens einer Videodatei ein eingebetteter Cue-Point erreicht wird. Sie können den Listener verwenden, um Aktionen in Ihrem Code auszulösen, wenn das Video einen bestimmten Cue-Punkt erreicht, an dem Sie andere Aktionen in Ihrer Anwendung mit Videoabspielereignissen synchronisieren können. Weitere Informationen zu Videoformaten, die vom Flash Media Server unterstützt werden, finden Sie unter www.adobe.com/go/learn_fms_fileformats_de.

Hinweis: Dieses Ereignis wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

onCuePoint ist eigentlich eine Eigenschaft des NetStream.client-Objekts. Die Eigenschaft wird im Abschnitt „Ereignisse“ aufgeführt, weil sie auf ein Datenereignis reagiert, wenn entweder mit dem Media Flash Player gestreamt oder eine FLV-Datei wiedergegeben wird. Weitere Informationen finden Sie in der Beschreibung der NetStream-Klasse. Sie können die addEventListener()-Methode bzw. andere EventDispatcher-Methoden nicht verwenden, um onCuePoint zu überwachen oder als ein Ereignis zu verarbeiten. Definieren Sie eine Rückruffunktion und fügen Sie sie einem der folgenden Objekte hinzu:

• Das Objekt, auf das die client-Eigenschaft einer NetStream-Instanz verweist.
• Eine Instanz einer NetStream-Unterklasse. Bei „NetStream“ handelt es sich um eine „versiegelte“ Klasse, d. h., dass einem NetStream-Objekt zur Laufzeit keine Eigenschaften oder Methoden hinzugefügt werden können. Erstellen Sie eine Unterklasse von NetStream und definieren Sie Ihre Ereignisprozedur in der Unterklasse. Sie können die Unterklasse als dynamische Klasse definieren und die Ereignisprozedurfunktion einer Instanz der Unterklasse hinzufügen.

Der verknüpfte Ereignis-Listener wird nach dem Aufruf der NetStream.play()-Methode, aber noch vor dem Vorlauf des Abspielkopfes ausgelöst.

Sie können die folgenden Arten von Cue-Points in eine Videodatei einbetten:

• Ein Navigations-Cue-Point gibt ein Schlüsselbild innerhalb der Videodatei an, wobei die time-Eigenschaft des Cue-Points exakt dem Schlüsselbild entspricht. Navigations-Cue-Points werden oft als Lesezeichen oder Eingangspunkte verwendet, anhand derer die Benutzer durch die Videodatei navigieren können.
• Ein Ereignis-Cue-Point gibt eine Zeit an. Die Zeit kann einem bestimmten Schlüsselbild entsprechen, dies muss jedoch nicht so sein. Ein Ereignis-Cue-Point steht in der Regel für einen Zeitpunkt eines Ereignisses im Video, das zur Auslösung anderer Anwendungsereignisse verwendet werden kann.

Das onCuePoint-Ereignisobjekt hat folgende Eigenschaften:

Sie können Cue-Points beim ersten Kodieren der Videodatei oder beim Importieren eines Videoclips in das Flash-Authoring-Tool mit dem Videoimportassistenten einfügen.

Das Ereignis onMetaData ruft auch Informationen über die Cue-Points in einer Videodatei ab. Das Ereignis onMetaData ruft jedoch Informationen über alle Cue-Points ab, bevor die Wiedergabe des Videos gestartet wird. Das Ereignis onCuePoint ruft dagegen Informationen über einen einzelnen Cue-Point zu dem für diesen Cue-Point festgelegten Zeitpunkt während der Wiedergabe ab.

Wenn Sie bei einem bestimmten Cue-Point zu dem Zeitpunkt, zu dem er in der Wiedergabe auftritt, eine Aktion im Code auslösen möchten, verwenden Sie das Ereignis onCuePoint.

Mit der für das Ereignis onMetaData bereitgestellten Liste von Cue-Points können Sie den Benutzern ermöglichen, die Wiedergabe an vordefinierten Punkten im Videostream zu starten. Übergeben Sie den Wert der time-Eigenschaft des Cue-Point an die Methode NetStream.seek(), um die Wiedergabe des Videos ab diesem Cue-Point zu starten.

var video:Video = new Video();
addChild(video);
 
var nc:NetConnection = new NetConnection();
nc.connect(null);
 
var ns:NetStream = new NetStream(nc);
ns.client = {};
ns.client.onMetaData = ns_onMetaData;
ns.client.onCuePoint = ns_onCuePoint;

video.attachNetStream(ns);
ns.play("http://www.helpexamples.com/flash/video/cuepoints.flv");

 
function ns_onMetaData(item:Object):void {
    trace("metaData");
    // Resize video instance.
    video.width = item.width;
    video.height = item.height;
    // Center video instance on Stage.
    video.x = (stage.stageWidth - video.width) / 2;
    video.y = (stage.stageHeight - video.height) / 2;
}
 
function ns_onCuePoint(item:Object):void {
    trace("cuePoint");
    trace(item.name + "\t" + item.time);
}

Verwandte API-Elemente

Erstellt einen Listener, der reagiert, wenn AIR DRM-Inhalts-Metadaten extrahiert, die in einer Mediendatei eingebettet sind.

Hinweis: Dieses Ereignis wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Ein DRMContentData-Objekt enthält die notwendigen Informationen, um einen Gutschein zu erhalten, der zur Wiedergabe einer DRM-geschützten Mediendatei erforderlich ist. Verwenden Sie die DRMManager-Klasse, um den Gutschein mit diesen Informationen herunterzuladen.

onDRMContentData ist eine Eigenschaft des NetStream.client-Objekts. Diese Eigenschaft wird im Abschnitt „Ereignisse“ aufgeführt, weil sie beim Vorabladen eingebetteter Daten aus einer lokalen Mediendatei auf ein Datenereignis reagiert. Weitere Informationen finden Sie in der Beschreibung der NetStream-Klasse. Sie können die addEventListener()-Methode bzw. andere EventDispatcher-Methoden nicht verwenden, um onDRMContentData zu überwachen oder als ein Ereignis zu verarbeiten. Stattdessen müssen Sie eine einzelne Callback-Funktion definieren und direkt an eines der folgenden Objekte anhängen:

• Das Objekt, auf das die client-Eigenschaft einer NetStream-Instanz verweist.
• Eine Instanz einer NetStream-Unterklasse. Bei „NetStream“ handelt es sich um eine „versiegelte“ Klasse, d. h., dass einem NetStream-Objekt zur Laufzeit keine Eigenschaften oder Methoden hinzugefügt werden können. Sie können jedoch eine Unterklasse für „NetStream“ erstellen und die Ereignisprozedur in der Unterklasse definieren oder die Unterklasse als dynamisch festlegen und die Ereignisprozedurfunktion einer Instanz der Unterklasse hinzufügen.

Verwandte API-Elemente

Erstellt einen Listener, der reagiert, wenn Flash Player Bilddaten als Bytearray erhält, das in einer Mediendatei eingebettet ist, die aktuell abgespielt wird. Die Bilddaten können entweder JPEG-, PNG- oder GIF-Inhalt erzeugen. Verwenden Sie die flash.display.Loader.loadBytes()-Methode, um das Bytearray in ein Anzeigeobjekt zu laden.

Hinweis: Dieses Ereignis wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

onImageData ist eigentlich eine Eigenschaft des NetStream.client-Objekts. Die Eigenschaft wird im Abschnitt „Ereignisse“ aufgeführt, weil sie auf ein Datenereignis reagiert, wenn entweder mit dem Media Flash Player gestreamt oder eine FLV-Datei wiedergegeben wird. Weitere Informationen finden Sie in der Beschreibung der NetStream-Klasse. Sie können die addEventListener()-Methode bzw. andere EventDispatcher-Methoden nicht verwenden, um onImageData zu überwachen oder als ein Ereignis zu verarbeiten. Definieren Sie eine einzelne Rückruffunktion und fügen Sie sie einem der folgenden Objekte hinzu:

• Das Objekt, auf das die client-Eigenschaft einer NetStream-Instanz verweist.
• Eine Instanz einer NetStream-Unterklasse. Bei „NetStream“ handelt es sich um eine „versiegelte“ Klasse, d. h., dass einem NetStream-Objekt zur Laufzeit keine Eigenschaften oder Methoden hinzugefügt werden können. Erstellen Sie eine Unterklasse von NetStream und definieren Sie Ihre Ereignisprozedur in der Unterklasse. Sie können die Unterklasse als dynamische Klasse definieren und die Ereignisprozedurfunktion einer Instanz der Unterklasse hinzufügen.

Der verknüpfte Ereignis-Listener wird nach dem Aufruf der NetStream.play()-Methode, aber noch vor dem Vorlauf des Abspielkopfes ausgelöst.

Das onImageData-Ereignisobjekt enthält die Bilddaten als ein Bytearray, das über einen AMF0-Datenkanal gesendet wird.

package {
    import flash.display.*;
    import flash.net.*;
    import flash.media.*;
    import flash.system.*;
    import flash.events.*;

        public class OnTextDataExample extends Sprite {
                                              
            public function OnTextDataExample():void {

                var my_video:Video = new Video();
                addChild(my_video);

                var customClient:Object = new Object();
                customClient.onImageData = onImageDataHandler;           
                customClient.onTextData = onTextDataHandler;               

                var my_nc:NetConnection = new NetConnection();
                my_nc.connect(null);
                var my_ns:NetStream = new NetStream(my_nc);
                my_ns.client = customClient;

                my_video.attachNetStream(my_ns);
                my_ns.play("yourURL");
            }

            public function onImageDataHandler(imageData:Object):void {

                trace("imageData length: " + imageData.data.length);
                var imageloader:Loader = new Loader();           
                imageloader.loadBytes(imageData.data); // imageData.data is a ByteArray object.
                addChild(imageloader);
            }

    
            public function onTextDataHandler(textData:Object):void {

                trace("--- textData properties ----");
                var key:String;

                for (key in textData) {
                    trace(key + ": " + textData[key]);
                }
            }

        }

}

Verwandte API-Elemente

Erstellt einen Listener, der reagiert, wenn Flash Player beschreibende Informationen erhält, die in ein Video eingebettet sind, das aktuell abgespielt wird. Weitere Informationen zu Videoformaten, die vom Flash Media Server unterstützt werden, finden Sie unter www.adobe.com/go/learn_fms_fileformats_de.

onMetaData ist eigentlich eine Eigenschaft des NetStream.client-Objekts. Die Eigenschaft wird im Abschnitt „Ereignisse“ aufgeführt, weil sie auf ein Datenereignis reagiert, wenn entweder mit dem Media Flash Player gestreamt oder eine FLV-Datei wiedergegeben wird. Weitere Informationen finden Sie in der NetStream-Klassenbeschreibung und der NetStream.client-Eigenschaft. Die addEventListener()-Methode und die übrigen EventDispatcher-Methoden können nicht verwendet werden, um auf onMetaData zu warten oder diese Eigenschaft als Ereignis zu verarbeiten. Definieren Sie eine einzelne Rückruffunktion und fügen Sie sie einem der folgenden Objekte hinzu:

• Das Objekt, auf das die client-Eigenschaft einer NetStream-Instanz verweist.
• Eine Instanz einer NetStream-Unterklasse. Bei „NetStream“ handelt es sich um eine „versiegelte“ Klasse, d. h., dass einem NetStream-Objekt zur Laufzeit keine Eigenschaften oder Methoden hinzugefügt werden können. Sie können eine Unterklasse von NetStream erstellen und Ihre Ereignisprozedur in der Unterklasse definieren. Sie können die Unterklasse als dynamische Klasse definieren und die Ereignisprozedurfunktion einer Instanz der Unterklasse hinzufügen.

Das Dienstprogramm Flash Video Exporter (ab Version 1.1) bettet die Dauer, das Erstellungsdatum, die Datenrate und andere Angaben in die Videodatei selbst ein. Von anderen Videokodierern werden andere Metadaten eingebettet.

Der verknüpfte Ereignis-Listener wird nach dem Aufruf der NetStream.play()-Methode, aber noch vor dem Vorlauf des Abspielkopfes ausgelöst.

Häufig ist die in den Stream-Metadaten eingebettete Längenangabe nur ein ungefährer Wert. Das bedeutet, dass dieser Wert nicht immer mit dem Wert der Eigenschaft NetStream.time übereinstimmt, wenn der Abspielkopf das Ende des Videostreams erreicht hat.

Das Ereignisobjekt, das an die onMetaData-Ereignisprozedur übergeben wurde, enthält eine Eigenschaft für jeden Textdatenteil.

var video:Video = new Video();
addChild(video);
 
var nc:NetConnection = new NetConnection();
nc.connect(null);
 
var ns:NetStream = new NetStream(nc);
ns.client = {};
ns.client.onMetaData = ns_onMetaData;
ns.client.onCuePoint = ns_onCuePoint;

video.attachNetStream(ns);
ns.play("http://www.helpexamples.com/flash/video/cuepoints.flv");

 
function ns_onMetaData(item:Object):void {
    trace("metaData");
    // Resize video instance.
    video.width = item.width;
    video.height = item.height;
    // Center video instance on Stage.
    video.x = (stage.stageWidth - video.width) / 2;
    video.y = (stage.stageHeight - video.height) / 2;
}
 
function ns_onCuePoint(item:Object):void {
    trace("cuePoint");
    trace(item.name + "\t" + item.time);
}

Verwandte API-Elemente

Erstellt einen Listener, der reagiert, wenn ein NetStream-Objekt einen Stream vollständig abgespielt hat. Das verknüpfte Ereignisobjekt liefert zusätzliche Informationen zu dem, was vom netStatus-Ereignis zurückgegeben wird. Sie können diese Eigenschaft verwenden, um Aktionen in Ihrem Code auszulösen, wenn ein NetStream-Objekt von einem Stream zu einem anderen Stream in einer Wiedergabeliste gewechselt hat (wie durch das Informationsobjekt NetStream.Play.Switch angegeben) oder wenn ein NetStream-Objekt bis zum Ende abgespielt wurde (wie durch das Informationsobjekt NetStream.Play.Complete angegeben).

onPlayStatus ist eigentlich eine Eigenschaft des NetStream.client-Objekts. Die Eigenschaft wird im Abschnitt „Ereignisse“ aufgeführt, weil sie auf ein Datenereignis reagiert, wenn entweder mit dem Media Flash Player gestreamt oder eine FLV-Datei wiedergegeben wird. Weitere Informationen finden Sie in der Beschreibung der NetStream-Klasse. Sie können die addEventListener()-Methode bzw. andere EventDispatcher-Methoden nicht verwenden, um onPlayStatus zu überwachen oder als ein Ereignis zu verarbeiten. Definieren Sie eine Rückruffunktion und fügen Sie sie einem der folgenden Objekte hinzu:

• Das Objekt, auf das die client-Eigenschaft einer NetStream-Instanz verweist.
• Eine Instanz einer NetStream-Unterklasse. Bei „NetStream“ handelt es sich um eine „versiegelte“ Klasse, d. h., dass einem NetStream-Objekt zur Laufzeit keine Eigenschaften oder Methoden hinzugefügt werden können. Erstellen Sie eine Unterklasse von NetStream und definieren Sie Ihre Ereignisprozedur in der Unterklasse. Sie können die Unterklasse als dynamische Klasse definieren und die Ereignisprozedurfunktion einer Instanz der Unterklasse hinzufügen.

Dieses Ereignis kann ein Informationsobjekt mit den folgenden Eigenschaften zurückgeben:

Verwandte API-Elemente

Wird synchron von appendBytes() aufgerufen, wenn der Append-Bytes-Parser auf einen Punkt trifft, den er als ansteuerbaren Punkt betrachtet (zum Beispiel ein Videoschlüsselbild). Verwenden Sie dieses Ereignis, um eine Suchpunkttabelle zu konstruieren. Der byteCount entspricht dem byteCount beim ersten Byte der analysierbaren Meldung für diesen Suchpunkt und wird auf Null zurückgesetzt wie oben beschrieben. Für Suchläufe suchen Sie beim NetStream.Seek.Notify-Ereignis die Bytes, die an einem ansteuerbaren Punkt starten, und rufen appendBytes(bytes) auf. Wenn das bytes-Argument ein ByteArray ist, das aus Bytes besteht, die beim ansteuerbaren Punkt beginnen, wird das Video ab diesem Suchpunkt abgespielt.

Hinweis: Aufrufen von appendBytes() aus diesem Rückruf heraus werden ignoriert.

Hinweis: Dieses Ereignis wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Die onSeekPoint-Eigenschaft ist eine Eigenschaft des NetStream.client-Objekts. Die Eigenschaft wird im Abschnitt „Ereignisse“ aufgeführt, da sie auf Daten reagiert, die in die appendBytes()-Methode kommen. Weitere Informationen finden Sie in der NetStream-Klassenbeschreibung und der NetStream.client-Eigenschaft. Die addEventListener()-Methode und die übrigen EventDispatcher-Methoden können nicht verwendet werden, um auf onSeekPoint zu warten oder diese Eigenschaft als Ereignis zu verarbeiten. Um onSeekPoint zu verwenden, definieren Sie eine Rückruffunktion und fügen sie einem der folgenden Objekte hinzu:

• Das Objekt, auf das die client-Eigenschaft einer NetStream-Instanz verweist.
• Eine Instanz einer NetStream-Unterklasse. Bei „NetStream“ handelt es sich um eine „versiegelte“ Klasse, d. h., dass einem NetStream-Objekt zur Laufzeit keine Eigenschaften oder Methoden hinzugefügt werden können. Sie können jedoch eine Unterklasse von NetStream erstellen und Ihre Ereignisprozedur in der Unterklasse definieren. Sie können die Unterklasse als dynamische Klasse definieren und die Ereignisprozedurfunktion einer Instanz der Unterklasse hinzufügen.

Verwandte API-Elemente

Erstellt einen Listener, der reagiert, wenn Flash Player Textdaten empfängt, die in einer aktuell abgespielten Mediendatei eingebettet sind. Die Textdaten sind im Format UTF-8 und können Informationen über Formatierungen basierend auf der 3GP-Timed-Textspezifikation enthalten.

Hinweis: Dieses Ereignis wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

onTextData ist eigentlich eine Eigenschaft des NetStream.client-Objekts. Die Eigenschaft wird im Abschnitt „Ereignisse“ aufgeführt, weil sie auf ein Datenereignis reagiert, wenn entweder mit dem Media Flash Player gestreamt oder eine FLV-Datei wiedergegeben wird. Weitere Informationen finden Sie in der Beschreibung der NetStream-Klasse. Sie können die addEventListener()-Methode bzw. andere EventDispatcher-Methoden nicht verwenden, um onTextData zu überwachen oder als ein Ereignis zu verarbeiten. Definieren Sie eine Rückruffunktion und fügen Sie sie einem der folgenden Objekte hinzu:

• Das Objekt, auf das die client-Eigenschaft einer NetStream-Instanz verweist.
• Eine Instanz einer NetStream-Unterklasse. Bei „NetStream“ handelt es sich um eine „versiegelte“ Klasse, d. h., dass einem NetStream-Objekt zur Laufzeit keine Eigenschaften oder Methoden hinzugefügt werden können. Erstellen Sie eine Unterklasse von NetStream und definieren Sie Ihre Ereignisprozedur in der Unterklasse. Sie können die Unterklasse als dynamische Klasse definieren und die Ereignisprozedurfunktion einer Instanz der Unterklasse hinzufügen.

Der verknüpfte Ereignis-Listener wird nach dem Aufruf der NetStream.play()-Methode, aber noch vor dem Vorlauf des Abspielkopfes ausgelöst.

Das onTextData-Ereignisobjekt enthält eine Eigenschaft für jeden Textdatenteil.

package {
    import flash.display.*;
    import flash.net.*;
    import flash.media.*;
    import flash.system.*;
    import flash.events.*;

        public class OnTextDataExample extends Sprite {
                                              
            public function OnTextDataExample():void {

                var my_video:Video = new Video();
                addChild(my_video);

                var customClient:Object = new Object();
                customClient.onImageData = onImageDataHandler;           
                customClient.onTextData = onTextDataHandler;               

                var my_nc:NetConnection = new NetConnection();
                my_nc.connect(null);
                var my_ns:NetStream = new NetStream(my_nc);
                my_ns.client = customClient;

                my_video.attachNetStream(my_ns);
                my_ns.play("yourURL");
            }

            public function onImageDataHandler(imageData:Object):void {

                trace("imageData length: " + imageData.data.length);
                var imageloader:Loader = new Loader();           
                imageloader.loadBytes(imageData.data); // imageData.data is a ByteArray object.
                addChild(imageloader);
            }

    
            public function onTextDataHandler(textData:Object):void {

                trace("--- textData properties ----");
                var key:String;

                for (key in textData) {
                    trace(key + ": " + textData[key]);
                }
            }

        }

}

Verwandte API-Elemente

Erstellt einen Listener, der reagiert, wenn Flash Player Informationen empfängt, die spezifisch für die Adobe Extensible Metadata Platform (XMP) sind und die in einem Video eingebettet sind, das aktuell abgespielt wird. Weitere Informationen zu Videoformaten, die vom Flash Media Server unterstützt werden, finden Sie unter www.adobe.com/go/learn_fms_fileformats_de.

Hinweis: Dieses Ereignis wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

onXMPData ist eigentlich eine Eigenschaft des NetStream.client-Objekts. Die Eigenschaft wird im Abschnitt „Ereignisse“ aufgeführt, weil sie auf ein Datenereignis reagiert, wenn entweder mit dem Media Flash Player gestreamt oder eine FLV-Datei wiedergegeben wird. Weitere Informationen finden Sie in der NetStream-Klassenbeschreibung und der NetStream.client-Eigenschaft. Die addEventListener()-Methode und die übrigen EventDispatcher-Methoden können nicht verwendet werden, um auf onMetaData zu warten oder diese Eigenschaft als Ereignis zu verarbeiten. Definieren Sie eine Rückruffunktion und fügen Sie sie einem der folgenden Objekte hinzu:

• Das Objekt, auf das die client-Eigenschaft einer NetStream-Instanz verweist.
• Eine Instanz einer NetStream-Unterklasse. Bei „NetStream“ handelt es sich um eine „versiegelte“ Klasse, d. h., dass einem NetStream-Objekt zur Laufzeit keine Eigenschaften oder Methoden hinzugefügt werden können. Sie können jedoch eine Unterklasse von NetStream erstellen und Ihre Ereignisprozedur in der Unterklasse definieren. Sie können die Unterklasse als dynamische Klasse definieren und die Ereignisprozedurfunktion einer Instanz der Unterklasse hinzufügen.

Der verknüpfte Ereignis-Listener wird nach dem Aufruf der NetStream.play()-Methode, aber noch vor dem Vorlauf des Abspielkopfes ausgelöst.

Das Objekt, das an die onXMPData()-Ereignisprozedurfunktion übergeben wurde, hat eine data-Eigenschaft, die ein String ist. Der String wird von einer Top-Level UUID-Box generiert. (Die 128-Bit-UUID der Top-Level-Box ist BE7ACFCB-97A9-42E8-9C71-999491E3AFAC.) Diese Top-Level UUID-Box enthält exakt ein XML-Dokument, das als nullterminierter UTF8-String repräsentiert ist.

Verwandte API-Elemente

Wird ausgelöst, wenn die Anwendung versucht, mit DRM (Digital Rights Management) verschlüsselten Inhalt abzuspielen, indem die NetStream.play()-Methode aufgerufen wird. Der Wert der Statuscode-Eigenschaft ist "DRM.encryptedFLV".

Hinweis: Dieses Ereignis wird für H.264-Video unter AIR 3.0 for iOS nicht unterstützt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Ein statisches Objekt, das als Parameter für den Konstruktor einer NetStream-Instanz verwendet wird. Der Standardwert des zweiten Parameters im NetStream-Konstruktor: er wird nicht von der Anwendung für die progressive Medienwiedergabe verwendet. Wenn dieser Parameter verwendet wird, stellt der Konstruktor eine Verbindung zur Flash Media Server-Instanz her.

Stellt eine Peer-to-Peer-Herausgeberverbindung her. Übergeben Sie diesen String für den zweiten (optionalen) Parameter an den Konstruktor für eine NetStream-Instanz. Mit diesem String kann eine Anwendung eine NetStream-Verbindung zum Veröffentlichen von Audio und Video für Clients erstellen.

In diesem Fall wird der Code zur Erstellung des Video- und NetStream-Objekts und zum Aufrufen der Methoden Video.attachNetStream() und NetStream.play() in eine Prozedurfunktion eingefügt. Die Prozedur wird nur aufgerufen, wenn die Verbindung mit dem NetConnection-Objekt erfolgreich hergestellt werden kann, d. h. wenn das Ereignis netStatus ein info-Objekt mit einer code-Eigenschaft zurückgibt, die Erfolg angibt. Es wird empfohlen, die erfolgreiche Verbindungsherstellung abzuwarten, bevor Sie NetStream.play() aufrufen.

package {
    import flash.display.Sprite;
    import flash.events.NetStatusEvent;
    import flash.events.SecurityErrorEvent;
    import flash.media.Video;
    import flash.net.NetConnection;
    import flash.net.NetStream;
    import flash.events.Event;

    public class NetConnectionExample extends Sprite {
        private var videoURL:String = "http://www.helpexamples.com/flash/video/cuepoints.flv";
        private var connection:NetConnection;
        private var stream:NetStream;
        private var video:Video = new Video();        

        public function NetConnectionExample() {
            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("Stream not found: " + videoURL);
                    break;
            }
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function connectStream():void {
            addChild(video);
            var stream:NetStream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.client = new CustomClient();
            video.attachNetStream(stream);
            stream.play(videoURL);
        }
    }
}

class CustomClient {
    public function onMetaData(info:Object):void {
        trace("metadata: duration=" + info.duration + " width=" + info.width + " height=" + info.height + " framerate=" + info.framerate);
    }
    public function onCuePoint(info:Object):void {
        trace("cuepoint: time=" + info.time + " name=" + info.name + " type=" + info.type);
    }
}