UWP uygulamasıyla uygulama bildirimlerini kullanma

Uygulama bildirimi, uygulamanızın penceresinin dışında görünen ve kullanıcıya zamanında bilgi veya eylemler sunan bir kullanıcı arabirimi açılır penceresidir. Bildirimler tamamen bilgilendirilebilir, tıklandığında uygulamanızı başlatabilir veya uygulamanızı ön plana getirmeden bir arka plan eylemi tetikleyebilir.

Bu makalede, UWP uygulamasından uygulama bildirimi oluşturma ve gönderme ve kullanıcı etkileşime geçtiğinde etkinleştirmeyi işleme adımlarında size yol gösterilir.

Uygulama bildirimlerine genel bakış ve diğer çerçevelere yönelik yönergeler için bkz. Uygulama bildirimlerine genel bakış.

Bu makale yerel bildirimleri kapsar. Bulut hizmetinden bildirim gönderme hakkında bilgi için Anlık bildirimlere genel bakış bölümüne bakın.

Önkoşullar

• Visual Studio'de UWP uygulama projesi
• Visual Studio’da Evrensel Windows Platformu geliştirme iş yükü kurulu

Uygulama bildirimi gönderme

UWP uygulamaları, XML kullanarak bildirim oluşturmak ve göndermek için Windows.UI.Notifications ad alanını kullanır. Bu bölümde, C# ve C++ kullanarak bildirim gönderme gösterilmektedir.

C#

using Windows.Data.Xml.Dom;
using Windows.UI.Notifications;

var xml = @"<toast launch=""action=viewConversation&amp;conversationId=9813"">
    <visual>
        <binding template=""ToastGeneric"">
            <text>Andrew sent you a picture</text>
            <text>Check this out, The Enchantments in Washington!</text>
        </binding>
    </visual>
</toast>";

var doc = new XmlDocument();
doc.LoadXml(xml);

var notification = new ToastNotification(doc);
ToastNotificationManager.CreateToastNotifier().Show(notification);

C++

using namespace winrt::Windows::UI::Notifications;
using namespace winrt::Windows::Data::Xml::Dom;

XmlDocument doc;
doc.LoadXml(L"\
    <toast launch=\"action=viewConversation&amp;conversationId=9813\">\
        <visual>\
            <binding template=\"ToastGeneric\">\
                <text>Andrew sent you a picture</text>\
                <text>Check this out, The Enchantments in Washington!</text>\
            </binding>\
        </visual>\
    </toast>");

ToastNotification notif{ doc };
ToastNotificationManager::CreateToastNotifier().Show(notif);

Aktivasyonu yönetme

Kullanıcı bildiriminize (veya ön plan etkinleştirmeli bildirimdeki bir düğmeye) tıkladığında uygulamanızın OnActivated yöntemi çağrılır. OnLaunched uygulamanız kapatılıp ilk kez başlatılıyor olsa bile bildirim etkinleştirmeleri için çağrılmaz. Öneriyoruz OnLaunched ve OnActivated öğelerinin paylaşılan bir başlatma yönteminde birleştirilmesini.

C#

App.xaml.cs

protected override void OnLaunched(LaunchActivatedEventArgs e)
{
    OnLaunchedOrActivated(e.PreviousExecutionState);

    var rootFrame = Window.Current.Content as Frame;
    if (e.PrelaunchActivated == false)
    {
        if (rootFrame?.Content == null)
        {
            rootFrame?.Navigate(typeof(MainPage), e.Arguments);
        }
        Window.Current.Activate();
    }
}

protected override void OnActivated(IActivatedEventArgs e)
{
    OnLaunchedOrActivated(e.PreviousExecutionState);

    if (e is ToastNotificationActivatedEventArgs toastArgs)
    {
        var rootFrame = Window.Current.Content as Frame;
        if (rootFrame?.Content == null)
        {
            rootFrame?.Navigate(typeof(MainPage));
        }
        Window.Current.Activate();

        // Parse the notification arguments
        string argument = toastArgs.Argument;
        // TODO: Navigate to the relevant content based on the arguments
    }
}

private void OnLaunchedOrActivated(ApplicationExecutionState previousState)
{
    if (Window.Current.Content is not Frame)
    {
        var rootFrame = new Frame();
        rootFrame.NavigationFailed += OnNavigationFailed;
        Window.Current.Content = rootFrame;
    }
}

C++

App.xaml.cpp

void App::OnLaunched(LaunchActivatedEventArgs const& e)
{
    OnLaunchedOrActivated(e.PreviousExecutionState());

    auto rootFrame = Window::Current().Content().try_as<Frame>();
    if (!e.PrelaunchActivated())
    {
        if (rootFrame.Content() == nullptr)
        {
            rootFrame.Navigate(xaml_typename<MainPage>(), box_value(e.Arguments()));
        }
        Window::Current().Activate();
    }
}

void App::OnActivated(IActivatedEventArgs const& e)
{
    OnLaunchedOrActivated(e.PreviousExecutionState());

    if (e.Kind() == ActivationKind::ToastNotification)
    {
        auto toastArgs = e.as<ToastNotificationActivatedEventArgs>();

        auto rootFrame = Window::Current().Content().try_as<Frame>();
        if (rootFrame.Content() == nullptr)
        {
            rootFrame.Navigate(xaml_typename<MainPage>());
        }
        Window::Current().Activate();

        // Parse the notification arguments
        auto argument = toastArgs.Argument();
        // TODO: Navigate to the relevant content based on the arguments
    }
}

void App::OnLaunchedOrActivated(ApplicationExecutionState previousState)
{
    if (Window::Current().Content() == nullptr)
    {
        auto rootFrame = Frame();
        rootFrame.NavigationFailed({ this, &App::OnNavigationFailed });
        Window::Current().Content(rootFrame);
    }
}

Bildirimlerinize düğme, görüntü, giriş, ses ve diğer zengin içerik ekleme hakkında bilgi için bkz. Uygulama bildirimi içeriği.

İlgili içerik

• Hızlı Başlangıç: Windows Uygulama SDK'sındaki Uygulama Bildirimleri
• Uygulama bildirim içeriği
• ToastNotification Sınıfı
• ToastNotificationActivatedEventArgs Sınıfı