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 โดยจะดำเนินการแบบเป็นระยะเพื่อแนะนำพาร์ทเนอร์ตลอดกระบวนการย้ายข้อมูล

ทีมวิศวกรของ 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.56 ขึ้นไปเพื่อใช้ประโยชน์จากการปรับปรุง HLS ล่าสุด หากต้องการเลือกเข้าร่วม ให้ทำตามข้อมูลโค้ดด้านล่าง

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

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

context.start(castReceiverOptions);

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

พาร์ทเนอร์ควรตรวจสอบการเล่นเนื้อหาใน 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 การดำเนินการนี้จะส่งผลต่อแอปพลิเคชันของฉันอย่างไร

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