مصفوفة معرّفات TrackId التي يجب أن تكون نشطة. وإذا لم يتم توفيره، لن تتغير المسارات النشطة. وإذا كانت الصفيفة فارغة، لن تكون أيّ قناة
نشطة.
customData
(كائن غير فارغ أو غير محدد)
البيانات الخاصة بالتطبيق لهذا الطلب. وتتيح هذه الخدمة للمرسِل والمستلِم توسيع بروتوكول الوسائط بسهولة بدون الحاجة إلى استخدام مساحة اسم جديدة مع الرسائل المخصّصة.
ضَع علامة لتفعيل المسارات النصية أو إيقافها.
أما إذا كانت الإجابة "خطأ"، فسيؤدي ذلك إلى إيقاف جميع المسارات النصية، وفي حال ضبطها على "صحيح"، سيتم تفعيل
المقطع الصوتي الأول أو المسارات النصية النشطة السابقة.
يتم تجاهل هذه العلامة في حال تحديد قيم ActiveTrackId أو اللغة.
isSuggestedLanguage
(منطقية أو غير محدّدة)
يشير إلى أن اللغة المقدمة لم تكن طلبًا صريحًا من المستخدم، بل يتم استنتاجها من اللغة المستخدمة في طلب البحث الصوتي.
تسمح هذه السياسة لتطبيقات المُستلِم باستخدام الإعدادات المفضّلة المحفوظة للمستخدم بدلاً من اللغة المحكية.
language
(سلسلة أو غير محدّدة)
لغة المسارات التي يجب أن تكون نشطة وفي حال تحديد حقلي اللغة، سيحظى حقل اللغة
بالأولوية على ActiveTrackId.
رقم لمزامنة جميع أوامر قائمة الانتظار.
وفي حال توفير هذه الأداة لأحد طلبات قائمة المحتوى التالي، ستتحقّق حزمة تطوير البرامج (SDK) من تطابق أحدث رقم تسلسلي لقائمة الانتظار مع الطلب.
يتم توفير التسلسل الحالي رقم كجزء من الرسائل التي تم تغييرها في قائمة الانتظار الصادرة.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eEditTracksInfoRequestData\u003c/code\u003e is a class used for media event requests to edit track information, such as active tracks and text track settings.\u003c/p\u003e\n"],["\u003cp\u003eIt includes properties like \u003ccode\u003eactiveTrackIds\u003c/code\u003e, \u003ccode\u003elanguage\u003c/code\u003e, and \u003ccode\u003etextTrackStyle\u003c/code\u003e to specify desired track modifications.\u003c/p\u003e\n"],["\u003cp\u003eThe request data can also include \u003ccode\u003ecustomData\u003c/code\u003e for application-specific needs and \u003ccode\u003emediaSessionId\u003c/code\u003e to target a specific media session.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eenableTextTracks\u003c/code\u003e can be used to enable or disable text tracks, while \u003ccode\u003eisSuggestedLanguage\u003c/code\u003e helps the receiver app differentiate between user specified or inferred language.\u003c/p\u003e\n"],["\u003cp\u003eThis class inherits properties like \u003ccode\u003erequestId\u003c/code\u003e, \u003ccode\u003esequenceNumber\u003c/code\u003e, and \u003ccode\u003ecustomData\u003c/code\u003e from the \u003ccode\u003ecast.framework.messages.RequestData\u003c/code\u003e parent class.\u003c/p\u003e\n"]]],["`EditTracksInfoRequestData` manages media track adjustments. Key actions include setting `activeTrackIds` to control which tracks are active, using the `language` field to prioritize track selection, and enabling/disabling text tracks with `enableTextTracks`. It also supports `customData` for application-specific information. `isSuggestedLanguage` allows for inferred language preferences. `mediaSessionId`, `requestId`, and `sequenceNumber` support request tracking, with `textTrackStyle` managing text track display.\n"],null,["# Class: EditTracksInfoRequestData\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).[messages](/cast/docs/reference/web_receiver/cast.framework.messages).EditTracksInfoRequestData\n==================================================================================================================================================================\n\nclass static\n\nMedia event EDIT_TRACKS_INFO request data.\n\nConstructor\n-----------\n\n### EditTracksInfoRequestData\n\nnew\nEditTracksInfoRequestData()\n\nExtends\n: [cast.framework.messages.RequestData](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData)\n\nProperties\n----------\n\n### activeTrackIds\n\n(non-null Array of number or undefined)\n\nArray of the Track trackIds that should be active. If it is not provided,\nthe active tracks will not change. If the array is empty, no track will\nbe active.\n\n### customData\n\n(non-null Object or undefined)\n\nApplication-specific data for this request. It enables the sender and\nreceiver to easily extend the media protocol without having to use a new\nnamespace with custom messages.\n\nInherited from\n: [cast.framework.messages.RequestData#customData](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#customData)\n\n### enableTextTracks\n\n(boolean or undefined)\n\nFlag to enable or disable text tracks.\nIf false it will disable all text tracks, if true it will enable the\nfirst text track, or the previous active text tracks.\nThis flag is ignored if activeTrackIds or language is provided.\n\n### isSuggestedLanguage\n\n(boolean or undefined)\n\nIndicates that the provided language was not explicit user request,\nbut rather inferred from used language in voice query.\nIt allows receiver apps to use user saved preference instead of\nspoken language.\n\n### language\n\n(string or undefined)\n\nLanguage for the tracks that should be active. The language field will\ntake precedence over activeTrackIds if both are specified.\n\n### mediaSessionId\n\n(number or undefined)\n\nId of the media session that the request applies to.\n\nInherited from\n: [cast.framework.messages.RequestData#mediaSessionId](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#mediaSessionId)\n\n### requestId\n\nnumber\n\nId of the request, used to correlate request/response.\n\nInherited from\n: [cast.framework.messages.RequestData#requestId](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#requestId)\n\n### sequenceNumber\n\n(number or undefined)\n\nA number to synchronize all queue commands.\nIf provided for a queue command, the SDK will verify the queue latest\nsequence number match the request.\nCurrent sequenceNumber is provided as part of outgoing queue changed\nmessages.\n\nInherited from\n: [cast.framework.messages.RequestData#sequenceNumber](/cast/docs/reference/web_receiver/cast.framework.messages.RequestData#sequenceNumber)\n\n### textTrackStyle\n\n([cast.framework.messages.TextTrackStyle](/cast/docs/reference/web_receiver/cast.framework.messages.TextTrackStyle) or undefined)\n\nThe requested text track style. If it is not provided the existing style\nwill be used (if no style was provided in previous calls, it will be the\ndefault receiver style)."]]
