Représente un clip de coupure publicitaire (par exemple, un clip d'annonce pendant une coupure publicitaire).
Constructeur
BreakClip
nouveau
BreakClip(id)
Paramètres
id
chaîne
ID unique de l'extrait de coupure publicitaire.
Propriétés
clickThroughUrl
(chaîne ou non défini)
URL de la page que l'expéditeur affiche lorsque l'utilisateur final clique sur le lien dans son interface utilisateur lors de la lecture de cet extrait sur le destinataire.
contentId
(chaîne ou non défini)
ID du contenu en cours de lecture sur le récepteur. Il s'agit généralement de l'URL de la coupure multimédia.
contentType
(chaîne ou non défini)
Type MIME du contenu.
contentUrl
(chaîne ou non défini)
URL facultative de coupure multimédia, qui permet d'utiliser contentId à la place du vrai ID. Si contentUrl est fourni, il est utilisé comme URL du média. Sinon, contentId est utilisé comme URL du média.
customData
(objet non nul ou non défini)
Données sur l'extrait de coupure publicitaire spécifique à l'application.
Configuration de la demande d'annonce VAST.
Cette valeur est utilisée lorsque ni contentId, ni contentUrl ne sont fournis.
Pour éviter tout dépassement, ce champ n'est pas inclus dans les messages MediaStatus.
whenSkippable
(nombre ou non défini)
Durée, en secondes, à laquelle cet extrait de coupure publicitaire devient désactivable. Par exemple, la valeur 5 signifie que l'utilisateur peut ignorer cet extrait de coupure publicitaire au bout de cinq secondes. Si ce champ a une valeur négative ou est undefined, cela signifie que l'extrait de coupure publicitaire actuel n'est pas désactivable.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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."]]
