Как предоставить явное согласие на всплывающие уведомления (приложения среды выполнения Windows)

  • Статья

[ Эта статья адресована разработчикам приложений среды выполнения Windows для Windows 8.x и Windows Phone 8.x. При разработке приложений для Windows 10 см. раздел последняя документация]

Примечание  Не используете JavaScript? См. раздел Как предоставить явное согласие на всплывающие уведомления (XAML).

 

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

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

Технологии

  • Windows Runtime

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

Чтобы понять изложенное в этом разделе, вам необходимо:

  • Хорошее знание понятий и терминов, связанных со всплывающими уведомлениями. Подробнее см. раздел Обзор всплывающих уведомлений.
  • Знакомство со схемой XML всплывающих уведомлений, а также общее знакомство с XML и использованием этого языка в API модели DOM. Дополнительные сведения см. в разделе о схеме для всплывающих уведомлений.

Инструкции

Этап 1: Объявление о поддержке всплывающих уведомлений

Возможность отображения всплывающих уведомлений объявляется в файле package.appxmanifest вашего приложения. Если вы используете редактор манифестов Microsoft Visual Studio, присвойте значение "Да" параметру Разрешить всплывающие уведомления в разделе Уведомления вкладки Приложение.

В следующем примере показан XML, вставленный в файл package.appxmanifest после выбора нужного варианта. Атрибут ToastCapable добавлен в элемент VisualElements манифеста.

В этом примере также показано необходимое дополнение, если вы создаете файл package.appxmanifest вручную, без использования Visual Studio. Дополнительные сведения см. в разделе о создании манифеста пакета вручную. Обратите внимание: хотя в Visual Studio этот параметр имеет значение "Да", в файл package.appxmanifest записывается значение "true".


<VisualElements 
    ...
    ToastCapable="true">
</VisualElements>

Этап 2: Объявите цвет фона и цвет текста для всплывающих уведомлений (только в Windows)

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

Если вы используете редактор манифестов Visual Studio, выберите параметр Текст переднего плана на вкладке Визуальные активы. Задайте параметр Цвет фона с помощью строки цвета W3DC (например, "#FFFFFF").

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

В следующем примере показан XML-код, вставленный в файл package.appxmanifest после выбора нужных вариантов. Атрибуты ForegroundText и BackgroundColor добавлены в элемент VisualElements манифеста.


<VisualElements 
    ...
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF">
</VisualElements>

Этап 3: Задайте изображение для логотипа

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

Примечание  Windows Phone 8.1 не использует этот логотип. На плитке представляется только отображаемое имя приложения (указанное в манифесте) или ничего не представляется.

Если вы используете редактор манифестов Visual Studio, укажите путь к квадратному логотипу 30 x 30 (Windows) или квадратному логотипу 44 x 44 (Windows Phone) на вкладке Визуальные активы. Указанное изображение необходимо включить в пакет приложения.

В следующем примере показан XML, вставленный в файл package.appxmanifest после выбора нужных вариантов. Атрибут SmallLogo добавлен в элемент VisualElements манифеста.


<VisualElements 
    ...
    SmallLogo="images\smallTile-sdk.png">
</VisualElements>

Замечания

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

Полный пример

В следующем примере показан полный XML-код для элемента VisualElements из образца приложения для Windows в файле package.appxmanifest, включающий атрибуты, о которых говорилось в этом разделе.


<VisualElements 
    DisplayName="ToastsSample" 
    Logo="images\squareTile-sdk.png" 
    SmallLogo="images\smallTile-sdk.png" 
    Description="SDK Sample" 
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF" 
    ToastCapable="true">
    <DefaultTile ShortName="ToastsSample" ShowName="allLogos"/>
    <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
</VisualElements>

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

Обзор всплывающих уведомлений

Руководство и контрольный список для всплывающих уведомлений

Пример всплывающих уведомлений