Conteúdo da notificação do sistemaToast content

As notificações do sistema interativas e adaptáveis permitem a criação de notificações flexíveis com texto, imagens e botões/entradas.Adaptive and interactive toast notifications let you create flexible notifications with text, images, and buttons/inputs.

APIs importantes: Pacote do nuget de notificações de kit de ferramentas de comunidade UWPImportant APIs: UWP Community Toolkit Notifications nuget package

Observação

Para ver os modelos herdados do Windows 8.1 e Windows Phone 8.1, consulte o catálogo de modelos de notificação do sistema herdados.To see the legacy templates from Windows 8.1 and Windows Phone 8.1, see the legacy toast template catalog.

IntroduçãoGetting started

Instale a biblioteca de notificações.Install Notifications library. Se você quiser usar a linguagem C# em vez de XML para gerar notificações, instale o pacote NuGet denominado Microsoft.Toolkit.Uwp.Notifications (procure por "notificações uwp").If you'd like to use C# instead of XML to generate notifications, install the NuGet package named Microsoft.Toolkit.Uwp.Notifications (search for "notifications uwp"). Os exemplos em linguagem C# fornecidos neste artigo usam o pacote NuGet, versão 1.0.0.The C# samples provided in this article use version 1.0.0 of the NuGet package.

Instale o Visualizador de Notificações.Install Notifications Visualizer. Esse aplicativo gratuito do Windows ajuda você a criar notificações interativas do sistema fornecendo uma visualização Visual instantânea de sua notificação ao editá-la, semelhante à exibição de design/editor XAML do Visual Studio.This free Windows app helps you design interactive toast notifications by providing an instant visual preview of your toast as you edit it, similar to Visual Studio's XAML editor/design view. Consulte Visualizador de notificações para obter mais informações ou Baixar o Visualizador de notificações da Store.See Notifications Visualizer for more information, or download Notifications Visualizer from the Store.

Envio da notificação do sistemaSending a toast notification

Para saber como enviar uma notificação, consulte Enviar notificação do sistema local.To learn how to send a notification, see Send local toast. Esta documentação abrange apenas a criação do conteúdo de notificação do sistema.This documentation only covers creating the toast content.

Estrutura de notificação do sistemaToast notification structure

As notificações do sistema são uma combinação de algumas propriedades de dados como Marcação/Grupo (que permitem a você identificar a notificação) e o conteúdo da notificação do sistema.Toast notifications are a combination of some data properties like Tag/Group (which let you identify the notification) and the toast content.

Os componentes principais de conteúdo da notificação do sistema são...The core components of toast content are...

  • iniciar: define quais argumentos serão passados para o aplicativo quando o usuário clica na notificação, permitindo que você se aprofunde no conteúdo correto exibido pela notificação do sistema.launch: This defines what arguments will be passed back to your app when the user clicks your toast, allowing you to deep link into the correct content that the toast was displaying. Para saber mais, consulte Enviar notificação do sistema local.To learn more, see Send local toast.
  • visual: a parte visual da notificação do sistema, incluindo a associação genérica que contém os logotipos texto e imagens.visual: The visual portion of the toast, including the generic binding that contains text and images.
  • ações: a parte da notificação do sistema, incluindo entradas e ações.actions: The interactive portion of the toast, including inputs and actions.
  • áudio: controla o áudio reproduzido quando a notificação é exibida para o usuário.audio: Controls the audio played when the toast is shown to the user.

O conteúdo da notificação do sistema é definido em XML bruto, mas você pode usar nossa biblioteca NuGet para obter um modelo de objeto C# (ou C++) para construir o conteúdo de notificação do sistema.The toast content is defined in raw XML, but you can use our NuGet library to get a C# (or C++) object model for constructing the toast content. Este artigo documenta todo o conteúdo da notificação do sistema.This article documents everything that goes within the toast content.

new ToastContentBuilder()
    .AddToastActivationInfo("app-defined-string", ToastActivationType.Foreground)
    .AddText("Some text")
    .AddButton("Archive", ToastActivationType.Background, "archive")
    .AddAudio(new Uri("ms-appx:///Sound.mp3"));

Esta é uma representação visual do conteúdo da notificação do sistema:Here is a visual representation of the toast's content:

estrutura de notificação do sistema

VisualVisual

Cada notificação do sistema deve especificar um elemento visual, onde você deve fornecer uma associação de notificação do sistema genérica que pode conter texto, imagens e muito mais.Each toast must specify a visual, where you must provide a generic toast binding, which can contain text, images, and more. Esses elementos serão renderizados em vários dispositivos Windows, incluindo a área de trabalho, telefones, tablets e Xbox.These elements will be rendered on various Windows devices, including desktop, phones, tablets, and Xbox.

Para todos os atributos com suporte na seção visual e seus elementos filho, consulte a documentação do esquema.For all attributes supported in the visual section and its child elements, see the schema documentation.

A identidade do seu aplicativo na notificação do sistema é transmitida por meio do ícone do aplicativo.Your app's identity on the toast notification is conveyed via your app icon. No entanto, se você usar a substituição de logotipo do aplicativo, exibiremos o nome do aplicativo abaixo das linhas de texto.However, if you use the app logo override, we will display your app name beneath your lines of text.

Identidade do aplicativo para notificação do sistema normalApp identity for normal toast Identidade do aplicativo com appLogoOverrideApp identity with appLogoOverride
notification without appLogoOverride notification with appLogoOverride

Elementos de textoText elements

Cada notificação deve ter pelo menos um elemento de texto e pode conter dois elementos de texto adicionais, todos do tipo AdaptiveText.Each toast must have at least one text element, and can contain two additional text elements, all of type AdaptiveText.

Toast with title and description

A partir da Atualização de Aniversário do Windows 10, você pode controlar quantas linhas de texto são exibidas com a propriedade HintMaxLines no texto.Since the Windows 10 Anniversary Update, you can control how many lines of text are displayed by using the HintMaxLines property on the text. O padrão (e máximo) é de até 2 linhas de texto para o título e até 4 linhas (combinadas) para os dois elementos de descrição adicionais (o segundo e o terceiro AdaptiveText).The default (and maximum) is up to 2 lines of text for the title, and up to 4 lines (combined) for the two additional description elements (the second and third AdaptiveText).

new ToastContentBuilder()
    .AddText("Adaptive Tiles Meeting", hintMaxLines: 1)
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

Substituição de logotipo do aplicativoApp logo override

Por padrão, o sistema exibirá o logotipo do aplicativo.By default, your toast will display your app's logo. No entanto, você pode substituir esse logotipo por sua própria imagem ToastGenericAppLogo .However, you can override this logo with your own ToastGenericAppLogo image. Por exemplo, se esta for uma notificação de uma pessoa, recomendamos substituir o logotipo do aplicativo por uma foto da pessoa.For example, if this is a notification from a person, we recommend overriding the app logo with a picture of that person.

Toast with app logo override

Você pode usar a propriedade HintCrop para alterar o recorte da imagem.You can use the HintCrop property to change the cropping of the image. Por exemplo, Círculo resulta em uma imagem recortada de círculo.For example, Circle results in a circle-cropped image. Do contrário, a imagem é quadrada.Otherwise, the image is square. As dimensões da imagem são 48 x 48 pixels em escala de 100%.Image dimensions are 48x48 pixels at 100% scaling.

new ToastContentBuilder()
    ...
    
    .AddAppLogoOverride(new Uri("https://picsum.photos/48?image=883"), NotificationAppLogoCrop.Circle);

Imagem de heróiHero image

Novidade na atualização de aniversário: as notificações do sistema podem exibir uma imagem de herói, que é uma ToastGenericHeroImage exibida com destaque na barra de notificação do sistema enquanto estiver na Central de Ações.New in Anniversary Update: Toasts can display a hero image, which is a featured ToastGenericHeroImage displayed prominently within the toast banner and while inside Action Center. As dimensões da imagem são 364 x 180 pixels em escala de 100%.Image dimensions are 364x180 pixels at 100% scaling.

Toast with hero image
new ToastContentBuilder()
    ...
    
    .AddHeroImage(new Uri("https://picsum.photos/364/180?image=1043"));

Imagem embutidaInline image

Você pode fornecer uma imagem embutida de largura inteira que aparece ao expandir a notificação do sistema.You can provide a full-width inline-image that appears when you expand the toast.

Toast with additional image
new ToastContentBuilder()
    ...
    
    .AddInlineImage(new Uri("https://picsum.photos/360/202?image=1043"));

Restrições de tamanho de imagemImage size restrictions

As imagens usadas em sua notificação do sistema podem ser originadas de...The images you use in your toast notification can be sourced from...

  • http://http://
  • ms-appx:///ms-appx:///
  • ms-appdata:///ms-appdata:///

Para imagens http e http remotas da Web, existem limites de tamanho do arquivo de cada imagem individual.For http and https remote web images, there are limits on the file size of each individual image. Na Fall Creators Update (16299), aumentamos o limite para 3 MB em conexões normais e 1 MB em conexões limitadas.In the Fall Creators Update (16299), we increased the limit to be 3 MB on normal connections and 1 MB on metered connections. Antes disso, as imagens sempre eram limitadas a 200 KB.Before that, images were always limited to 200 KB.

Conexão normalNormal connection Conexão limitadaMetered connection Antes do Fall Creators UpdateBefore Fall Creators Update
3 MB3 MB 1 MB1 MB 200 KB200 KB

Se uma imagem excede o tamanho do arquivo ou não foi possível baixá-la, ou atingir o tempo limite, ela será descartada e o restante da notificação será exibido.If an image exceeds the file size, or fails to download, or times out, the image will be dropped and the rest of the notification will be displayed.

Texto de atribuiçãoAttribution text

Novidade na Atualização de aniversário: se você precisar fazer referência à origem do conteúdo, é possível usar o texto de atribuição.New in Anniversary Update: If you need to reference the source of your content, you can use attribution text. Este texto sempre é exibido na parte inferior da sua notificação, juntamente com a identidade do aplicativo ou o carimbo de data e hora da notificação.This text is always displayed at the bottom of your notification, along with your app's identity or the notification's timestamp.

Em versões mais antigas do Windows sem suporte a texto de atribuição, o texto será exibido simplesmente como outro elemento de texto (supondo que você ainda não tem o máximo de três elementos de texto).On older versions of Windows that don't support attribution text, the text will simply be displayed as another text element (assuming you don't already have the maximum of three text elements).

Toast with attribution text
new ToastContentBuilder()
    ...
    
    .AddAttributionText("Via SMS");

Carimbo de data e hora personalizadoCustom timestamp

Novidade na Atualização de Criadores: agora você pode substituir o carimbo de data e hora do sistema por um personalizado que aparece quando a mensagem/informações/conteúdo é gerado.New in Creators Update: You can now override the system-provided timestamp with your own timestamp that accurately represents when the message/information/content was generated. Este carimbo de data e hora fica visível na Central de Ações.This timestamp is visible within Action Center.

Toast with custom timestamp

Para saber mais sobre como usar um carimbo de data e hora personalizado carimbo de data e hora personalizado em notificações do sistema.To learn more about using a custom timestamp, please see custom timestamps on toasts.

new ToastContentBuilder()
    ...
    
    .AddCustomTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));

Barra de progressoProgress bar

Novo na atualização de criadores: você pode fornecer uma barra de progresso em sua notificação do sistema para manter o usuário informado sobre o progresso das operações, como downloads.New in Creators Update: You can provide a progress bar on your toast notification to keep the user informed of the progress of operations such as downloads.

Toast with progress bar

Para saber mais sobre como usar uma barra de progresso, consulte barra de progresso da notificação do sistema.To learn more about using a progress bar, please see Toast progress bar.

headersHeaders

Novidade na Atualização para Criadores: você pode agrupar as notificações em cabeçalhos na Central de ações.New in Creators Update: You can group notifications under headers within Action Center. Por exemplo, você pode agrupar as mensagens de um chat do grupo em um cabeçalho ou notificações do grupo de um tema comum em um cabeçalho ou mais.For example, you can group messages from a group chat under a header, or group notifications of a common theme under a header, or more.

Toasts with header

Para saber mais sobre como usar cabeçalhos, consulte Cabeçalhos da notificação do sistema.To learn more about using headers, please see Toast headers.

Conteúdo adaptávelAdaptive content

Novidade na Atualização de aniversário: além do conteúdo especificado acima, você também pode exibir conteúdo adaptável adicional que é visível quando a notificação é expandida.New in Anniversary Update: In addition to the content specified above, you can also display additional adaptive content that is visible when the toast is expanded.

Esse conteúdo adicional é especificado usando Adaptável e você pode saber mais sobre isso lendo a documentação de Blocos adaptáveis.This additional content is specified using Adaptive, which you can learn more about by reading the Adaptive Tiles documentation.

Observe que qualquer conteúdo adaptável deve estar contido em um AdaptiveGroup.Note that any adaptive content must be contained within an AdaptiveGroup. Caso contrário, ele não será renderizado usando o recurso adaptável.Otherwise it will not be rendered using adaptive.

Colunas e elementos de textoColumns and text elements

Aqui está um exemplo em que as colunas e alguns elementos avançados de texto adaptável são usados.Here's an example where columns and some advanced adaptive text elements are used. Como os elementos de texto estão em um AdaptiveGroup, eles oferecem suporte a todas as propriedades avançadas de estilo adaptável.Since the text elements are within an AdaptiveGroup, they support all the rich adaptive styling properties.

Toast with additional text
new ToastContentBuilder()
    ...
    
    .AddVisualChild(new AdaptiveGroup()
    {
        Children =
        {
            new AdaptiveSubgroup()
            {
                Children =
                {
                    new AdaptiveText()
                    {
                        Text = "52 attendees",
                        HintStyle = AdaptiveTextStyle.Base
                    },
                    new AdaptiveText()
                    {
                        Text = "23 minute drive",
                        HintStyle = AdaptiveTextStyle.CaptionSubtle
                    }
                }
            },
            new AdaptiveSubgroup()
            {
                Children =
                {
                    new AdaptiveText()
                    {
                        Text = "1 Microsoft Way",
                        HintStyle = AdaptiveTextStyle.CaptionSubtle,
                        HintAlign = AdaptiveTextAlign.Right
                    },
                    new AdaptiveText()
                    {
                        Text = "Bellevue, WA 98008",
                        HintStyle = AdaptiveTextStyle.CaptionSubtle,
                        HintAlign = AdaptiveTextAlign.Right
                    }
                }
            }
        }
    });

BotõesButtons

Os botões proporcionam a interação com a notificação do sistema, permitindo ao usuário executar ações rápidas na notificação do sistema sem interromper o fluxo de trabalho atual.Buttons make your toast interactive, letting the user take quick actions on your toast notification without interrupting their current workflow. Por exemplo, os usuários podem responder a uma mensagem diretamente em uma notificação do sistema ou excluir um email sem precisar abrir o aplicativo de email.For example, users can reply to a message directly from within a toast, or delete an email without even opening the email app. Os botões aparecem na parte expandida da notificação.Buttons appear in the expanded portion of your notification.

Para saber mais sobre a implementação de botões de ponta a ponta, consulte Enviar notificações do sistema local.To learn more about implementing buttons end-to-end, see Send local toast.

Os botões podem realizar as seguintes ações diferentes...Buttons can perform the following different actions...

  • Ativar o aplicativo em primeiro plano, com um argumento de ação específica que pode ser usado para navegar até uma página/contexto específico.Activating the app in the foreground, with an argument that can be used to navigate to a specific page/context.
  • Ativar a tarefa em segundo plano do aplicativo para um cenário de resposta rápida ou semelhante.Activating the app's background task, for a quick-reply or similar scenario.
  • Ativar outro aplicativo por meio da inicialização de protocolo.Activating another app via protocol launch.
  • Executar uma ação do sistema, como adiar ou ignorar a notificação.Performing a system action, such as snoozing or dismissing the notification.

Observação

Você pode ter até cinco botões (incluindo itens de menu de contexto que abordaremos mais adiante).You can only have up to 5 buttons (including context menu items which we discuss later).

notification with actions, example 1
new ToastContentBuilder()
    ...
    
    .AddButton("See more details", ToastActivationType.Foreground, "action=viewdetails&contentId=351")
    .AddButton("Remind me later", ToastActivationType.Background, "action=remindlater&contentId=351");

Botões com íconesButtons with icons

Você pode adicionar ícones ao seus botões.You can add icons to your buttons. Esses ícones são imagens transparentes brancas de 16 x 16 pixels na escala de 100% e não devem ter preenchimento na imagem em si.These icons are white transparent 16x16 pixel images at 100% scaling, and should have no padding included in the image itself. Se você optar por fornecer ícones em uma notificação do sistema, é necessário fornecer ícones para todos os seus botões na notificação, pois isso transforma o estilo dos botões em botões de ícones.If you choose to provide icons on a toast notification, you must provide icons for ALL of your buttons in the notification, as it transforms the style of your buttons into icon buttons.

Observação

Para fins de acessibilidade, certifique-se de incluir uma versão do ícone em contraste com branco (um ícone preto para telas de fundo brancas), para que o ícone fique visível quando o usuário ativar o modo de Branco em alto contraste.For accessibility, be sure to include a contrast-white version of the icon (a black icon for white backgrounds), so that when the user turns on High Contrast White mode, your icon is visible. Saiba mais sobre a página de acessibilidade de notificação do sistema.Learn more on the toast accessiblity page.

Toast that has buttons with icons
new ToastContentBuilder()
    ...
    
    .AddButton(
        "Dismiss",
        ToastActivationType.Foreground,
        "dismiss", new Uri("Assets/NotificationButtonIcons/Dismiss.png", UriKind.Relative));

Botões com ativação de atualização pendenteButtons with pending update activation

Novidade na Fall Creators Update: você pode usar uma ativação após o comportamento de PendingUpdate nos botões de ativação em segundo plano para criar interações de várias etapas nas notificações do sistema.New in Fall Creators Update: On background activation buttons, you can use an after activation behavior of PendingUpdate to create multi-step interactions in your toast notifications. Quando o usuário clicar no botão, a tarefa em segundo plano é ativada e a notificação do sistema é colocada em um estado de "atualização pendente", onde permanece na tela até que a tarefa em segundo plano substitua a notificação do sistema por uma nova notificação do sistema.When the user clicks your button, your background task is activated, and the toast gets placed in a "pending update" state, where it stays on screen till your background task replaces the toast with a new toast.

Para saber como implementar isso, consulte atualização pendente de notificação do sistema.To learn how to implement this, see Toast pending update.

Notificação do sistema com atualizações pendentes

Ações do menu de contextoContext menu actions

Novidade na Atualização de Aniversário: você pode adicionar mais ações de menu de contexto ao menu de contexto existente que aparece quando o usuário clica com o botão direito do mouse na sua notificação na Central de ações.New in Anniversary Update: You can add additional context menu actions to the existing context menu that appears when the user right clicks your toast from within Action Center. Observe que esse menu aparece somente quando o botão direito do mouse clicar na Central de ações.Note that this menu only appears when right clicked from Action Center. Ele não aparece quando o botão direito do mouse clica em uma faixa de pop-up de notificação do sistema.It does not appear when right clicking a toast popup banner.

Observação

Em dispositivos mais antigos, essas ações de menu de contexto adicionais aparecem como botões normais na notificação do sistema.On older devices, these additional context menu actions will simply appear as normal buttons on your toast.

As ações de menu de contexto adicionais que você adiciona (como "alterar local") aparecem acima das duas entradas padrão do sistema.The additional context menu actions you add (such as "Change location") appear above the two default system entries.

Toast with context menu

A sintaxe do construtor não dá suporte a ações de menu de contexto, portanto, é recomendável usar a sintaxe do inicializador.The builder syntax doesn't support context menu actions, so we recommend using initializer syntax.

ToastContent content = new ToastContent()
{
    ...
 
    Actions = new ToastActionsCustom()
    {
        ContextMenuItems =
        {
            new ToastContextMenuItem("Change location", "action=changeLocation")
        }
    }
};

Observação

Itens de menu de contexto adicionais contribuem para o limite total de cinco botões em uma notificação do sistema.Additional context menu items contribute to the total limit of 5 buttons on a toast.

A ativação de itens de menu de contexto adicionais é processada de forma idêntica a dos botões de notificação.Activation of additional context menu items is handled identical to toast buttons.

EntradasInputs

As entradas são especificadas na região de Ações da região de notificação do sistema, ou seja, ficam visíveis somente quando a notificação do sistema é expandida.Inputs are specified within the Actions region of the toast region of the toast, meaning they are only visible when the toast is expanded.

Caixa de texto de resposta rápidaQuick reply text box

Para habilitar uma caixa de texto de resposta rápida (por exemplo, em um aplicativo de mensagens), adicione uma entrada de texto e um botão e referencie a ID do campo de entrada de texto para que o botão seja exibido ao lado do campo de entrada.To enable a quick reply text box (for example, in a messaging app) add a text input and a button, and reference the ID of the text input field so that the button is displayed next to to the input field. O ícone do botão deve ser uma imagem de 32x32 em pixels sem preenchimento, pixels brancos definidos como transparente e escala de 100%.The icon for the button should be a 32x32 pixel image with no padding, white pixels set to transparent, and 100% scale.

notification with text input and actions
new ToastContentBuilder()
    ...
    
    .AddInputTextBox("tbReply", "Type a reply")

    .AddButton(
        textBoxId: "tbReply", // To place button next to text box, reference text box's id
        content: "Reply",
        activationType: ToastActivationType.Background,
        arguments: "action=reply&convId=9318",
        imageUri: new Uri("Assets/Reply.png", UriKind.Relative));

Entradas com barra de botõesInputs with buttons bar

Você também pode ter uma (ou várias) entradas com botões normais exibidos abaixo das entradas.You also can have one (or many) inputs with normal buttons displayed below the inputs.

notification with text and input actions
new ToastContentBuilder()
    ...
    
    .AddInputTextBox("tbReply", "Type a reply")

    .AddButton("Reply", ToastActivationType.Background, "action=reply&threadId=9218")
    .AddButton("Video call", ToastActivationType.Foreground, "action=videocall&threadId=9218");

Entrada de seleçãoSelection input

Além de caixas de texto, você também pode usar um menu de seleção.In addition to text boxes, you can also use a selection menu.

notification with selection input and actions
new ToastContentBuilder()
    ...
    
    .AddToastInput(new ToastSelectionBox("time")
    {
        DefaultSelectionBoxItemId = "lunch",
        Items =
        {
            new ToastSelectionBoxItem("breakfast", "Breakfast"),
            new ToastSelectionBoxItem("lunch", "Lunch"),
            new ToastSelectionBoxItem("dinner", "Dinner")
        }
    })

    .AddButton(...)
    .AddButton(...);

Adiamento/ignorarSnooze/dismiss

Com um menu de seleção e dois botões, podemos criar uma notificação de lembrete que utiliza as ações de adiamento de sistema e ignorar.Using a selection menu and two buttons, we can create a reminder notification that utilizes the system snooze and dismiss actions. Certifique-se de definir o cenário como Lembrete para que a notificação se comporte como um lembrete.Make sure to set the scenario to Reminder for the notification to behave like a reminder.

reminder notification

Vinculamos o botão de Adiamento para a entrada do menu de seleção usando a propriedade SelectionBoxId no botão de notificação do sistema.We link the Snooze button to the selection menu input using the SelectionBoxId property on the toast button.

new ToastContentBuilder()
    .SetToastScenario(ToastScenario.Reminder)
    
    ...
    
    .AddToastInput(new ToastSelectionBox("snoozeTime")
    {
        DefaultSelectionBoxItemId = "15",
        Items =
        {
            new ToastSelectionBoxItem("5", "5 minutes"),
            new ToastSelectionBoxItem("15", "15 minutes"),
            new ToastSelectionBoxItem("60", "1 hour"),
            new ToastSelectionBoxItem("240", "4 hours"),
            new ToastSelectionBoxItem("1440", "1 day")
        }
    })

    .AddButton(new ToastButtonSnooze() { SelectionBoxId = "snoozeTime" })
    .AddButton(new ToastButtonDismiss());

Para usar as ações de adiamento e ignorar:To use the system snooze and dismiss actions:

  • Especifique um ToastButtonSnooze ou ToastButtonDismissSpecify a ToastButtonSnooze or ToastButtonDismiss
  • Como alternativa, especifique uma cadeia de caracteres de conteúdo personalizada:Optionally specify a custom content string:
    • Se você não fornecer uma cadeia de caracteres, usaremos automaticamente as cadeias de caracteres localizadas de "Adiar" e "Ignorar".If you don't provide a string, we'll automatically use localized strings for "Snooze" and "Dismiss".
  • Opcionalmente, especifique a SelectionBoxId:Optionally specify the SelectionBoxId:
    • Se você não quiser que o usuário selecione um intervalo de adiamento e, em vez disso, apenas que sua notificação seja adiada apenas uma vez por um intervalo de tempo definido pelo sistema (consistente com o sistema operacional), não crie nenhuma <input>.If you don't want the user to select a snooze interval and instead just want your notification to snooze only once for a system-defined time interval (that is consistent across the OS), then don't construct any <input> at all.
    • Se você quiser fornecer seleções de intervalo de adiamento:If you want to provide snooze interval selections:
      • Especifique SelectionBoxId na ação de adiamentoSpecify SelectionBoxId in the snooze action
      • Combine a identificação da entrada com a SelectionBoxId da ação de adiamentoMatch the id of the input with the SelectionBoxId of the snooze action
      • Especifique o valor de ToastSelectionBoxItem como um nonNegativeInteger que represente o intervalo de adiamento em minutos.Specify ToastSelectionBoxItem's value to be a nonNegativeInteger which represents snooze interval in minutes.

ÁudioAudio

O áudio personalizado sempre contou com suporte na versão Mobile e tem suporte na versão Desktop 1511 (compilação 10586) ou mais recente.Custom audio has always been supported by Mobile, and is supported in Desktop Version 1511 (build 10586) or newer. O áudio personalizado pode ser referenciado por meio dos seguintes caminhos:Custom audio can be referenced via the following paths:

  • ms-appx:///ms-appx:///
  • ms-appdata:///ms-appdata:///

Você também pode escolher uma opção da lista de ms-winsoundevents, que sempre tem suporte nas duas plataformas.Alternatively, you can pick from the list of ms-winsoundevents, which have always been supported on both platforms.

new ToastContentBuilder()
    ...
    
    .AddAudio(new Uri("ms-appx:///Assets/NewMessage.mp3"));

Consulte a página de esquema de áudio para obter informações sobre áudio em notificações do sistema.See the audio schema page for information on audio in toast notifications. Para saber como enviar uma notificação do sistema usando o áudio personalizado, consulte áudio personalizado em notificações do sistema.To learn how to send a toast using custom audio, see custom audio on toasts.

Alarmes, lembretes e chamadas de entradaAlarms, reminders, and incoming calls

Para criar alarmes, lembretes e notificações de chamadas de entrada, você pode usar uma notificação normal do sistema com um valor de cenário atribuído a ela.To create alarms, reminders, and incoming call notifications, you simply use a normal toast notification with a scenario value assigned to it. O cenário ajusta alguns comportamentos para criar uma experiência do usuário unificada e consistente.The scenario adusts a few behaviors to create a consistent and unified user experience.

Importante

Ao usar o Lembrete ou o Alarme, você deve fornecer pelo menos um botão em sua notificação do sistema.When using Reminder or Alarm, you must provide at least one button on your toast notification. Caso contrário, a notificação do sistema será tratada como uma notificação do sistema normal.Otherwise, the toast will be treated as a normal toast.

  • Lembrete: a notificação do sistema permanecerá na tela até que o usuário a ignore ou execute uma ação.Reminder: The notification will stay on screen until the user dismisses it or takes action. No Windows Mobile, as notificações do sistema também aparecem pré-expandidas.On Windows Mobile, the toast will also show pre-expanded. Um lembrete sonoro será reproduzido.A reminder sound will be played.
  • Alarme: além de comportamentos de lembrete, os alarmes fazem o loop do áudio com um som de alarme padrão.Alarm: In addition to the reminder behaviors, alarms will additionally loop audio with a default alarm sound.
  • IncomingCall: as notificações de chamadas de entrada são exibidas em tela inteira nos dispositivos Windows Mobile.IncomingCall: Incoming call notifications are displayed full screen on Windows Mobile devices. Caso contrário, elas têm os mesmos comportamentos dos alarmes, exceto que utilizam áudio de toque e os botões têm estilos diferentes.Otherwise, they have the same behaviors as alarms except they use ringtone audio and their buttons are styled differently.
new ToastContentBuilder()
    .SetToastScenario(ToastScenario.Reminder)
    ...

Localização e acessibilidadeLocalization and accessibility

Seu blocos e notificações do sistema podem carregar cadeias de caracteres e imagens adaptadas para exibição de idioma, de fator de escala, alto contraste e outros contextos de tempo de execução.Your tiles and toasts can load strings and images tailored for display language, display scale factor, high contrast, and other runtime contexts. Para obter mais informações, consulte Suporte à notificação de bloco e notificações do sistema para o idioma, escala e alto contraste.For more info, see Tile and toast notification support for language, scale, and high contrast.

Manipular a ativaçãoHandling activation

Para saber como manipular ativações de notificações do sistema (o usuário clica na notificação do sistema ou nos botões dela), consulte Enviar notificação do sistema local.To learn how to handle toast activations (the user clicking your toast or buttons on the toast), see Send local toast.