Gibt einen Stream an. Ein Stream ist eine Darstellung eines veröffentlichten Streams in einer Sitzung. Wenn ein Client die Methode „Session.publish()“, wird ein neuer Stream angelegt. Die Eigenschaften des Stream-Objekts liefern Informationen über den Stream.

Wenn ein Stream zu einer Sitzung hinzugefügt wird, löst das Session-Objekt einen streamCreatedEvent. Wenn ein Stream zerstört wird, löst das Session-Objekt ein streamDestroyed Ereignis. Das StreamEvent-Objekt, das diese Ereignisobjekte definiert, verfügt über ein stream Eigenschaft, bei der es sich um ein Array von Stream-Objekten handelt. Weitere Informationen und ein Code-Beispiel finden Sie unter StreamEvent.

Wenn eine Verbindung zu einer Sitzung hergestellt wird, löst das Session-Objekt ein sessionConnected Ereignis, das durch das `SessionConnectEvent`-Objekt definiert ist. Das `SessionConnectEvent`-Objekt verfügt über ein streams Eigenschaft, bei der es sich um ein Array von Stream- Objekten handelt, die sich auf die zu diesem Zeitpunkt in der Sitzung vorhandenen Streams beziehen. Weitere Informationen und ein Code-Beispiel finden Sie unter SessionConnectEvent.

Eigenschaften

Name Typ Beschreibung
connection Verbindung Das „Connection“-Objekt, das der Verbindung entspricht, über die der Stream veröffentlicht wird. Man kann dies mit dem connection Eigenschaft des Session-Objekts, um zu prüfen, ob der Stream von der lokalen Webseite veröffentlicht wird.
creationTime Numbers Der Zeitstempel für die Erstellung des Streams. Dieser Wert wird in Millisekunden berechnet. Sie können diesen Wert in ein Date-Objekt umwandeln, indem Sie new Date(creationTime), wobei creationTime ist die creationTime Eigenschaft des Stream-Objekts.
frameRate Numbers Die vom Publisher festgelegte Zielbildrate für die Aufzeichnung. Ursprünglich abgeleitet aus dem frameRate an übergebene Eigenschaft OT.initPublisher(). Diese Eigenschaft wird nur gesetzt, wenn der Herausgeber explizit eine Bildrate angibt; andernfalls ist ihr Wert undefiniert. Dieser Wert wird aktualisiert, wenn der Herausgeber Publisher.setPreferredFrameRate(). Anmerkung: Dieser Wert gibt die aktuelle Ziel-Aufnahme-Bildrate des Anbieters an, nicht die tatsächlich codierte oder vom Teilnehmer empfangene Bildrate. Die codierte Bildrate kann aufgrund von Bandbreiten- oder CPU-Einschränkungen dennoch niedriger sein, und die empfangene Bildrate kann je nach Netzwerkbedingungen zusätzlich variieren. Um die tatsächliche decodierte Bildrate für einen Teilnehmer zu ermitteln, verwenden Sie die video.decodedFrameRate Eigenschaft, die von Subscriber.getStats().
hasCaptions Boolesche Ob der Stream Untertitel enthält. Diese Eigenschaft kann sich ändern, wenn der Herausgeber die Untertitel ein- oder ausschaltet (durch Aufruf der Publisher.publishCaptions() Methode). In diesem Fall wird die Sitzung Objekt sendet eine streamPropertyChanged Ereignis (siehe StreamPropertyChangedEvent).
hasAudio Boolesche Ob der Stream Audio enthält. Diese Eigenschaft kann sich ändern, wenn der Publisher den Ton ein- oder ausschaltet (durch Aufruf von Publisher.publishAudio()). Wenn dies geschieht, wird die Sitzung Objekt sendet eine streamPropertyChanged Ereignis (siehe StreamPropertyChangedEvent).
hasVideo Boolesche Ob der Stream Video enthält. Diese Eigenschaft kann sich ändern, wenn der Herausgeber das Video aktiviert oder deaktiviert (durch Aufruf von Publisher.publishVideo()). Wenn dies geschieht, wird die Sitzung Objekt sendet eine streamPropertyChanged Ereignis (siehe StreamPropertyChangedEvent).
initials Zeichenfolge Die Initialen für den Stream. Publisher können die Initialen festlegen, die angezeigt werden sollen, wenn das Video deaktiviert ist. (Siehe den initials Eigenschaft der properties Parameter, der an die OT.initPublisher() Methode).
name Zeichenfolge Der Name des Streams. Publisher können beim Veröffentlichen eines Streams einen Namen angeben (mithilfe des publish() Methode des Session-Objekts des Herausgebers).
streamId Zeichenfolge Die eindeutige ID des Streams.
videoDimensions Objekt Dieses Objekt hat zwei Eigenschaften: width und height (beide Numbers). Diese geben die zuletzt an die Sitzung gemeldete Zielauflösung des Publishers wieder. Der Wert wird über die Signalisierungsschicht an alle Teilnehmer gesendet und kann sowohl auf den Publisher- als auch auf den Abonnenten-Clients abgerufen werden. Der Wert wird anfänglich über die resolution an übergebene Eigenschaft OT.initPublisher(). Es wird zur Laufzeit aktualisiert, wenn die lokale <video> Das Element erkennt eine Dimensionsänderung (beispielsweise nach einem Aufruf von Publisher.setPreferredResolution(), eine Größenänderung des Bildschirminformationsfensters oder eine Drehung des Mobilgeräts). Anmerkung: Diese Werte geben die Zielauflösung des Anbieters bei der Aufnahme wieder, nicht die Auflösung, die tatsächlich codiert oder vom Abonnenten empfangen wird. Der Anbieter codiert möglicherweise aufgrund von Bandbreiten- oder CPU-Einschränkungen mit einer niedrigeren Auflösung, und Abonnenten, die skalierbares Video nutzen, erhalten möglicherweise eine Ebene mit noch geringerer Auflösung. Um die tatsächlich decodierte Auflösung auf dem Client des Abonnenten zu ermitteln, verwenden Sie Subscriber.videoWidth() und Subscriber.videoHeight(). Wenn sich diese Eigenschaft ändert, wird die Sitzung Objekt sendet eine streamPropertyChanged Ereignis (siehe StreamPropertyChangedEvent).
videoType Zeichenfolge Die Art des Videos – entweder "camera", "screen", oder "custom". A "screen" Das Video nutzt die Bildschirmfreigabe auf dem Publisher als Videoquelle; bei anderen Videos ist diese Eigenschaft auf "camera". A "custom" Das Video verwendet ein „VideoTrack“-Element als Videoquelle auf dem Publisher. (Siehe die videoSource Eigenschaft der options Parameter, der an die OT.initPublisher() Methode.) Die videoType ist undefined wenn es sich um einen reinen Sprachstrom handelt (siehe die Anleitung nur mit Stimme). Diese Eigenschaft kann sich ändern, wenn sich bei einem von einem Mobilgerät veröffentlichten Stream der Videotyp von „Kamera“ zu „Bildschirmfreigabe“ ändert. Wenn sich der Videotyp ändert, wird die Sitzung Objekt sendet eine streamPropertyChanged Ereignis (siehe StreamPropertyChangedEvent).