用途:在 WPF 应用中集成图片、视频与音频等多媒体内容,覆盖 Image 控件、MediaElement 与 SoundPlayer/SoundPlayerAction 三类方案。
主要能力:Image 控件支持资源、绝对路径与 URI 三种来源,Stretch 可选 None、Fill、Uniform、UniformToFill;提供 ImageHelper 从文件、流、Base64 加载 BitmapImage,支持 DecodePixelWidth/Height 生成缩略图、CacheOption.OnLoad 与 Freeze() 以便跨 UI 线程使用,并可监听 DownloadCompleted、DownloadFailed、DownloadProgress 事件。MediaElement 支持视频与音频播放,LoadedBehavior 可选 Play、Pause、Stop、Manual、Close,配合 MediaOpened、MediaEnded、MediaFailed 事件;示例给出含播放/暂停/停止按钮、进度滑块、时间显示与音量滑块的 VideoPlayerControl。音频方面可用 MediaElement 播放 mp3,或用 SoundPlayer 播放 WAV(Play 异步、PlaySync 同步、Load 预加载),也可在 XAML 中用 SoundPlayerAction 绑定事件触发音效。
使用方式:在 XAML 中声明控件并设置 Source、LoadedBehavior 等属性,在代码后置中处理事件与调用 Play/Pause/Stop、Position、Volume;动态加载时用 BeginInit/EndInit 配置 BitmapImage。
适用场景:需要展示图片、播放视频或音频、实现自定义播放器与图片画廊的 WPF 桌面应用。
限制:SoundPlayer 仅支持 WAV;资料未提供 NuGet 包、安装命令、收费与平台支持信息;画廊与性能优化细节指向 references/media-gallery.md,正文未展开。