媒体进度指示器
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
媒体进度指示器组件是媒体应用独有的组件。
进度指示器直观显示媒体来源的时长和已播放时长。播放期间,它会显示在媒体应用中。
解剖学
媒体进度指示器由两个部分组成:一是表示媒体来源时长的无效轨道(以灰色显示),另一组以强调色显示的有效轨道,与非活跃轨道叠加以指示已播放时长。
1. 有效轨道
2. 无效轨道
媒体进度指示器可以是线性或圆形。
线性进度指示器在横轴上显示时长和已播放时间。轨道的可见部分位于 76dp 触摸目标区域的中心。点按或拖动经过的时间可允许用户移至媒体来源中的不同位置。线性媒体进度指示器适用于高度为 800dp 或更高的屏幕。
圆形进度指示器以圆形的形式显示时长和经过的时间。通过点按或拖动经过的时间,无法移动到其他位置。圆形媒体进度指示器适用于高度小于 800dp 的屏幕,以及当媒体播放控件最小化时使用。
在播放过程中,进度指示器处于以下四种状态之一:
- 正在播放:媒体正在播放,有效曲目会跳过无效曲目,以表示已播放时长。
- 已暂停:用户暂停了播放。当前曲目在播放暂停处处于静止状态。
- 正在缓冲:媒体应用正在加载要播放的内容。该指示器会显示一条白线,当内容加载时,该白线反复穿过无效轨道。
- 错误:无法播放媒体。没有有效轨道,且无效轨道已停用。
播放状态:当媒体播放时,有效轨道会跨越无效轨道。
暂停状态:当媒体播放暂停时,有效轨道处于静止状态。
缓冲状态:内容加载时,一条白线反复穿过无效轨道。
错误状态:当发生媒体错误时,不会显示任何有效轨道,并且会停用无效轨道。
规格
线性媒体进度指示器
圆形媒体进度指示器
自定义
在媒体播放期间,系统会使用强调色显示媒体进度指示器的活动轨道。默认的强调色是蓝色阴影。应用开发者可以选择提供能够反映其媒体品牌的应用强调色。同样,OEM 可以提供能够反映其汽车品牌的强调色。如果提供强调色,则 OEM 强调色优先于应用的强调色。
进度指示器的默认样式为蓝色。应用开发者可以用自己品牌的强调色(本例中为绿色)替换默认应用样式。原始设备制造商 (OEM) 也可以用自己品牌的强调色(本例中为橙色)替换默认样式和应用样式。
应用于圆形进度指示器的默认、应用和 OEM 强调色样式示例
车载设备界面库集成指南提供了有关自定义组件的 OEM 指南。
有关使用颜色自定义组件的具体指南,请参阅颜色。
示例
媒体应用播放视图中的线性媒体进度指示器
在本例中,圆形媒体进度指示器显示在最小化播放控件上。最小化的控件会叠加在播放列表屏幕之上。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):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"]],["最后更新时间 (UTC):2025-07-25。"],[],[]]