Руководство. Отправка push-уведомлений в приложения Windows с использованием Центров уведомлений Azure

  • Статья

Обзор

Примечание

Служба push-уведомлений (Майкрософт) (MPNS) устарела и больше не поддерживается.

В этом руководстве показано, как принудительно отправлять уведомления на мобильные устройства, зарегистрированные в службе "Центры уведомлений". В этом руководстве рассматривается обновление приложений, созданных в руководстве Использование концентраторов уведомлений для передачи экстренных новостей, для поддержки следующих сценариев:

  • приложение Магазина Windows позволяет клиентским устройствам указывать язык и подписываться на различные категории экстренных новостей;
  • внутреннее приложение рассылает уведомления, используя функции tag и template Центров уведомлений Azure.

Когда вы завершите работу с руководством, в мобильном приложении можно будет зарегистрироваться в интересующих вас категориях, а также указать язык получения уведомлений. Внутреннее приложение отправляет уведомления, локализованные на указанном языке и с учетом устройства.

В этом руководстве описано следующее.

  • Обновление приложения Windows для поддержки информации о языковом стандарте
  • обновление внутреннего приложения для отправки локализованных уведомлений;
  • Тестирование приложения

Предварительные требования

Выполните инструкции в руководстве Отправка push-уведомлений на конкретные устройства (универсальная платформа Windows).

В руководстве Отправка push-уведомлений на конкретные устройства (универсальная платформа Windows) создается приложение, использующее теги для подписки на уведомления в разных новостных категориях. В этом руководстве будут продемонстрированы способы использования шаблонов Центров уведомлений, которые позволяют легко доставлять локализованные уведомления об экстренных новостях.

В общих чертах, шаблоны позволяют указать формат, в котором конкретное устройство должно получать уведомления. Шаблон указывает точный формат полезных данных путем обращения к свойствам, которые являются частью сообщения, отправленного сервером вашего приложение. В этом руководстве внутреннее приложение отправляет независимое от языкового стандарта сообщение, содержащее все поддерживаемые языки:

{
    "News_English": "...",
    "News_French": "...",
    "News_Mandarin": "..."
}

Устройство регистрируется с шаблоном, который ссылается на нужное свойство. Например, приложение Магазина Windows, которое хочет получать всплывающее сообщение на английском, будет зарегистрировано для следующего шаблона с любыми соответствующими тегами:

<toast>
    <visual>
    <binding template=\"ToastText01\">
        <text id=\"1\">$(News_English)</text>
    </binding>
    </visual>
</toast>

Дополнительные сведения о шаблонах см. в этой статье.

Обновление приложения Windows для поддержки информации о языковом стандарте

  1. Откройте решение Visual Studio, созданное для руководства Отправка push-уведомлений на конкретные устройства (универсальная платформа Windows).

  2. Обновите файл MainPage.xamlрешения, чтобы включить поле со списком языкового стандарта:

    <Grid Margin="120, 58, 120, 80"  
        Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
    <Grid.RowDefinitions>
        <RowDefinition />
        <RowDefinition />
        <RowDefinition />
        <RowDefinition />
        <RowDefinition />
        <RowDefinition />
    </Grid.RowDefinitions>
    <Grid.ColumnDefinitions>
        <ColumnDefinition />
        <ColumnDefinition />
    </Grid.ColumnDefinitions>
    <TextBlock Grid.Row="0" Grid.Column="0" Grid.ColumnSpan="2"  TextWrapping="Wrap" Text="Breaking News" FontSize="42" VerticalAlignment="Top"/>
    <ComboBox Name="Locale" HorizontalAlignment="Left" VerticalAlignment="Center" Width="200" Grid.Row="1" Grid.Column="0">
        <x:String>English</x:String>
        <x:String>French</x:String>
        <x:String>Mandarin</x:String>
    </ComboBox>
    <ToggleSwitch Header="World" Name="WorldToggle" Grid.Row="2" Grid.Column="0"/>
    <ToggleSwitch Header="Politics" Name="PoliticsToggle" Grid.Row="3" Grid.Column="0"/>
    <ToggleSwitch Header="Business" Name="BusinessToggle" Grid.Row="4" Grid.Column="0"/>
    <ToggleSwitch Header="Technology" Name="TechnologyToggle" Grid.Row="2" Grid.Column="1"/>
    <ToggleSwitch Header="Science" Name="ScienceToggle" Grid.Row="3" Grid.Column="1"/>
    <ToggleSwitch Header="Sports" Name="SportsToggle" Grid.Row="4" Grid.Column="1"/>
    <Button Content="Subscribe" HorizontalAlignment="Center" Grid.Row="5" Grid.Column="0" Grid.ColumnSpan="2" Click="SubscribeButton_Click" />
</Grid>

  3. В классе Notifications добавьте параметр языкового стандарта к методам StoreCategoriesAndSubscribe и SubscribeToCategories.

    public async Task<Registration> StoreCategoriesAndSubscribe(string locale, IEnumerable<string> categories)
{
    ApplicationData.Current.LocalSettings.Values["categories"] = string.Join(",", categories);
    ApplicationData.Current.LocalSettings.Values["locale"] = locale;
    return await SubscribeToCategories(locale, categories);
}

public async Task<Registration> SubscribeToCategories(string locale, IEnumerable<string> categories = null)
{
    var channel = await PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync();

    if (categories == null)
    {
        categories = RetrieveCategories();
    }

    // Using a template registration. This makes supporting notifications across other platforms much easier.
    // Using the localized tags based on locale selected.
    string templateBodyWNS = String.Format("<toast><visual><binding template=\"ToastText01\"><text id=\"1\">$(News_{0})</text></binding></visual></toast>", locale);

    return await hub.RegisterTemplateAsync(channel.Uri, templateBodyWNS, "localizedWNSTemplateExample", categories);
}

    Вместо вызова метода RegisterNativeAsync вызовите RegisterTemplateAsync. Зарегистрируйте определенный формат уведомлений, в котором шаблон зависит от языкового стандарта. Так как может потребоваться зарегистрировать более одного шаблона (например, один для всплывающих уведомлений и один для плиток), введите имя шаблона (например, "localizedWNSTemplateExample"). Вам также необходимо назвать их, чтобы иметь возможность обновить или удалить их.

    Если устройство регистрирует несколько шаблонов с тем же тегом, одно входящее сообщение для этого тега приведет к передаче нескольких уведомлений на устройство (по одному для каждого шаблона). Это полезно, когда одного логическое сообщение должно привести к нескольким визуальным уведомлениям в приложении Магазина Windows, например в виде эмблемы и во всплывающем окне.

  4. Для получения сохраненного языкового стандарта добавьте следующий метод:

    public string RetrieveLocale()
{
    var locale = (string) ApplicationData.Current.LocalSettings.Values["locale"];
    return locale != null ? locale : "English";
}

  5. В файле MainPage.xaml.cs щелкните файл, обновите обработчик нажатия кнопки, чтобы получить текущее значение поля со списком языкового стандарта, и укажите его в вызове класса Notifications:

    private async void SubscribeButton_Click(object sender, RoutedEventArgs e)
{
    var locale = (string)Locale.SelectedItem;

    var categories = new HashSet<string>();
    if (WorldToggle.IsOn) categories.Add("World");
    if (PoliticsToggle.IsOn) categories.Add("Politics");
    if (BusinessToggle.IsOn) categories.Add("Business");
    if (TechnologyToggle.IsOn) categories.Add("Technology");
    if (ScienceToggle.IsOn) categories.Add("Science");
    if (SportsToggle.IsOn) categories.Add("Sports");

    var result = await ((App)Application.Current).notifications.StoreCategoriesAndSubscribe(locale,
            categories);

    var dialog = new MessageDialog("Locale: " + locale + " Subscribed to: " + 
        string.Join(",", categories) + " on registration Id: " + result.RegistrationId);
    dialog.Commands.Add(new UICommand("OK"));
    await dialog.ShowAsync();
}

  6. Наконец, в файле App.xaml.cs обновите метод InitNotificationsAsync, чтобы получить языковый стандарт и использовать его при подписке:

    private async void InitNotificationsAsync()
{
    var result = await notifications.SubscribeToCategories(notifications.RetrieveLocale());

    // Displays the registration ID so you know it was successful
    if (result.RegistrationId != null)
    {
        var dialog = new MessageDialog("Registration successful: " + result.RegistrationId);
        dialog.Commands.Add(new UICommand("OK"));
        await dialog.ShowAsync();
    }
}

Запуск приложения UWP

  1. Запустите приложение универсальной платформы Windows. Дождитесь появления сообщения Регистрация выполнена успешно.

    Мобильное приложение и регистрация

  2. Выберите категории и языковой стандарт, а затем щелкните Подписаться. Приложение преобразует выбранные категории в теги и запрашивает у концентратора уведомлений новую регистрацию устройств для выбранных тегов.

    Мобильное приложение

  3. Отобразится сообщение о подтвержденииподписок.

    Сообщение о подписке

Обновление консольного приложения для отправки локализованных уведомлений

При отправке уведомлений шаблона необходимо предоставить набор свойств. В этом руководстве внутреннее приложение отправит набор свойств, содержащий локализованную версию текущих новостей, например:

{
    "News_English": "World News in English!",
    "News_French": "World News in French!",
    "News_Mandarin": "World News in Mandarin!"
}

В этом разделе вы обновляете проект консольного приложения в решении. Измените метод SendTemplateNotificationAsync в созданном ранее консольном приложении с помощью следующего кода:

Важно!

Укажите имя и строку подключения с полным доступом для центра уведомлений в коде.

private static async void SendTemplateNotificationAsync()
{
    // Define the notification hub.
    NotificationHubClient hub = NotificationHubClient.CreateClientFromConnectionString(
        "<connection string with full access>", "<hub name>");

    // Sending the notification as a template notification. All template registrations that contain
    // "messageParam" or "News_<local selected>" and the proper tags will receive the notifications.
    // This includes APNS, FCM, WNS, and MPNS template registrations.
    Dictionary<string, string> templateParams = new Dictionary<string, string>();

    // Create an array of breaking news categories.
    var categories = new string[] { "World", "Politics", "Business", "Technology", "Science", "Sports"};
    var locales = new string[] { "English", "French", "Mandarin" };

    foreach (var category in categories)
    {
        templateParams["messageParam"] = "Breaking " + category + " News!";

        // Sending localized News for each tag too...
        foreach( var locale in locales)
        {
            string key = "News_" + locale;

            // Your real localized news content would go here.
            templateParams[key] = "Breaking " + category + " News in " + locale + "!";
        }

        await hub.SendTemplateNotificationAsync(templateParams, category);
    }
}

Этот простой вызов будет доставлять правильно локализованную часть новостей на все устройства, независимо от платформы, так как Центр уведомлений создает и доставляет правильные собственные полезные данные на все устройства, подписанные на определенный тег.

Запуск консольного приложения для отправки локализованных уведомлений

Запустите консольное приложение, чтобы отправить уведомления для каждой категории и на каждом поддерживаемом языке. Убедитесь, что вы получаете уведомление только для категорий, на которые подписаны, и что сообщение соответствует выбранному языку.

Сообщения уведомлений

Дальнейшие действия

В этом руководстве вы узнали, как отправлять локализованные push-уведомления на определенные устройства, с регистрацией которых связаны теги. Сведения о том, как принудительно отправлять уведомления конкретным пользователям, которые могут использовать несколько устройств, см. в следующем руководстве:

Отправка push-уведомлений определенным пользователям