[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eIn addition to content organization, developers need to determine playback controls and queue implementation for their car apps.\u003c/p\u003e\n"],["\u003cp\u003eCar makers provide basic playback controls; developers can add custom actions and queues for more functionality.\u003c/p\u003e\n"],["\u003cp\u003eCustom action icons should be monochrome, vector-based, and dynamically change to reflect state for consistency and glanceability.\u003c/p\u003e\n"],["\u003cp\u003eIf implemented, queues should include an indicator for the currently playing item and might include thumbnails or elapsed time.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should refer to linked resources for details on implementing custom actions and playback interface examples.\u003c/p\u003e\n"]]],[],null,["# Customize playback controls\n\n\u003cbr /\u003e\n\nIn addition to deciding how your app content is organized for navigating and browsing, you need to decide whether you want a queue or any custom controls for playing the content.\n\nCar makers take care of implementing and styling the playback view, minimized control bar, and queue. They also provide a basic set of playback controls, including Play/Pause, Next, Previous, and Overflow. If these controls are sufficient for your app, then you're done.\n\nHowever, if you want to provide a queue or access to additional playback actions beyond the ones that car makers provide, you need to decide:\n\n- Whether to display thumbnails for queue items\n- Whether to display an icon or elapsed time for the currently playing item in the queue\n- Whether to include previously played items in the queue\n- Which custom actions you want on the control bar, and whether they should replace the car makers' Next and Previous controls\n- What the icons representing the relevant states of each action (such as available and disabled) will look like\n\nFor examples of the playback interface, visit [Playing media](/cars/design/automotive-os/apps/media/interaction-model/playing-media).\n| **Note:** Custom actions display in the order in which they are added to the PlaybackState. Their icons are specified as icon resources. For details, consult [Add custom playback actions](https://developer.android.com/training/cars/media/#custom-icons).\n\n*** ** * ** ***\n\nPlayback control guidelines\n---------------------------\n\n| Requirement level | Guidelines |\n|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **MUST** | App developers must: - Provide monochrome (black or white) vector icons for any custom actions they add, and change them dynamically to indicate state |\n| **SHOULD** | App developers should: - If using text (including numbers) in an icon, utilize the maximum space in the bounding box to make the text as large and readable as possible |\n| **MAY** | App developers may: - Provide monochrome (black or white) vector icons for up to 8 custom actions |\n\n**Rationale:**\n\n- **Consistent app UI:** App developers need to align the interfaces for custom actions in media apps with similar actions familiar to their users on other devices.\n- **Glanceability:** Text can appear smaller when paired with iconography, so text in icons should be maximized within the available space.\n\n*** ** * ** ***\n\nQueue guidelines\n----------------\n\nThe following considerations apply if you decide to implement a queue to allow users to view currently playing and upcoming content.\n\n| Requirement level | Guidelines |\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| **SHOULD** | App developers should: - Provide an indicator for the currently playing queue item - Include previously played items in the queue |\n| **MAY** | App developers may: - Provide thumbnails for queue items - Indicate the currently playing item with either an icon or by displaying elapsed time |\n\n| **Note:** Car makers can choose to disable the display of thumbnails. They can also choose to disable display of icons and elapsed time for the currently playing item.\n\n**Rationale:**\n\n- **Glanceable UI:** Users should be able to see what's currently playing at a glance."]]