非常全的javascript控制MediaPlayer的属性集合

MediaPlayer控件的基础控制其实并不复杂，核心的播放、暂停、定位、循环和停止操作，都可以通过简洁的API调用实现。播放调用MediaPlayer.Play()，暂停则是MediaPlayer.Pause()，定位使用MediaPlayer.SetCurrentEntry(lWhichEntry)，配合MediaPlayer.Next()和MediaPlayer.Previous()进行切换。循环控制方面，将MediaPlayer.PlayCount设置为0即可实现无限循环，设为1则只播放一次。停止操作直接调用MediaPlayer.Stop()。这些基本控制构成了播放器交互的骨架。

核心属性详解

在掌握了基础控制之后，真正让播放器“聪明”起来的，是它背后那一整套属性体系。这些属性覆盖了从显示行为到音频控制，再到网络流处理的方方面面。

显示与交互控制：AllowChangeDisplaySize控制用户能否调整显示尺寸，AllowScan决定是否允许扫描播放。AutoSize和AutoStart是两个常用属性，前者控制控件是否自动适应媒体尺寸，后者决定媒体载入后是否自动播放。ClickToPlay则允许用户通过点击图像来暂停或播放剪辑。

音频与播放控制：Balance属性用于立体声平衡调节，-10000为左声道，10000为右声道，0为立体声。Volume控制音量，Mute实现静音切换。Rate可以调整回放帧频，实现快放或慢放效果。AutoRewind决定播放完毕后是否自动回绕到开头。

状态与缓冲管理：PlayState返回当前操作状态，数值从1到10分别对应停止、暂停、播放、缓冲、连接等不同状态。BufferingProgress返回缓冲完成的百分比，BufferingTime则记录缓冲的总时间。ReadyState指示控件是否准备就绪，而OpenState反映内容源的状态。

媒体信息获取：通过currentMedia对象可以获取丰富的媒体信息。Duration返回媒体总长度，DurationString则以“03:24”这样的字符串格式呈现。getItemInfo方法支持获取媒体标题、艺术家、版权信息、文件大小、文件类型等元数据。SourceLink则返回内容文件的路径。

错误与事件处理：HasError指示是否发生错误，ErrorCode和ErrorDescription分别返回错误代码和描述。SendErrorEvents、SendPlayStateChangeEvents等事件开关，控制着控件是否向外部发送特定状态变化通知。

播放控制方法

对于播放器的高级控制，wmp.controls对象提供了完整的操作接口。controls.play、pause、stop分别对应播放、暂停、停止。currentPosition可以获取或设置当前进度，currentPositionString则以字符串格式显示进度。fastForward和fastReverse实现快进快退，next和previous则用于切换曲目。

settings对象则负责播放器的基本设置。volume设置音量，autoStart控制是否自动播放，mute实现静音，playCount设置播放次数。

当需要处理播放列表时，currentPlaylist对象提供了count属性获取媒体数量，Item[integer]则用于获取或设置指定项目的媒体信息，其子属性与currentMedia对象一致。

总体而言，MediaPlayer控件的属性体系覆盖了从底层状态监控到上层交互控制的完整链路。理解这些属性的用途和相互关系，是构建稳定、易用的媒体播放应用的基础。无论是简单的音频播放，还是复杂的流媒体处理，这套属性模型都能提供足够的灵活性和控制力。