คลาส: CastReceiverOptions

เครื่องมือสร้าง

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

constant

boolean

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

localSenderId

(string or undefined)

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

maxInactivity

(number or undefined)

เวลาสูงสุดเป็นวินาทีก่อนที่จะปิดการเชื่อมต่อผู้ส่งที่ไม่มีการใช้งาน การตั้งค่านี้จะเปิดใช้ข้อความฮาร์ตบีตเพื่อให้ การเชื่อมต่อใช้งานได้ ใช้เพื่อตรวจหาผู้ส่งที่ไม่ตอบสนองได้เร็วกว่า การหมดเวลา 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.53" (ค่าเริ่มต้นปัจจุบัน)

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

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

skipMplLoad

(boolean or undefined)

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

skipPlayersLoad

(boolean or undefined)

หากเป็น "จริง" จะป้องกันไม่ให้ตัวรับสัญญาณโหลดไลบรารี MPL หรือ Shaka Player เทียบเท่ากับการตั้งค่าทั้ง 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)

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