類別：LoadRequestData
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：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)"]]
