#EXT-X-DATERANGE 속성에 있는 HLS 관련 시간 지정 메타데이터 속성을 포함합니다.
https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-06#section-4.4.5.1
생성자
HlsTimedMetadata
new
HlsTimedMetadata()
속성
clientAttributes
(null이 아닌 객체 또는 정의되지 않음)
'X-' 프리픽스는 클라이언트에서 정의한 속성용으로 예약된 네임스페이스를 정의합니다. 클라이언트 속성은 올바른 AttributeName이어야 합니다. 클라이언트는 충돌을 방지하기 위해 자체 속성 이름을 정의할 때 역방향 DNS 구문을 사용해야 합니다(SHOULD). 속성 값은 문자열, 16진수 시퀀스 또는 10진수 부동 소수점이어야 합니다(MUST). 클라이언트 정의 속성의 예는 X-COM-EXAMPLE-AD-ID="XYZ123"입니다. 이러한 속성은 선택사항입니다.
시간
(숫자 또는 정의되지 않음)
초 단위의 십진수 부동 소수점 수로 표현된 기간입니다. 음수이면 안 됩니다(MUST NOT). 단일 순간(예: 결승선 통과)은 지속 시간 0으로 표시되어야 합니다(SHOULD). 이 속성은 선택사항입니다.
endDate
(문자열 또는 정의되지 않음)
기간이 끝나는 ISO-8601 날짜를 포함하는 문자열입니다. 시작 날짜 속성 값과 같거나 그 이후여야 합니다(MUST).
이 속성은 선택사항입니다.
endOnNext
(불리언 또는 정의되지 않음)
포함 범위의 끝을 나타내는 불리언이 다음 범위의 시작-DATE와 같음 다음 기간은 해당 기간의 시작일에서 시작일이 가장 이른 시점인 동일한 CLASS의 기간입니다. 이 속성은 선택사항이며 기본값은 false입니다.
plannedDuration
(숫자 또는 정의되지 않음)
십진수 부동 소수점 수(초)로 표시되는 기간의 예상 기간입니다. 음수이면 안 됩니다(MUST NOT). 이 속성은 실제 기간이 아직 알려지지 않은 기간의 예상 기간을 나타내는 데 사용해야 합니다(SHOULD). 이 속성은 선택사항입니다.
rangeClass
(문자열 또는 정의되지 않음)
일부 속성 집합 및 연결된 값 의미 체계를 지정하는 클라이언트 정의 문자열입니다. CLASS 속성 값이 동일한 모든 기간은 이러한 시맨틱을 준수해야 합니다(MUST). 이 속성은 선택사항입니다.
Scte35Cmd
(문자열 또는 정의되지 않음)
SCTE-35 splice_info_section() 데이터를 전달합니다. 이 속성은 선택사항입니다.
[null,null,["최종 업데이트: 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."]]
