如何计划 Windows Phone 的磁贴更新

2012/2/9

本主题介绍使用 ShellTileSchedule 更新应用程序磁贴的背景图像所需的步骤。ShellTileSchedule 也可以用于更新次要磁贴。Windows Phone 的磁贴概述包含磁贴属性以及可以用于更新磁贴的各种方法。

提示提示:

磁贴正面的背景图像是唯一一个可以使用 ShellTileSchedule 进行更新的属性。

可以在 Windows Phone 的代码示例中找到这个已完成的示例。

ShellTileSchedule 允许您设置将更新磁贴的背景图像的一次性计划或定期计划。即使您的应用程序处于非活动状态,该计划仍然可以继续运行。ShellTileSchedule 还可以用于停止为您的应用程序运行的任何计划。每当应用程序由于计划失败而启动时,应用程序都应该存储其 ShellTileSchedule 设置并启动该计划,即使应用程序不再运行,也可以取消计划。

ShellTileSchedule 示例是一个具有四个按钮的简单程序。这四个按钮分别是:

  1. 更新磁贴一次。

  2. 创建一个更新磁贴次数不确定的计划。

  3. 创建一个更新磁贴指定次数的计划。

  4. 停止正在运行的任何计划。

AP_Tiles_TileScheduleSample
注意注意:

请记住,将应用程序的应用程序磁贴固定到“开始”屏幕以便测试磁贴更新功能。

创建应用程序 UI

  1. 在 Visual Studio 2010 Express for Windows Phone 中,通过选择“文件 | 新建项目”菜单命令创建一个新项目。

  2. 将显示“新建项目”窗口。展开 Visual C# 模板,然后选择“Silverlight for Windows Phone”模板。

  3. 选择“Windows Phone 应用程序”模板。用您选择的名称填写“名称”。

  4. 单击“确定”。将显示“新建 Windows Phone 应用程序”窗口。

  5. “Windows Phone OS 目标版本”菜单中,确保“Windows Phone OS 7.1”处于选定状态。

  6. 单击“确定”。一个新项目便创建完成,并在 Visual Studio 设计器窗口中打开 MainPage.xaml。

  7. 在 MainPage.xaml 中,将名为 ContentPanel 的 Grid 替换为以下代码。该代码将为我们的 UI 创建四个按钮。

            <Grid x:Name="ContentPanel" Grid.Row="1" Margin="12,0,12,0">
                <Button Content="Start One Time Schedule" Height="72" HorizontalAlignment="Center" Margin="38,42,38,0" Name="buttonOneTime" VerticalAlignment="Top" Width="400" Click="buttonOneTime_Click" />
                <Button Content="Start Indefinite Schedule" Height="72" HorizontalAlignment="Center"  Margin="38,120,38,0" Name="buttonIndefinite" VerticalAlignment="Top" Width="400" Click="buttonIndefinite_Click" />
                <Button Content="Start Defined Count Schedule" Height="72" HorizontalAlignment="Center"  Margin="38,198,38,0" Name="buttonDefined" VerticalAlignment="Top" Width="400"  Click="buttonDefined_Click"/>
                <Button Content="Stop Schedule" Height="72" HorizontalAlignment="Center" Margin="38,276,38,0" Name="buttonStop" VerticalAlignment="Top" Width="400" Click="buttonStop_Click" />
            </Grid>
    
    

创建磁贴计划

  1. 向 MainPage.xaml.cs 文件的顶部添加一个 using 指令并提供包含 ShellTileSchedule 的命名空间的名称。

    using Microsoft.Phone.Shell;
    
    
  2. 声明并初始化用于计划和状态的变量。

     
    public partial class MainPage : PhoneApplicationPage
    {
        ShellTileSchedule SampleTileSchedule = new ShellTileSchedule();
        bool TileScheduleRunning = false;
    
    
    
  3. 添加用于执行一次性更新的代码。

    
    private void buttonOneTime_Click(object sender, RoutedEventArgs e)
    {
        // Update will happen one time.
        SampleTileSchedule.Recurrence = UpdateRecurrence.Onetime;
    
        // Start the update schedule now, but because updates are batched, the update may not happen for an hour or so.
        SampleTileSchedule.StartTime = DateTime.Now;
    
        SampleTileSchedule.RemoteImageUri = new Uri(@"http://www.weather.gov/forecasts/graphical/images/conus/MaxT1_conus.png");
        SampleTileSchedule.Start();
        TileScheduleRunning = true;
    }
    
    
  4. 添加用于设置运行次数不确定的计划的代码。请记住,如果该计划失败次数太多,将取消该计划。

    
    private void buttonIndefinite_Click(object sender, RoutedEventArgs e)
    {
        // Updates will happen on a fixed interval. 
        SampleTileSchedule.Recurrence = UpdateRecurrence.Interval;
    
        // Updates will happen every hour.  Because MaxUpdateCount is not set, the schedule will run indefinitely.
        SampleTileSchedule.Interval = UpdateInterval.EveryHour;
    
        SampleTileSchedule.RemoteImageUri = new Uri(@"http://www.weather.gov/forecasts/graphical/images/conus/MaxT1_conus.png");
        SampleTileSchedule.Start();
        TileScheduleRunning = true;
    }
    
    
  5. 添加用于设置某个计划的代码,该计划将更新磁贴无限次。同样,如果该计划失败次数太多,将取消该计划。

    
    private void buttonDefined_Click(object sender, RoutedEventArgs e)
    {
        // Updates will happen on a fixed interval.
        SampleTileSchedule.Recurrence = UpdateRecurrence.Interval;
    
        // Updates will happen every hour.
        SampleTileSchedule.Interval = UpdateInterval.EveryHour;
    
        // Do a maximum of 50 updates and then stop.
        SampleTileSchedule.MaxUpdateCount = 50;
    
        SampleTileSchedule.RemoteImageUri = new Uri(@"http://www.weather.gov/forecasts/graphical/images/conus/MaxT1_conus.png");
        SampleTileSchedule.Start();
        TileScheduleRunning = true;
    }
    
    
  6. 添加用于停止任何正在运行的计划的代码。请注意,我们如何通过首先启动计划来附加到该计划。

    
    private void buttonStop_Click(object sender, RoutedEventArgs e)
    {
        // Attach to a shell schedule by starting it.
        if (!TileScheduleRunning)
        {
            buttonIndefinite_Click(sender, e);
        }
    
        SampleTileSchedule.Stop();
        TileScheduleRunning = false;
    }
    
    
    

调试更新计划可能具有挑战性。为了省电,对更新进行批处理,因此可能需要多达约一小时的时间才能看到更新后的图像。当设备锁定时将不会进行更新,因为用户将看不到更新。

运行和调试应用程序的步骤

  1. 通过选择“调试 | 启动调试”菜单命令运行应用程序。

  2. 当模拟器初始化并且您的程序正在运行时,按模拟器上的“开始”按键以进入“开始”屏幕。导航到应用程序列表并找到您的应用程序。长按应用程序名称,然后从上下文菜单中选择“固定到‘开始'屏幕”。应用程序磁贴便固定到“开始”屏幕。

  3. “返回”按键返回您的应用程序。按应用程序上的其中一个按钮启动某个计划。

  4. 返回“开始”屏幕。等待该计划运行,以查看结果。请记住,此过程可能需要一小段时间,因为需要对更新进行批处理。

    AP_Tiles_TileScheduleResult

尽管该示例没有次要磁贴,但您也可以通过向 ShellTileSchedule 构造函数传递磁贴信息来为次要磁贴设置计划。下面的示例演示了如何为每个现有磁贴设置计划。

foreach (ShellTile TileToSchedule in ShellTile.ActiveTiles)
{
    ShellTileSchedule mySchedule = new ShellTileSchedule(TileToSchedule);
    mySchedule.Interval = UpdateInterval.EveryHour;
    mySchedule.Recurrence = UpdateRecurrence.Interval;
    mySchedule.RemoteImageUri = imageURI;
    mySchedule.Start();
}

显示: