Đại diện cho một đoạn chèn quảng cáo (ví dụ: một đoạn của một quảng cáo trong một điểm chèn quảng cáo)
Hàm dựng
BreakClip
mới
BreakClip(id)
Thông số
id
string
Mã của đoạn ngắt duy nhất.
Thuộc tính
clickThroughUrl
(chuỗi hoặc không xác định)
URL của trang mà người gửi hiển thị khi người dùng cuối nhấp vào đường liên kết trên giao diện người dùng của người gửi trong khi phát đoạn video này trên trình nhận.
contentId
(chuỗi hoặc không xác định)
Mã của nội dung hiện đang phát trên bộ thu. Thông thường, đây là URL của điểm chèn nội dung đa phương tiện.
contentType
(chuỗi hoặc không xác định)
Loại MIME nội dung.
contentUrl
(chuỗi hoặc không xác định)
URL ngắt nội dung đa phương tiện (không bắt buộc), cho phép sử dụng contentId thay cho mã nhận dạng thực. Nếu bạn cung cấp contentUrl, giá trị này sẽ được dùng làm URL nội dung nghe nhìn, nếu không, contentId sẽ được dùng làm URL của nội dung nghe nhìn.
Cấu hình yêu cầu quảng cáo VAST.
Hàm này được dùng khi cả contentId và contentUrl đều không được cung cấp.
Để tránh bị tràn, trường này không được đưa vào thông báo MediaStatus.
whenSkippable
(số hoặc không xác định)
Thời lượng tính bằng giây khi đoạn ngắt này có thể bỏ qua. Ví dụ: giá trị 5 có nghĩa là người dùng có thể bỏ qua đoạn ngắt này sau 5 giây. Nếu trường này có giá trị âm hoặc là undefined, thì tức là không thể bỏ qua đoạn chèn quảng cáo hiện tại.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003e\u003ccode\u003eBreakClip\u003c/code\u003e represents an individual ad or segment within an ad break during content playback on a Cast receiver.\u003c/p\u003e\n"],["\u003cp\u003eIt provides properties for managing metadata like URLs, duration, content type, and custom data associated with the ad.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eBreakClip\u003c/code\u003e supports various ad formats including standard media, VAST ads, and HLS, allowing flexibility in ad delivery.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can specify when the break clip is skippable by the user, enhancing user experience during ad breaks.\u003c/p\u003e\n"]]],["The `BreakClip` class represents a media clip, like an ad, within a break. Key properties include: `id` (unique identifier), `contentId`/`contentUrl` (media source), `contentType` (MIME type), `duration` (clip length), `posterUrl` (display image), and `title` (display text). `clickThroughUrl` specifies a URL for sender UI interaction. `vastAdsRequest` handles ad requests if direct content isn't provided. `whenSkippable` defines the skip time. HLS segment format settings are available for HLS content.\n"],null,["# Class: BreakClip\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).[messages](/cast/docs/reference/web_receiver/cast.framework.messages).BreakClip\n==================================================================================================================================================\n\nclass static\n\nRepresents a break clip (for example, a clip of an ad during an ad break)\n\nConstructor\n-----------\n\n### BreakClip\n\nnew\nBreakClip(id)\n\n| #### Parameter ||\n|----|----------------------------------|\n| id | string The unique break clip ID. |\n\nProperties\n----------\n\n### clickThroughUrl\n\n(string or undefined)\n\nThe URL of the page that the sender displays when the end user clicks\nthe link on the sender UI during playback of this clip on the receiver.\n\n### contentId\n\n(string or undefined)\n\nThe ID of the content currently playing on the receiver. Typically, this\nis the URL of the break media.\n\n### contentType\n\n(string or undefined)\n\nThe content MIME type.\n\n### contentUrl\n\n(string or undefined)\n\nThe optional break media URL, which allows the use of `contentId` in\nplace of the real ID. If `contentUrl` is provided, it is used as the\nmedia URL, otherwise the `contentId` is used as the media URL.\n\n### customData\n\n(non-null Object or undefined)\n\nThe application-specific break clip data.\n\n### duration\n\n(number or undefined)\n\nThe break clip duration, in seconds.\n\n### hlsSegmentFormat\n\n(non-null [cast.framework.messages.HlsSegmentFormat](/cast/docs/reference/web_receiver/cast.framework.messages#.HlsSegmentFormat) or undefined)\n\nThe format of the HLS media segment. Only required for HLS content\nplayback using MPL.\n\n### hlsVideoSegmentFormat\n\n(non-null [cast.framework.messages.HlsVideoSegmentFormat](/cast/docs/reference/web_receiver/cast.framework.messages#.HlsVideoSegmentFormat) or undefined)\n\nThe format of the HLS Video media segment. Only required for HLS content\nplayback using MPL.\n\n### id\n\nstring\n\nThe unique break clip ID.\n\n### posterUrl\n\n(string or undefined)\n\nThe URL of the content that the sender displays while the receiver is\nplaying this clip.\n\n### title\n\n(string or undefined)\n\nThe title of the break clip. Sender might display this on its screen, if\nprovided.\n\n### vastAdsRequest\n\n(non-null [cast.framework.messages.VastAdsRequest](/cast/docs/reference/web_receiver/cast.framework.messages.VastAdsRequest) or undefined)\n\nThe VAST ad request configuration.\nThis is used when neither `contentId` nor `contentUrl` are provided.\nTo avoid overflow, this field is not included in `MediaStatus` messages.\n\n### whenSkippable\n\n(number or undefined)\n\nThe time in seconds when this break clip becomes skippable. For example,\na value of `5` means that the user can skip this break clip after five\nseconds. If this field has a negative value or is `undefined`, this means\nthat the current break clip is not skippable."]]
