AxWindowsMediaPlayer (Windows Media Play)控件的常用属性、方法及事件

博主： Arvin
发布时间：2023 年 11 月 07 日
1386 次浏览
暂无评论
7559字数
分类： C#

## 概述

AxWindowsMediaPlayer 对象是 Windows 媒体播放器 控件的根对象。

本案例AxWindowsMediaPlayer控件取名: axPlay

## 常用属性 [表-1]

| 属性名            | 数据类型            | 描述或用法                                                                                                                                                                                      |
| ----------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| URL               | string              | 设置或获取媒体位置，本机或网络地址                                                                                                                                                              |
| uiMode            | string              | 设置或获取播放器的页面显示模式<br />取值范围：Full, Mini, None, Invisible                                                                                                                       |
| playState         | WMPLib.WMPPlayState | 获取播放状态<br />常见取值范围：wmppsStopped(停止)<br />wmppsPaused(暂停)<br />wmppsPlaying(正在播放)<br />wmppsBuffering(正在缓冲)<br />wmppsTransitioning(正在连接)<br />wmppsReady(准备就绪) |
| enableContextMenu | bool                | 是否启用右键菜单                                                                                                                                                                                |
| fullScreen        | bool                | 是否全屏显示                                                                                                                                                                                    |
| Ctlcontrols       | -                   | 播放器控制属性，请查考[表-2]                                                                                                                                                                    |
| settings          | -                   | 播放器基本设置，请查考[表-3]                                                                                                                                                                    |
| currentMedia      | -                   | 播放器当前媒体，请查考[表-4]                                                                                                                                                                    |
| currentPlaylist   | -                   | 播放器当前播放列表，请查考[表-5]                                                                                                                                                                |

```csharp
// 设置播放器的播放路径
axPlay.URL = @"C:\Demo\我爱的人.mp4";
// 设置播放器的页面显示模式
axPlay.uiMode = "Full";
// 获取播放器播放状态
var state = axPlay.playState;
if(state == WMPLib.WMPPlayState.wmppsStopped)
{
    // 播放器已停止播放
}
// 禁用右键菜单
axPlay.enableContextMenu = false;
// 开启全屏显示
axPlay.fullScreen = true;
```

### 播放器基本控制属性常用方法 [表-2] [使用案例: axPlay.Ctlcontrols]

| 方法名/属性名                            | 返回值类型 | 描述或用法                                   |
| ---------------------------------------- | ---------- | -------------------------------------------- |
| axPlay.Ctlcontrols.play()                | void       | 控制播放器进行播放                           |
| axPlay.Ctlcontrols.pause()               | void       | 暂停                                         |
| axPlay.Ctlcontrols.stop()                | void       | 停止                                         |
| axPlay.Ctlcontrols.next()                | void       | 播放下一个媒体元素[需要提供播放列表]         |
| axPlay.Ctlcontrols.previous()            | void       | 播放上一个媒体元素[需要提供播放列表]         |
| axPlay.Ctlcontrols.fastForward()         | void       | 快进                                         |
| axPlay.Ctlcontrols.fastReverse()         | void       | 快退                                         |
| axPlay.Ctlcontrols.currentPosition       | double     | 获取或设置当前播放进度                       |
| axPlay.Ctlcontrols.currentPositionString | string     | 获取当前播放进度,返回字符串格式。如“00:23” |

### 播放器基本控制属性常用方法 [表-3] [使用案例: axPlay.settings]

| 方法名/属性名             | 返回值类型 | 描述或用法            |
| ------------------------- | ---------- | --------------------- |
| axPlay.settings.volume    | int        | 设置或获取音量，0-100 |
| axPlay.settings.autoStart | bool       | 是否自动播放          |
| axPlay.settings.mute      | bool       | 是否开启静音          |
| axPlay.settings.playCount | int        | 播放次数              |

### 播放器基本控制属性常用方法 [表-4] [使用案例: axPlay.currentMedia]

| 方法名/属性名                                                        | 返回值类型 | 描述或用法                                                                                                                                                                                                                                                                |
| -------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| axPlay.currentMedia.duration                                         | double     | 媒体总长度                                                                                                                                                                                                                                                                |
| axPlay.currentMedia.durationString                                   | string     | 媒体总长度，字符串格式。如“03:24”                                                                                                                                                                                                                                       |
| axPlay.currentMedia.getItemInfo(string bstrItemName)                 | string     | 获取当前媒体信息，<br />bstrItemName参数填写字符串如下: <br />"Title"=媒体标题<br />"Author"=艺术家<br />"Copyright"=版权信息<br />"Description"=媒体内容描述<br />"Duration"=持续时间（秒）<br />"FileSize"=文件大小<br />"FileType"=文件类型<br />"sourceURL"=原始地址 |
| axPlay.currentMedia.setItemInfo(string bstrItemName, string bstrVal) | void       | 通过属性名设置媒体信息                                                                                                                                                                                                                                                    |

### 播放器基本控制属性常用方法 [表-5] [使用案例: axPlay.currentPlaylist]

| 方法名/属性名                          | 返回值类型 | 描述或用法                                              |
| -------------------------------------- | ---------- | ------------------------------------------------------- |
| axPlay.currentPlaylist.count           | int        | 当前播放列表所包含媒体数                                |
| axPlay.currentPlaylist.Item[int index] | -          | 获取或设置指定项目媒体信息，其子属性同wmp.currentMedia  |

```csharp
// 使当前播放器播放
axPlay.Ctlcontrols.play();
// 暂停
axPlay.Ctlcontrols.pause();
// 停止
axPlay.Ctlcontrols.stop();
// 播放下一个媒体
axPlay.Ctlcontrols.next();
// 获取或设置当前播放进度
double position = axPlay.Ctlcontrols.currentPosition;
// 获取当前播放进度,返回字符串格式。如“00:23”
string positions = axPlay.Ctlcontrols.currentPositionString;

// 设置音量
axPlay.settings.volume = 50;
// 设置自动播放
axPlay.settings.autoStart = true;
// 开启静音
axPlay.settings.mute = true;
```

如需了解更多，请参阅：[Microsoft Ignite](https://learn.microsoft.com/zh-cn/windows/win32/wmp/axwindowsmediaplayer-object--vb-and-c?redirectedfrom=MSDN)

</div>

最后修改：2023 年 11 月 07 日