Zawiera specyficzne dla HLS właściwości metadanych czasowych pochodzące z właściwości #EXT-X-DATERANGE.
https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-06#section-4.4.5.1
Zespół
HlsTimedMetadata
new
HlsTimedMetadata()
Właściwości
clientAttributes
(niepusty obiekt lub niezdefiniowany)
Prefiks „X-” definiuje przestrzeń nazw zarezerwowaną na atrybuty zdefiniowane przez klienta. Atrybut klient MUSI mieć formę prawną AttributeName. Aby uniknąć kolizji, klienci powinni używać składni odwrotnej translacji DNS podczas definiowania własnych nazw atrybutów. Wartość atrybutu MUSI być ciągiem tekstowym, ciągiem szesnastkowym lub liczbą zmiennoprzecinkową. Przykład atrybutu definiowanego przez klienta to X-COM-EXAMPLE-AD-ID="XYZ123". Te atrybuty są OPCJONALNE.
czas trwania
(liczba lub wartość nieokreślona)
Czas trwania zakresu dat wyrażony w postaci liczby zmiennoprzecinkowej w sekundach. NIE MOŻE być wartością ujemną. Pojedyncza chwila w czasie (np. przekroczenie linii mety) POWINNA być reprezentowana przez czas trwania wynoszący 0. Ten atrybut jest OPCJONALNY.
endDate
(ciąg znaków lub nieokreślony)
Ciąg tekstowy zawierający datę w formacie ISO-8601, w której kończy się zakres dat. Musi być równa wartości atrybutu START-DATE lub późniejsza.
Ten atrybut jest OPCJONALNY.
endOnNext
(wartość logiczna lub nieokreślona)
Wartość logiczna wskazująca koniec zakresu, który go zawiera, jest równy START-DATE odpowiedniego zakresu. Poniższy zakres to zakres dat dla tej samej klasy, która ma najwcześniejszą datę START-DATE po START-DATE danego zakresu. Ten atrybut jest OPCJONALNY i przyjmuje wartość domyślną „false” (fałsz).
plannedDuration
(liczba lub wartość nieokreślona)
Oczekiwany czas trwania zakresu dat wyrażony w postaci liczby dziesiętnej zmiennoprzecinkowej w sekundach. NIE MOŻE być wartością ujemną. Ten atrybut POWINIEN być używany do wskazywania oczekiwanego czasu trwania dla zakresu dat, którego rzeczywisty czas trwania nie jest jeszcze znany. Ten atrybut jest OPCJONALNY.
rangeClass
(ciąg znaków lub nieokreślony)
Ciąg zdefiniowany przez klienta, który określa zestaw atrybutów i powiązaną z nimi semantykę wartości. Wszystkie zakresy dat z tą samą wartością atrybutu CLASS MUSZĄ być zgodne z tymi semantykami. Ten atrybut jest OPCJONALNY.
SCTE35Cmd
(ciąg znaków lub nieokreślony)
Zawiera dane SCTE-35 splice_info_section(). Ten atrybut jest OPCJONALNY.
SCTE35In
(ciąg znaków lub nieokreślony)
Przenosi w danych sprzężenie danych SCTE-35. Ten atrybut jest OPCJONALNY.
SCTE35Out
(ciąg znaków lub nieokreślony)
Przenosi dane podziału danych SCTE-35. Ten atrybut jest OPCJONALNY.
startDate
(ciąg znaków lub nieokreślony)
Ciąg tekstowy zawierający datę w formacie ISO-8601, od której rozpoczyna się zakres dat.
Ten atrybut jest WYMAGANY.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003e\u003ccode\u003ecast.framework.HlsTimedMetadata\u003c/code\u003e handles HLS timed metadata, specifically properties within the \u003ccode\u003e#EXT-X-DATERANGE\u003c/code\u003e tag, as defined in the HLS RFC.\u003c/p\u003e\n"],["\u003cp\u003eIt includes properties like \u003ccode\u003estartDate\u003c/code\u003e, \u003ccode\u003eendDate\u003c/code\u003e, \u003ccode\u003eduration\u003c/code\u003e, and various SCTE-35 related attributes for managing date ranges and content signaling.\u003c/p\u003e\n"],["\u003cp\u003eClient-defined attributes, prefixed with "X-", allow for custom metadata to be included within the timed metadata.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003erangeClass\u003c/code\u003e property enables grouping of date ranges with shared semantics for specific functionalities.\u003c/p\u003e\n"]]],["The `HlsTimedMetadata` class manages HLS timed metadata properties from the `#EXT-X-DATERANGE` tag. Key properties include `startDate` (required ISO-8601 start date), `endDate` (optional ISO-8601 end date), `duration` (optional duration in seconds), and `plannedDuration` (optional expected duration). `rangeClass` allows for custom attribute sets. Additional attributes cover client-defined data (`clientAttributes`) and SCTE-35 information (`scte35Cmd`, `scte35In`, `scte35Out`). The `endOnNext` property indicates if the range ends at the start of the next one.\n"],null,["# Class: HlsTimedMetadata\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).HlsTimedMetadata\n===================================================================================\n\nclass static\n\nContains HLS-specific timed metadata properties found in the #EXT-X-DATERANGE\nproperty.\nhttps://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-06#section-4.4.5.1\n\nConstructor\n-----------\n\n### HlsTimedMetadata\n\nnew\nHlsTimedMetadata()\n\nProperties\n----------\n\n### clientAttributes\n\n(non-null Object or undefined)\n\nThe \"X-\" prefix defines a namespace reserved for client-defined\nattributes. The client-attribute MUST be a legal AttributeName. Clients\nSHOULD use a reverse-DNS syntax when defining their own attribute names\nto avoid collisions. The attribute value MUST be a string, a\nhexadecimal-sequence, or a decimal-floating-point. An example of a\nclient-defined attribute is X-COM-EXAMPLE-AD-ID=\"XYZ123\". These\nattributes are OPTIONAL.\n\n### duration\n\n(number or undefined)\n\nThe duration of the Date Range expressed as a decimal-floating-point\nnumber of seconds. It MUST NOT be negative. A single instant in time\n(e.g., crossing a finish line) SHOULD be represented with a duration of\n0. This attribute is OPTIONAL.\n\n### endDate\n\n(string or undefined)\n\nA string containing the ISO-8601 date at which the Date Range ends. It\nMUST be equal to or later than the value of the START-DATE attribute.\nThis attribute is OPTIONAL.\n\n### endOnNext\n\n(boolean or undefined)\n\nA boolean indicating the end of the range containing it is equal to the\nSTART-DATE of its Following Range. The Following Range is the Date Range\nof the same CLASS that has the earliest START-DATE after the START-DATE\nof the range in question. This attribute is OPTIONAL and defaults to\nfalse.\n\n### plannedDuration\n\n(number or undefined)\n\nThe expected duration of the Date Range expressed as a\ndecimal-floating-point number of seconds. It MUST NOT be negative. This\nattribute SHOULD be used to indicate the expected duration of a Date\nRange whose actual duration is not yet known. This attribute is OPTIONAL.\n\n### rangeClass\n\n(string or undefined)\n\nA client-defined string that specifies some set of attributes and their\nassociated value semantics. All Date Ranges with the same CLASS\nattribute value MUST adhere to these semantics. This attribute is\nOPTIONAL.\n\n### scte35Cmd\n\n(string or undefined)\n\nCarries SCTE-35 splice_info_section() data. This attribute is OPTIONAL.\n\n### scte35In\n\n(string or undefined)\n\nCarries SCTE-35 data splice in data. This attribute is OPTIONAL.\n\n### scte35Out\n\n(string or undefined)\n\nCarries SCTE-35 data splice out data. This attribute is OPTIONAL.\n\n### startDate\n\n(string or undefined)\n\nA string containing the ISO-8601 date at which the Date Range begins.\nThis attribute is REQUIRED."]]
