Hinzufügen Microsoft Stream (klassisch) Videos zu anderen Apps mithilfe von oEmbed

Warnung

Microsoft Stream (klassisch) wird eingestellt und durch Stream (auf SharePoint) und Microsoft Teams-Liveereignisse ersetzt. Es wird empfohlen, Stream (auf SharePoint) zu verwenden, indem Sie Videos in SharePoint, Teams, Viva Engage oder OneDrive hochladen und Ihre Liveereignisse über Teams und Viva Engage ausführen.

Die Funktionalität in Stream (klassisch) wird vor dem Ausmusterungsdatum geändert und entfernt. Erfahren Sie mehr über Stream (auf SharePoint)...

Stream (klassisch) verwendet eine einfache Version einer oEmbed-Implementierung, damit Anwendungen den Einbettungscode eines bestimmten Videos oder Kanals dynamisch abrufen können. Da dies eine einfache Version der oEmbed-Spezifikation ist und aus Sicherheitsgründen zurückgegeben wird, werden die zurückgegebenen Werte für Titel, Miniaturansicht, Beschreibung, Autoreninformationen usw. als generische Informationen aufgeführt.

Eine Anwendung kann einfach ein Video oder einen Kanal aus der zurückgegebenen oEmbed-Antwort einbetten, und die Metadateninformationen werden automatisch angezeigt, nachdem ein bekannter autorisierter Benutzer den Inhalt gesehen hat. Zur Erinnerung: Nur autorisierte Benutzer können sichere Inhalte in Microsoft Stream sehen, unabhängig davon, wo sie eingebettet sind.

Weitere Informationen zu oEmbed finden Sie in der offiziellen oEmbed-Dokumentation.

Ein Beispielszenario

Ein Beispielszenario, wie dies einem Anwendungsentwickler helfen kann, ist die Stream (klassisch) Zusammenarbeit mit OneNote oder Yammer. In beiden Fällen fügt ein Benutzer einfach eine URL aus Microsoft Stream (klassisch) entweder seiner Notiz oder dem Unterhaltungsthread hinzu.

Die Anwendung übernimmt dann die Eingabe Stream (klassisch) URL und ruft den Einbettungscode aus dem HTML-Wert der oEmbed-Antwort ab. Die Anwendung rendert den Einbettungscode, sodass ein autorisierter, angemeldeter Benutzer Inhalte inline watch kann.

Erkennen einer Microsoft Stream (klassisch)-URL

Das Erkennen einer Stream (klassisch) URL ist einfach. Video-URLs folgen folgendem Muster:

https://*.microsoftstream.com/video/ID

Stream (klassisch) Kanäle folgen folgendem Muster:

https://*.microsoftstream.com/channel/ID

oEmbed-Endpunkt

Der Stream (klassisch) oEmbed-Endpunkt kann unter https://web.microsoftstream.com/oembed erreicht werden, wenn die unterstützten Abfrageparameter hinzugefügt werden.

Unterstützte Parameter

Parameter Pflichtfeld? Wert Anmerkungen
URL erforderlich string: URL-codierte Zeichenfolge URL für ein Microsoft Stream (klassisch) Video oder Kanal. Video-URLs von Microsoft 365 Video werden ebenfalls unterstützt.
Autoplay Optional Boolescher Wert: true/false Bei "true" wird das Video automatisch wiedergegeben, sobald der Benutzer angemeldet ist, sofern dies von der Plattform unterstützt wird. Gilt nur für Videos. Der Standardwert ist „false“.
width Optional int Breite in Pixel. Es wird empfohlen, dass das Verhältnis von Breite zu Höhe 16:9 beträgt. Der Standardwert ist 640px für ein Video.
height Optional int Höhe in Pixel. Es wird empfohlen, dass das Verhältnis von Breite zu Höhe 16:9 beträgt. Der Standardwert ist 360px für ein Video.
Vorspannung Optional auto/none Wenn Sie vorab laden auf Automatisch festlegen, werden die Videoblöcke automatisch abgerufen, wenn die Plattform dies zulässt. Das Festlegen von Preload auf none wartet, bis der Benutzer die Wiedergabeschaltfläche auswählt, bevor die Videoblöcke abgerufen werden. Der Standardwert ist "None".
st Optional int Legen Sie diesen Parameter fest, um das Video mit dem Wert in Sekunden zu starten. Gilt nur für Microsoft Stream (klassisch) Videos.

Beispiel

Ein Consumer stellt die folgenden HTTP-Anforderungen:

https://web.microsoftstream.com/oembed?url=https%3A%2F%2Fweb.microsoftstream.com%2Fvideo%2Ff6df81b2-9438-4154-b32c-c023ebb2a4e3&preload=none&autoplay=false&width=1280&height=720

Die Antwort wird wie folgt zurückgegeben:

{
    "type": "video",
    "version": "1.0",
    "title": "",
    "provider_name": "Microsoft Stream",
    "provider_url": "https://stream.microsoft.com",
    "embed_url": "https://web.microsoftstream.com/embed/video/f6df81b2-9438-4154-b32c-c023ebb2a4e3?autoplay=false&preload=none",
    "html": "<iframe width=\"1280\" height=\"720\" src=\"https://web.microsoftstream.com/embed/video/f6df81b2-9438-4154-b32c-c023ebb2a4e3?autoplay=false&preload=none\" frameborder=\"0\" allowfullscreen><iframe>",
    "width": 1280,
    "height": 720,
    "thumbnail_url": "https://amsglob0cdnstream11.azureedge.net/oembed/images/poster_1280x720.jpg"
}

Siehe auch

Funktionsweise von Stream (klassisch) mit anderen Produkten