类：QueueManager
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-25。
[null,null,["最后更新时间 (UTC)：2025-07-25。"],[[["\u003cp\u003eThe \u003ccode\u003eQueueManager\u003c/code\u003e class provides methods for manipulating the queue of media items, such as inserting, removing, and updating items.\u003c/p\u003e\n"],["\u003cp\u003eIt allows developers to get information about the queue, like retrieving the current item, item index, or all items.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access \u003ccode\u003eQueueManager\u003c/code\u003e through the \u003ccode\u003ePlayerManager\u003c/code\u003e instance and should not directly instantiate it.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eQueueManager\u003c/code\u003e supports managing container metadata, which provides contextual information about the queue.\u003c/p\u003e\n"],["\u003cp\u003eThe number of queue items reported in Media Status can be limited using \u003ccode\u003esetQueueStatusLimit\u003c/code\u003e for performance optimization.\u003c/p\u003e\n"]]],[],null,["# Class: QueueManager\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).QueueManager\n===============================================================================\n\nclass static\n\nQueueManager exposes several queue manipulation APIs to developers.\n\nThrows\n\n: `non-null Error` If constructor is used directly.\n The QueueManager should only be accessed\n by calling [cast.framework.PlayerManager#getQueueManager](/cast/docs/reference/web_receiver/cast.framework.PlayerManager#getQueueManager).\n\nMethods\n-------\n\n### getContainerMetadata\n\ngetContainerMetadata() returns [cast.framework.messages.ContainerMetadata](/cast/docs/reference/web_receiver/cast.framework.messages.ContainerMetadata)\n\nGet Container Metadata.\n\nReturns\n\n: `nullable `[cast.framework.messages.ContainerMetadata](/cast/docs/reference/web_receiver/cast.framework.messages.ContainerMetadata)\n\n### getCurrentItem\n\ngetCurrentItem() returns [cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem)\n\nReturns the current queue item.\n\nReturns\n\n: `nullable `[cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem)\n\n### getCurrentItemIndex\n\ngetCurrentItemIndex() returns number\n\nReturns the index of the current queue item.\n\nReturns\n\n: `number` The current item index\n\n### getItems\n\ngetItems() returns Array of non-null [cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem)\n\nReturns the queue items.\n\nReturns\n\n: `non-null Array of non-null `[cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem)\n\n### insertItems\n\ninsertItems(items, insertBefore)\n\nInserts items into the queue.\n\n| #### Parameter ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| items | Array of non-null [cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem) Value must not be null. |\n| insertBefore | Optional number ID of the item that will be located immediately after the inserted list. If it is not provided or it is not found, the list will be appended to the end of the queue. |\n\n### removeItems\n\nremoveItems(itemIds)\n\nRemoves items from the queue.\n\n| #### Parameter ||\n|---------|--------------------------------------------------------------------------|\n| itemIds | Array of number The IDs of the items to reorder. Value must not be null. |\n\n### setContainerMetadata\n\nsetContainerMetadata(containerMetadata)\n\nSet Container Metadata.\n\n| #### Parameter ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------|\n| containerMetadata | [cast.framework.messages.ContainerMetadata](/cast/docs/reference/web_receiver/cast.framework.messages.ContainerMetadata) Value may be null. |\n\n### setQueueStatusLimit\n\nsetQueueStatusLimit(limitQueueItemsInStatus)\n\nSets whether to limit the number of queue items to be reported in Media\nStatus (default is true).\n\n| #### Parameter ||\n|-------------------------|---------|\n| limitQueueItemsInStatus | boolean |\n\n### updateItems\n\nupdateItems(items)\n\nUpdates existing queue items by matching itemId.\n\n| #### Parameter ||\n|-------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| items | Array of non-null [cast.framework.messages.QueueItem](/cast/docs/reference/web_receiver/cast.framework.messages.QueueItem) Value must not be null. |"]]
