使用 oEmbed 將 Microsoft Stream (傳統版) 影片新增至其他應用程式

警告

Microsoft Stream (傳統版) 即將淘汰,並由 SharePoint) 和 Microsoft Teams 即時活動的 Stream (取代。 建議您將影片上傳至 SharePoint、Teams、Viva Engage 或 OneDrive,並透過 Teams 和 Viva Engage 執行即時活動,以開始在 SharePoint) 上使用 Stream (。

Stream (傳統版) 中的功能將會在停用日期前變更和移除。 深入瞭解 SharePoint) 上的 Stream (...

Stream (傳統版) 使用 oEmbed 實作的簡單版本,以允許應用程式動態取得指定影片或頻道的內嵌程序代碼。 因為這是 oEmbed 規格的簡單版本,而且基於安全性考慮,所以標題、縮圖、描述、作者資訊等的傳回值都會列為一般資訊。

應用程式可以直接從傳回的 oEmbed 回應內嵌視訊或頻道,而元數據資訊會在已知授權的使用者看到內容之後自動顯示。 提醒您,只有授權的使用者才能在 Microsoft Stream 中看到安全的內容,無論內容內嵌的位置為何。

若要深入瞭解 oEmbed,請造訪 官方 oEmbed 檔

範例案例

這如何協助應用程式開發人員的範例案例是與 OneNoteYammer Stream (傳統版) 共同作業。 在這兩種情況下,使用者只會將來自 Microsoft Stream (傳統版) 的 URL 新增至其記事或交談對話。

然後,應用程式會取得輸入 Stream (傳統版) URL,並從 oEmbed 回應的 html 值取得內嵌程序代碼。 應用程式會轉譯內嵌程序代碼,讓已登入的已授權用戶能夠 watch 內嵌內容。

偵測 Microsoft Stream (傳統版) URL

偵測 Stream (傳統版) URL 很簡單。 影片 URL 遵循下列模式:

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

Stream (傳統版) 信道遵循下列模式:

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

oEmbed 端點

您可以透過新增支援的查詢參數,在 到達 https://web.microsoftstream.com/oembed Stream (傳統版) oEmbed 端點。

支援的參數

參數 必要? 附註
URL 必要 string:URL 編碼字串 Microsoft Stream (傳統版) 視訊或頻道的URL。 也支援來自 Microsoft 365 Video 的影片 URL。
autoplay 選用 boolean: true/false 如果為 true,則視訊會在使用者登入後立即自動開始播放,如果平臺支持的話。 僅適用於影片。 預設值為 False。
width 選用 int 寬度,以像素為單位。 建議寬度與高度比率為16:9。 視訊的預設值為 640px。
height 選用 int 高度以像素為單位。 建議寬度與高度比率為16:9。 視訊的預設值為 360px。
預緊 選用 auto/none 將預先載入設定為自動在平台允許時自動擷取視訊區塊。 將 [預先載入] 設定為 [無] 會等到用戶選取 [播放] 按鈕后,再擷取視訊區塊。 預設值為 none。
選用 int 將此參數設定為以秒為單位的值啟動視訊。 僅適用於 Microsoft Stream (傳統版) 影片。

範例

取用者提出下列 HTTP 要求:

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

回應的傳回方式如下:

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

另請參閱

Stream (傳統版) 如何與其他產品搭配運作