oEmbed kullanarak diğer uygulamalara Microsoft Stream videoları ekleme
Stream, uygulamaların belirli bir video veya kanalın ekleme kodunu dinamik olarak almaya izin vermek için oEmbed uygulamasının basit bir sürümünü kullanır. Bu, oEmbed belirtimi için basit bir sürüm olduğundan ve güvenlik nedeniyle başlık, küçük resim, açıklama, yazar bilgileri vb. için döndürülen değerlerin hepsi genel bilgi olarak listelenir.
Bir uygulama döndürülen oEmbed yanıtından bir video veya kanal eklemekle birlikte, bilinen yetkili bir kullanıcı içeriği görüntüledikten sonra meta veri bilgileri otomatik olarak görüntülenir. Anımsatıcı olarak, Microsoft Stream'in ekli olduğu yere bakılmaksızın, yalnızca yetkili kullanıcılar güvenli içeriği görebilir.
OEmbed hakkında daha fazla bilgi edinmek için resmi oEmbed belgelerini ziyaret edin.
Örnek bir senaryo
Bunun uygulama geliştiricisi için nasıl yardımcı olara yardımcı olduğuyla ilgili örnek bir senaryo, OneNote veya Yammer. Her iki durumda da, kullanıcı Microsoft Stream'den not veya konuşma dizilerine yalnızca bir URL ekler.
Daha sonra uygulama giriş Akışı URL'sini alır ve ekleme kodunu oEmbed yanıtının html değerinden alır. Uygulama, ekleme kodunu oluşturarak yetkili, oturum açık bir kullanıcının içeriği satır içinde izlemesi için bunu sağlar.
Microsoft Stream URL'sini algılama
Akış URL'sini kolayca algılanabilir. Video URL'leri aşağıdaki desene uyar:
https://*.microsoftstream.com/video/ID
Kanalların akışı aşağıdaki desene uyar:
https://*.microsoftstream.com/channel/ID
oEmbed uç noktası
Stream oEmbed uç noktasına, desteklenen https://web.microsoftstream.com/oembed sorgu parametreleri ekleriyle birlikte erişebilirsiniz.
Desteklenen parametreler
| Parametre | Gerekli? | Değer | Notlar |
|---|---|---|---|
| URL | Gerekli | dize: URL kodlanmış dize | Microsoft Stream videosu veya kanalının URL'si. Video Microsoft 365 Video'dan video URL'leri de de desteklene. |
| otomatik yürütme | isteğe bağlı | boole: true/false | Doğru olduğunda, kullanıcı platform tarafından desteklenirse oturum açtığı anda video otomatik olarak oynatılır. Yalnızca videolar için geçerlidir. Varsayılan değer yanlış değeridir. |
| Genişlik | isteğe bağlı | int | genişlikte olur. Genişlik ile yükseklik oranının 16:9 arasında olduğu önerilir. Video için varsayılan 640px değeridir. |
| yükseklik | isteğe bağlı | int | yüksekliğini piksel cinsinden ayarlar. Genişlik ile yükseklik oranının 16:9 arasında olduğu önerilir. Varsayılan, video için 360px'tir. |
| önceden yükleme | isteğe bağlı | otomatik/yok | Platform izin veri olduğunda video öbeklerini otomatik olarak getirmek için önceden yükleme ayarını yapmak gerekir. Önceden yükleme yok olarak ayar yapmak, kullanıcı video öbeklerini getirmeden önce oynat düğmesini seçmeyi bekler. Varsayılan, yok değeridir. |
| st | isteğe bağlı | int | Bu parametreyi saniyeler içinde videonun değeriyle başlayacak şekilde ayarlayın. Yalnızca Microsoft Stream videoları için geçerlidir. |
Örnek
Tüketici aşağıdaki HTTP istekleri yapar:
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
Yanıt aşağıdaki gibi döndürülür:
{
"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"
}