Jwt3.3.0文档翻译：类WMediaPlayer，Class WMediaPlayer

这是一个媒体播放器。

这个部件实现了媒体播放器的功能，可用于播放视频或音频，并且其界面是可自定义的。

为了能够实现跨浏览器播放视频或音频内容，妳需要提供已经按照适当的方式编码好的文件内容。对于音频内容，最少要提供一个MP3 或MP4 音频（M4A）内容，而对于视频内容，应当提供M4V内容。如果妳还能提供其它格式的内容那更好，因为它们增加了使用原生的HTML <video> 或 <audio> 元素（因而有可能是使用了硬件加速的）的机率，这样就不需要使用flash 播放器了。参考 HTML5浏览器多媒体支持 。

妳需要在实例化这个媒体播放器的时候就指定所要播放的内容编码类型，因为它需要根据具体的编码类型来选择使用一个适当的实现方式。所以，妳需要立即调用 addSource() ，不过呢，如果妳当时还不想载入多媒体内容的话也可以向它设置空的URL。

这个播放器提供了一个用于控制播放过程的界面，这个界面可以随意自定义，并且与底层的媒体播放技术（HTML视频或Flash播放器）无关。用于控制的用户界面可以实现为一个JWt 部件，它的控件（按钮、进度条和文字部件）会直接与视频播放器组件（浏览器端）绑定在一起。

这个部件依赖一个第三方JavaScript 组件jPlayer ，它是随Wt 一起发布的。

默认的用户界面可使用jPlayer 主题来自定义。这个主题是全局的（对所有的媒体播放器实例都有效），是通过载入一个 CSS 样式单来进行配置的。

或者，也可以使用 setControlsWidget() 来设置一个自定义的部件来替换默认的控制组件。在这种情况下，妳应当向那个部件添加按钮、文字占位符和进度条，并且使用 setButton() 、 setText() 和 setProgressBar() 方法来将它们与媒体播放器绑定起来。这个控制部件会被整合至媒体播放器中，这样做（对于视频播放器）有一个独一无二的好处，当视频播放器被最大化时，它们也会显示出来。

最后，妳也许还想要只通过位于媒体播放器之外的部件来控制这个媒体播放器。这一点可以通过将控制部件属性（controlsWidget）设置为 null 来实现。然而，在这种情况下，不应当使用全屏模式，因为无法再恢复到之前的尺寸了。

赵欣瑜