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

ภาพรวม

Cast Web Receiver SDK รองรับการเล่นเนื้อหาโดยใช้โปรโตคอลการสตรีมบนเว็บหลายรายการ SDK จะโหลดเพลเยอร์เพื่อจัดการการเล่นเนื้อหาตาม โปรโตคอลที่ใช้ ในกรณีของเนื้อหา HLS ระบบจะโหลดคลังมีเดียเพลเยอร์ (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 พ.ย. 2025 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.12 เพื่อใช้ประโยชน์จาก การปรับปรุง 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 Issue Tracker
  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 ดูรายละเอียดเกี่ยวกับ ด้านใดของเนื้อหาที่ควรให้ความสำคัญได้ที่การตรวจสอบความถูกต้องของเนื้อหา เมื่อได้รับการตรวจสอบแล้ว พาร์ทเนอร์จะต้อง เพิ่มแฟล็กเพื่อเลือกใช้ในสภาพแวดล้อมแอปพลิเคชันเวอร์ชันที่ใช้งานจริงเพื่อเริ่ม ใช้ประโยชน์จากสิทธิประโยชน์ที่ 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 จะยังคงโฮสต์และแอปพลิเคชันตัวรับของคุณจะยังเข้าถึงได้ อย่างไรก็ตาม เราจะไม่รองรับคำขอฟีเจอร์และการแก้ไขข้อบกพร่องที่เกี่ยวข้องกับ Smooth Streaming เนื่องจากข้อกำหนดของ Smooth Streaming ไม่ได้รับการอัปเดตมานานกว่า 4 ปีแล้ว เราขอแนะนำให้คุณย้ายข้อมูลเนื้อหาไปใช้โปรโตคอลการสตรีม DASH หรือ HLS เพื่อรับข้อมูลอัปเดตประสิทธิภาพและการสนับสนุนสำหรับเนื้อหาต่อไป

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

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

ก่อนหน้า
ฟีเจอร์หลัก
ถัดไป
จัดรูปแบบโปรแกรมเล่น