Legge til Microsoft Stream-videoer i andre apper ved hjelp av oEmbed

Stream bruker en forenklet versjon av en implementering som er i bruk, slik at programmer dynamisk kan få innebyggingskoden for en gitt video eller kanal. Siden dette er en forenklet versjon av spesifikasjonen, og for sikkerhetsformål, er de returnerte verdiene for tittel, miniatyrbilde, beskrivelse, forfatterinformasjon og så videre oppført som generell informasjon.

Et program kan ganske enkelt bygge inn en video eller kanal fra det returnerte svaret, og metadatainformasjonen vises automatisk etter at en kjent autorisert bruker ser innholdet. Som en påminnelse er det bare autoriserte brukere som kan se sikkert innhold i Microsoft Stream, uavhengig av hvor det er innebygd.

Hvis du vil lære mer om oEmbed, kan du gå til den offisielle dokumentasjonen for oEmbed.

Et eksempelscenario

Et eksempelscenario for hvordan dette kan hjelpe en programutvikler, er Stream-samarbeidet med OneNote eller Yammer. I begge tilfeller legger en bruker ganske enkelt til en nettadresse fra Microsoft Stream i notat- eller samtaletråden.

Programmet tar deretter url-adressen for inndatastrømmen og henter innebyggingskoden fra html-verdien til svaret som ble tatt i bruk. Programmet gjengir innebyggingskoden slik at en autorisert, pålogget bruker kan se innholdet linjebundet.

Oppdage en Nettadresse for Microsoft Stream

Det er enkelt å oppdage en nettadresse for strøm. Nettadresser for video følger mønsteret til:

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

Strømkanaler følger mønsteret for:

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

oEmbed-endepunkt

Endepunktet Stream oEmbed kan nås ved å legge https://web.microsoftstream.com/oembed til de støttede spørringsparameterne.

Støttede parametere

Parameter Obligatorisk? Verdi Merknader
NETTADRESSE obligatorisk streng: URL-kodet streng Nettadressen for en Microsoft Stream-video eller -kanal. Videoadresser fra Microsoft 365 Video støttes også.
autokjør valgfritt boolsk: sann/usann Når den er sann, begynner videoen automatisk å spilles av så snart brukeren er logget på, hvis den støttes av plattformen. Gjelder bare for videoer. Standard er usann.
bredde valgfritt int bredde i piksler. Det anbefales at forholdet mellom bredde og høyde er 16:9. Standard er 640px for en video.
høyde valgfritt int høyde i piksler. Det anbefales at forholdet mellom bredde og høyde er 16:9. Standard er 360 px for en video.
forhåndslasting valgfritt auto/none Når du angir forhåndslasting til automatisk, hentes videosegmentene automatisk når plattformen tillater det. Når du angir forhåndsinnlasting til ingen, venter brukeren til brukeren velger avspillingsknappen før videoen hentes. Standard er ingen.
st valgfritt int Angi denne parameteren for å starte videoen med verdien i sekunder. Gjelder bare for Microsoft Stream-videoer.

Eksempel

En forbruker gjør følgende HTTP-forespørsler:

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

Svaret returneres på følgende måte:

{
    "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"
}

Se også

Slik fungerer Stream med andre produkter