C# 中的AxWindowsMediaPlayer控件使用详解

5星 · 超过95%的资源 需积分: 10 3 下载量 93 浏览量 更新于2024-09-21 收藏 14KB TXT 举报
"这篇文章主要介绍了C#中的MediaPlayer控件及其属性的使用方法,包括如何创建、设置URL播放媒体以及常见的属性和方法。" 在C#编程中,开发人员经常使用MediaPlayer控件来处理音频和视频播放。这个控件是.NET Framework提供的一种功能强大的工具,允许在应用程序中集成多媒体播放功能。为了正确地使用MediaPlayer,你需要了解其关键的属性和方法。 首先,创建一个MediaPlayer控件并不复杂。通常,你可以直接在Visual Studio的设计视图中拖放AxWindowsMediaPlayer控件,或者在代码中实例化它。代码示例如下: ```csharp AxWMPLib.AxWindowsMediaPlayer wmp = new AxWMPLib.AxWindowsMediaPlayer(); this.Controls.Add(wmp); ``` 接下来,设置MediaPlayer的URL属性来指定要播放的媒体文件,如: ```csharp wmp.URL = "music.mp3"; ``` 然后,通过调用Ctlcontrols.play()方法开始播放: ```csharp wmp.Ctlcontrols.play(); ``` 在实际应用中,你可能需要处理一些其他属性和方法,例如: - `wmp.settings`: 这个对象提供了对播放设置的访问,比如音量、循环播放等。例如,`wmp.settings.setMode("loop", true)`将使媒体循环播放。 - `wmp.currentPlaylist`: 表示当前播放列表。你可以添加或删除媒体项目。例如,`wmp.currentPlaylist.appendItem(wmp.newMedia("anotherSong.mp3"))`将新的媒体项添加到播放列表。 - `wmp.controls`: 提供了控制播放的命令,如暂停、停止、快进、快退等。例如,`wmp.controls.pause()`将暂停播放。 - `wmp.currentMedia`: 返回当前正在播放的媒体对象,你可以获取或设置与此媒体相关的属性,如播放时间、总时长等。 - `wmp.isPlaying`: 用于检查媒体是否正在播放。 - `wmp.fullScreen`: 控制媒体是否全屏播放。 在使用AxWindowsMediaPlayer控件时,需要注意一些潜在的问题。例如,如果在窗体初始化期间尝试调用播放方法,可能会导致`System.Windows.Forms.AxHost+InvalidActiveXStateException`异常。为了避免这种情况,你应该确保所有操作都在控件完全加载之后进行,通常在`EndInit()`方法之后。 此外,资源管理也非常重要。使用完MediaPlayer控件后,应释放资源,避免内存泄漏。这可以通过设置控件的Visible属性为false或调用Dispose方法来实现。 最后,关于`.OcxState`属性,它是用来保存控件的某些非托管状态(即COM组件的状态)。当从资源文件中加载控件时,`OcxState`用于恢复控件的初始状态。如果你在代码中动态创建控件,记得使用BeginInit()和EndInit()方法来正确初始化和结束初始化过程,以确保`.OcxState`的正确应用。 理解和熟练使用C#的MediaPlayer控件及其属性是创建多媒体应用程序的关键步骤。通过掌握这些基础知识,你可以创建出功能丰富的媒体播放应用。
2016-07-06 上传
1、基本属性  URL 指定媒体位置,本机或网络地址 例如:axWindowsMediaPlayer1.URL = @"f:\aa.mp3"; uiMode 播放器界面模式,可为Full, Mini, None, Invisible ;Full:有下面的控制条; None:只有播放部份没有控制条 例如:axWindowsMediaPlayer1.uiMode = "Invisible"; playState 播放状态,1=停止,2=暂停,3=播放,6=正在缓冲,9=正在连接,10=准备就绪 enableContextMenu 启用/禁用右键菜单 fullScreen 是否全屏显示 stretchToFit 非全屏状态时是否伸展到最佳大小 2、播放器基本控制 Ctlcontrols.play(); 播放 Ctlcontrols.pause(); 暂停 Ctlcontrols.stop(); 停止 Ctlcontrols.currentPosition 当前进度 Ctlcontrols.currentPositionString 当前进度,字符串格式。如“00:23” Ctlcontrols.fastForward(); 快进 Ctlcontrols.fastReverse(); 快退 Ctlcontrols.next(); 下一曲 Ctlcontrols.previous(); 上一曲 3、播放器基本设置 settings.volume 音量,0-100 settings.balance 声道,通过它应该可以进行立体声、左声道、右声道的控制。 settings.autoStart 是否自动播放 settings.mute 是否静音 settings.playCount 播放次数 settings.rate 播放速度 4、当前媒体属性 currentMedia.duration 媒体总长度 currentMedia.durationString 媒体总长度,字符串格式。如“03:24” currentMedia.getItemInfo(const string) 获取当前媒体信息"Title"=媒体标题,"Author"=艺术家,"Copyright"=版权信息,"Description"=媒体内容描述,"Duration"=持续时间(秒),"FileSize"=文件大小,"FileType"=文件类型,"sourceURL"=原始地址 currentMedia.setItemInfo(const string) 通过属性名设置媒体信息 currentMedia.name 同 currentMedia.getItemInfo("Title")
2009-12-28 上传
MediaPlayer控件属性描述 属性 描述 AllowChangeDisplaySize 返回或设置最终用户是否能设置显示尺寸(逻辑型) AllowScan 返回或设置是否允许扫描(逻辑型) AnimationAtStart 返回或设置控件开始播放之前是否先播放一个动画序列(逻辑型) AudioStream 返回或设置音频流的编号(用于多音频流的剪辑,默认为-1)(长整型) AutoRewind 返回或设置媒体文件播放完毕后是否自动回绕(逻辑型) AutoSize 返回或设置是否自动调整控件大小来适应载入的媒体(逻辑型) AutoStart 返回或设置在载入媒体文件之后是否自动开始播放(逻辑型) Balance 返回或设置指定立体声媒体文件的播放声道(-10000为左声道,10000为右声道,0为立体声)(长整型) Bandwidth 返回或设置当前文件的带宽(长整型) BaseURL 返回基本的 HTTP URL(字符串) BufferingCount 返回媒体文件回放时缓冲的总时间(长整型) BufferingProgress 返回缓冲完成的百分比(长整型) BufferingTime 返回缓冲的时间(双精度型) CanPreview 返回或设置当前显示的剪辑是能否被预览(逻辑型) CanScan 返回或设置当前文件是否支持快进或快退(逻辑型) CanSeek 返回或设置当前文件是否能搜索并定位到某个时间(逻辑型) CanSeekToMarkers 返回或设置文件是否支持搜索到标签(逻辑型) CaptioningID 返回在标题中显示的帧或控件的名称(字符串) ChannelDescription 返回电台的描述(字符串) ChannelName 返回电台的名称(字符串) ChannelURL 返回电台的元文件的位置(字符串) ClickToPlay 返回或设置是否可以通过点击图像暂停或播放剪辑(逻辑型) ClientID 返回客户端唯一的标识符(字符串) CodecCount 返回文件使用的可安装的 codecs 的个数(长整型) ContactAddress 返回电台的联系地址(字符串) ContactEmail 返回电台的联系电子邮件地址(字符串) ContactPhone 返回电台的联系电话(字符串) CreationDate 返回剪辑的创建日期(日期型) CurrentMarker 返回或设置当前书签号码(长整型) CurrentPosition 返回或设置剪辑的当前位置(双精度型) CursorType 返回或设置指针类型(长整型) DefaultFrame 返回或设置控件的默认目标 Http 帧(字符串) DisplayBackColor 返回或设置显示面板的背景色(OLE_COLOR 值) DisplayForeColor 返回或设置显示面板的前景色(OLE_COLOR 值) DisplayMode 返回或设置显示面板是否用秒或帧的形式显示当前位置(MPDisplayModeConstants 值) DisplaySize 返回或设置图像显示窗口的大小(MPDisplaySizeConstant 值) Duration 返回或设置剪辑剪辑的播放时间(双精度型) EnableContextMenu 返回或设置是否允许使用上下文菜单(逻辑型) Enabled 返回或设置控件是否可用(逻辑型) EnableFullScreenControls 返回或设置全屏幕控制是否可用(逻辑型) EnablePositionControls 返回或设置位置控制是否可用(逻辑型) EnableTracker 返回或设置搜索栏控制是否可用(逻辑型) ErrorCode 返回当前错误代码(长整型) ErrorCorrection 返回当前剪辑的错误修正类型(长整型) ErrorDescription 返回当前错误的描述(字符串) FileName 返回或设置要播放的剪辑的文件名称(字符串) HasError 返回控件是否发生错误(逻辑型) HasMultipleItems 返回或设置控件是否包含某些多重项目的内容(逻辑型) ImageSourceHeight 返回或设置当前剪辑的原始图像高度(长整型) ImageSourceWidth 返回或设置当前剪辑的原始图像宽度(长整型) InvokeURLs 返回或设置 URL 是否自动发送请求(逻辑型) IsBroadcast 返回或设置源是否进行广播(逻辑型) IsDurationValid 返回或设置持续时间值是否有效(逻辑型) Language 返回或设置用于本地化语言支持的当前区域语言(长整型) LostPackets 返回丢失的数据包数量(长整型) MarkerCount 返回文件书签的数量(长整型) Mute 返回或设置控件是否播放声音(逻辑型) OpenState 返回控件的内容源状态(长整型) PlayCount 返回或设置一个剪辑播放的次数(长整型) PlayState 返回控件的当前操作状态(长整型) PreviewMode 返回或设置控件是否处在预览模式(逻辑型) Rate 返回或设置回放帧频(双精度型) ReadyState 返回控件是否准备就绪(ReadyStateConstant 值) ReceivedPackets 返回已接收到的数据包的数量(长整型) ReceptionQuality 返回最后 30 秒接收到的数据包的百分比(长整型) RecoveredPackets 返回已转换的数据包的数量(长整型) SAMIFileName 返回或设置 closed-captioning 文件名(字符串) SAMILang 返回或设置 closed captioning 语言(字符串) SAMIStyle 返回或设置 closed captioning 风格(字符串) SelectionEnd 返回或设置流的结束位置(双精度型) SelectionStart 返回或设置流的起始位置(双精度型) SendErrorEvents 返回或设置控件是否发送错误事件(逻辑型) SendKeyboardEvents 返回或设置控件是否发送键盘事件(逻辑型) SendMouseClickEvents 返回或设置控件是否发送鼠标单击事件(逻辑型) SendMouseMoveEvents 返回或设置控件是否发送鼠标移动事件(逻辑型) SendOpenStateChangeEvents 返回或设置控件是否发送打开状态改变事件(逻辑型) SendPlayStateChangeEvents 返回或设置控件是否发送播放状态改变事件(逻辑型) SendWarningEvents 返回或设置控件是否发送警告事件(逻辑型) ShowAudioControls 返回或设置是否显示音频控制(逻辑型) ShowCaptioning 返回或设置是否显示字幕(逻辑型) ShowControls 返回或设置控制面板是否可见(逻辑型) ShowDisplay 返回或设置是否显示显示面板(逻辑型) ShowGotoBar 返回或设置是否显示跳转栏(逻辑型) ShowPositionControls 返回或设置是否显示位置控制(逻辑型) ShowStatusBar 返回或设置是否显示状态栏(逻辑型) ShowTracker 返回或设置是否显示搜索栏(逻辑型) SourceLink 返回内容文件的路径(字符串) SourceProtocol 返回用于接收数据的协议(长整型) StreamCount 返回媒体帧的数量(长整型) TransparentAtStart 返回或设置在开始播放之前和停止之后控件是否透明(逻辑型) VideoBorder3D 返回或设置视频边框是否显示为 3D 效果(逻辑型) VideoBorderColor 返回或设置视频边框的颜色(OLE_颜色) VideoBorderWidth 返回或设置视频边框的宽度(长整型) Volume 返回或设置音量(长整型)