cast. framework. CastReceiverOptions
ตัวเลือกบริบทของตัวรับสัญญาณ Cast พร็อพเพอร์ตี้ทั้งหมดเป็นพร็อพเพอร์ตี้ที่ไม่บังคับ
เครื่องมือสร้าง
CastReceiverOptions
new CastReceiverOptions()
พร็อพเพอร์ตี้
adBreakPreloadTime
(number or undefined)
ระยะเวลาเป็นวินาทีที่เราควรโหลดเนื้อหาของช่วงพักโฆษณาแต่ละช่วงล่วงหน้า ซึ่งจะช่วยให้คุณหลีกเลี่ยงการโหลดช่วงพักโฆษณาล่วงหน้านานเกินไป และทำให้เมตริกโฆษณาไม่ถูกต้อง หากไม่ได้ระบุไว้ ระบบจะใช้ค่าเริ่มต้นเป็น 5 วินาที
customNamespaces
non-null Object with non-null cast.framework.system.MessageType properties
แผนผังของเนมสเปซข้อความที่กำหนดเองและประเภทของเนมสเปซ คุณต้องเริ่มต้นเนมสเปซข้อความที่กำหนดเองก่อนที่แอปพลิเคชันจะเริ่มทำงาน จึงต้องระบุเนมสเปซในตัวเลือกตัวรับสัญญาณ (ประเภทข้อความเริ่มต้นคือ JSON หากไม่ได้ระบุไว้ที่นี่)
disableIdleTimeout
(boolean or undefined)
หากเป็น "จริง" จะป้องกันไม่ให้ตัวรับสัญญาณปิดเมื่อไม่มีการใช้งานหลังจากหยุดเล่นเนื้อหาที่เล่นอยู่ คุณควรใช้พร็อพเพอร์ตี้นี้กับ แอปที่ไม่ใช่แอปสื่อเท่านั้น
enforceSupportedCommands
boolean
หากเป็น "จริง" คำสั่งสื่อใดๆ ที่ไม่อยู่ในแผนผัง supportedCommands จะ ทำให้เกิดข้อผิดพลาด ระบบจะตั้งค่า cast.framework.messages.ErrorReason เป็น NOT_SUPPORTED ค่าเริ่มต้นคือ "เท็จ" ซึ่งอนุญาตให้ดำเนินการคำสั่งสื่อ ได้โดยไม่ต้องตรวจสอบแผนผัง
localSenderId
(string or undefined)
รหัสผู้ส่งที่ใช้สำหรับคำขอในเครื่อง ค่าเริ่มต้นคือ "local"
maxInactivity
(number or undefined)
เวลาสูงสุดเป็นวินาทีก่อนที่จะปิดการเชื่อมต่อผู้ส่งที่ไม่มีการใช้งาน การตั้งค่านี้จะเปิดใช้ข้อความ Heartbeat เพื่อรักษา การเชื่อมต่อ ใช้เพื่อตรวจหาผู้ส่งที่ไม่ตอบสนองได้เร็วกว่า การหมดเวลา TCP ทั่วไป ค่าต่ำสุดคือ 5 วินาที ระบบไม่ได้กำหนดขอบเขตบน แต่โดยปกติแล้วจะใช้เวลาหลายนาทีก่อนที่การหมดเวลา TCP ของแพลตฟอร์มจะมีผล ค่าเริ่มต้นคือ 10 วินาที
mediaElement
(non-null HTMLMediaElement or undefined)
องค์ประกอบสื่อที่จะใช้เล่นเนื้อหา ลักษณะการทำงานเริ่มต้นคือการใช้ องค์ประกอบสื่อรายการแรกที่พบในหน้า
playbackConfig
(non-null cast.framework.PlaybackConfig or undefined)
การกำหนดค่าการเล่นที่มีพารามิเตอร์ที่กำหนดเอง
playWatchedBreak
(boolean or undefined)
หากเป็น "จริง" ช่วงพักโฆษณาที่ผสานรวมโดยไคลเอ็นต์จะเล่นแม้ว่าจะเคยดูแล้วก็ตาม
preferredPlaybackRate
(number or undefined)
อัตราการเล่นที่จะใช้หากไม่ได้ระบุไว้ในคำขอโหลด ช่วงที่อนุญาตคือ 0.5 ถึง 2 โดย 1 คือความเร็วปกติ
preferredTextLanguage
(string or undefined)
ภาษาที่จะใช้สำหรับแทร็กข้อความหากคำขอโหลดไม่ได้ ระบุแทร็กที่ใช้งานอยู่
queue
(non-null cast.framework.QueueBase or undefined)
การติดตั้งใช้งานคิวที่กำหนดเอง
shakaVariant
(non-null cast.framework.ShakaVariant or undefined)
บิลด์ของ Shaka Player ที่ควรโหลด ตั้งค่าเป็น
cast.framework.ShakaVariant.DEBUG เพื่อโหลดบิลด์การแก้ไขข้อบกพร่อง
shakaVersion
(string or undefined)
เวอร์ชัน Shaka ในรูปแบบ MAJOR.MINOR.PATCH หรือ MAJOR.MINOR.PATCH-SUFFIX รูปแบบ เช่น "4.15.56" (ค่าเริ่มต้นปัจจุบัน)
เวอร์ชันที่รองรับคือ >=4.15.56 <5.0.0 เวอร์ชันที่เลิกใช้งานแล้วแต่ยังคงใช้งานร่วมกันได้คือ >=2.5.6 <4.15.56
หมายเหตุ: เราไม่แนะนำให้ใช้ Shaka Player เวอร์ชันเก่ากว่าค่าเริ่มต้น เนื่องจากมีการแก้ไขข้อบกพร่องจำนวนมากในเวอร์ชันล่าสุด คุณสามารถระบุเวอร์ชันใหม่กว่าได้ที่นี่เพื่อเลือกใช้การแก้ไขหรือฟีเจอร์เพิ่มเติมที่ยังไม่พร้อมใช้งานโดยค่าเริ่มต้น อย่างไรก็ตาม โปรดทราบว่า Web Receiver SDK เวอร์ชันในอนาคตอาจเปลี่ยนช่วงของเวอร์ชันที่รองรับและบังคับให้ใช้เวอร์ชันอื่นนอกเหนือจากที่คุณระบุไว้ที่นี่ คุณควรใช้แฟล็กนี้ เป็นมาตรการชั่วคราวเท่านั้น และภายใต้คำแนะนำจากทีมสนับสนุนของ Cast (https://developers.google.com/cast/support) โปรดใช้ด้วยความระมัดระวัง
skipMplLoad
(boolean or undefined)
หากเป็น "จริง" จะป้องกันไม่ให้ตัวรับสัญญาณโหลดเพลเยอร์ MPL
skipPlayersLoad
(boolean or undefined)
หากเป็น "จริง" จะป้องกันไม่ให้ตัวรับสัญญาณโหลดไลบรารีเพลเยอร์ MPL หรือ Shaka เทียบเท่ากับการตั้งค่าทั้ง skipMplLoad และ skipShakaLoad เป็น "จริง"
skipShakaLoad
(boolean or undefined)
หากเป็น "จริง" จะป้องกันไม่ให้ตัวรับสัญญาณโหลด Shaka Player
statusText
(string or undefined)
ข้อความที่แสดงสถานะของแอปพลิเคชัน ข้อความนี้ควรเป็นไปตามกฎการแปลเป็นภาษาต่างๆ เนื่องจากแอปพลิเคชันผู้ส่งอาจแสดงข้อความนี้
supportedCommands
(number or undefined)
บิตแมสก์ของคำสั่งสื่อ ที่แอปพลิเคชันรองรับ แอปพลิเคชันต้องรองรับ LOAD, PLAY, STOP, GET_STATUS เสมอ หากไม่ได้ระบุค่านี้ ระบบจะถือว่ารองรับ PAUSE, SEEK, STREAM_VOLUME, STREAM_MUTE, EDIT_TRACKS และ PLAYBACK_RATE ด้วย
- ดูเพิ่มเติม
- cast.framework.messages.Command
uiConfig
(non-null cast.framework.ui.UiConfig or undefined)
การกำหนดค่า UI
useLegacyDashSupport
(boolean or undefined)
หากเป็น true ให้ใช้ MPL สำหรับเนื้อหา DASH
useShakaForHls
(boolean or undefined)
หากเป็น 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
(number or undefined)
จำนวนเต็มที่ใช้เป็นหมายเลขเวอร์ชันภายในเพื่อแสดงเวอร์ชันตัวรับสัญญาณ หมายเลขนี้ใช้เพื่อแยกความแตกต่างระหว่างตัวรับสัญญาณ ที่เผยแพร่เมื่อรวบรวมเมตริกเท่านั้น ควรเพิ่มหมายเลขนี้ในทุกๆ การเผยแพร่และยังคงผูกกับเวอร์ชันที่เผยแพร่นั้นในกรณีที่มีการย้อนกลับ