Conteúdo da notificação do aplicativo

Este artigo descreve os elementos da interface do usuário que podem ser usados em uma notificação de aplicativo e fornece exemplos de código para gerar o conteúdo da notificação. Para obter mais informações sobre notificações do aplicativo, consulte a visão geral das notificações do aplicativo. Para obter um passo a passo da implementação de notificações de aplicativo, consulte Quickstart: Notificações de aplicativo no SDK do Aplicativo Windows.

Como começar

As notificações do aplicativo são definidas com uma carga XML definida pelo esquema de notificação do aplicativo. Atualmente, há duas maneiras de gerar o conteúdo XML para uma notificação de aplicativo. Os exemplos de código neste artigo demonstram ambos os métodos:

• O Microsoft.Windows.AppNotifications.Builder APIs – introduzido no SDK do Aplicativo Windows 1.2, este namespace fornece APIs que permitem construir facilmente o payload XML para uma notificação de maneira programática sem precisar se preocupar com as especificidades do formato XML. Exemplos de código usando essas APIs estão nas guias rotuladas como "SDK do Aplicativo Windows".
• XML bruto – se preferir, você pode criar seu próprio código personalizado para gerar cadeias de caracteres XML no formato necessário. Os exemplos de XML brutos estão nas guias rotuladas como "XML".

Instalar o Visualizador de Notificações. Este aplicativo gratuito para Windows ajuda você a criar notificações interativas de apps, fornecendo uma pré-visualização instantânea do seu toast ao editá-la, semelhante ao editor de design XAML do Visual Studio. Consulte o Visualizador de Notificações para obter mais informações ou baixe o Visualizador de Notificações naLoja.

Este artigo aborda apenas a criação do conteúdo da notificação do aplicativo. Para obter informações sobre como enviar uma notificação, consulte a visão geral das notificações do aplicativo.

Estrutura de notificação do aplicativo

Alguns componentes importantes e de alto nível de uma carga XML de notificação do aplicativo incluem:

• notificação: o atributo lançamento desse elemento define quais argumentos serão passados de volta para seu aplicativo quando o usuário clicar na sua notificação, permitindo que você faça um link profundo para o conteúdo correto que a notificação estava exibindo. Para saber mais, confira a visão geral das notificações do aplicativo.
• visual: esse elemento representa a parte visual do toast, incluindo a vinculação genérica que contém texto e imagens.
• ações: esse elemento representa a parte interativa do aviso de notificação, incluindo entradas e ações.
• de áudio: esse elemento especifica o áudio reproduzido quando a notificação é exibida ao usuário.

var builder = new AppNotificationBuilder()
    .AddArgument("conversationId", "9813")

    .AddText("Some text")

    .AddButton(new AppNotificationButton("Archive")
        .AddArgument("action", "archive"))

    .SetAudioUri(new Uri("ms-appx:///Sound.mp3"));

<toast launch='conversationId=9813'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Some text</text>
        </binding>
    </visual>
    <audio src='ms-appx:///Audio/NotificationSound.mp3'/>
    <actions>
        <action content='Archive' arguments='action=archive'/>
    </actions>
</toast>

Aqui está uma representação visual do conteúdo da notificação do aplicativo:

Área de atribuição

A área de atribuição está na parte superior da notificação do aplicativo. A partir do Windows 11, o nome e o ícone do aplicativo são exibidos nessa área. A área de atribuição também inclui um botão de fechar que permite ao usuário ignorar rapidamente a notificação e um menu de três pontos que permite ao usuário desabilitar rapidamente as notificações para seu aplicativo ou ir para a página de Configurações do Windows para as notificações do aplicativo. A área de atribuição é configurada pelo shell e não pode ser substituída na carga XML do sistema, embora seu aplicativo possa adicionar itens ao menu de contexto da área de atribuição. Para obter mais informações , consulte as ações do menu Contexto.

Visual

Cada notificação de aplicativo deve especificar um elemento visual, onde você deve fornecer uma vinculação de toast genérica e que pode conter texto e imagens. Esses elementos serão renderizados em vários dispositivos Windows, incluindo desktop, telefones, tablets e Xbox.

Para todos os atributos com suporte na seção visual e seus elementos filho, consulte esquema de notificação de aplicativo.

Elementos de texto

Cada notificação do aplicativo deve ter pelo menos um elemento de texto e pode conter dois elementos de texto adicionais, todos do tipo AdaptiveText. Os elementos de texto dão suporte à associação de dados, o que permite que você atualize o conteúdo do texto após a notificação ser exibida. Para obter mais informações, consulte a barra de progresso da notificação do aplicativo e a associação de dados.

Você pode controlar quantas linhas de texto são exibidas usando o método AppNotificationTextProperties.SetMaxLines . O padrão (e máximo) é 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).

var builder = new AppNotificationBuilder()
    .AddArgument("conversationId", 9813)
    .AddText("Adaptive Tiles Meeting", new AppNotificationTextProperties().SetMaxLines(1))
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

<toast launch='meetingId=9813'>
    <visual>
        <binding template='ToastGeneric'>
            <text hint-maxLines='1'>Adaptive Tiles Meeting</text>
            <text>Conf Room 2001 / Building 135</text>
            <text>10:00 AM - 10:30 AM</text>
        </binding>
    </visual>
</toast>

Imagem embutida

Por padrão, as imagens são exibidas embutidas, após qualquer elemento de texto, preenchendo a largura total da área visual. Use AppNotificationBuilder.SetInlineImage para adicionar uma imagem embutida.

var builder = new AppNotificationBuilder()
    .AddText("Featured image of the day.")
    .SetInlineImage(new Uri("ms-appx:///Images/InlineImage.png"));

AppNotificationManager.Default.Show(builder.BuildNotification());

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Featured image of the day.</text>
            <image src='ms-appx:///Images/InlineImage.png'/>
        </binding>
    </visual>
</toast>

Substituição do logotipo do aplicativo

Especificar um valor de posicionamento como "appLogoOverride" fará com que a imagem seja exibida em um quadrado no lado esquerdo da área visual. Use AppNotificationBuilder.SetAppLogoOverride para definir essa imagem. O nome dessa propriedade reflete o comportamento em versões anteriores do Windows, em que a imagem substituiria a imagem do logotipo do aplicativo padrão. Em Windows 11, o logotipo do aplicativo é exibido na área de atribuição, portanto, ele não é substituído pelo posicionamento da imagem appLogoOverride.

As dimensões da imagem são de 48 x 48 pixels com escala de 100%. Geralmente, recomendamos fornecer uma versão de cada ativo de ícone para cada fator de escala: 100%, 125%, 150%, 200%e 400%.

var builder = new AppNotificationBuilder()
    .AddText("Featured image of the day.")
    .SetAppLogoOverride(new Uri("ms-appx:///Images/AppLogo.png"));

Sugestão de recorte

Microsoft diretrizes de estilo recomendam representar imagens de perfil com uma imagem circular para fornecer uma representação consistente de pessoas entre aplicativos e o shell. Passe AppNotificationImageCrop.Circle para SetAppLogoOverride para renderizar a imagem com um corte circular.

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetAppLogoOverride(new Uri("ms-appx:///Images/Profile.png"), AppNotificationImageCrop.Circle);

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Matt sent you a friend request</text>
            <text>Hey, wanna dress up as wizards and ride around on hoverboards?</text>
            <image placement='appLogoOverride' src='ms-appx:///Images/Profile.png' hint-crop='circle'/>
        </binding>
    </visual>
</toast>

Imagem em destaque

As notificações do aplicativo podem exibir uma imagem destacada, que é um ToastGenericHeroImage em destaque no banner do toast e dentro da Central de Notificações. Use AppNotificationBuilder.SetHeroImage para adicionar uma imagem de herói. As dimensões da imagem são 364 x 180 pixels com escala de 100%%.

var builder = new AppNotificationBuilder()
    .AddText("Marry Anne")
    .AddText("Check out where we camped last night!")
    .SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"));

Restrições de tamanho de imagem

As imagens que você usa na notificação do aplicativo podem ser originadas de...

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

Para imagens da Web remotas http e https, há limites no tamanho do arquivo de cada imagem individual. O limite é de 3 MB em conexões normais e 1 MB em conexões limitadas.

Se uma imagem exceder o tamanho do arquivo ou não baixar ou atingir o tempo limite, a imagem será descartada e o restante da notificação será exibida.

Texto de atribuição

Se você precisar referenciar a origem do conteúdo, poderá usar o texto de atribuição. Use AppNotificationBuilder.SetAttributionText para definir o texto de atribuição. Esse texto é sempre exibido abaixo de qualquer elemento de texto, mas acima de imagens embutidas. O texto usa um tamanho ligeiramente menor do que os elementos de texto padrão para ajudar a distinguir dos elementos de texto regulares.

Em versões mais antigas de Windows que não dão suporte ao texto de atribuição, o texto será simplesmente exibido como outro elemento de texto (supondo que você ainda não tenha o máximo de três elementos de texto).

var builder = new AppNotificationBuilder()
    .AddText("Marry Anne")
    .AddText("Check out where we camped last night!")
    .SetAttributionText("via SMS");
    .SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"));

<toast>  
  <visual>
    <binding template="ToastGeneric">
      <image src="ms-appx:///Images/HeroImage.png"/>
      <text>Mary Anne</text>
      <text>Check out where we camped last night!</text>
      <text placement="attribution">Via SMS</text>
    </binding>
  </visual>
</toast>

Carimbo de data/hora personalizado

Você pode substituir o carimbo de data/hora fornecido pelo sistema com seu próprio carimbo de data/hora que representa com precisão quando a mensagem/informação/conteúdo foi gerada. Esse carimbo de data/hora é visível na Central de Notificações.

Para saber mais sobre como usar um carimbo de data/hora personalizado, consulte carimbos de data/hora personalizados nas notificações do aplicativo.

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));

<toast displayTimestamp='2017-04-15T12:45:00-07:00'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Matt sent you a friend request</text>
            <text>Hey, wanna dress up as wizards and ride around on hoverboards?</text>
        </binding>
    </visual>
</toast>

Barra de progresso

Você pode fornecer uma barra de progresso na notificação do aplicativo para manter o usuário informado sobre o progresso das operações, como downloads. As barras de progresso dão suporte à associação de dados, o que permite atualizar dinamicamente os valores de progresso depois que a notificação é exibida.

Para saber mais sobre como usar uma barra de progresso, consulte a barra de progresso da notificação do aplicativo e a associação de dados.

Cabeçalhos

Você pode agrupar notificações em cabeçalhos na Central de Notificações. Por exemplo, você pode agrupar mensagens de um chat em grupo em um cabeçalho ou agrupar notificações de um tema comum em um cabeçalho ou mais.

Para saber mais sobre como usar cabeçalhos, consulte os cabeçalhos de notificação do aplicativo.

Conteúdo adaptável

Além do conteúdo especificado acima, você também pode exibir conteúdo adaptável adicional que fica visível quando a notificação é expandida.

Esse conteúdo adicional é especificado usando Adaptive, sobre o qual você pode saber mais lendo a documentação de Blocos Adaptáveis.

Observe que qualquer conteúdo adaptável deve estar contido em um AdaptiveGroup. Caso contrário, ele não será renderizado usando adaptativo.

Colunas e elementos de texto

Aqui está um exemplo em que colunas e alguns elementos de texto adaptáveis avançados são usados. Como os elementos de texto estão dentro de um AdaptiveGroup, eles dão suporte a todas as propriedades de estilo ricamente adaptáveis.

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support adaptive text elements.

<toast launch="app-defined-string">
  <visual>
    <binding template="ToastGeneric">
      <text>Reminder: Windows Launch Party</text>
      <text>4:00 PM, 10/21/2021</text>
      <group>
        <subgroup>
          <text hint-style="base">52 attendees</text>
          <text hint-style="captionSubtle">23 minute drive</text>
        </subgroup>
        <subgroup>
          <text hint-style="captionSubtle" hint-align="right">1 Microsoft Way</text>
          <text hint-style="captionSubtle" hint-align="right">Bellevue, WA 98008</text>
        </subgroup>
      </group>
    </binding>
  </visual>
</toast>

Buttons

Os botões tornam o toast interativo, permitindo que o usuário execute ações rápidas na notificação do aplicativo sem interromper o fluxo de trabalho atual. Por exemplo, os usuários podem responder a uma mensagem diretamente de uma notificação flutuante ou excluir um email sem sequer abrir o aplicativo de email. Os botões aparecem na parte expandida da notificação. Use AppNotificationButton para definir botões e AppNotificationBuilder.AddButton para adicioná-los à notificação.

Para saber mais sobre como implementar botões de ponta a ponta, confira a visão geral das notificações do aplicativo.

Os botões podem ativar um aplicativo das seguintes maneiras:

• O aplicativo é ativado em primeiro plano, com um argumento que pode ser usado para navegar até uma página/contexto específico.
• Outro aplicativo é ativado por meio da inicialização do protocolo.
• A ativação em segundo plano tem suporte explícito para aplicativos UWP. Para aplicativos SDK do Aplicativo Windows, o aplicativo é sempre iniciado em primeiro plano. O aplicativo pode chamar AppInstance.GetActivatedEventArgs para detectar se a ativação foi iniciada por uma notificação e determinar pelos argumentos passados se deseja iniciar totalmente o aplicativo em primeiro plano ou apenas manipular a notificação e sair.
• Ações do sistema, como adiar ou ignorar a notificação, têm suporte tanto para aplicativos UWP quanto para SDK do Windows App. As APIs AppNotificationBuilder não dão suporte a esse cenário, mas SDK do Aplicativo Windows aplicativos podem implementar esse cenário usando o Microsoft.Windows. AppNotifications.Builder APIs ou XML bruto.

var builder = new AppNotificationBuilder()
    .AddText("New product in stock!")
    .AddButton(new AppNotificationButton("See more details")
        .AddArgument("action", "viewDetails"))
        .AddArgument("contentId", "351")
    .AddButton(new AppNotificationButton("Remind me later")
        .AddArgument("action", "remindLater"))
        .AddArgument("contentId", "351");

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>New product in stock!</text>
        </binding>
    </visual>
      <actions>
          <action content='See more details' arguments='action=viewDetails;contentId=351'/>
          <action content='Remind me later' arguments='action=remindLater;contentId=351'/>
      </actions>
</toast>

Botões com ícones

Você pode adicionar ícones aos botões usando AppNotificationButton.SetIcon. Esses ícones são imagens transparentes brancas de 16x16 pixels com escala de 100%, e não devem ter nenhum preenchimento na própria imagem. Se você optar por fornecer ícones em uma notificação de aplicativo, deverá fornecer ícones para TODOS os botões na notificação, pois transformará o estilo dos botões em botões de ícone.

var builder = new AppNotificationBuilder()
    .AddText("Return books to the library.")
    .AddButton(new AppNotificationButton("Accept")
        .AddArgument("action", "accept")
        .SetIcon(new Uri("ms-appx:///Images/Accept.png")))
    .AddButton(new AppNotificationButton("Snooze")
        .AddArgument("action", "snooze")
        .SetIcon(new Uri("ms-appx:///Images/Snooze.png")))
    .AddButton(new AppNotificationButton("Dismiss")
        .AddArgument("action", "dismiss")
        .SetIcon(new Uri("ms-appx:///Images/Dismiss.png")));

Novo no Windows 11 Update: você pode adicionar dicas de ferramentas aos ícones com a propriedade HintToolTip no XML. Isso é ideal se os botões tiverem ícones, mas nenhum conteúdo, pois isso garantirá que você possa passar texto que Windows Narrador possa ler. No entanto, se o conteúdo estiver presente, o Narrador lerá o conteúdo, independentemente do que for passado na dica de ferramenta.

var button = new AppNotificationButton("Reply")
    .AddArgument("action", "reply");

if (AppNotificationButton.IsToolTipSupported())
{
    button.ToolTip = "Click to reply.";
}

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .AddButton(button); 

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <actions>
        <action content='Reply' arguments='action=reply' hint-toolTip='Click to reply'/>
    </actions>
</toast>

Botões com cores

Novo no Windows 11 Update: você pode adicionar cores vermelhas ou verdes aos botões usando AppNotificationButton.SetButtonStyle com AppNotificationButtonStyle. No XML, adicione o atributo useButtonStyle ao elemento toast e o atributo hint-buttonStyle ao elemento de ação, conforme visto abaixo.

var builder = new AppNotificationBuilder()
    .SetScenario(AppNotificationScenario.IncomingCall)
    .AddText("Andrew Bares", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .AddText("Incoming Call - Mobile", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .SetInlineImage(new Uri("ms-appx:///Images/Profile.png"),
        AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton()
        .SetToolTip("Answer Video Call")
        .SetButtonStyle(AppNotificationButtonStyle.Success)
        .SetIcon(new Uri("ms-appx:///Images/Video.png"))
        .AddArgument("videoId", "123"))
    .AddButton(new AppNotificationButton()
        .SetToolTip("Answer Phone Call")
        .SetButtonStyle(AppNotificationButtonStyle.Success)
        .SetIcon(new Uri("ms-appx:///Images/Call.png"))
        .AddArgument("callId", "123"))
    .AddButton(new AppNotificationButton()
        .SetToolTip("Hang Up")
        .SetButtonStyle(AppNotificationButtonStyle.Critical)
        .SetIcon(new Uri("ms-appx:///Images/HangUp.png"))
        .AddArgument("hangUpId", "123"));

<toast scenario='incomingCall' useButtonStyle='true'>
    <visual>
        <binding template='ToastGeneric'>
            <text hint-callScenarioCenterAlign='true'>Andrew Bares</text>
            <text hint-callScenarioCenterAlign='true'>Incoming Call - Mobile</text>
            <image src='ms-appx:///Images/InlineImage.png' hint-crop='circle'/>
        </binding>
    </visual>
    <actions>
        <action 
            content='' 
            arguments='videoId=123' 
            imageUri='ms-appx:///Images/Video.png' 
            hint-buttonStyle='Success' 
            hint-toolTip='Answer Video Call'/>
        <action 
            content='' 
            arguments='callId=123' 
            imageUri='ms-appx:///Images/Call.png' 
            hint-buttonStyle='Success' 
            hint-toolTip='Answer Phone Call'/>
        <action 
            content='' 
            arguments='hangUpId=123' 
            imageUri='ms-appx:///Images/HangUp.png' 
            hint-buttonStyle='Critical' 
            hint-toolTip='Hang Up'/>
    </actions>
</toast>

Ações de menu de contexto

Você pode adicionar outras 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 notificação do aplicativo ou seleciona o ícone de menu de contexto. Use AppNotificationButton.SetContextMenuPlacement para colocar um botão no menu de contexto em vez da barra de ações.

As ações do menu de contexto adicionais que você adicionar (como "Silenciar chat em grupo por 1 hora") aparecem acima das duas entradas padrão do sistema.

de menu de contexto

var builder = new AppNotificationBuilder()
    .AddText("Camping this weekend?")
    .SetAppLogoOverride(new Uri("ms-appx:///images/Reply.png"), AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton("Mute group chat for 1 hour")
        .AddArgument("action", "mute")
        .SetContextMenuPlacement());

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Camping this weekend?</text>
            <image placement='appLogoOverride' src='ms-appx:///images/Reply.png' hint-crop='circle'/>
        </binding>
    </visual>
    <actions>
        <action content='Mute group chat for 1 hour' arguments='action=mute' placement='contextMenu'/>
    </actions>
</toast>

A ativação de itens adicionais do menu de contexto é feita da mesma forma que os botões de notificação.

Entradas

As entradas são especificadas na região de ações Actions da notificação do aplicativo, o que significa que só ficam visíveis quando a notificação é expandida.

Caixa de texto de resposta rápida

Para habilitar uma caixa de texto de resposta rápida (por exemplo, em um aplicativo de mensagens), adicione uma entrada de texto com AppNotificationBuilder.AddTextBox e um botão e faça referência à ID do campo de entrada de texto para que o botão seja exibido ao lado do campo de entrada. O ícone opcional do botão, se fornecido, deve ser uma imagem de 32 x 32 pixels sem preenchimento, com pixels brancos definidos como transparentes e em escala 100%.

var builder = new AppNotificationBuilder()
    .AddTextBox("textBox", "Type a reply", "Reply")
    .AddButton(AppNotificationButton("Send")
        .AddArguments("action", "Send")
        .SetInputId("textBox"))
    .BuildNotification();

<toast launch="app-defined-string">
  <visual>
    <binding template="ToastGeneric">
      <image placement="appLogoOverride" hint-crop="circle" src="https://picsum.photos/48?image=883"/>
      <text>Andrew Bares</text>
      <text>Shall we meet up at 8?</text>
    </binding>
  </visual>
  <actions>
    <input id="textBox" type="text" placeHolderContent="Type a reply"/>
    <action
      content="Send"
      arguments="action=reply&amp;convId=9318"
      hint-inputId="textBox"
      imageUri="Assets/Reply.png"/>
  </actions>
</toast>

Entradas com barra de botões

Você também pode ter uma (ou muitas) entradas com botões normais exibidos abaixo das entradas.

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support quick reply text boxes.

<toast launch="app-defined-string">
  <visual>
    <binding template="ToastGeneric">
      <image placement="appLogoOverride" hint-crop="circle" src="https://picsum.photos/48?image=883"/>
      <text>Andrew Bares</text>
      <text>Shall we meet up at 8?</text>
    </binding>
  </visual>
  <actions>
    <input id="textBox" type="text" placeHolderContent="Type a reply"/>
    <action
      content="Reply"
      arguments="action=reply&amp;threadId=9218"/>
    <action
      content="Video call"
      arguments="action=videocall&amp;threadId=9218"
      activationType="foreground"/>
  </actions>
</toast>

Entrada de seleção

Além das caixas de texto, você também pode usar um menu de seleção com AppNotificationBuilder.AddComboBox.

var builder = new AppNotificationBuilder()
    .AddText("4th coffee?")
    .AddText("When do you plan to come in tomorrow?")
    .AddComboBox(new AppNotificationComboBox("time")
        .SetTitle("Select an item:")
        .AddItem("breakfast", "Breakfast")
        .AddItem("lunch", "Lunch")
        .AddItem("dinner", "Dinner")
        .SetSelectedItem("lunch"))
    .AddButton(new AppNotificationButton("Reply")
        .AddArgument("action", "reply")
        .AddArgument("threadId", "9218")
        .SetContextMenuPlacement())
    .AddButton(new AppNotificationButton("Call restaurant")
        .AddArgument("action", "videocall")
        .AddArgument("threadId", "9218")
        .SetContextMenuPlacement());

Snooze/dismiss

Usando um menu de seleção e dois botões, podemos criar uma notificação de lembrete que utiliza as ações de adiar e descarte do sistema. Defina o cenário como "Lembrete" para que a notificação se comporte como um lembrete.

Vinculamos o botão de soneca à entrada do menu de seleção usando a propriedade SelectionBoxId no botão da notificação.

A sintaxe Microsoft.Windows.AppNotifications.Builder não suporta atualmente a ativação do sistema. Mas esse cenário tem suporte para SDK do Aplicativo Windows aplicativos e você pode criar notificações para esse cenário usando XML bruto.

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support system activation. 
// But this scenario is supported for Windows App SDK apps, and you can build notifications for this 
// scenario using raw XML.

Para usar as ações de soneca e descaso do sistema:

• Especifique um ToastButtonSnooze ou ToastButtonDismiss
• Opcionalmente, especifique uma cadeia de caracteres de conteúdo personalizada:
• Se você não fornecer uma cadeia de caracteres, usaremos automaticamente cadeias de caracteres localizadas para "Snooze" e "Dismiss".
• Opcionalmente, especifique o SelectionBoxId:
• Se você não quiser que o usuário selecione um intervalo de soneca e, em vez disso, apenas queira que sua notificação soneca apenas uma vez durante um intervalo de tempo definido pelo sistema (que seja consistente em todo o sistema operacional), não construa nenhuma entrada <>.
• Se você quiser fornecer seleções de intervalo de soneca: – especifique SelectionBoxId na ação de soneca – corresponda o ID da entrada com o SelectionBoxId da ação de soneca – especifique que o valor de ToastSelectionBoxItemseja um número inteiro não negativo que represente o intervalo de soneca em minutos.

Áudio

Use AppNotificationBuilder.SetAudioUri para especificar um arquivo de áudio personalizado ou use AppNotificationBuilder.SetAudioEvent para selecionar um som do sistema. O áudio personalizado pode ser referenciado por meio dos seguintes caminhos:

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

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"));

Como alternativa, você pode escolher da lista de ms-winsoundevents, que sempre tiveram suporte em ambas as plataformas.

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioEvent(AppNotificationSoundEvent.Alarm, AppNotificationAudioLooping.Loop);

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-winsoundevent:Notification.Looping.Alarm' loop='true'/>
</toast>

Consulte a página de esquema de áudio para obter informações sobre áudio em notificações do aplicativo. Para saber como enviar uma notificação de aplicativo que usa áudio personalizado, consulte Áudio personalizado em notificações do aplicativo.

Cenários

Para criar notificações importantes, alarmes, lembretes e notificações de chamada de entrada, use AppNotificationBuilder.SetScenario com um valor AppNotificationScenario . O cenário ajusta alguns comportamentos para criar uma experiência de usuário consistente e unificada. Há quatro valores possíveis dos Cenários :

• Reminder
• Alarm
• IncomingCall
• Urgent

Lembretes

No cenário de lembrete, a notificação permanecerá na tela até que o usuário a descarte ou execute uma ação. No Windows Mobile, a notificação do aplicativo também será exibida já expandida. Um som de lembrete será reproduzido. Você deve fornecer pelo menos um botão na notificação do aplicativo. Caso contrário, a notificação será tratada como uma notificação normal.

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetScenario(AppNotificationScenario.Reminder);

<toast scenario='reminder'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
</toast>

Alarmes

Os alarmes se comportam da mesma forma que os lembretes, exceto que os alarmes também farão loop de áudio com um som de alarme padrão. Você deve fornecer pelo menos um botão na notificação do aplicativo. Caso contrário, a notificação será tratada como uma notificação normal.

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetScenario(AppNotificationScenario.Alarm)
    .AddButton(new AppNotificationButton("Dismiss")
        .AddArgument("action", "dismiss"));

<toast scenario='alarm'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <actions>
        <action content='Dismiss' arguments='action=dismiss'/>
    </actions>
</toast>

Chamadas de entrada

As notificações de chamada de entrada são exibidas previamente expandidas em um formato de chamada especial e permanecem na tela do usuário até serem ignoradas. O áudio de toque será repetido por padrão. Em dispositivos móveis Windows, eles exibem tela inteira.

var builder = new AppNotificationBuilder()
    .SetScenario(AppNotificationScenario.IncomingCall)
    .AddText("Andrew Bares", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
    .AddText("incoming call - mobile", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .SetInlineImage(new Uri("ms-appx:///images/profile.png"),
        AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton("Text reply")
        .SetToolTip("Text reply")
        .SetIcon(new Uri("ms-appx:///images/reply.png"))
        .AddArgument("textId", "123"))
    .AddButton(new AppNotificationButton("Reminder")
        .SetToolTip("Reminder")
        .SetIcon(new Uri("ms-appx:///images/reminder.png"))
        .AddArgument("reminderId", "123"))
    .AddButton(new AppNotificationButton("Ignore")
        .SetToolTip("Ignore")
        .SetIcon(new Uri("ms-appx:///images/ignore.png"))
        .AddArgument("ignoreId", "123"))
    .AddButton(new AppNotificationButton("Answer")
        .SetToolTip("Answer")
        .SetIcon(new Uri("ms-appx:///images/answer.png"))
        .AddArgument("answerId", "123"));

<toast scenario='incomingCall'>
    <visual>
        <binding template='ToastGeneric'>
            <text hint-callScenarioCenterAlign='true'>Andrew Bares</text>
            <text hint-callScenarioCenterAlign='true'>incoming call - mobile</text>
            <image src='ms-appx:///images/profile.png' hint-crop='circle'/>
        </binding>
    </visual>
    <actions>
        <action 
            content='Text reply' 
            arguments='textId=123' 
            imageUri='ms-appx:///images/reply.png' 
            hint-toolTip='Text reply'/>
        <action 
                content='Reminder' 
                arguments='reminderId=123' 
                imageUri='ms-appx:///images/reminder.png' 
                hint-toolTip='Reminder'/>
        <action 
                content='Ignore' 
                arguments='ignoreId=123' 
                imageUri='ms-appx:///images/ignore.png' 
                hint-toolTip='Ignore'/>
        <action 
            content='Answer' 
            arguments='answerId=123' 
            imageUri='ms-appx:///images/answer.png' 
            hint-toolTip='Answer'/>
    </actions>
</toast>

Notificações importantes

Notificações importantes permitem que os usuários tenham mais controle sobre quais aplicativos de primeiro e terceiros podem enviar notificações de aplicativos de alta prioridade (urgentes/importantes) que podem ultrapassar o Focus Assist (Não Incomodar). Isso pode ser modificado nas configurações de notificações.

var builder = new AppNotificationBuilder()
    .AddText("Adaptive Tiles Meeting", 
        new AppNotificationTextProperties()
            .SetMaxLines(1))
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

if (AppNotificationBuilder.IsUrgentScenarioSupported())
{
    builder.SetScenario(AppNotificationScenario.Urgent);
}

<toast scenario='urgent'>
    <visual>
        <binding template='ToastGeneric'>
            <text hint-maxLines='1'>Adaptive Tiles Meeting</text>
            <text>Conf Room 2001 / Building 135</text>
            <text>10:00 AM - 10:30 AM</text>
        </binding>
    </visual>
</toast>

Localização e acessibilidade

Seus blocos e notificações de aplicativo podem carregar cadeias de caracteres e imagens personalizadas para linguagem de exibição, fator de escala de exibição, alto contraste e outros contextos de runtime. Para obter mais informações, consulte suporte à notificação de blocos e toast para linguagem, escala e alto contraste.

Gerenciamento da ativação

Para saber como lidar com ativações de aplicativo (o usuário clicando em sua notificação ou botões na notificação), consulte a visão geral das notificações do aplicativo.  

Tópicos relacionados

• Visão geral das notificações do aplicativo
• suporte para notificações de tiles e toast em linguagem, escala e alto contraste