คลาส: CastReceiverOptions

cast.framework.CastReceiverOptions

class   static

ตัวเลือกบริบทของอุปกรณ์รับการแคสต์ พร็อพเพอร์ตี้ทั้งหมดเป็นแบบไม่บังคับ

ผู้ผลิต

CastReceiverOptions

new CastReceiverOptions()

พร็อพเพอร์ตี้

adBreakPreloadTime

(ตัวเลขหรือไม่ได้กำหนด)

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

customNamespaces

ออบเจ็กต์ที่ไม่ใช่ค่า Null ที่มีพร็อพเพอร์ตี้ cast.framework.system.MessageType ที่ไม่ใช่ค่า Null

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

disableIdleTimeout

(บูลีนหรือไม่ได้กำหนด)

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

enforceSupportedCommands

constant

บูลีน

หากเป็นจริง คำสั่งสื่อที่ไม่ได้อยู่ในแผนที่ supportedCommands จะสร้างข้อผิดพลาด ระบบจะตั้งค่า cast.framework.messages.ErrorReason เป็น NOT_SUPPORTED ค่าเริ่มต้นคือเท็จ ซึ่งอนุญาตให้เรียกใช้คำสั่งสื่อได้โดยไม่ต้องตรวจสอบแผนที่

localSenderId

(สตริงหรือไม่ได้กำหนด)

รหัสผู้ส่งที่ใช้สำหรับคำขอในเครื่อง ค่าเริ่มต้นคือ "local"

maxInactivity

(ตัวเลขหรือไม่ได้กำหนด)

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

mediaElement

(HTMLMediaElement ที่ไม่ใช่ค่า Null หรือไม่ได้กำหนด)

องค์ประกอบสื่อที่จะใช้เล่นเนื้อหา ลักษณะการทำงานเริ่มต้นคือการใช้องค์ประกอบสื่อแรกที่พบในหน้าเว็บ

playbackConfig

(cast.framework.PlaybackConfig ที่ไม่ใช่ค่า Null หรือไม่ได้กำหนด)

การกำหนดค่าการเล่นที่มีพารามิเตอร์ที่กำหนดเอง

playWatchedBreak

(บูลีนหรือไม่ได้กำหนด)

หากเป็น "จริง" ช่วงพักที่เชื่อมต่อฝั่งไคลเอ็นต์จะเล่นแม้ว่าจะดูไปแล้วก็ตาม

preferredPlaybackRate

(ตัวเลขหรือไม่ได้กำหนด)

อัตราการเล่นที่จะใช้หากไม่ได้ระบุไว้ในคำขอโหลด ช่วงที่อนุญาตคือ 0.5 ถึง 2 โดย 1 คือความเร็วปกติ

preferredTextLanguage

(สตริงหรือไม่ได้กำหนด)

ภาษาที่จะใช้สำหรับแทร็กข้อความหากคำขอโหลดไม่ได้ระบุแทร็กที่ใช้งานอยู่

คิว

(cast.framework.QueueBase ที่ไม่ใช่ค่า Null หรือไม่ได้กำหนด)

การติดตั้งใช้งานคิวที่กำหนดเอง

shakaVariant

(cast.framework.ShakaVariant ที่ไม่ใช่ค่า Null หรือไม่ได้กำหนด)

บิลด์ของ Shaka Player ที่ควรโหลด ตั้งค่าเป็น cast.framework.ShakaVariant.DEBUG เพื่อโหลดบิลด์การแก้ไขข้อบกพร่อง

shakaVersion

(สตริงหรือไม่ได้กำหนด)

เวอร์ชัน Shaka ในรูปแบบ MAJOR.MINOR.PATCH หรือ MAJOR.MINOR.PATCH-SUFFIX เช่น "4.15.56" (ค่าเริ่มต้นปัจจุบัน)

เวอร์ชันที่รองรับคือ >=4.15.56 <6.0.0 เวอร์ชันที่เลิกใช้งานแล้วแต่ยังคงเข้ากันได้คือ >=2.5.6 <4.15.56

หมายเหตุ: เราไม่แนะนำให้ใช้ Shaka Player เวอร์ชันที่เก่ากว่าเวอร์ชันเริ่มต้น เนื่องจากข้อบกพร่องหลายอย่างได้รับการแก้ไขแล้วในเวอร์ชันล่าสุด คุณสามารถระบุเวอร์ชันที่ใหม่กว่าได้ที่นี่เพื่อเลือกใช้การแก้ไขหรือฟีเจอร์เพิ่มเติมที่ยังไม่พร้อมใช้งานโดยค่าเริ่มต้น อย่างไรก็ตาม โปรดทราบว่า SDK ตัวรับสัญญาณบนเว็บเวอร์ชันต่อๆ ไปอาจเปลี่ยนช่วงของเวอร์ชันที่รองรับและบังคับให้ใช้เวอร์ชันอื่นนอกเหนือจากที่คุณระบุไว้ที่นี่ ควรใช้แฟล็กนี้เป็นมาตรการชั่วคราวเท่านั้น และอยู่ภายใต้คำแนะนำจากทีมสนับสนุนของ Cast (https://developers.google.com/cast/support) คุณต้องรับความเสี่ยงของการใช้งานเอง

skipMplLoad

(บูลีนหรือไม่ได้กำหนด)

หากเป็น "จริง" จะป้องกันไม่ให้ตัวรับสัญญาณโหลดโปรแกรมเล่น MPL

skipPlayersLoad

(บูลีนหรือไม่ได้กำหนด)

หากเป็นจริง จะป้องกันไม่ให้ตัวรับสัญญาณโหลดไลบรารี MPL หรือ Shaka Player เทียบเท่ากับการตั้งค่าทั้ง skipMplLoad และ skipShakaLoad เป็น true

skipShakaLoad

(บูลีนหรือไม่ได้กำหนด)

หากเป็น "จริง" จะป้องกันไม่ให้ตัวรับสัญญาณโหลดโปรแกรมเล่น Shaka

statusText

(สตริงหรือไม่ได้กำหนด)

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

supportedCommands

(ตัวเลขหรือไม่ได้กำหนด)

บิตมาสก์ของคำสั่งสื่อที่แอปพลิเคชันรองรับ ต้องรองรับ LOAD, PLAY, STOP, GET_STATUS เสมอ หากไม่ได้ระบุค่านี้ ระบบจะถือว่ารองรับ PAUSE, SEEK, STREAM_VOLUME, STREAM_MUTE, EDIT_TRACKS และอัตราการเล่นด้วย

ดูเพิ่มเติม

cast.framework.messages.Command

uiConfig

(cast.framework.ui.UiConfig ที่ไม่ใช่ค่า Null หรือไม่ได้กำหนด)

การกำหนดค่า UI

useLegacyDashSupport

(บูลีนหรือไม่ได้กำหนด)

หาก true ให้ใช้ MPL สำหรับเนื้อหา DASH

useShakaForHls

(บูลีนหรือไม่ได้กำหนด)

หาก true ให้ใช้ Shaka Player สำหรับเนื้อหา HLS ค่าเริ่มต้นคือ false

หมายเหตุ: Shaka Player ไม่ใช่ค่าเริ่มต้นสำหรับเนื้อหา HLS เนื่องจากยังมีฟีเจอร์ที่ขาดหายไป และเนื่องจากเราต้องการตรวจสอบว่า Shaka Player มีประสิทธิภาพและเข้ากันได้กับตัวรับสัญญาณ HLS ในวงกว้างก่อนที่จะกำหนดให้เป็นค่าเริ่มต้น หากคุณเลือกใช้ Shaka Player สำหรับ HLS ก่อนการเปิดตัวอย่างเป็นทางการ เราขอให้คุณรายงานปัญหาที่พบ (https://developers.google.com/cast/support) ก่อนที่จะเปิดตัว Shaka Player สำหรับ HLS อย่างเต็มรูปแบบ เราไม่รับประกันความเข้ากันได้ของ Shaka Player สำหรับ HLS และเราอาจแนะนำให้คุณเปลี่ยนกลับแฟล็กนี้เป็นการตั้งค่าเริ่มต้นหากพบปัญหาที่สำคัญ

versionCode

(ตัวเลขหรือไม่ได้กำหนด)

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