เพิ่มวิดีโอสตรีมของ Microsoft ลงในแอปอื่นๆโดยใช้ oEmbedAdd Microsoft Stream videos to other apps by using oEmbed

สตรีมใช้การดำเนินการ oEmbed เวอร์ชันที่เรียบง่ายเพื่อให้แอปพลิเคชันได้รับโค้ดฝังตัวของวิดีโอหรือแชนเนลที่ได้รับการปรับให้เป็นแบบไดนามิกStream uses a simplistic version of an oEmbed implementation in order to allow applications to dynamically get the embed code of a given video or channel. เนื่องจากนี่เป็นข้อมูลจำเพาะของ oEmbed เวอร์ชันที่เรียบง่ายและสำหรับวัตถุประสงค์ด้านความปลอดภัยค่าที่ส่งกลับสำหรับชื่อเรื่องรูปขนาดย่อคำอธิบายข้อมูลผู้เขียนและอื่นๆจะแสดงเป็นข้อมูลทั่วไปทั้งหมดBecause this is a simplistic version of the oEmbed specification, and for security purposes, the returned values for title, thumbnail, description, author information, etc, is all listed as generic information.

แอปพลิเคชันสามารถฝังวิดีโอหรือแชนเนลจากการตอบสนอง oEmbed ที่ส่งกลับและข้อมูล metadata จะแสดงโดยอัตโนมัติหลังจากผู้ใช้ที่ได้รับอนุญาตที่รู้จักเห็นเนื้อหานั้นAn application can simply embed a video or channel from the returned oEmbed response, and the metadata information will be displayed automatically after a known authorized user sees the content. ในฐานะที่เป็นตัวเตือนผู้ใช้ที่ได้รับอนุญาตเท่านั้นที่สามารถดูเนื้อหาที่ปลอดภัยใน Microsoft Stream ได้โดยไม่คำนึงถึงตำแหน่งที่ฝังตัวอยู่As a reminder, only authorized users are able to see secure content in Microsoft Stream, regardless of where it is embedded.

เมื่อต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ oEmbed ให้ไปที่ คู่มือ oEmbed อย่างเป็นทางการTo learn more about oEmbed, visit the official oEmbed documentation.

สถานการณ์สมมติตัวอย่างAn example scenario

สถานการณ์สมมติตัวอย่างของวิธีการนี้จะช่วยให้นักพัฒนาแอปพลิเคชันมีการทำงานร่วมกันในการทำงานร่วมกันด้วยOneNoteหรือYammerAn example scenario of how this can help an application developer is the Stream collaboration with OneNote or Yammer. ในทั้งสองกรณีผู้ใช้เพียงแค่เพิ่ม URL จาก Microsoft Stream ไปยังบันทึกย่อหรือเธรดการสนทนาของพวกเขาIn both cases, a user simply adds a URL from Microsoft Stream to either their note or conversation thread.

แอปพลิเคชันจากนั้นจะใช้ URL ของสตรีมการป้อนข้อมูลและได้รับโค้ดฝังตัวจากค่า html ของการตอบสนอง oEmbedThe application then takes the input Stream URL and gets the embed code from the html value of the oEmbed response. แอปพลิเคชันแสดงรหัสฝังเพื่อให้ผู้ใช้ที่ได้รับอนุญาตลงชื่อเข้าใช้สามารถดูเนื้อหาแบบอินไลน์ได้The application renders the embed code so that an authorized, signed in user can watch content inline.

การตรวจหา URL ของ Microsoft StreamDetecting a Microsoft Stream URL

การตรวจหา URL ของสตรีมทำได้ง่ายDetecting a Stream URL is easy. Url ของวิดีโอให้ทำตามรูปแบบของ:Video URLs follow the pattern of:

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

สตรีมแชนเนลตามรูปแบบของ:Stream channels follow the pattern of:

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

จุดปลายทาง oEmbedoEmbed endpoint

จุดสิ้นสุดของสตรีม oEmbed สามารถ https://web.microsoftstream.com/oembed เข้าถึงได้ด้วยการเพิ่มพารามิเตอร์คิวรีที่ได้รับการสนับสนุนThe Stream oEmbed endpoint can be reached at https://web.microsoftstream.com/oembed with addition of the supported query parameters.

พารามิเตอร์ที่ได้รับการสนับสนุนSupported parameters

พารามิเตอร์Parameter ต้องระบุRequired? ค่าValue บันทึกย่อNotes
URLURL ต้องระบุrequired สตริง: สตริงที่เข้ารหัส URLstring: URL encoded string URL สำหรับวิดีโอหรือแชนเนลของ Microsoft StreamURL for a Microsoft Stream video or channel. ได้รับการสนับสนุนจากวิดีโอ Url จาก Microsoft ๓๖๕Video URLs from Microsoft 365 Video are also supported.
เล่นอัตโนมัติautoplay ตัวเลือกoptional บูลีน: true/falseboolean: true/false เมื่อ true วิดีโอจะเริ่มเล่นทันทีที่ผู้ใช้เข้าสู่ระบบถ้าได้รับการสนับสนุนโดยแพลตฟอร์มWhen true, the video will automatically start playing as soon as the user is logged in, if supported by the platform. นำไปใช้กับวิดีโอเท่านั้นApplies to videos only. ค่าเริ่มต้นคือ falseDefault is false.
ความกว้างwidth ตัวเลือกoptional intint ความกว้างเป็นพิกเซลwidth in pixels. ขอแนะนำให้ความกว้างเป็นอัตราส่วนความสูงคือ16:9It is recommended that the width to height ratio is 16:9. ค่าเริ่มต้นคือ640px สำหรับวิดีโอDefault is 640px for a video.
สูงheight ตัวเลือกoptional intint ความสูงเป็นพิกเซลheight in pixels. ขอแนะนำให้ความกว้างเป็นอัตราส่วนความสูงคือ16:9It is recommended that the width to height ratio is 16:9. ค่าเริ่มต้นคือ360px สำหรับวิดีโอDefault is 360px for a video.
โหลดpreload ตัวเลือกoptional อัตโนมัติ/ไม่มีauto/none การตั้งค่าการโหลดอัตโนมัติเพื่อดึงข้อมูลกลุ่มวิดีโอโดยอัตโนมัติเมื่อ platform ทำให้การตั้งค่าSetting preload to auto automatically fetches the video chunks when the platform allows it. การตั้งค่าการโหลดล่วงหน้าเป็นไม่มีการรอจนกว่าผู้ใช้จะเลือกปุ่มเล่นก่อนที่จะดึงส่วนของวิดีโอSetting preload to none waits until the user selects the play button before fetching the video chunks. ค่าเริ่มต้นคือไม่มีDefault is none.
stst ตัวเลือกoptional intint ตั้งค่าพารามิเตอร์นี้เพื่อเริ่มวิดีโอที่ค่าเป็นวินาทีSet this parameter to start the video at the value in seconds. นำไปใช้กับวิดีโอสตรีมของ Microsoft เท่านั้นApplies to Microsoft Stream videos only.

ตัวอย่างExample

ผู้บริโภคทำให้การร้องขอ HTTP ต่อไปนี้:A consumer makes the following HTTP requests:

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

การตอบกลับจะถูกส่งกลับดังต่อไปนี้:The response is returned as follows:

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

ดูเพิ่มเติมSee also

สตรีมทำงานกับผลิตภัณฑ์อื่นได้อย่างไรHow Stream works with other products