מכילה מאפייני מטא-נתונים מתוזמנים ספציפיים ל-HLS שנמצאו בנכס #EXT-X-DATERANGE.
https://tools.ietf.org/html/draft-pantos-hls-rfc8216bis-06#section-4.4.5.1
יצרן
HlsTimedMetadata
חדש
HlsTimedMetadata()
תכונות
clientAttributes
(אובייקט לא null או לא מוגדר)
הקידומת 'X- ' מגדירה מרחב שמות ששמור למאפיינים
שמוגדרים על ידי הלקוח. מאפיין הלקוח חייב להיות AttributeName חוקי. לקוחות
צריכים להשתמש בתחביר DNS הפוך כשהם מגדירים את שמות המאפיינים שלהם
כדי למנוע התנגשויות. ערך המאפיין חייב להיות מחרוזת,
רצף הקסדצימלי או נקודה עשרונית-צפה. דוגמה
למאפיין בהגדרת הלקוח: X-COM-EXAMPLE-AD-ID="XYZ123". המאפיינים
האלה אופציונליים.
משך
(מספר או לא מוגדר)
משך הזמן של טווח התאריכים, מבוטא כמספר עשרוני של נקודה צפה (floating-point). זה לא יכול להיות שלילי. יש לייצג רגע אחד של זמן
(למשל, חציית קו סיום) עם משך זמן של
0. המאפיין הזה אופציונלי.
endDate
(מחרוזת או לא מוגדר)
מחרוזת שמכילה את התאריך בפורמט ISO-8601 שבו טווח התאריכים מסתיים. הערך
חייב להיות שווה לערך של המאפיין 'תאריך ושעה' או מאוחר ממנו.
המאפיין הזה אופציונלי.
endOnNext
(בוליאני או לא מוגדר)
ערך בוליאני שמציין את סוף הטווח שמכיל אותו שווה ל-
START-DATE של הטווח הבא שלו. ה'טווח הבא' הוא 'טווח התאריכים' של אותו CLASS שתאריך ההתחלה שלו הוא 'START-DATE', שמתחיל אחרי תאריך ה-START-DATE של הטווח המדובר. המאפיין הזה הוא אופציונלי וברירת המחדל שלו היא
FALSE.
plannedDuration
(מספר או לא מוגדר)
משך הזמן הצפוי של טווח התאריכים, מבוטא
כמספר עשרוני של נקודה צפה (floating-point). זה לא יכול להיות שלילי. צריך להשתמש
במאפיין הזה כדי לציין את משך הזמן הצפוי של טווח
תאריכים, שמשך הזמן שלו בפועל עדיין לא ידוע. המאפיין הזה אופציונלי.
rangeClass
(מחרוזת או לא מוגדר)
מחרוזת המוגדרת על ידי הלקוח, שמציינת קבוצת מאפיינים ואת
הסמנטיקה של הערכים המשויכים להם. כל טווחי התאריכים עם אותו ערך מאפיין CLASS
חייבים להיות תואמים לסמנטיקה הזו. המאפיין הזה
אופציונלי.
scte35Cmd
(מחרוזת או לא מוגדר)
נושא את נתוני SCTE-35 splice_info_section() . המאפיין הזה אופציונלי.
scte35In
(מחרוזת או לא מוגדר)
נושא את חיבור הנתונים SCTE-35 בנתונים. המאפיין הזה אופציונלי.
scte35Out
(מחרוזת או לא מוגדר)
גורם לפיצול נתונים של SCTE-35. המאפיין הזה אופציונלי.
startDate
(מחרוזת או לא מוגדר)
מחרוזת שמכילה את התאריך בפורמט ISO-8601 שבו מתחיל טווח התאריכים.
המאפיין הזה הוא שדה חובה.
[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."]]
