Silverlight 雖已停止更新,但在存量企業級應用、內部管理系統、特定行業客戶端中仍有存量維護需求。Silverlight 核心只提供底層 MediaElement,缺乏開箱即用的播放器控件 (播放/暫停、進度條、音量、全屏、播放列表等)。本文基於 **Blend 行為/樣式/模板** 機制,封裝一個**可復用、可定製、MVVM 友好**的自定義視頻播放器控件,涵蓋核心功能點、關鍵事件處理、模板部件契約、狀態管理與樣式分離最佳實踐。
| 功能模塊 | 核心需求 | 技術難點/關鍵點 |
|---|---|---|
| 播放控制 | 播放、暫停、停止、狀態顯示 (Buffering/Playing/Paused/Stopped) | MediaElement.CurrentState 狀態機管理、CurrentStateChanged 事件同步 UI |
| 時間顯示 | 當前播放時間、總時長、剩餘時間 (格式化 HH:mm:ss) | MediaElement.Position (當前)、NaturalDuration (總長,MediaOpened 後可用)、CompositionTarget.Rendering 高頻更新 UI |
| 進度條拖拽 | 拖動 Slider 跳轉播放位置、拖動時預覽縮略圖 (可選) | Slider Thumb.DragStarted/Completed 區分用戶拖動與程序更新、MediaElement.Position = TimeSpan 定位 |
| 全屏切換 | 全屏按鈕、雙擊畫面進入/退出全屏、ESC 退出、多螢幕支援 | Application.Current.Host.Content.IsFullScreen 切換、FullScreenChanged 事件調整佈局、MouseLeftButtonDown 計時判斷雙擊 |
| 音量控制 | 靜音切換、音量滑塊 (0.0-1.0)、持久化記憶 | MediaElement.Volume, IsMuted、Slider 綁定、IsolatedStorage 存儲偏好 |
| 播放列表 | 多視頻順序/隨機/循環播放、列表 UI、當前項高亮、雙擊切換 | ObservableCollection 綁定 ListBox、MediaEnded 事件驅動下一曲、SelectedItem 雙向綁定 |
| 錯誤處理 | 網絡錯誤、格式不支持、解碼失敗、DRM 錯誤友好提示、重試機制 | MediaFailed 事件捕獲 ExceptionRoutedEventArgs.ErrorException、顯示友好提示、記錄日誌、可選重試邏輯 |
| 緩衝指示 | 緩衝進度百分比、緩衝狀態文本 | MediaElement.BufferingProgress (0.0-1.0)、CurrentState=Buffering 時顯示 |
播放器核心邏輯封裝在 MediaPlayerControl : Control (或 UserControl) 中,通過 **Template Parts (PART_...)** 契約與樣式分離。
public class MediaPlayerControl : Control
{
private MediaElement _mediaElement;
private PlaybackControlPanel _playTools; // 模板部件:包含播放/暫停按鈕、進度條、時間顯示、音量、全屏按鈕等
private DispatcherTimer _positionUpdateTimer; // 替代 CompositionTarget.Rendering 降低 CPU 佔用
public override void OnApplyTemplate()
{
base.OnApplyTemplate();
_mediaElement = GetTemplateChild("PART_MediaElement") as MediaElement;
_playTools = GetTemplateChild("PART_PlaybackControls") as PlaybackControlPanel;
if (_mediaElement != null)
{
_mediaElement.MediaOpened += MediaElement_MediaOpened;
_mediaElement.MediaEnded += MediaElement_MediaEnded;
_mediaElement.MediaFailed += MediaElement_MediaFailed;
_mediaElement.CurrentStateChanged += MediaElement_CurrentStateChanged;
_mediaElement.BufferingProgressChanged += MediaElement_BufferingProgressChanged;
// 使用 DispatcherTimer 替代 CompositionTarget.Rendering 更新播放進度 (每 500ms 更新一次,降低 CPU)
_positionUpdateTimer = new DispatcherTimer { Interval = TimeSpan.FromMilliseconds(500) };
_positionUpdateTimer.Tick += (s, e) => UpdatePositionUI();
}
// 綁定播放控制面板事件 (Play/Pause/Stop/Seek/Volume/Fullscreen/Playlist)
if (_playTools != null) { WirePlaybackControlsEvents(); }
}
// 1. 媒體打開成功:獲取總時長,初始化 UI
void MediaElement_MediaOpened(object sender, RoutedEventArgs e)
{
if (_mediaElement.NaturalDuration.HasTimeSpan)
{
_playTools.TotalDuration = _mediaElement.NaturalDuration.TimeSpan;
_playTools.UpdateTotalTimeDisplay();
}
_playTools.CurrentState = MediaElementState.Playing; // AutoPlay=true 時
_positionUpdateTimer.Start();
}
// 2. 播放結束:停止、判斷循環/播放列表下一曲
void MediaElement_MediaEnded(object sender, RoutedEventArgs e)
{
_positionUpdateTimer.Stop();
_mediaElement.Stop(); // 重置狀態
_playTools.CurrentState = MediaElementState.Stopped;
if (IsRepeatCurrent) { _mediaElement.Play(); } // 單曲循環
else if (HasNextInPlaylist) { PlayNextInPlaylist(); } // 列表下一曲
else { _playTools.CurrentState = MediaElementState.Stopped; } // 停在末尾
}
// 3. 錯誤處理
void MediaElement_MediaFailed(object sender, ExceptionRoutedEventArgs e)
{
_positionUpdateTimer.Stop();
string msg = $"播放失敗: {e.ErrorException.Message}";
_playTools.ShowError(msg);
Log.Error(msg, e.ErrorException);
// 可選: 重試邏輯 (指數退避)
}
// 4. 狀態變更同步 UI (播放/暫停/緩衝/停止)
void MediaElement_CurrentStateChanged(object sender, RoutedEventArgs e)
{
_playTools.CurrentState = _mediaElement.CurrentState;
if (_mediaElement.CurrentState == MediaElementState.Buffering)
{
_playTools.BufferingProgress = _mediaElement.BufferingProgress;
_playTools.StatusText = $"緩衝中... {_mediaElement.BufferingProgress:P0}";
}
else if (_mediaElement.CurrentState == MediaElementState.Playing)
{
_playTools.StatusText = "播放中";
}
// ... 其他狀態
}
// 5. 緩衝進度更新
void MediaElement_BufferingProgressChanged(object sender, RoutedEventArgs e)
{
if (_mediaElement.CurrentState == MediaElementState.Buffering)
{
_playTools.BufferingProgress = _mediaElement.BufferingProgress;
}
}
// 定時更新播放位置 UI (替代 CompositionTarget.Rendering)
void UpdatePositionUI()
{
if (_mediaElement.CurrentState == MediaElementState.Playing && _mediaElement.NaturalDuration.HasTimeSpan)
{
_playTools.CurrentPosition = _mediaElement.Position;
_playTools.UpdatePositionDisplay();
}
}
// 公共控制方法 (供模板部件/外部調用)
public void Play() => _mediaElement?.Play();
public void Pause() => _mediaElement?.Pause();
public void Stop() => _mediaElement?.Stop();
public void Seek(TimeSpan position) { if (_mediaElement != null) _mediaElement.Position = position; }
public void SetVolume(double volume) { if (_mediaElement != null) _mediaElement.Volume = Math.Clamp(volume, 0, 1); }
public void ToggleMute() { if (_mediaElement != null) _mediaElement.IsMuted = !_mediaElement.IsMuted; }
public void ToggleFullScreen() { Application.Current.Host.Content.IsFullScreen = !Application.Current.Host.Content.IsFullScreen; }
// 依賴屬性: Source, AutoPlay, IsRepeat, Playlist (ObservableCollection) 等
// 模板部件契約: PART_MediaElement (MediaElement), PART_PlaybackControls (PlaybackControlPanel)
}
**核心原則**:邏輯代碼 (C#) **零** 硬編碼 UI 元素,完全通過 **Template Parts (PART_...)** 和 **Visual States** 與 XAML 模板解耦。設計師可在 Blend 中完全重設計外觀而不動代碼。
... 控制面板顯示動畫 ...
...
... 顯示 PART_BufferingOverlay ...
...
... 顯示 PART_ErrorOverlay ...
... 隱藏非視頻區、調整佈局 ...
...
MediaPlayerControl.cs、PlaybackControlPanel.xaml/.cs、Themes/Generic.xaml。MediaPlayerControl,拖入設計面板。ResourceDictionary (如 Themes/Generic.xaml、Themes/DarkTheme.xaml),主程式 App.xaml 合併引用,實現**多主題切換**。PlaybackControlPanel 設置 **Design-time DataContext** (模擬播放列表、時間、狀態),所見即所得調整列表項模板、進度條樣式。// 播放項數據模型
public class MediaItem : INotifyPropertyChanged
{
public string Title { get; set; }
public Uri Source { get; set; }
public TimeSpan Duration { get; set; }
public ImageSource Thumbnail { get; set; }
// ... INotifyPropertyChanged 實現
}
// 播放器屬性
public ObservableCollection Playlist { get; } = new();
public MediaItem CurrentItem { get; private set; }
// 播放列表邏輯 (簡化)
void PlayNextInPlaylist()
{
int idx = Playlist.IndexOf(CurrentItem);
if (idx >= 0 && idx + 1 < Playlist.Count)
{
CurrentItem = Playlist[idx + 1];
Source = CurrentItem.Source; // 觸發 MediaElement 重新加載
Play();
}
}
// ListBox ItemTemplate 綁定 Title/Thumbnail/Duration,SelectedItem 雙向綁定 CurrentItem
// 雙擊/Enter 命令 -> PlaySelectedItem()
clientaccesspolicy.xml / crossdomain.xml 授權。MediaElement.LicenseAcquirer。CompositionTarget.Rendering 高頻更新 UI,改用 DispatcherTimer (500ms-1s)。釋放資源:MediaElement.Source=null; MediaElement.Stop(); 卸載視頻。通過 **Template Parts 契約**、**Visual States 視覺狀態**、**Dependency Properties 數據綁定**、**DispatcherTimer 低頻 UI 更新**、**Blend 設計時模板編輯**,構建了**邏輯與外觀完全分離、高度可定製、MVVM 友好**的 Silverlight 視頻播放器控件。核心難點在於 **狀態機管理 (MediaElement 事件序列)**、**進度條拖拽與定位同步**、**全屏切換佈局重排**、**播放列表狀態機**。此架構模式可直接遷移至 **WPF/WinUI 3/MAUI/Avalonia** 等現代 XAML 框架,資產復用率極高。