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.

Siehe auch

Bestimmt, wie lange Nachrichten im Zwischenspeicher bleiben, bis mit der Anzeige des Streams begonnen wird. Wenn beispielsweise die ersten 15 Sekunden des Streams ohne Unterbrechung wiedergegeben werden sollen, legen Sie 15 für bufferTime fest. Flash Player beginnt mit der Wiedergabe des Streams erst, wenn 15 Datensekunden zwischengespeichert sind.

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.

Hinweis: 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 Flash Player 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.

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 Flash beginnt, Bilder zu überspringen. Bei einer Highspeed-Verbindung sollte die Pufferzeit kein Problem darstellen; Daten werden fast so schnell gesendet, wie Flash sie puffern kann. Bei langsameren Verbindungen kann es jedoch einen erheblichen Unterschied geben zwischen der Geschwindigkeit, mit der Flash 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 beispielsweise die ersten 15 Sekunden des Streams ohne Unterbrechung wiedergegeben werden sollen, legen Sie 15 für bufferTime fest; Flash beginnt mit der Wiedergabe des Streams erst, wenn 15 Datensekunden zwischengespeichert sind.

Wenn ein aufgezeichneter Stream abgespielt wird und bufferTime den Wert null 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.

Siehe auch

Die Anzahl der in Flash Player geladenen Datenbytes. 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.

Siehe auch

Die Gesamtgröße (in Byte) der in Flash Player geladenen Datei.

Siehe auch

Gibt an, ob vor dem Laden der Videodatei versucht werden soll, eine domänenübergreifende Richtliniendatei vom Server der Videodatei herunterzuladen. Diese Eigenschaft wird angewendet, wenn Sie ein NetStream-Objekt für den progressiven Video-Download (eigenständige Dateien) verwenden oder Dateien laden, die sich außerhalb der Domäne der aufrufenden SWF-Datei befinden. Diese Eigenschaft wird ignoriert, wenn Sie ein NetStream-Objekt verwenden, um einen RTMP-Bestand abzurufen.

Setzen Sie diese Eigenschaft auf true, wenn Sie eine Videodatei laden, die sich außerhalb der Domäne der aufrufenden SWF-Datei befindet und Sie die Methode BitmapData.draw() für Zugriff auf Pixelebene auf das Video verwenden müssen. 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.

Wenn kein Zugriff auf Pixelebene auf das zu ladende Video erforderlich ist, setzen Sie checkPolicyFile nicht auf true. 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 vor dem Herunterladen des im NetStream.play()-Aufruf angegebenen Objekts entweder eine entsprechende domänenübergreifende Richtlinie erfolgreich heruntergeladen werden, oder es muss festgestellt werden, dass keine Richtliniendatei vorhanden ist. In Flash Player werden die folgenden Aktionen in der angegebenen Reihenfolge ausgeführt, um zu überprüfen, ob eine Richtliniendatei vorhanden ist:

1. Flash Player überprüft Richtliniendateien, die bereits heruntergeladen wurden.
2. Flash Player versucht, ausstehende Richtliniendateien herunterzuladen, die in Aufrufen der Security.loadPolicyFile()-Methode angegeben wurden.
3. Flash Player 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 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 SWF-Datei über mindestens ein <allow-access-from>-Tag auf das Video zugreifen kann.

Wenn Sie checkPolicyFile auf true setzen, wird das Video in Flash Player erst geladen, nachdem 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 Flash Player 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. Flash Player 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 im Kapitel "Sicherheitsaspekte im Flash Player" im Handbuch Programmieren mit ActionScript 3.0.

Siehe auch

Gibt das Objekt an, bei dem Rückrufmethoden aufgerufen werden. Standardeinstellung ist das erstellte NetStream-Objekt this. Wenn Sie die client-Eigenschaft auf ein anderes Objekt einstellen, werden die Rückrufmethoden bei dem eingestellten Objekt aufgerufen.

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.

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

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.

Die Objektcodierung (AMF-Version) für dieses NetStream-Objekt. Der objectEncoding-Wert für das NetStream-Objekt wird von dem zugehörigen 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 Objektcodierung der Serververbindung zurück.

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

Siehe auch

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

Siehe auch

Die Position des Abspielkopfs in Sekunden.

Flash Media Server Für einen veröffentlichenden Stream die Anzahl der Sekunden, die der Stream bereits abgespielt wurde. Für einen veröffentlichenden Stream die Anzahl der Sekunden, die der Stream veröffentlicht hat. Die Zahl ist bis zur Tausenderdezimalstelle genau; multiplizieren Sie sie mit 100, um die Anzahl der Millisekunden zu erhalten, die der Stream bereits abgespielt wurde.

Für einen abonnierenden Stream wird der Wert von time nicht mehr erhöht, wenn der Server aufhört, Daten zu senden, der Stream jedoch geöffnet bleibt. Wenn der Server wieder beginnt, Daten zu senden, wird der Wert weiter erhöht ab dem Zeitpunkt, zu dem das Senden beendet wurde, plus der verstrichenen Zeit, zu der keine Daten gesendet wurden.

Der Wert von time wird weiter erhöht, wenn der Stream von einem Element der Wiedergabeliste 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.

Siehe auch

Erstellt einen Stream, der zum Wiedergeben von Videodateien durch das angegebene NetConnection-Objekt verwendet werden kann.

Informationen zu unterstützten Codecs und Dateiformaten finden Sie unter http://www.adobe.com/go/hardware_scaling_de und in der Flash Media Server-Dokumentation.

Siehe auch

Gibt einen über das NetStream-Objekt gesendeten Audio-Stream an, wobei das Microphone-Objekt als Quelle übergeben wurde. Diese Methode ist nur für den Herausgeber des angegebenen Streams verfügbar.

Die attachAudio-Methode ist für die Verwendung mit Flash Media Server konzipiert. Diese Methode wird häufig von einem Benutzer aufgerufen, der Live-Audio (oder Live-Video mit Audio) von einem Client-Computer an den Server sendet.

Sie können diese Methode vor oder nach dem Aufruf der Methode publish() zum Starten der Übertragung aufrufen. Abonnenten, die die Audiodaten wiedergeben möchten, müssen die Methode NetStream.play() aufrufen. Sie können die Soundeigenschaften dieses Audio-Streams über die Eigenschaft soundTransform des angegebenen Microphone-Objekts steuern.

Parameter

Siehe auch

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. Um die Videodaten wiederzugeben, müssen Abonnenten die Methoden NetStream.play() und Video.attachCamera() zur Anzeige des Videos auf der Bühne aufrufen.

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. Die Anzeigezeit wird um den Nachspann verlängert. Durch das wiederholte Aufrufen von attachCamera() mit einem positiven Wert für snapshotMilliseconds wird durch die abwechselnde Abfolge von Schnappschüssen und Nachspann ein Zeitraffer-Effekt erzielt. 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 Flash Player die lokale Kopie der erstellten Datei löscht, verbleibt möglicherweise eine Kopie im Cache-Verzeichnis des Browsers. Wenn Sie die Cache- oder lokale Speicherung der Videodatei vollständig vermeiden möchten, verwenden Sie Flash Media Server.

Wenn Sie Flash Media Server verwenden, wird diese Methode implizit aufgerufen, wenn Sie NetStream.play() von einem veröffentlichenden Stream bzw. NetStream.publish() von 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.

Siehe auch

Hält die Wiedergabe eines Video-Streams 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.

Siehe auch

Startet die Wiedergabe von Videodateien.

Informationen zu unterstützten Codecs und Dateiformaten finden Sie unter http://www.adobe.com/go/hardware_scaling_de und in der Flash Media Server-Dokumentation.

Zum Anzeigen von Videodaten müssen Sie ein Videoobjekt erstellen und die Methode Video.attachNetStream() aufrufen, wobei das Audio-Streaming zusammen mit den Videodaten erfolgt oder eine Videodatei, die nur Audiodaten enthält, automatisch abgespielt wird. Verwenden Sie für das Audio-Streaming von einem Mikrofon die Methode NetStream.attachAudio(), und steuern Sie einige Aspekte der Audiodaten durch das Microphone-Objekt.

Wenn Sie die mit einer Videodatei verknüpften Audiodaten steuern möchten, können Sie sie mit der Methode DisplayObjectContainer.addChild() einem Objekt in der Anzeigeliste zuordnen und dann ein Sound-Objekt zum Steuern einiger Aspekte der Audiodaten erstellen. Weitere Informationen hierzu finden Sie im Abschnitt zur Methode DisplayObjectContainer.addChild().

Wenn die Videodatei nicht gefunden wird, wird das Ereignis netStatus ausgelöst. Verwenden Sie die Methode close(), um die Wiedergabe eines Streams zu stoppen.

Wenn Sie diese Methode ohne Flash Media Server verwenden, sollten Sie das Flash Player-Sicherheitsmodell in Betracht ziehen. Von einer SWF-Datei in der lokalen vertrauenswürdigen Sandbox oder der lokalen Sandbox mit Netzwerkzugang kann eine Videodatei von der Remote-Sandbox geladen und wiedergegeben werden. Der Zugriff auf die Remote-Datei ist jedoch nur möglich, wenn eine ausdrückliche Genehmigung in Form einer domänenübergreifenden Richtliniendatei vorliegt. Sie können eine SWF-Datei daran hindern, diese Methode aufzurufen, indem Sie in der HTML-Seite, die den SWF-Inhalt enthält, den Parameter allowNetworking der Tags object und embed festlegen.

Weitere Informationen finden Sie in den folgenden Abschnitten:

• Das Kapitel Sicherheit im Handbuch Programmieren mit ActionScript 3.0 und die neusten Kommentare zu den LiveDocs.
• Das Flash Player 9-Whitepaper zum Thema Sicherheit
• Die Eigenschaft Netstream.checkPolicyFile.

Parameter

Siehe auch

  ns.play("record1", 0, 100, true);
  

  ns.play("stephen");
  

Sendet einen Stream mit Audiodaten, Videodaten und Textnachrichten von einem Client an Flash Media Server. Der Stream kann während der Übertragung aufgezeichnet werden. Diese Methode ist nur für den Herausgeber des angegebenen Streams verfügbar.

Verwenden Sie diese Methode nicht, um auf einem Client einen Stream wiederzugeben, der bereits veröffentlicht und aufgezeichnet wurde. Erstellen Sie stattdessen eine NetStream-Instanz für diesen Client, und rufen Sie die Methode play() auf:

  var subscribeNS:NetStream = new NetStream(myNetConnection);
  subscribeNS.play("streamToPlay");
  

Wenn Sie einen Stream mit Flash Media Server aufzeichnen, erstellt der Server eine Datei und speichert sie in einem Unterverzeichnis unter dem Anwendungsverzeichnis des Servers. Jeder Stream wird in einem Verzeichnis gespeichert, dessen Name mit dem Instanznamen der Anwendung übereinstimmt, der an NetConnection.connect() übergeben wird. Der Server erstellt diese Verzeichnisse automatisch, sodass Sie nicht für jede Anwendungsinstanz manuell ein Verzeichnis erstellen müssen. Beispiel: Anhand des folgenden Codes wird gezeigt, wie Sie eine Verbindung zu einer bestimmten Instanz einer Anwendung herstellen, die im Anwendungsverzeichnis in einem Unterverzeichnis mit dem Namen "lectureSeries" gespeichert ist. Eine Datei mit dem Namen "lecture.flv" ist in einem Unterverzeichnis mit dem Namen "/yourAppsFolder/lectureSeries/streams/Monday" gespeichert:

  var myNC:NetConnection = new NetConnection();
  myNC.connect("rtmp://server.domain.com/lectureSeries/Monday");
  var myNS:NetStream = new NetStream(myNC);
  myNS.publish("lecture", "record");
  

Das folgende Beispiel zeigt, wie Sie eine Verbindung zu einer anderen Instanz derselben Anwendung herstellen, wobei Sie denselben Befehl zum Veröffentlichen ausgeben. Eine Datei mit dem Namen "lecture.flv" ist in einem Unterverzeichnis mit dem Namen "/yourAppsFolder/lectureSeries/streams/Tuesday" gespeichert.

  var myNC:NetConnection = new NetConnection();
  myNC.connect("rtmp://server.domain.com/lectureSeries/Tuesday");
  var myNS:NetStream = new NetStream(my_nc);
  myNS.publish("lecture", "record");
  

Wenn Sie keinen Wert für den Instanznamen angeben, wird der an die name-Eigenschaft übergebene Wert im Unterverzeichnis "/yourAppsFolder/appName/streams/_definst_" verwendet ("definst" steht für "Standardinstanz"). Weitere Informationen zum Verwenden von Instanznamen finden Sie im Abschnitt zur Methode NetConnection.connect(). Informationen zur Wiedergabe von Videodateien finden Sie im Abschnitt zur Methode NetStream.play().

Wenn ein Flash Media Server-Anwendungs-Client publish() aufruft, erhält die Anwendung ein onPublish-Ereignis. Die Anwendung muss das Ereignis in einem serverseitigen Skript verarbeiten. Wenn der Client die Veröffentlichung stoppt, erhält die Anwendung ein onUnpublish-Ereignis. Weitere Informationen finden Sie im Handbuch Flash Media Server Server-Side ActionScript Language Reference.

Diese Methode kann ein netStatus-Ereignis mit verschiedenen Informationsobjekten auslösen. Beispiel: Wenn jemand bereits über einen Stream mit dem angegebenen Namen veröffentlicht, wird das Ereignis netStatus mit der Code-Eigenschaft NetStream.Publish.BadName ausgelöst. Weitere Informationen hierzu finden Sie im Abschnitt zum Ereignis netStatus.

Parameter

Siehe auch

Gibt an, ob eingehende Audiodaten im Stream wiedergegeben werden. Diese Methode ist nur für Clients verfügbar, die diesen Stream abonniert haben, nicht für den Herausgeber des Streams.

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

Sie können diese Methode vor oder nach dem Aufruf der Methode NetStream.play() zum Starten des Empfangs aufrufen. Sie haben beispielsweise die Möglichkeit, diese Methoden mit einer Schaltfläche zu verknüpfen, auf die der Benutzer klicken kann, um den Ton für den eingehenden Audio-Stream ein- bzw. auszuschalten.

Wenn der angegebene Stream nur Audiodaten enthält, wird durch die Übergabe des Werts false an diese Methode der Wert für NetStream.time nicht weiter erhöht.

Parameter

Gibt an, ob eingehende Videodaten im Stream wiedergegeben werden. Diese Methode ist nur für Clients verfügbar, die diesen Stream abonniert haben, nicht für den Herausgeber des Streams.

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

Sie können diese Methode vor oder nach dem Aufruf der Methode NetStream.play() zum Starten des Empfangs aufrufen. Sie haben beispielsweise die Möglichkeit, diese Methoden mit einer Schaltfläche zu verknüpfen, auf die der Benutzer klicken kann, um den eingehenden Video-Stream ein- bzw. auszublenden.

Wenn der angegebene Stream nur Videodaten enthält, wird durch die Übergabe des Werts false an diese Methode der Wert für NetStream.time nicht weiter erhöht.

Parameter

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

Siehe auch

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

Video-Streams 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.

Auf Flash Media Server wird das Verhalten von seek() vom Wert des EnhancedSeek-Elements in der Konfigurationsdatei Application.xml gesteuert.

Wenn EnhancedSeek den Wert false hat, verwendet der Server den normalen Suchmodus. Im normalen Suchmodus startet der Server das Streaming vom nächsten Schlüsselbild. Wenn ein Video zum Beispiel bei 0 und 10 Sekunden ein Schlüsselbild aufweist, bewirkt ein Suchlauf bis 4 Sekunden, dass die Wiedergabe (unter Verwendung des Schlüsselbilds bei 0 Sekunden) bei 4 Sekunden beginnt. 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.

Wenn EnhancedSeek den Wert true aufweist (dies ist der Standardwert), generiert der Server ein neues Schlüsselbild bei offset, basierend auf dem vorherigen Schlüsselbild und ggf. dazwischenliegenden P-Frames. Dadurch 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.

Parameter

Siehe auch

Sendet eine Nachricht an alle Clients mit Abonnement über den veröffentlichten Stream. Diese Methode steht nur dem Herausgeber des angegebenen Streams zur Verfügung und ist für die Verwendung mit Flash Media Server konzipiert. 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 nicht serialisiert. Zur Anzeige von Objekten wird lediglich der Pfad serialisiert.

Durch einen Aufruf der send()-Methode können Sie einem Live-Stream, der an Flash Media Server gesendet wird, Datenschlüsselbilder hinzufügen. Ein Datenschlüsselbild ist eine Meldung, die ein Herausgeber einem Live-Stream hinzufügt. Datenschlüsselbilder werden im Allgemeinen 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. Herausgeber sollten Eigenschaftennamen vorgeben, die für Abonnenten leicht verständlich sind. Eine Liste mit Vorschlägen für Eigenschaftennamen finden Sie in der Flash Media Server-Dokumentation.

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

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

Parameter

Siehe auch

  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.play("dummy");
                   ns2.client = new CustomClient();
                   vid.attachNetStream(ns2);
                   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);
  

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.

Siehe auch

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:

Siehe auch

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

Dieses Ereignis verfügt über die folgenden Eigenschaften:

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:

Siehe auch

Wird aufgerufen, wenn bei der Wiedergabe einer Videodatei ein eingebetteter Cue-Point erreicht wird. Mit dieser Prozedur können Sie Aktionen im Code auslösen, wenn ein bestimmter Cue-Point im Video erreicht wird, sodass Sie andere Aktionen in der Anwendung mit Video-Wiedergabeereignissen synchronisieren können. Informationen zu den von Flash Media Server unterstützten Videodateiformaten finden Sie in der Flash Media Server-Dokumentation.

Dieses Ereignis ist für die Verwendung mit Flash Media Server konzipiert. Es ist nicht Teil der Flash Player-API, wurde jedoch der Überschaubarkeit halber in dieses Referenzhandbuch aufgenommen. Die Methode addEventListener() und sonstige EventDispatcher-Methoden können zur Überwachung und Verarbeitung dieses Ereignisses nicht verwendet werden. Stattdessen müssen Sie eine einzelne Rückruffunktion 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.

Folgende Typen von Cue-Points können in eine Videodatei eingebettet werden:

• 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 wird nach Zeit angegeben, unabhängig davon, ob diese Zeitangabe einem bestimmten Schlüsselbild entspricht. 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 Video-Stream 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.

Siehe auch

Wird ausgelöst, wenn Flash Player in der wiedergegebenen Videodatei eingebettete beschreibende Informationen empfängt. Informationen zu den von Flash Media Server unterstützten Videodateiformaten finden Sie in der Flash Media Server-Dokumentation.

Dieses spezielle Ereignis ist für die Verwendung mit Flash Media Server konzipiert. Weitere Informationen finden Sie in der Beschreibung der Klasse. Es ist nicht Teil der Flash Player-API, wurde jedoch der Überschaubarkeit halber in dieses Referenzhandbuch aufgenommen. Die Methode addEventListener() und sonstige EventDispatcher-Methoden können zur Überwachung und Verarbeitung dieses Ereignisses nicht verwendet werden. Stattdessen müssen Sie eine einzelne Rückruffunktion 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.

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 Videocodierern werden andere Metadaten eingebettet.

Dieses Ereignis wird nach dem Aufruf der Methode NetStream.play(), 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 Video-Streams erreicht hat.

Siehe auch

Wird ausgelöst, wenn ein NetStream-Objekt einen Stream vollständig wiedergegeben hat. Diese Prozedur gibt Informationsobjekte zurück, die zusätzliche Informationen zu den vom Ereignis netStatus zurückgegebenen Informationen bereitstellen. Mit dieser Prozedur können Sie im Code Aktionen auslösen, wenn ein NetStream-Objekt von einem Stream zu einem anderen Stream in einer Wiedergabeliste wechselt (wie vom Informationsobjekt NetStream.Play.Switch angegeben) oder wenn ein NetStream-Objekt die Wiedergabe bis zum Ende ausgeführt hat (wie vom Informationsobjekt NetStreamPlay.Comlete angegeben). Um auf dieses Ereignis zu reagieren, müssen Sie eine Funktion zur Verarbeitung des vom Server gesendeten Informationsobjekts erstellen.

Dieses Ereignis ist für die Verwendung mit Flash Media Server konzipiert. Weitere Informationen finden Sie in der Beschreibung der Klasse. Es ist nicht Teil der Flash Player-API, wurde jedoch der Überschaubarkeit halber in dieses Referenzhandbuch aufgenommen. Die Methode addEventListener() und sonstige EventDispatcher-Methoden können zur Überwachung und Verarbeitung dieses Ereignisses nicht verwendet werden. Stattdessen müssen Sie eine einzelne Rückruffunktion 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.

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

Siehe auch

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 Prozedur-Funktion 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 = "Video.flv";
        private var connection:NetConnection;
        private var stream:NetStream;

        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 {
            stream = new NetStream(connection);
            stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler);
            stream.client = new CustomClient();
            var video:Video = new Video();
            video.attachNetStream(stream);
            stream.play(videoURL);
            addChild(video);
        }
    }
}

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);
    }
}