Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Videowiedergabe mit HLS
HTTPLive Streaming (HLS)
Sie können es HLS für die Live-Wiedergabe verwenden. Die Latenz liegt in der Regel zwischen 3 und 5 Sekunden, kann aber je nach Anwendungsfall, Player und Netzwerkbedingungen auch zwischen 1 und 10 Sekunden liegen. Sie können einen Player eines Drittanbieters (wie Video.js
Um einen Kinesis-Videostream mit G Session anzusehenHLS, erstellen Sie zunächst eine etHLSStreaming Streaming-Sitzung URL. Diese Aktion gibt ein URL (das ein Sitzungstoken enthält) für den Zugriff auf die HLS Sitzung zurück. Sie können das dann URL in einem Media Player oder einer eigenständigen Anwendung verwenden, um den Stream anzuzeigen.
Wichtig
Nicht alle an Kinesis Video Streams gesendeten Medien können wiedergegeben werden. HLS Spezifische GetHLSStreamingSessionURL Upload-Anforderungen finden Sie unter.
Themen
Verwenden Sie den AWS CLI , um eine HLS Streaming-Sitzung abzurufen URL
Gehen Sie wie folgt vor, um mit dem AWS CLI eine HLS Streaming-Sitzung URL für einen Kinesis-Videostream zu generieren.
Installationsanweisungen finden Sie im AWS Command Line Interface Benutzerhandbuch. Nach der Installation konfigurieren Sie das AWS CLI mit den Anmeldeinformationen und der Region.
Öffnen Sie alternativ das AWS CloudShell Terminal, auf dem das AWS CLI installiert und konfiguriert ist. Weitere Informationen finden Sie im AWS CloudShell -Benutzerhandbuch.
Rufen Sie den HLS URL Endpunkt für Ihren Kinesis-Videostream ab.
Geben Sie Folgendes in das Terminal ein:
aws kinesisvideo get-data-endpoint \ --api-name GET_HLS_STREAMING_SESSION_URL \ --stream-nameYourStreamNameSie erhalten eine Antwort, die wie folgt aussieht:
{ "DataEndpoint": "https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com" }Stellen Sie die HLS URL Streaming-Sitzungsanfrage an den zurückgegebenen Endpunkt.
Sie erhalten eine Antwort, die wie folgt aussieht:
{ "HLSStreamingSessionURL": "https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com/hls/v1/getHLSMasterPlaylist.m3u8?SessionToken=CiAz...DkRE6M~" }Wichtig
Teilen oder speichern Sie dieses Token nicht an einem Ort, an dem eine nicht autorisierte Entität darauf zugreifen könnte. Das Token ermöglicht den Zugriff auf den Inhalt des Streams. Schützen Sie das Token mit denselben Maßnahmen, die Sie für Ihre AWS Anmeldeinformationen verwenden würden.
Du kannst diesen URL und jeden anderen HLS Spieler verwenden, um den HLS Stream anzusehen.
Verwenden Sie beispielsweise den VLC Media Player.
Sie können den HLS Stream auch abspielen, indem Sie die HLS Streaming-Sitzung URL in der Adressleiste der Apple Safari- oder Microsoft Edge-Browser aufrufen.
Beispiel: Verwendung HLS in HTML und JavaScript
Das folgende Beispiel zeigt, wie Sie mit AWS SDK for JavaScript v2 eine HLS Streaming-Sitzung für einen Kinesis-Videostream abrufen und auf einer Webseite wiedergeben können. Das Beispiel veranschaulicht die Wiedergabe von Videos in den folgenden Playern:
Den vollständigen Beispielcode
Erläuterung der folgenden Themen durch den Code:
- Importieren Sie das AWS SDK JavaScript für Browser
- Den Kinesis Video Streams Streams-Client einrichten
- Ruft den Endpunkt für HLS die Wiedergabe ab
- Den Kinesis Video Streams Streams-Client für archivierte Medien einrichten
- Rufen Sie die HLS Streaming-Sitzung ab URL
- Zeigen Sie den HLS Stream auf der Webseite an
Importieren Sie das AWS SDK JavaScript für Browser
Fügen Sie auf der Webseite das folgende Skript-Tag ein, um das AWS SDK für JavaScript v2 in das Projekt zu importieren.
<script src="https://cdnjs.cloudflare.com/ajax/libs/aws-sdk/2.490.0/aws-sdk.min.js"></script>
Weitere Informationen finden Sie in der AWS SDK JavaScriptDokumentation.
Den Kinesis Video Streams Streams-Client einrichten
Um auf Streaming-Video zuzugreifenHLS, müssen Sie zunächst den Kinesis Video Streams Streams-Client erstellen und konfigurieren. Weitere Authentifizierungsmethoden finden Sie unter Anmeldeinformationen in einem Webbrowser einrichten.
const clientConfig = { accessKeyId: 'YourAccessKey', secretAccessKey: 'YourSecretKey', region: 'us-west-2' }; const kinesisVideoClient = new AWS.KinesisVideo(clientConfig);
Die Anwendung ruft die erforderlichen Werte aus den Eingabefeldern auf der HTML Seite ab.
Ruft den Endpunkt für HLS die Wiedergabe ab
Rufen Sie den Kinesis Video Streams Streams-Client auf, GetDataEndpoint API um den Endpunkt abzurufen.
const getDataEndpointOptions = { StreamName: 'YourStreamName', APIName: 'GET_HLS_STREAMING_SESSION_URL' }; const getDataEndpointResponse = await kinesisVideoClient .getDataEndpoint(getDataEndpointOptions) .promise(); const hlsDataEndpoint = getDataEndpointResponse.DataEndpoint;
Dieser Code speichert den Endpunkt in der hlsDataEndpoint Variablen.
Den Kinesis Video Streams Streams-Client für archivierte Medien einrichten
Geben Sie in der Client-Konfiguration für den Kinesis Video Streams Streams-Client für archivierte Medien den Endpunkt an, den Sie im vorherigen Schritt abgerufen haben.
const archivedMediaClientConfig = { accessKeyId: 'YourAccessKey', secretAccessKey: 'YourSecretKey', region: 'us-west-2', endpoint: hlsDataEndpoint }; const kinesisVideoArchivedMediaClient = new AWS.KinesisVideoArchivedMedia(archivedMediaClientConfig);
Rufen Sie die HLS Streaming-Sitzung ab URL
Verwenden Sie den Kinesis Video Streams Streams-Client für archivierte Medien, um den aufzurufen GetHLSStreamingSessionURLAPI, um die Wiedergabe abzurufen. HLS URL
const getHLSStreamingSessionURLOptions = { StreamName: 'YourStreamName', PlaybackMode: 'LIVE' }; const getHLSStreamingSessionURLResponse = await kinesisVideoArchivedMediaClient .getHLSStreamingSessionURL(getHLSStreamingSessionURLOptions) .promise(); const hlsUrl = getHLSStreamingSessionURLResponse.HLSStreamingSessionURL;
Zeigen Sie den HLS Stream auf der Webseite an
Wenn Sie die HLS Streaming-Sitzung habenURL, stellen Sie sie dem Videoplayer zur Verfügung. Die Methode zur Bereitstellung für den URL Videoplayer ist spezifisch für den verwendeten Player.
HLSProbleme beheben
In diesem Abschnitt werden Probleme beschrieben, die bei der Verwendung von HTTP Live-Streaming (HLS) mit Kinesis Video Streams auftreten können.
Problembereiche
Das Abrufen der HLS Streaming-Sitzung URL ist erfolgreich, aber die Wiedergabe im Videoplayer schlägt fehl
Diese Situation tritt auf, wenn Sie eine HLS Streaming-Sitzung URL mit erfolgreich aufrufen könnenGetHLSStreamingSessionURL, das Video jedoch nicht wiedergegeben werden kann, wenn das für einen Videoplayer bereitgestellt URL wird.
Um das Problem zu beheben, versuchen Sie Folgendes:
-
Stellen Sie fest, ob der Videostream in der Kinesis Video Streams Streams-Konsole wiedergegeben wird. Ziehen Sie alle in der Konsole angezeigten Fehler in Betracht.
-
Wenn die Fragmentdauer weniger als eine Sekunde beträgt, erhöhen Sie sie auf eine Sekunde. Wenn die Fragmentdauer zu kurz ist, drosselt der Dienst möglicherweise den Player, weil er zu häufig Videofragmente anfordert.
-
Stellen Sie sicher, dass jede HLS Streaming-Sitzung URL nur von einem Player verwendet wird. Wenn mehrere Spieler eine einzelne HLS Streaming-Sitzung verwendenURL, erhält der Dienst möglicherweise zu viele Anfragen und drosselt diese.
-
Stellen Sie sicher, dass Ihr Player alle Optionen unterstützt, die Sie für die HLS Streaming-Sitzung angeben. Probieren Sie verschiedene Kombinationen von Werten für die folgenden Parameter aus:
-
ContainerFormat -
PlaybackMode -
FragmentSelectorType -
DiscontinuityMode -
MaxMediaPlaylistFragmentResults
Einige Mediaplayer (z. B. HTML5 mobile Player) unterstützen HLS normalerweise nur das MP4 F-Containerformat. Andere Mediaplayer (wie Flash und benutzerdefinierte Player) unterstützen HLS möglicherweise nur das MPEG TS-Containerformat. Wir empfehlen, mit dem
ContainerFormatParameter zu experimentieren, um mit der Problembehandlung zu beginnen. -
-
Stellen Sie sicher, dass jedes Fragment über eine konsistente Anzahl von Tracks verfügt. Stellen Sie sicher, dass sich Fragmente im Stream nicht ändern, wenn Sie sowohl eine Audio- und Videospur als auch nur eine Videospur haben. Stellen Sie außerdem sicher, dass sich die Encoder-Einstellungen (Auflösung und Bildrate) nicht zwischen den einzelnen Fragmenten in den einzelnen Spuren ändern.
Latenz zwischen Produzent und Player zu hoch
Diese Situation tritt auf, wenn die Latenz ab dem Zeitpunkt, an dem das Video erfasst wurde, bis zu dem Zeitpunkt, an dem es im Video-Player abgespielt wird, zu hoch ist.
Das Video wird HLS fragmentweise abgespielt. Daher darf die Latenz nicht kürzer als die Fragmentdauer sein. Die Latenz umfasst auch die für die Pufferung und Übertragung von Daten benötigte Zeit. Wenn Ihre Lösung eine Latenz von weniger als einer Sekunde erfordert, sollten Sie GetMedia API stattdessen die verwenden.
Sie können die folgenden Parameter können so anpassen, dass die Latenz insgesamt verringert wird. Eine Anpassung dieser Parameter kann jedoch zur Folge haben, dass sich die Videoqualität verringert oder die Neupufferungsrate erhöht.
-
Fragmentdauer — Die Fragmentdauer ist die Menge an Video zwischen den Abschnitten im Stream, die durch die Häufigkeit der vom Video-Encoder generierten Keyframes gesteuert wird. Der empfohlene Wert ist eine Sekunde. Eine kürzere Fragmentdauer bedeutet, dass weniger lange auf den Abschluss des Fragments gewartet wird, bevor die Videodaten zum Service übertragen werden. Außerdem kann der Service kürzere Fragmente schneller verarbeiten. Wenn die Fragmentdauer zu kurz ist, nimmt jedoch die Wahrscheinlichkeit zu, dass dem Player die Inhalte ausgehen und er anhalten und Inhalte puffern muss. Wenn die Fragmentdauer weniger als 500 Millisekunden beträgt, erstellt der Produzent möglicherweise zu viele Anforderungen, die dann vom Service gedrosselt werden.
-
Bitrate — Ein Videostream mit einer niedrigeren Bitrate benötigt weniger Zeit zum Lesen, Schreiben und Übertragen. Ein Videostream mit einer niedrigeren Bitrate verfügt in der Regel jedoch über eine geringere Videoqualität.
-
Anzahl der Fragmente in Medien-Playlisten — Ein Player, der latenzempfindlich ist, sollte nur die neuesten Fragmente in eine Medien-Playlist laden. Die meisten Spieler beginnen stattdessen mit dem frühesten Fragment. Indem Sie die Anzahl der Fragmente in der Playlist reduzieren, verringern Sie den Zeitabstand zwischen dem vorherigen und dem neuen Fragment. Bei einer kleineren Playlist kann es sein, dass ein Fragment bei der Wiedergabe übersprungen wird, wenn es zu Verzögerungen beim Hinzufügen neuer Fragmente zur Playlist kommt oder wenn der Player verzögert eine aktualisierte Playlist erhält. Wir empfehlen, 3—5 Fragmente zu verwenden und einen Player zu verwenden, der so konfiguriert ist, dass er nur die neuesten Fragmente aus einer Playlist lädt.
-
Puffergröße des Players — Die meisten Videoplayer haben eine konfigurierbare Mindestpufferdauer, normalerweise mit einer Standardeinstellung von 10 Sekunden. Für die niedrigste Latenz können Sie diesen Wert auf 0 Sekunden setzen. Dies bedeutet jedoch, dass der Player zurückweist, wenn es zu Verzögerungen kommt, wodurch Fragmente entstehen, da der Player dann keinen Puffer hat, um die Verzögerung zu absorbieren.
-
Spieler-Aufholjagd — Videoplayer catch die Wiedergabe normalerweise nicht automatisch bis zum Anfang des Videopuffers auf, wenn der Puffer voll wird, z. B. wenn ein verzögertes Fragment zu einem Rückstau von Fragmenten führt. Um dies zu vermeiden, kann ein benutzerdefinierter Player Frames verwerfen oder die Wiedergabegeschwindigkeit erhöhen (z. B. auf 1,1-fach), um bis zum Anfang des Puffers aufzuholen. Dies führt zu einer abgehackten Wiedergabe oder einer Zunahme der Geschwindigkeit, während der Player aufholt, und die erneute Pufferung kann häufiger erfolgen, da die Puffergröße gering gehalten wird.
