يحتوي على خصائص البيانات الوصفية المحدّدة زمنيًا وفق بروتوكول HLS والتي تم العثور عليها في السمة #EXT-X-DATERANGE.
https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-06#section-4.4.5.1
الشركة المصنِّعة
HlsTimedMetadata
جديد
HlsTimedMetadata()
أماكن إقامة
clientAttributes
(كائن غير فارغ أو غير محدد)
تحدّد البادئة "-X" مساحة اسم محجوزة للسمات التي يحدّدها العميل. يجب أن تكون سمة client-AttributeName القانوني. على العملاء
استخدام بنية نظام أسماء النطاقات العكسي عند تحديد أسماء السمات الخاصة بهم
لتجنُّب التضاربات. ويجب أن تكون قيمة السمة سلسلة أو تسلسلاً سداسيًا عشريًا أو نقطة عشرية عائمة. ومن أمثلة السمات التي يحددها العميل X-COM-EXAMPLE-AD-ID="XYZ123". وتكون هذه السمات اختيارية.
المدة
(رقم أو غير محدد)
مدة النطاق الزمني التي يتم التعبير عنها كعدد عشري عائم للثواني. يجب ألا تكون سلبية. يجب تمثيل لحظة واحدة من الزمن (على سبيل المثال، تجاوز خط النهاية) بقيمة 0. هذه السمة اختيارية.
endDate
(سلسلة أو غير محدّدة)
سلسلة تحتوي على تاريخ ISO-8601 الذي ينتهي فيه النطاق الزمني. ويجب
أن تكون مساوية لقيمة السمة Start-DATE أو أكبر منها.
هذه السمة اختيارية.
endOnNext
(منطقية أو غير محدّدة)
قيمة منطقية تشير إلى نهاية النطاق الذي يحتوي عليه أنّها تساوي تاريخ البدء "START-DATE" للنطاق التالي النطاق التالي هو النطاق الزمني للفئة نفسها التي يقع تاريخها الأول الذي يبدأ من START-DATE بعد تاريخ START-DATE
للنطاق المعنيّ. هذه السمة اختيارية ويتم ضبطها تلقائيًا على
false.
plannedDuration
(رقم أو غير محدد)
تمثّل هذه السمة المدة المتوقعة للنطاق الزمني التي يتم التعبير عنها
بعدد عشري عائم للثواني. يجب ألا تكون سلبية. يُفترض
استخدام هذه السمة للإشارة إلى المدة المتوقّعة لنطاق زمني
لم تتعرّف مدته على قيمته الفعلية بعد. هذه السمة اختيارية.
rangeClass
(سلسلة أو غير محدّدة)
سلسلة من تحديد العميل تحدد مجموعة من السمات ودلالات القيم المرتبطة بها. يجب أن تتقيد كل النطاقات الزمنية التي لها قيمة سمة Class نفسها بهذه المعنى. هذه السمة اختيارية.
scte35Cmd
(سلسلة أو غير محدّدة)
يحمل بيانات SCTE-35 splice_info_section() . هذه السمة اختيارية.
scte35In
(سلسلة أو غير محدّدة)
يتضمن دمج بيانات SCTE-35 في البيانات. هذه السمة اختيارية.
موسيقى scte35Out
(سلسلة أو غير محدّدة)
يحمل بيانات دمج بيانات SCTE-35. هذه السمة اختيارية.
startDate
(سلسلة أو غير محدّدة)
سلسلة تحتوي على تاريخ ISO-8601 الذي يبدأ فيه النطاق الزمني.
هذه السمة مطلوبة.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
