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

ภาพรวม

Cast Web Receiver SDK รองรับการเล่นเนื้อหาโดยใช้โปรโตคอลสตรีมมิงบนเว็บหลายรายการ SDK จะโหลดโปรแกรมเล่นเพื่อจัดการการเล่นเนื้อหาตามโปรโตคอลที่ใช้ ในกรณีของเนื้อหา HLS ระบบจะโหลดคลัง Media Player (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
• ควบคุมสภาพแวดล้อมการเล่นได้มากขึ้นจาก shakaVersion API
• การรองรับการเล่นที่เพิ่มขึ้นจาก Google ด้วยทรัพยากรด้านวิศวกรรมที่มุ่งเน้นการเล่น HLS ใน Shaka Player ตามที่แสดงในแผนงาน

ไทม์ไลน์

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

ระยะ	วันที่เริ่มต้น	ภาพรวม
1	ต.ค. 2022	Cast Web Receiver SDK เปิดตัว API เพื่อเลือกใช้ในการเล่นเนื้อหา HLS บน Shaka Player
2	ครึ่งปีแรก '25	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.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 มากกว่าเวอร์ชันที่คุณตั้งไว้ วิธีนี้จะช่วยให้แอปพลิเคชันของคุณเป็นเวอร์ชันล่าสุดอยู่เสมอพร้อมกับการเปลี่ยนแปลงล่าสุดของ Web Receiver SDK การเปลี่ยนแปลงในรุ่นเริ่มต้นของ Shaka Player จะได้รับการโพสต์ไว้ในหมายเหตุประจำรุ่นและสื่อสารผ่านกลุ่ม Google cast-sdk-announcements

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

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

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

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

เลือกไม่ใช้

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.3 ให้ลองตั้งค่าเป็นรุ่นล่าสุดในเวอร์ชัน 4.2.x หรือ 3.3.x โปรดอ่านบันทึกประจำรุ่นของ Shaka Player เพื่อดูรุ่นที่มีอัปเดตที่เกี่ยวข้องมากที่สุด โปรดทราบว่า shakaVersion API มีเวอร์ชันที่รองรับขั้นต่ำและสูงสุดตามที่ระบุไว้ในเอกสารอ้างอิง หากสังเกตเห็นว่ามีปัญหาซ้ำ ให้รายงานปัญหาในเครื่องมือติดตามปัญหาของ Shaka Player

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

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

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

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

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

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

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

ฉันควรเปลี่ยนไปใช้ Shaka Player ไหม

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

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

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

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

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

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

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

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

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

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

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

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

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