حاوی ویژگی‌های فراداده زمان‌دار خاص HLS است که در ویژگی #EXT-X-DATERANGE یافت می‌شود. https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-06#section-4.4.5.1
سازنده
HlsTimedMetadata
جدید HlsTimedMetadata()
خواص
ویژگی های مشتری
(شیء غیر تهی یا تعریف نشده)
پیشوند "X-" فضای نامی را برای ویژگی های تعریف شده توسط مشتری مشخص می کند. ویژگی مشتری باید یک AttributeName قانونی باشد. کلاینت ها باید از یک نحو معکوس DNS هنگام تعریف نام ویژگی های خود برای جلوگیری از برخورد استفاده کنند. مقدار مشخصه باید یک رشته، یک دنباله هگزادسیمال یا یک ممیز شناور اعشاری باشد. نمونه ای از ویژگی های تعریف شده توسط مشتری X-COM-EXAMPLE-AD-ID="XYZ123" است. این ویژگی ها اختیاری هستند.
مدت زمان
(تعداد یا تعریف نشده)
مدت زمان محدوده تاریخ به صورت یک عدد ممیز شناور اعشاری از ثانیه بیان می شود. نباید منفی باشد. یک لحظه در زمان (به عنوان مثال، عبور از خط پایان) باید با مدت زمان 0 نشان داده شود. این ویژگی اختیاری است.
تاریخ پایان
(رشته یا تعریف نشده)
رشته ای حاوی تاریخ ISO-8601 که در آن محدوده تاریخ به پایان می رسد. باید برابر یا دیرتر از مقدار مشخصه START-DATE باشد. این ویژگی اختیاری است.
endOnNext
(بولی یا تعریف نشده)
یک بولی که پایان محدوده حاوی آن را نشان می دهد برابر با START-DATE محدوده زیر است. محدوده زیر، محدوده تاریخ همان کلاس است که دارای اولین START-DATE بعد از START-DATE محدوده مورد نظر است. این ویژگی اختیاری است و پیش‌فرض آن false است.
مدت زمان برنامه ریزی شده
(تعداد یا تعریف نشده)
مدت زمان مورد انتظار محدوده تاریخ به صورت یک عدد ممیز شناور اعشاری از ثانیه بیان می شود. نباید منفی باشد. این ویژگی باید برای نشان دادن مدت زمان مورد انتظار یک محدوده تاریخی که مدت زمان واقعی آن هنوز مشخص نیست استفاده شود. این ویژگی اختیاری است.
rangeClass
(رشته یا تعریف نشده)
یک رشته تعریف شده توسط مشتری که مجموعه ای از ویژگی ها و معنای ارزش مرتبط با آنها را مشخص می کند. همه محدوده‌های تاریخ با مقدار مشخصه CLASS یکسان باید به این معناشناسی پایبند باشند. این ویژگی اختیاری است.
scte35Cmd
(رشته یا تعریف نشده)
داده های SCTE-35 splice_info_section() را حمل می کند. این ویژگی اختیاری است.
scte35In
(رشته یا تعریف نشده)
اتصال داده SCTE-35 را در داده ها حمل می کند. این ویژگی اختیاری است.
scte35 Out
(رشته یا تعریف نشده)
داده های اتصال داده SCTE-35 را انجام می دهد. این ویژگی اختیاری است.
تاریخ شروع
(رشته یا تعریف نشده)
رشته ای حاوی تاریخ ISO-8601 که در آن محدوده تاریخ شروع می شود. این ویژگی ضروری است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
