Controls 对象

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

Controls 对象提供了一种使用以下属性和方法操作媒体播放的方法。

Controls 对象支持以下属性。

属性	说明
audioLanguageCount	检索支持的音频语言的数量。
currentAudioLanguage	指定或检索用于播放的音频语言的区域设置标识符 (LCID)
currentAudioLanguageIndex	指定或检索与用于播放的音频语言相对应的从 1 开始的索引。
currentItem	指定或检索当前媒体项。
currentMarker	指定或检索当前标记编号。
currentPosition	指定或检索媒体项中的当前位置（以秒为单位）。
currentPositionString	以 字符串的形式检索媒体项中的当前位置。
currentPositionTimecode	使用时间代码格式指定或检索当前媒体项中的当前位置。 此属性当前支持 SMPTE 时间代码。
isAvailable	检索指定类型的信息是否可用，或者是否可以执行给定操作。

 

Controls 对象支持以下方法。

方法	说明
fastForward	开始向前方向快速播放媒体项。
fastReverse	反向启动媒体项的快速播放。
getAudioLanguageDescription	检索与指定的从 1 开始的索引对应的音频语言的说明。
getAudioLanguageID	检索指定音频语言索引的 LCID。
getLanguageName	检索具有指定 LCID 的音频语言的名称。
下一步	将当前项目设置为播放列表中的下一项。
pause	暂停媒体项的播放。
玩游戏	使媒体项开始播放。
playItem	导致当前媒体项开始播放，或恢复播放暂停的项。
previous	将当前项设置为播放列表中的上一项。
step	导致当前视频媒体项冻结下一帧的播放。
stop	停止播放媒体项。

 

通过以下属性访问 Controls 对象。

Object	属性
播放器	控制

 

另请参阅

用于脚本的对象模型参考