HLS ในการย้ายข้อมูล Shaka Player

ภาพรวม

Cast Web Receiver SDK รองรับการเล่นเนื้อหาโดยใช้โปรโตคอลการสตรีมเว็บ หลายรายการ โดย SDK จะโหลดโปรแกรมเล่นเพื่อจัดการการเล่นเนื้อหาตามโปรโตคอลที่ใช้ ในกรณีของเนื้อหา HLS ระบบจะโหลด Media Player Library (MPL) ส่วนในกรณีของ เนื้อหา DASH ระบบจะโหลด Shaka Player

นับจากนี้ไป ทีมวิศวกรของ Cast SDK และ Shaka Player จะร่วมมือกันเพื่อเพิ่มการรองรับการเล่นเนื้อหา HLS ใน Shaka Player MPL จะไม่ได้รับการอัปเดตที่สำคัญอีกต่อไป เราขอแนะนำให้คุณเลือกใช้ Shaka Player เพื่อเล่นเนื้อหา HLS ของแอปพลิเคชัน

ข้อดีของ Shaka Player

การเปลี่ยนโปรแกรมเล่นจะช่วยให้แอปพลิเคชันได้รับประโยชน์ดังต่อไปนี้

• เซสชันการสตรีมที่เสถียรมากขึ้น สำหรับผู้ใช้ โดยมีการปรับปรุงข้อผิดพลาดในการโหลดและเวลาที่ใช้ในการโหลดและเวลาในการตอบสนอง
• การนำฟีเจอร์ HLS ล่าสุดมาใช้ต่อไป
• ความชัดเจนที่เพิ่มขึ้นในการวิเคราะห์สาเหตุหลัก ของปัญหาความเข้ากันได้ระหว่างโปรแกรมเล่นกับเนื้อหา เนื่องจาก Shaka Player เป็นโอเพนซอร์ส
• โค้ดเบสของโปรแกรมเล่นแบบโอเพนซอร์ส ช่วยให้พาร์ทเนอร์มีส่วนร่วม ในโปรเจ็กต์ Shaka Player ได้
• เวลาในการนำฟีเจอร์และการแก้ไขข้อบกพร่องไปใช้จริงลดลงอย่างมาก เนื่องจาก Shaka Player มีรอบการเผยแพร่บ่อย และไม่ขึ้นอยู่กับการเผยแพร่ Web Receiver SDK
• ควบคุมสภาพแวดล้อมการเล่นได้มากขึ้น ซึ่ง API shakaVersion เป็นผู้มอบให้
• การสนับสนุนการเล่นที่เพิ่มขึ้นจาก Google โดยมีทรัพยากรด้านวิศวกรรม ที่มุ่งเน้นการเล่น HLS ใน Shaka Player ตามที่แสดงใน โรดแมป

ไทม์ไลน์

Web Receiver SDK จะเปลี่ยนไปใช้ Shaka Player เป็นโปรแกรมเล่นเริ่มต้นสำหรับการเล่นเนื้อหา HLS โดยจะดำเนินการแบบเป็นระยะเพื่อแนะนำพาร์ทเนอร์ตลอดกระบวนการย้ายข้อมูล

ระยะ	วันที่เริ่มต้น	ภาพรวม
1	ต.ค. 2022	Cast Web Receiver SDK เปิดตัว API เพื่อเลือกใช้ การเล่นเนื้อหา HLS ใน Shaka Player
2	18 พ.ค. 2026	Cast Web Receiver SDK เปลี่ยนโปรแกรมเล่นเริ่มต้นเป็น Shaka Player สำหรับการเล่นเนื้อหา HLS

ทีมวิศวกรของ Web Receiver SDK จะใช้แนวทางที่เน้นประสิทธิภาพ และจะดำเนินการไปยังระยะถัดไปก็ต่อเมื่อประสิทธิภาพของ Shaka Player อยู่ในระดับเดียวกับประสิทธิภาพพื้นฐานของ MPL เราจะประกาศการเปลี่ยนแปลงเหล่านี้ใน กลุ่ม Google cast-sdk-announcements และอัปเดตใน คู่มือนี้

เลือกใช้

ตั้งแต่ CAF เวอร์ชัน 3.0.0105 เป็นต้นไป จะมีการกำหนดค่าระดับแอปพลิเคชันเพื่อเลือกใช้ Shaka Player สำหรับการเล่น HLS นอกจากนี้ เวอร์ชันนี้ยังเปิดตัว API เพื่อเลือกเวอร์ชัน Shaka Player ที่จะโหลดจากช่วงเวอร์ชันที่รองรับ โดยแฟล็กเหล่านี้มีอยู่ในคลาส CastReceiverOptions ผ่านพร็อพเพอร์ตี้ useShakaForHls และ shakaVersion และจะได้รับการประเมินเมื่อเริ่ม CastReceiverContext แอปพลิเคชันที่เลือกใช้ Shaka สำหรับ HLS ควรตั้งค่า Shaka Player เวอร์ชันอย่างน้อย 4.15.53 เพื่อใช้ประโยชน์จากการปรับปรุง HLS ล่าสุด หากต้องการเลือกใช้ ให้ทำตามข้อมูลโค้ดด้านล่าง

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;

context.start(castReceiverOptions);

หมายเหตุ: เมื่อตั้งค่า พร็อพเพอร์ตี้ shakaVersion จะตรึงเวอร์ชัน Shaka Player ไว้ ซึ่งจะลบล้างค่าเริ่มต้นที่กำหนดโดย Web Receiver SDK เราขอแนะนำให้ลบพร็อพเพอร์ตี้ shakaVersion เมื่อเวอร์ชัน Shaka Player เริ่มต้นสูงกว่าเวอร์ชันที่คุณตั้งไว้ วิธีนี้จะช่วยให้แอปพลิเคชันของคุณอัปเดตอยู่เสมอด้วยการเปลี่ยนแปลงล่าสุดของ Web Receiver SDK เราจะโพสต์การเปลี่ยนแปลงเวอร์ชัน Shaka Player เริ่มต้น ในบันทึกประจำรุ่นและ แจ้งให้ทราบผ่าน กลุ่ม Google cast-sdk-announcements

ตรวจสอบเนื้อหา

พาร์ทเนอร์ควรตรวจสอบการเล่นเนื้อหาใน Shaka Player ก่อนที่จะเลือกใช้ Shaka Player ในแอปที่ใช้งานจริง เราขอแนะนำให้ทดสอบเนื้อหาแต่ละรูปแบบตามที่ระบุไว้ด้านล่าง

• ประเภทสตรีม: LIVE หรือ VOD
• รูปแบบคอนเทนเนอร์: TS, MP4 หรือสตรีมพื้นฐาน
• เนื้อหาที่มีการหยุดชะงักหรือโฆษณาที่ฝังไว้
• การเล่นในอุปกรณ์ประเภทต่อไปนี้: จอแสดงผลอัจฉริยะ, ดองเกิล Google Cast, อุปกรณ์ Android TV, ทีวีที่มี Google Cast, ลำโพงอัจฉริยะ

หากพบข้อผิดพลาดหรือลักษณะการทำงานที่ไม่คาดคิด ให้รายงานข้อบกพร่อง เมื่อยืนยันได้ว่าเนื้อหาไม่มีข้อผิดพลาดในการเล่นที่สำคัญแล้ว ให้พุชการเปลี่ยนแปลงไปยังสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์

เลือกไม่ใช้

Web Receiver SDK จะเปลี่ยนไปใช้โมเดลการเลือกไม่ใช้สำหรับการเล่นเนื้อหา HLS ของ Shaka Player ตาม ไทม์ไลน์ พร็อพเพอร์ตี้ useShakaForHls จะเปลี่ยนค่าเริ่มต้น จาก false เป็น true ในเวลานั้น แอปพลิเคชันสามารถเลือกใช้ MPL สำหรับการเล่น HLS ได้โดยตั้งค่าพร็อพเพอร์ตี้นี้เป็น false ด้วยตนเอง เมื่อเริ่ม CastReceiverContext แล้ว Web Receiver SDK จะกลับไปโหลด MPL แทน Shaka Player ดูตัวอย่างวิธีเลือกไม่ใช้ได้ที่ด้านล่าง

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;

context.start(castReceiverOptions);

รายงานปัญหา

เราขอแนะนำให้พาร์ทเนอร์รายงานปัญหาที่พบเมื่อเล่นเนื้อหา HLS ดังที่กล่าวไว้ MPL จะไม่ได้รับการอัปเดตที่สำคัญอีกต่อไป หากพบปัญหาเกี่ยวกับ MPL ให้ทำตามขั้นตอนในส่วนเลือกใช้ ของคู่มือเพื่อตรวจสอบว่าการเปลี่ยนไปใช้ Shaka Player จะช่วยแก้ปัญหาได้หรือไม่ ทำตามขั้นตอนด้านล่างหากปัญหายังคงอยู่หรือหากพบปัญหาอื่นเมื่อเปลี่ยนโปรแกรมเล่น

1. ลองตั้งค่า shakaVersion เป็น เวอร์ชันสาขาอื่นเพื่อแก้ปัญหา เช่น หากพบปัญหาในสาขา 4.15 ให้ลองตั้งค่าเป็นเวอร์ชันล่าสุดในสาขาอื่น ตรวจสอบบันทึกประจำรุ่นของ Shaka Player เพื่อดูเวอร์ชันที่มีการอัปเดตที่เกี่ยวข้องมากที่สุด โปรดทราบว่า API shakaVersion มีเวอร์ชันต่ำสุดและสูงสุดที่ รองรับตามที่ระบุไว้ในเอกสารอ้างอิง หากพบว่ามีการถดถอย ให้รายงานปัญหาใน เครื่องมือติดตามปัญหาของ Shaka Player
2. ลองเปลี่ยนพารามิเตอร์การกำหนดค่าโปรแกรมเล่น คุณกำหนดค่า Shaka Player ได้ผ่าน ออบเจ็กต์ PlayerConfiguration Web Receiver SDK กำหนดค่าเริ่มต้นไว้ชุดหนึ่งและช่วยให้แอปพลิเคชันแก้ไขการกำหนดค่านี้ได้ผ่านพร็อพเพอร์ตี้ shakaConfig ในออบเจ็กต์PlaybackConfig ระบบจะประเมินค่านี้ในระหว่างเวลาที่ใช้ในการโหลดเมื่อสร้างอินสแตนซ์ของโปรแกรมเล่น ดูข้อมูลเพิ่มเติมได้ที่ การกำหนดค่าและ ตัวเลือกของแอปพลิเคชัน ค่าเริ่มต้นที่ Web Receiver SDK ตั้งไว้คือค่าที่แนะนำ
3. ดูว่ามีการรายงานปัญหาใน เครื่องมือติดตามปัญหาของ Shaka Player หรือ เครื่องมือติดตามปัญหาของ Cast หรือไม่ แสดงความคิดเห็นเกี่ยวกับข้อบกพร่องและเพิ่มข้อมูลที่เกี่ยวข้องหากข้อบกพร่องนั้นอธิบายปัญหาของคุณด้วย
4. ทดสอบเนื้อหาในเว็บไซต์เดโมของ Shaka Player หากคุณ พบว่าปัญหาเกิดขึ้นซ้ำในเว็บไซต์เดโมสำหรับเนื้อหาของคุณ ให้รายงาน ข้อบกพร่องในโปรเจ็กต์ Shaka Player
5. รายงานข้อบกพร่องใน Issue Tracker ของ Cast หากคุณพบปัญหาที่เกิดขึ้นเฉพาะกับ Shaka Player ในปลายทาง Cast

คำถามที่พบบ่อย

การเปลี่ยนโปรแกรมเล่นอาจทำให้เกิดคำถามมากมาย ด้านล่างนี้เป็นคำตอบของคำถามที่พบบ่อยที่สุดเพื่อช่วยแนะนำคุณตลอดกระบวนการย้ายข้อมูล

ฉันควรย้ายข้อมูลไปใช้ Shaka Player ไหม

เราขอแนะนำให้พาร์ทเนอร์ที่ใช้เนื้อหา HLS เริ่มกระบวนการย้ายข้อมูลโดยเร็วที่สุด ซึ่งจะช่วยให้แอปของคุณมอบประสบการณ์การสตรีมที่เสถียรมากขึ้นแก่ผู้ใช้ ดูรายละเอียดเพิ่มเติมได้ในส่วนข้อดีของ Shaka Player ในคู่มือนี้ พาร์ทเนอร์ควรตรวจสอบว่าแอปของตนทำงานอย่างถูกต้องโดยใช้ Shaka Player เพื่อให้การเปลี่ยนผ่านเป็นไปอย่างราบรื่น แอปบางแอปอาจมีความเสี่ยงสำหรับ เมื่อ Web Receiver SDK เปลี่ยนไปใช้ โมเดลการเลือกไม่ใช้ หากพาร์ทเนอร์ไม่ตรวจสอบ ว่าเนื้อหาของตนเล่นได้อย่างถูกต้องใน Shaka Player ล่วงหน้า

ระดับความพยายามที่คาดไว้เมื่อเปลี่ยนโปรแกรมเล่นคือเท่าใด

พาร์ทเนอร์จะต้องทดสอบแอปพลิเคชันและเนื้อหาในสภาพแวดล้อมการทดสอบเพื่อให้แน่ใจว่าประสบการณ์ของผู้ใช้จะคล้ายกันหรือดีขึ้นเมื่อเทียบกับ HLS ในการดำเนินการนี้ พาร์ทเนอร์จะต้องเลือกใช้ฟีเจอร์ในสภาพแวดล้อมภายในและทดสอบอย่างละเอียดว่าเนื้อหาของตนเล่นได้โดยใช้ Shaka Player ดูรายละเอียดเกี่ยวกับเนื้อหาที่ควรเน้นได้ที่การตรวจสอบเนื้อหาสำหรับ เมื่อตรวจสอบแล้ว พาร์ทเนอร์จะต้องเพิ่มแฟล็กเพื่อเลือกใช้ในสภาพแวดล้อมแอปพลิเคชันเวอร์ชันที่ใช้งานจริงเพื่อเริ่มใช้ประโยชน์จากสิทธิประโยชน์ที่ Shaka Player มอบให้ โดยรวมแล้วมีการเปลี่ยนแปลงการพัฒนาซอฟต์แวร์น้อยมาก และส่วนใหญ่เป็นข้อกำหนดด้าน QA สำหรับพาร์ทเนอร์เพื่อให้ย้ายข้อมูลได้สำเร็จ

แอปพลิเคชันของฉันจะใช้ HLS ในการสตรีมเนื้อหาในเร็วๆ นี้ ฉันควรทำอย่างไร

การผสานรวมใหม่ควรเลือกใช้ Shaka Player เพื่อการเล่น แอปพลิเคชันของคุณจะได้รับการรองรับที่ดีขึ้นในระยะยาว และจะใช้ประโยชน์จากฟีเจอร์ HLS ใหม่และการปรับปรุงประสิทธิภาพด้วย หากการผสานรวมใหม่พบปัญหา ให้รายงานข้อบกพร่องโดยเร็วที่สุดเพื่อให้ทีมวิศวกรมีเวลาเพียงพอในการแก้ไขปัญหา หากแอปพลิเคชันของคุณมีกำหนดเวลาที่จำกัด ให้ระบุข้อมูลดังกล่าวในรายงานข้อบกพร่อง รวมถึงผลกระทบเพื่อจัดลำดับความสำคัญตามความเหมาะสม ทีมวิศวกรของเราจะพยายามหาโซลูชันเพื่อรองรับผู้ใช้ของคุณอย่างเพียงพอ

เนื้อหาหรือแอปของฉันใช้ไม่ได้กับ Shaka Player ฉันควรทำอย่างไร

คุณควรรายงานข้อบกพร่องในโปรเจ็กต์ Shaka Player หรือโปรเจ็กต์ Cast (ดู รายงานปัญหา) ทีมวิศวกรของ Cast SDK กำลังตรวจสอบเครื่องมือติดตามเหล่านี้อย่างแข็งขันและจะทำงานร่วมกับคุณเพื่อแก้ไขปัญหาที่พบ ยิ่งตรวจพบปัญหาเหล่านี้ได้เร็วเท่าใด ทีมวิศวกรก็จะมีเวลาในการแก้ไขมากขึ้นเท่านั้น

MPL จะไม่ได้รับการอัปเดตที่สำคัญอีกต่อไป หมายความว่าอย่างไร

ในอดีต MPL ได้นำฟีเจอร์ HLS ใหม่มาใช้และแก้ไขข้อบกพร่องที่สำคัญผ่านการอัปเดตที่สำคัญ เมื่อ MPL ไม่ได้รับการอัปเดตเหล่านี้อีกต่อไป ระบบจะไม่เพิ่มฟีเจอร์ HLS ใหม่ลงในโปรแกรมเล่น เช่นเดียวกัน ระบบจะไม่แก้ไขปัญหาที่รายงานสำหรับการเล่น HLS ใน MPL คุณควรแก้ปัญหาเหล่านี้โดยเปลี่ยนไปใช้ Shaka Player เพื่อการเล่น หากปัญหายังคงอยู่ คุณควรรายงานข้อบกพร่องเกี่ยวกับปัญหาที่พบใน Shaka Player. พาร์ทเนอร์ควรเลิกใช้ MPL

เนื้อหาของฉันใช้โปรโตคอล Smooth Streaming การเปลี่ยนแปลงนี้จะส่งผลต่อแอปพลิเคชันของฉันอย่างไร

ไบนารีของ MPL จะยังคงโฮสต์และแอปพลิเคชันตัวรับสัญญาณจะยังคงเข้าถึงได้ อย่างไรก็ตาม ระบบจะไม่รองรับคำขอฟีเจอร์และการแก้ไขข้อบกพร่องที่เกี่ยวข้องกับ Smooth Streaming เนื่องจากไม่ได้อัปเดตข้อกำหนด Smooth Streaming มานานกว่า 4 ปีแล้ว เราขอแนะนำให้ย้ายข้อมูลเนื้อหาไปใช้โปรโตคอลการสตรีม DASH หรือ HLS เพื่อรับการอัปเดตประสิทธิภาพและการสนับสนุนเนื้อหาต่อไป

เนื้อหาของฉันไม่ได้ใช้โปรโตคอล HLS หรือ Smooth Stream การเปลี่ยนแปลงนี้จะส่งผลต่อแอปพลิเคชันของฉันอย่างไร

หากคลังเนื้อหาของคุณไม่ได้ใช้โปรโตคอลการสตรีมใดโปรโตคอลหนึ่ง คุณจะไม่ได้รับผลกระทบจากการย้ายข้อมูล และไม่จำเป็นต้องทำการเปลี่ยนแปลงใดๆ ในแอปพลิเคชัน