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

ภาพรวม

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

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

สิทธิประโยชน์ของ Shaka Player

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

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

ไทม์ไลน์

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

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

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

เลือกใช้

ตั้งแต่ CAF เวอร์ชัน 3.0.0105 เป็นต้นไป โดยจะมีระดับแอปพลิเคชัน การกำหนดค่าเพื่อเลือกใช้เพื่อใช้ Shaka Player สำหรับการเล่น HLS เวอร์ชันนี้ ยังมี API ให้คุณเลือกจาก เวอร์ชันที่รองรับของ Shaka Player เพื่อโหลด การแจ้งว่าไม่เหมาะสมเหล่านี้มีอยู่ใน CastReceiverOptions ของชั้นเรียนผ่าน useShakaForHls และ พร็อพเพอร์ตี้ shakaVersion และจะได้รับการประเมินเมื่อ CastReceiverContext เริ่มต้นแล้ว แอปพลิเคชันทั้งหมดที่เลือกใช้ Shaka สำหรับ HLS ควรตั้งค่าเวอร์ชันของ Shaka Player อย่างน้อย 4.3.4 เพื่อใช้ประโยชน์จาก การปรับปรุง 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 คือ สูงกว่าเวอร์ชันที่คุณตั้งไว้ ทำให้แอปพลิเคชันของคุณเป็นปัจจุบันอยู่เสมอ ด้วยการเปลี่ยนแปลง SDK ของ Web Receiver ล่าสุด การเปลี่ยนแปลงของ Shaka Player เริ่มต้น มีโพสต์ในบันทึกประจำรุ่น และ สื่อสารผ่าน cast-sdk-announcements google group

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

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

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

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

เลือกไม่ใช้

Web Receiver SDK จะเปลี่ยนเป็นโมเดลเลือกไม่ใช้สำหรับ Shaka Player HLS การเล่นเนื้อหาตามไทม์ไลน์ ที่พัก useShakaForHls จะเปลี่ยนค่าเริ่มต้น จาก false เป็น true ในเวลานั้น แอปพลิเคชันจะเลือกใช้ MPL สำหรับ HLS ได้ โดยตั้งค่าพร็อพเพอร์ตี้นี้เป็นfalseด้วยตนเอง เมื่อ CastReceiverContext เริ่มทำงานแล้ว 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 เป็น เวอร์ชัน Branch ที่แตกต่างกันเพื่อแก้ไขปัญหา เช่น หากปัญหา มีประสบการณ์ใน Branch ของ 4.3 โปรดลองตั้งค่าให้เป็นรุ่นล่าสุดใน เวอร์ชัน 4.2.x หรือ 3.3.x ดูรุ่นของ Shaka Player โน้ตให้ค้นหา พร้อมการอัปเดตที่เกี่ยวข้องมากที่สุด โปรดทราบว่า shakaVersion API มีค่าต่ำสุดและสูงสุด เวอร์ชันที่รองรับ ตามที่อธิบายไว้ในเอกสารประกอบอ้างอิง หากคุณสังเกต มีการถดถอย โปรดรายงานปัญหาใน Shaka Player ปัญหาเกี่ยวกับเครื่องมือติดตาม

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

   การกำหนดค่าแอปพลิเคชัน ตัวเลือกเพิ่มเติม ค่าเริ่มต้น ค่าที่ Web Receiver SDK กำหนดไว้เป็นค่าที่แนะนำ

3. ดูว่ามีการรายงานปัญหาไว้ใน เครื่องมือติดตามปัญหาของโปรแกรมเล่น Shaka หรือ แคสต์ เครื่องมือติดตามปัญหา แสดงความคิดเห็นเกี่ยวกับข้อบกพร่องและเพิ่มข้อมูลที่เกี่ยวข้อง ข้อมูลนี้อธิบายปัญหาของคุณได้ด้วย

4. ทดสอบเนื้อหาในเว็บไซต์เดโมเพลเยอร์ของ Shaka หากคุณ พบว่าปัญหาเกิดซ้ำในเว็บไซต์เดโมสำหรับเนื้อหาของคุณ โปรดยื่น จากโปรเจ็กต์ Shaka Player

5. รายงานข้อบกพร่องในตัวติดตามปัญหาของการแคสต์หากคุณ มีปัญหาเฉพาะของ Shaka Player ในอุปกรณ์ปลายทางการแคสต์

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

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

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

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

ระดับความพยายามที่คาดไว้เมื่อเปลี่ยนผู้เล่น

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

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

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

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

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

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

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

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

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

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

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