مصفوفة من معرّفات التتبع النشطة. وإذا لم تتوفر المصفوفة، ستكون المسارات التلقائية نشطة.
التشغيل التلقائي
(منطقية أو غير محدّدة)
إذا تم تحديد معلَمة التشغيل التلقائي، سيبدأ مشغّل الوسائط
في تشغيل المحتوى عند تحميله. حتى إذا لم يتم تحديد التشغيل التلقائي، قد يختار تنفيذ مشغّل الوسائط بدء التشغيل على الفور.
بيانات الاعتماد
(سلسلة أو غير محدّدة)
بيانات اعتماد المستخدم الاختيارية.
credentialsType
(سلسلة أو غير محدّدة)
نوع بيانات الاعتماد الاختيارية.
النوع "سحابة" هو نوع محجوز تستخدمه طلبات التحميل التي تم إنشاؤها عن طريق أوامر المساعد الصوتي.
currentTime
(رقم أو غير محدد)
عدد الثواني منذ بداية المحتوى. إذا كان المحتوى يعرض محتوًى مباشرًا ولم يتم تحديد الوقت الحالي، سيبدأ البث من الموضع المباشر.
customData
(كائن غير فارغ أو غير محدد)
البيانات الخاصة بالتطبيق لهذا الطلب. وتتيح هذه الخدمة للمرسِل والمستلِم توسيع بروتوكول الوسائط بسهولة بدون الحاجة إلى استخدام مساحة اسم جديدة مع الرسائل المخصّصة.
رقم لمزامنة جميع أوامر قائمة الانتظار.
وفي حال توفير هذه الأداة لأحد طلبات قائمة المحتوى التالي، ستتحقّق حزمة تطوير البرامج (SDK) من تطابق أحدث رقم تسلسلي لقائمة الانتظار مع الطلب.
يتم توفير التسلسل الحالي رقم كجزء من الرسائل التي تم تغييرها في قائمة الانتظار الصادرة.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003ecast.framework.messages.LoadRequestData\u003c/code\u003e is a class that defines the data structure for a media LOAD request event.\u003c/p\u003e\n"],["\u003cp\u003eThis data includes information like the media to load, playback settings (autoplay, currentTime, playbackRate), active track IDs, and custom application data.\u003c/p\u003e\n"],["\u003cp\u003eIt also supports features like user credentials, queue management, and load options for advanced configurations.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eLoadRequestData\u003c/code\u003e inherits properties from \u003ccode\u003ecast.framework.messages.RequestData\u003c/code\u003e like \u003ccode\u003erequestId\u003c/code\u003e, \u003ccode\u003emediaSessionId\u003c/code\u003e, and \u003ccode\u003ecustomData\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers use this structure to handle incoming LOAD requests and control media playback within their Cast receiver applications.\u003c/p\u003e\n"]]],["The `LoadRequestData` class handles media loading requests, extending `RequestData`. Key actions include setting `activeTrackIds` to specify active media tracks, `autoplay` to control immediate playback, and `currentTime` for playback start position. It carries `credentials` and `credentialsType` for user authentication, `customData` for custom application-specific data, and `media` with detailed media information. `loadOptions` add additional preferences, `queueData` handles the media queues, and request details like `requestId` and `sequenceNumber` are inherited for command tracking and synchronization.\n"],null,["# Class: LoadRequestData\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).[messages](/cast/docs/reference/web_receiver/cast.framework.messages).LoadRequestData\n========================================================================================================================================================\n\nclass static\n\nMedia event LOAD request data.\n\nConstructor\n-----------\n\n### LoadRequestData\n\nnew\nLoadRequestData()\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 trackIds that are active. If the array is not provided,\nthe default tracks will be active.\n\n### autoplay\n\n(boolean or undefined)\n\nIf the autoplay parameter is specified, the media player will begin\nplaying the content when it is loaded. Even if autoplay is not\nspecified,the media player implementation may choose to begin playback\nimmediately.\n\n### credentials\n\n(string or undefined)\n\nOptional user credentials.\n\n### credentialsType\n\n(string or undefined)\n\nOptional credentials type.\nThe type 'cloud' is a reserved type used by load requests that were\noriginated by voice assistant commands.\n\n### currentTime\n\n(number or undefined)\n\nSeconds since beginning of content. If the content is live content, and\ncurrentTime is not specified, the stream will start at the live position.\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### loadOptions\n\n(non-null [cast.framework.messages.LoadOptions](/cast/docs/reference/web_receiver/cast.framework.messages.LoadOptions) or undefined)\n\nAdded load options.\n\n### media\n\nnon-null [cast.framework.messages.MediaInformation](/cast/docs/reference/web_receiver/cast.framework.messages.MediaInformation)\n\nThe media information associated with the load request.\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### playbackRate\n\n(number or undefined)\n\nThe media playback rate.\n\n### queueData\n\n(non-null [cast.framework.messages.QueueData](/cast/docs/reference/web_receiver/cast.framework.messages.QueueData) or undefined)\n\nQueue data.\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)"]]
