Silverlight实例教程 - Out of Browser音乐播放器

在上一篇，我们了解了如何在Silverlight的Out of Browser模式下进行Debug调试，另外学习Silverlight OOB应用的一个新特性Notifications窗口。本篇，我们将结合以往的Out of Browser特性，创建一款新的Out of Browser实例，音乐播放器。该实例目的比较简单，实现音乐播放，实现音乐文件列表读取，实现音乐文件信息读取，另外音乐播放自动跳转等功能。

在实例开始前，我们仍旧需要了解一些基础知识。Silverlight对音频的支持是使用MediaElement类，该类使用方法非常简单，该类的详细解释，请看MSDN

1 <MediaElement
2     x:Name="media"
3     Source="xbox.wmv"
4     CurrentStateChanged="media_state_changed"
5     Width="300" Height="300"/>

在了解了音频播放类的简单使用后，让我们先看看项目完成后的效果图，

从上面效果图中可以看出整个实例项目UI分5个部分，

1. 音频控制部分，这部分是实例主要功能；

2. 音频文件信息部分，这部分是获取显示当前和下一首音乐文件信息；

3. 唱片图片信息，其实这部分也是属于音频文件信息，不过这里单独列出来，使用独立的类进行处理；

4. 音频文件列表，该列表是载入My Music目录中的音乐文件，并支持用户选择播放功能；

5. UI控制，该部分可以使播放器进入最小化状态。例如：

下面我们开始分别解释以上几个部分的实例设计方法。

我们仍旧使用SilverlightOOBDemo项目，不过为了使代码更清晰易读，这次不再使用OutofBrowserMainPage作为OOB应用主界面，我们重新创建一个新的OOB应用界面OutofBrowserMusicPlayer。

为了修改启动页面为OutofBrowserMusicPlayer，为此，我们需要修改App.xaml中的启动页面代码:

1 private void Application_Startup(object sender, StartupEventArgs e)
2 {
3             if (!Application.Current.IsRunningOutOfBrowser)
4             {
5                 this.RootVisual = new MainPage();
6             }
7             else
8             {
9                 //this.RootVisual = new OutofBrowserMainPage();
10                 this.RootVisual = new OutofBrowserMusicPlayer();
11             }
12
13 }

根据实例需求，我们最主要的功能就是播放音乐，所以，我们第一步首先实现Out of Browser应用音频控制。

1. 创建自定义音频控制控件；

对于音频控制，这里我们使用了自定义控件控制音乐的播放。AudioControl.xaml控件，

这里我仅贴上部分代码，大家可以在文章最后下载完整源代码。

1 <Grid x:Name="LayoutRoot">
2         <Grid.ColumnDefinitions>
3             <ColumnDefinition Width="Auto" />
4             <ColumnDefinition Width="*" />
5             <ColumnDefinition Width="25" />
6             <ColumnDefinition Width="Auto" />
7             <ColumnDefinition Width="Auto" />
8         </Grid.ColumnDefinitions>
9         <Grid Grid.Column="0" Margin="0,0,0,0" HorizontalAlignment="Left" VerticalAlignment="Center" x:Name="gridCol1">
10             <ToggleButton Cursor="Hand" Margin="0,0,0,0" x:Name="btnPlay" RenderTransformOrigin="0.5,0.5" Template="{StaticResource playControlTemplate}">
11                 <ToggleButton.RenderTransform>
12                     <TransformGroup>
13                         <ScaleTransform ScaleX="1" ScaleY="1"/>
14                         <SkewTransform/>
15                         <RotateTransform/>
16                         <TranslateTransform/>
17                     </TransformGroup>
18                 </ToggleButton.RenderTransform>
19             </ToggleButton>
20         </Grid>
21         <Grid Grid.Column="1" Margin="0,0,0,0" HorizontalAlignment="Stretch" x:Name="gridCol2" VerticalAlignment="Center">
22             <Grid.ColumnDefinitions>
23                 <ColumnDefinition Width="*" />
24                 <ColumnDefinition Width="40" />
25                 <ColumnDefinition Width="10" />
26                 <ColumnDefinition Width="40" />
27             </Grid.ColumnDefinitions>
28             <TextBlock x:Name="tbCurrentTime" Margin="0,1.5,0,0"  Height="12" FontFamily="Verdana" FontSize="10" Text="00:00" TextWrapping="Wrap" Foreground="#FFFFFFFF" FontStyle="Normal" HorizontalAlignment="Right" TextAlignment="Right" Grid.Column="1"/>
29             <TextBlock Margin="0,1.5,0,0"  Height="12" FontFamily="Verdana" FontSize="10" Text="/" TextWrapping="Wrap" Foreground="#FFFFFFFF" FontStyle="Normal" HorizontalAlignment="Center" TextAlignment="Right" Grid.Column="2"/>
30             <TextBlock x:Name="tbTotalTime" Margin="0,1.5,0,0"  Height="12" FontFamily="Verdana" FontSize="10" Text="00:00" TextWrapping="Wrap" Foreground="#FFFFFFFF" FontStyle="Normal" HorizontalAlignment="Left" TextAlignment="Right" Grid.Column="3"/>
31             <local:MediaSlider Margin="0,1.5,0,0" HorizontalAlignment="Stretch" Maximum="100" x:Name="sliderTimeline" Style="{StaticResource progressSliderStyle}" Grid.Column="0" Value="0" Visibility="Visible"/>
32         </Grid>
33         <Grid Grid.Column="2" Margin="4,0,4,0" HorizontalAlignment="Stretch" x:Name="gridCol3" VerticalAlignment="Center">
34             <local:Spinner Margin="0,0,0,0" x:Name="spinner" Width="17" Height="17" HorizontalAlignment="Center" VerticalAlignment="Center"/>
35         </Grid>
36         <Grid Grid.Column="3" Margin="0,10.30,0,10.30" HorizontalAlignment="Stretch" x:Name="gridCol4" Width="70" VerticalAlignment="Stretch" d:LayoutOverrides="Height">
37             <Grid Margin="0,0,0,0" HorizontalAlignment="Right" VerticalAlignment="Center" Width="70">
38                 <Grid.ColumnDefinitions>
39                     <ColumnDefinition Width="Auto" />
40                     <ColumnDefinition Width="*" />
41                 </Grid.ColumnDefinitions>
42                 <ToggleButton HorizontalAlignment="Left" IsChecked="True" Margin="0,0,0,0" x:Name="btnSpeaker" Template="{StaticResource speakerControlTemplate}"/>
43                 <Slider Grid.Column="1" HorizontalAlignment="Stretch" Margin="3,0,0,0" VerticalAlignment="Center" Maximum="1" x:Name="sliderVolume" Style="{StaticResource volumeSliderStyle}" Background="#FF777777"/>
44             </Grid>
45         </Grid>
46         <Grid Grid.Column="4" Margin="0,10.3120002746582,4,10.3120002746582" HorizontalAlignment="Right" x:Name="gridCol5" VerticalAlignment="Stretch" d:LayoutOverrides="Height">
47             <ToggleButton Cursor="Hand" HorizontalAlignment="Left" Margin="0,0,0,0" x:Name="btnFullScreen" Template="{StaticResource fullScreenControlTemplate}"/>
48         </Grid>
49     </Grid>

从以上代码可以看到，在AudioControl中有两个自定义控件local:MediaSlider和local:Spinner。

MediaSlider：

其功能是控制音乐播放进度，支持拖拽前进或者后退音乐播放进度。其代码如下：

  1 public class MediaSlider : Slider
  2     {
  3         public Thumb              horizontalThumb;
  4         private FrameworkElement horizontalLeftTrack;
  5         private FrameworkElement horizontalRightTrack;
  6         private double oldValue = 0, newValue = 0, prevNewValue = 0;
  7         public event RoutedPropertyChangedEventHandler<double> MyValueChanged;
  8         public event RoutedPropertyChangedEventHandler<double> MyValueChangedInDrag;
  9         private DispatcherTimer dragtimer = new DispatcherTimer();
10         private double dragTimeElapsed = 0;
11         private const short DragWaitThreshold = 200, DragWaitInterval = 100;
12         public Rectangle progressRect = null;
13         private bool dragSeekJustFired = false;
14
15         public MediaSlider()
16         {
17
18             this.ValueChanged += new RoutedPropertyChangedEventHandler<double>(CustomSlider_ValueChanged);
19             dragtimer.Interval = new TimeSpan(0, 0, 0, 0, DragWaitInterval);
20             dragtimer.Tick += new EventHandler(dragtimer_Tick);
21         }
22
23         void dragtimer_Tick(object sender, EventArgs e)
24         {
25             dragTimeElapsed += DragWaitInterval;
26
27             if (dragTimeElapsed >= DragWaitThreshold)
28             {
29                 RoutedPropertyChangedEventHandler<double> handler = MyValueChangedInDrag;
30
31                 if ((handler != null) && (newValue != prevNewValue))
32                 {
33                     handler(this, new RoutedPropertyChangedEventArgs<double>(oldValue, newValue));
34                     dragSeekJustFired = true;
35                     prevNewValue = newValue;
36                 }
37
38                 dragTimeElapsed = 0;
39             }
40         }
41
42         void CustomSlider_ValueChanged(object sender, RoutedPropertyChangedEventArgs<double> e)
43         {
44             oldValue = e.OldValue;
45             newValue = e.NewValue;
46
47             if (horizontalThumb.IsDragging)
48             {
49                 dragTimeElapsed = 0;
50                 dragtimer.Stop();
51                 dragtimer.Start();
52                 dragSeekJustFired = false;
53             }
54         }
55
56         public override void OnApplyTemplate()
57         {
58             base.OnApplyTemplate();
59
60             horizontalThumb = GetTemplateChild("HorizontalThumb") as Thumb;
61             horizontalLeftTrack = GetTemplateChild("LeftTrack") as FrameworkElement;
62             horizontalRightTrack = GetTemplateChild("RightTrack") as FrameworkElement;
63             progressRect = GetTemplateChild("Progress") as Rectangle;
64
65             if (horizontalLeftTrack != null) horizontalLeftTrack.MouseLeftButtonDown += new MouseButtonEventHandler(OnMoveThumbToMouse);
66
67             if (horizontalRightTrack != null) horizontalRightTrack.MouseLeftButtonDown += new MouseButtonEventHandler(OnMoveThumbToMouse);
68
69             horizontalThumb.DragCompleted += new DragCompletedEventHandler(DragCompleted);
70
71             progressRect.Width = this.Width;
72         }
73
74         public Storyboard ProgressStoryboard { get { return (GetTemplateChild("ProgressStoryboard") as Storyboard); } }
75
76         public Rectangle ProgressBar { get { return (GetTemplateChild("Progress") as Rectangle); } }
77
78         protected override Size ArrangeOverride(Size finalSize)
79         {
80             Size s = base.ArrangeOverride(finalSize);
81
82             if (double.IsNaN(horizontalThumb.Width) && (horizontalThumb.ActualWidth != 0))
83             {
84                 horizontalThumb.Width = horizontalThumb.ActualWidth;
85             }
86
87             if (double.IsNaN(horizontalThumb.Height) && (horizontalThumb.ActualHeight != 0))
88             {
89                 horizontalThumb.Height = horizontalThumb.ActualHeight;
90             }
91
92             if (double.IsNaN(horizontalThumb.Width)) horizontalThumb.Width = horizontalThumb.Height;
93             if (double.IsNaN(horizontalThumb.Height)) horizontalThumb.Height = horizontalThumb.Width;
94
95             return (s);
96         }
97
98         private void OnMoveThumbToMouse(object sender, MouseButtonEventArgs e)
99         {
100             e.Handled = true;
101             Point p = e.GetPosition(this);
102
103             if (this.Orientation == Orientation.Horizontal)
104             {
105                 Value = (p.X - (horizontalThumb.ActualWidth / 2)) / (ActualWidth - horizontalThumb.ActualWidth) * Maximum;
106             }
107
108             RoutedPropertyChangedEventHandler<double> handler = MyValueChanged;
109
110             if (handler != null)
111             {
112                 handler(this, new RoutedPropertyChangedEventArgs<double>(oldValue, Value));
113             }
114         }
115
116         private void DragCompleted(object sender, DragCompletedEventArgs e)
117         {
118             dragtimer.Stop();
119             dragTimeElapsed = 0;
120
121             RoutedPropertyChangedEventHandler<double> handler = MyValueChanged;
122
123             if ((handler != null) && (!dragSeekJustFired))
124             {
125                 handler(this, new RoutedPropertyChangedEventArgs<double>(oldValue, this.Value));
126             }
127         }
128     }

而Spinner控件，是一个载入标识，当音频载入时，会显示该控件。该控件为Path绘制的控件，这里不再贴出代码描述。

2. 获取音频文件信息部分

该部分我们同样也创建一个自定义控件来实现，TrackInfo.xaml，主要是负责在客户端显示音频文件的信息，而Silverlight没有相关API可以实现读取音频文件的标签信息，这里，我们需要引入一个微软开源类库TagLib。该类库的主要功能就是读取和修改音乐文件的标签信息。

其调用方法非常简单：

1 // 获取标签
2 tags = TagLib.File.Create(MediaFile.ID);
3 // 设置标签属性
4 MediaFile.Artist = tags.Tag.FirstPerformer;
5 MediaFile.Title = tags.Tag.Title;
6 MediaFile.Album = tags.Tag.Album;
7 MediaFile.Genre = tags.Tag.FirstGenre;

当音乐标签信息获取成功后，即可将信息绑定到TrackInfo.DataContext。

3. 唱片图片信息

对于唱片的图片信息，这里需要读取Image从本地目录，当没有唱片图片时，则显示默认Music.png图片。这里需要注意的是，读取本地文件，需要OOB应用权限信任。

1 public ImageSource AlbumArtStream
2 {
3             get
4             {
5                 BitmapImage image;
6
7                 if (string.IsNullOrEmpty(AlbumArtPath))
8                 {
9                     if (null == _default)
10                     {
11                         _default = new BitmapImage(new Uri("../Images/Music.png", UriKind.Relative));
12                     }
13
14                     image = _default;
15                 }
16                 else
17                 {
18                     FileStream stream = File.Open(AlbumArtPath, FileMode.Open, FileAccess.Read);
19
20                     image = new BitmapImage();
21                     image.SetSource(stream);
22                     stream.Close();
23                 }
24
25                 return image;
26             }
27 }

4. 获取音频文件列表

从演示图片可以看出，我们的音频文件列表，是用了一个绑定了音乐播放文件信息的Datagrid。

其代码非常简单，创建两列，分别绑定歌手和歌曲名：

1 <data:DataGrid x:Name="playList"
2                        Grid.Row="1"
3                        Grid.Column="1"
4                        Grid.RowSpan="3"
5                        VerticalAlignment="Top"
6                        Margin="4"
7                        Height="296"
8                        Style="{StaticResource DataGridStyle}"
9                        AutoGenerateColumns="False"
10                        CanUserResizeColumns="True"
11                        CanUserSortColumns="False"
12                        SelectionChanged="playList_SelectionChanged">
13             <data:DataGrid.Columns>
14                 <data:DataGridTextColumn Header="歌手"
15                                          Binding="{Binding Artist}"
16                                          FontSize="12" />
17                 <data:DataGridTextColumn Header="歌名"
18                                          Binding="{Binding Title}"
19                                          FontSize="12"
20                                          Width="*" />
21             </data:DataGrid.Columns>
22 </data:DataGrid>

而后台，在读取了My Music目录后，将数据集绑定到datagrid.ItemsSource就可以正常实现歌曲列表了。

1 public static List<MediaFile> GetMediaFiles()
2 {
3             List<MediaFile> files = null; ;
4             MediaFile mf;
5             string path = Environment.GetFolderPath(Environment.SpecialFolder.MyMusic);
6             IEnumerable<string> list = Directory.EnumerateFiles(path, "*.mp3", SearchOption.AllDirectories);
7             TagLib.File tags;
8             files = GetCachedList(list);
9             if (null == files || files.Count == 0)
10             {
11                 files = new List<MediaFile>();
12                 foreach (string file in list)
13                 {
14                     mf = new MediaFile();
15                     mf.ID = file;
16                     mf.AlbumArtPath = GetAlbumArtPath(file);
17                     files.Add(mf);
18                 }
19
20                 for (int idx = 0; idx < files.Count; idx++)
21                 {
22                     mf = files[idx];
23                     tags = TagLib.File.Create(mf.ID);
24                     mf.Artist = tags.Tag.FirstPerformer;
25                     mf.Title = tags.Tag.Title;
26                     mf.Album = tags.Tag.Album;
27                     mf.Genre = tags.Tag.FirstGenre;
28                 }
29                 SaveCachedList(files);
30             }
31
32             return files;
33 }

在绑定成功后，同时，我们支持用户选择指定音乐播放，使用Datagrid的SelectionChanged事件即可。

1 private void playList_SelectionChanged(object sender, SelectionChangedEventArgs e)
2 {
3             DataGrid dg = (sender as DataGrid);
4
5             if (dg.SelectedIndex != _nowPlaying)
6             {
7                 if (dg.SelectedIndex != 0)
8                 {
9                     me.AutoPlay = true;
10                 }
11                 OpenAndPlay(dg.SelectedIndex);
12             }
13
14 }

5. UI控制

对于UI的控制，这里我们只是简单的实现了隐藏和显示音乐信息框的功能，其代码实现：

1         private void Minimize_Click(object sender, MouseButtonEventArgs e)
2         {
3             Window main = Application.Current.MainWindow;
4
5             if (!_min)
6             {
7                 main.Height = 40;
8                 rot.Angle = 0;
9             }
10             else
11             {
12                 main.Height = 340;
13                 rot.Angle = 180;
14             }
15
16             _min = !_min;
17         }

上面是OOB音乐播放器5个部分的核心功能代码，这里，我想同时将上一篇讲到的Notifications窗口应用到实例中，我们可以仍旧使用NotificationControl文件，在其中对播放音乐Title进行绑定，即当音乐播放完毕后，即弹出消息提示播放下一首“XXX”音乐。效果如下图：

根据上一篇介绍Notifications窗口的代码，我们简单进行修改，即可实现本篇实例需求：

1         NotificationWindow notifyWindow = null;
2         private void ShowToast()
3         {
4             notifyWindow = new NotificationWindow();
5
6             if (notifyWindow.Visibility == Visibility.Visible)
7                 notifyWindow.Close();
8
9             NotificationControl myNotify = new NotificationControl();
10             myNotify.DataContext = _playList[_nowPlaying];
11             notifyWindow.Width = 300;
12             notifyWindow.Height = 100;
13             notifyWindow.Content = myNotify;
14             notifyWindow.Show(10000);
15         }

至此，一款基于Silverlight的Out of Browser模式的音乐播放器基本完成了。大家可以根据该实例添加更多自定义功能，例如添加互联网音乐播放功能，音乐搜索功能等，创建属于自己的Silverlight版酷我音乐盒。

本篇源代码下载

欢迎大家加入"专注Silverlight" 技术讨论群：

32679955(六群)

23413513(五群)

32679922(四群)

100844510(三群)

37891947(二群)

22308706(一群)

posted on 2010-07-28 04:58 springside5 阅读(168) 评论(0) 编辑收藏举报