Язык: HTML | XAML

Активация через всплывающее уведомление (XAML)

Applies to Windows and Windows Phone

Примечание  Не используете C#, VB и C++? См. раздел Как выполнить активацию через всплывающее уведомление (HTML).

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

  1. Приложение или веб-служба создает и отправляет полезные данные всплывающего уведомления, включая строку запуска
  2. Всплывающее уведомление создается и/или отправляется в Центр поддержки
  3. Пользователь выбирает всплывающее уведомление (щелчком или касанием)
  4. Запускается активированное событие
  5. Обработчик активированных событий приложения считывает строку запуска
  6. Приложение запускается с использованием параметров, содержащихся в строке запуска
Примечание  Для тестирования возможностей кода всплывающих уведомлений в Microsoft Visual Studio необходимо использовать параметр отладки "Локальный компьютер" или "Удаленный компьютер" на компьютере с архитектурой Windows x86, x64 или среды выполнения Windows. Функцию отладки имитатора Visual Studio использовать нельзя — код скомпилируется и запустится в имитаторе, но всплывающее уведомление не появится.

Что необходимо знать

Технологии

  • Windows Runtime

Необходимые условия

Для понимания этого раздела вам понадобится:

Инструкции

Этап 1: Включение данных активации в полезные данные всплывающего уведомления

Когда ваше приложение активируется через всплывающее уведомление, ему необходимо передать информацию, связанную с содержимым уведомления. Затем это содержимое может быть отражено путем запуска приложения в связанном представлении вместо представления по умолчанию. Когда ваше приложение или веб-служба создает всплывающее уведомление, для указания этой информации активации используется атрибут launch. Эту строку можно считать аналогом аргументов командной строки. Строка может содержать любую информацию, которая может интерпретироваться приложением, при условии, что в результате полезные данные XML не станут недопустимыми. Обратите внимание, что общий размер полезных данных XML всплывающего уведомления, включая строку запуска, не может превышать 5 КБ.

Если вы не добавите строку атрибута запуска, ваше приложение не сможет нормально запуститься, и пользователю придется запустить его с начального экрана.

В данном шаге используется ранее созданный объект XmlDocument с именем toastXml. В этом примере создается атрибут launch, ему присваивается строковое значение, а затем он добавляется в полезные данные XML всплывающего уведомления. Инструкции по созданию полного всплывающего уведомления см. в разделе Краткое руководство: отправка всплывающих уведомлений.



((XmlElement)toastNode).SetAttribute("launch", "{\"type\":\"toast\",\"param1\":\"12345\",\"param2\":\"67890\"}");

Приведенный выше код приводит к появлению следующего кода XML, в зависимости от содержимого элемента visual, который определен в разделе Краткое руководство: отправка всплывающих уведомлений.



<toast launch="{&quot;type&quot;:&quot;toast&quot;:&quot;param1&quot;:&quot;12345&quot;:&quot;param2&quot;:&quot;67890&quot;}">                        
    <visual>
        <binding template="ToastImageAndText01">
            <image id="1" src="ms-appx:///images/redWide.png" alt="red graphic"/>
            <text id="1">Hello World!</text>
        </binding>
    </visual>
</toast>

Этап 2: Обработка события OnLaunched приложения

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

Примечание  Если вы не включили строку атрибута запуска в свое всплывающее уведомление, а ваше приложение уже выполняется при выборе уведомления, событие OnLaunched не происходит.

Этот пример демонстрирует синтаксис для переопределения события OnLaunched, в котором вы получите строку запуска, предоставленную через всплывающее уведомление, и выполните с ней необходимые действия.



protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    string launchString = args.Arguments

    ....
}

Связанные разделы

Примеры всплывающих уведомлений
Windows.UI.Notifications API namespace
Общие сведения о всплывающих уведомлениях
Руководство и контрольный список для всплывающих уведомлений
Краткое руководство: отправка всплывающих уведомлений
Каталог шаблонов всплывающих уведомлений
Схема XML для всплывающих уведомлений

 

 

Показ:
© 2015 Microsoft