Vega媒体控制的属性和功能

您的应用接收的命令和属性由清单配置中的三种机制决定：核心命令和属性（始终无需任何配置进行交付）、可选命令（通过command_options单独启用）以及功能受限命令和属性（通过features在组中启用）。以下各部分描述了每个命令和属性及其启用方式。

有关实现细节和代码示例，请参阅开始使用Vega媒体控制。

核心属性

这些属性始终可用，无需任何额外的清单配置：

• ActiveMediaId
• ActiveVideo
• AvailableActions
• AvailableBackwardSkip
• AvailableForwardSkip
• AvailableRatings
• AvailableSpeeds
• CurrentRating
• CurrentState
• CustomControlsState
• MediaSessionStates
• RepeatMode
• ShuffleEnabled

功能受限的属性

这些属性仅在features数组中包含其相应功能时才可用：

属性	必需功能
Duration	AdvancedSeek
PlaybackSpeed	AdvancedSeek
SampledPosition	AdvancedSeek
SeekRangeEnd	AdvancedSeek
SeekRangeStart	AdvancedSeek
StartTime	AdvancedSeek
ActiveAudioTrack	AudioTracks
AvailableAudioTracks	AudioTracks
ActiveTextTrack	TextTracks
AvailableTextTracks	TextTracks

核心命令

这些命令始终可用，无需任何额外的清单配置：

• EnableShuffle
• GetMediaSessionState
• GetMetadata
• Pause
• 播放
• SendCustomAction
• SetAudioVolume
• SetPlaybackSpeed
• SetRating
• SetRepeatMode
• Stop
• TogglePlayPause

功能受限的命令

这些命令仅在features数组中包含其相应功能时才可用：如果您未纳入该功能，则即使您实现了处理程序，您的应用也不会收到这些命令。

命令	必需功能
FastForward	VariableSpeed
快退	VariableSpeed
Seek	AdvancedSeek
ActivateAudioTrack	AudioTracks
ActivateTextTrack	TextTracks
DeactivateTextTrack	TextTracks

可选命令

通过将以下命令添加到清单中的command_options数组中，可以单独启用这些命令。如果您未在此处列出命令，则您的应用将不会收到对该命令的请求：

• 下一个
• Previous
• SkipBackward
• SkipForward
• StartOver

功能

您可以为Vega媒体控制指定以下功能。每个功能都启用一组相关的命令和属性。

• AdvancedSeek — 启用搜索功能和基于时间的播放属性。
  • 提供的属性
    • Duration
    • PlaybackSpeed
    • SampledPosition
    • SeekRangeEnd
    • SeekRangeStart
    • StartTime
  • 提供的命令
    • Seek
• AudioTracks — 启用音轨选择。
  • 提供的属性
    • ActiveAudioTrack
    • AvailableAudioTracks
  • 提供的命令
    • ActivateAudioTrack
• TextTracks — 启用文本轨道（字幕/标题）显示。
  • 提供的属性
    • ActiveTextTrack
    • AvailableTextTracks
  • 提供的命令
    • ActivateTextTrack
    • DeactivateTextTrack
• VariableSpeed — 启用快进和快退命令。您必须纳入此功能才能接收FastForward和Rewind事件。
  • 提供的命令
    • FastForward
    • Rewind

相关主题

• 开始使用Vega媒体控制
• Vega媒体控制概述

---

Last updated: 2026年3月31日