萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Silverlight 自定義控件開發:構建功能完整的多媒體視頻播放器

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 時顯示

核心實現:MediaElement 事件處理與狀態機

播放器核心邏輯封裝在 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)
}

控件模板與樣式分離 (Generic.xaml / Themes/Generic.xaml)

**核心原則**:邏輯代碼 (C#) **零** 硬編碼 UI 元素,完全通過 **Template Parts (PART_...)** 和 **Visual States** 與 XAML 模板解耦。設計師可在 Blend 中完全重設計外觀而不動代碼。






    
          ... 控制面板顯示動畫 ...  
         ... 
          ... 顯示 PART_BufferingOverlay ...  
         ... 
          ... 顯示 PART_ErrorOverlay ...  
    
    
          ... 隱藏非視頻區、調整佈局 ...  
         ... 
    

Blend 設計時體驗與開發工作流

  1. 創建控件庫專案:Silverlight Class Library,添加 MediaPlayerControl.cs、PlaybackControlPanel.xaml/.cs、Themes/Generic.xaml。
  2. Blend 打開專案:在 **Assets 面板 → Custom Controls** 找到 MediaPlayerControl,拖入設計面板。
  3. 編輯模板:右鍵控件 → **Edit Template → Edit a Copy** → 創建樣式資源字典。在 **Objects and Timeline** 面板看到視覺樹,可自由增刪改佈局、替換圖標、調整動畫、綁定數據。**零代碼修改外觀**。
  4. 視覺狀態錄製:在 **States 面板** 選擇狀態組 (PlaybackStates/FullscreenStates) 及具體狀態 (Playing/Buffering/Fullscreen),錄製屬性動畫 (Opacity, Visibility, Transform, Color)。
  5. 樣式資源分離:將樣式移至獨立 ResourceDictionary (如 Themes/Generic.xaml、Themes/DarkTheme.xaml),主程式 App.xaml 合併引用,實現**多主題切換**。
  6. 設計時數據:在 Blend 中為 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 授權。
  • 編碼格式:優先 H.264 (MP4) + AAC,Silverlight 5 原生硬解支援最好。HEVC/VP9/AV1 不支援。
  • DRM:Silverlight 支援 PlayReady,需單獨配置 License Server、MediaElement.LicenseAcquirer。
  • 性能:避免 CompositionTarget.Rendering 高頻更新 UI,改用 DispatcherTimer (500ms-1s)。釋放資源:MediaElement.Source=null; MediaElement.Stop(); 卸載視頻。
  • 遷移建議:新項目**強烈建議遷移至 HTML5 (Video.js, MediaElement.js, Plyr, Shaka Player) + MSE/EME** 或 **WPF/WinUI 3/MAUI** (桌面端),Silverlight 瀏覽器支援已終止 (2021/10),僅維舊系統。

總結

通過 **Template Parts 契約**、**Visual States 視覺狀態**、**Dependency Properties 數據綁定**、**DispatcherTimer 低頻 UI 更新**、**Blend 設計時模板編輯**,構建了**邏輯與外觀完全分離、高度可定製、MVVM 友好**的 Silverlight 視頻播放器控件。核心難點在於 **狀態機管理 (MediaElement 事件序列)**、**進度條拖拽與定位同步**、**全屏切換佈局重排**、**播放列表狀態機**。此架構模式可直接遷移至 **WPF/WinUI 3/MAUI/Avalonia** 等現代 XAML 框架,資產復用率極高。

copyright © 萬盛學電腦網 all rights reserved