Konten toast

Pemberitahuan toast adaptif dan interaktif memungkinkan Anda membuat pemberitahuan fleksibel dengan teks, gambar, dan tombol/input.

API Penting: Paket nuget Pemberitahuan Toolkit Komunitas UWP

Memulai

Anda dapat menentukan konten pemberitahuan menggunakan XML atau Microsoft.Toolkit.Uwp.Notifications sintaks penyusun. Untuk menggunakan XML, ikuti tab sampel XML di bawah ini dan referensikan skema XML pemberitahuan toast. Untuk menggunakan Microsoft.Toolkit.Uwp.Notification sintaksis penyusun C#, instal paket NuGet Microsoft.Toolkit.Uwp.Notifications, ikuti tab sampel sintaks Builder di bawah ini dan referensikan skema konten toast. Sampel C# yang disediakan dalam artikel ini menggunakan versi 7.0.0 dari paket NuGet.

Instal Visualizer Pemberitahuan. Aplikasi Windows gratis ini membantu Anda merancang pemberitahuan toast interaktif dengan menyediakan pratinjau visual instan roti panggang saat Anda mengeditnya, mirip dengan tampilan editor/desain XAML Visual Studio. Lihat Visualizer Pemberitahuan untuk informasi selengkapnya, atau unduh Visualizer Pemberitahuan dari Bursa.

Mengirim pemberitahuan toast

Untuk mempelajari cara mengirim pemberitahuan, lihat Mengirim toast lokal. Dokumentasi ini hanya mencakup pembuatan konten toast.

Struktur pemberitahuan toast

Pemberitahuan toast adalah kombinasi dari beberapa properti data seperti Tag/Grup (yang memungkinkan Anda mengidentifikasi pemberitahuan) dan konten toast.

Komponen inti konten roti panggang adalah...

  • peluncuran: Ini menentukan argumen apa yang akan diteruskan kembali ke aplikasi Anda saat pengguna mengklik roti panggang Anda, memungkinkan Anda untuk menautkan ke dalam konten yang benar yang ditampilkan oleh toast. Untuk mempelajari selengkapnya, lihat Mengirim roti panggang lokal.
  • visual: Bagian visual dari toast, termasuk pengikatan generik yang berisi teks dan gambar.
  • actions: Bagian interaktif dari toast, termasuk input dan tindakan.
  • audio: Mengontrol audio yang diputar saat toast ditampilkan kepada pengguna.

Konten toast didefinisikan dalam XML mentah, tetapi Anda dapat menggunakan pustaka NuGet kami untuk mendapatkan model objek C# (atau C++) untuk membuat konten toast. Artikel ini mencocokkan semua yang masuk ke dalam konten toast.

new ToastContentBuilder()
    .AddArgument("conversationId", 9813)

    .AddText("Some text")

    .AddButton(new ToastButton()
        .SetContent("Archive")
        .AddArgument("action", "archive")
        .SetBackgroundActivation())

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

Berikut adalah representasi visual dari konten toast:

Cuplikan layar pemberitahuan toast dengan label untuk area atribusi di bagian atas memperlihatkan ikon aplikasi dan nama aplikasi Notifications Visualizer. Bagian tengah roti panggang diberi label sebagai area visual, yang mencakup tiga baris teks. Bagian bawah roti panggang diberi label sebagai area tindakan dan berisi dua tombol berlabel Terima dan Tolak.

Area atribusi

Area atribusi berada di bagian atas pemberitahuan toast. Dimulai dengan Windows 11, nama dan ikon aplikasi Anda ditampilkan di area ini. Area atribusi juga menyertakan tombol tutup yang memungkinkan pengguna untuk dengan cepat menutup pemberitahuan dan menu elipsis yang memungkinkan pengguna untuk dengan cepat menonaktifkan pemberitahuan untuk aplikasi Anda atau masuk ke halaman Pengaturan Windows untuk pemberitahuan aplikasi Anda. Area atribusi dikonfigurasi oleh shell dan tidak dapat ditimpa dalam payload XML toast, meskipun aplikasi Anda dapat menambahkan item ke menu konteks area atribusi. Untuk informasi selengkapnya, lihat Tindakan menu konteks.

Visual

Setiap roti panggang harus menentukan visual, di mana Anda harus menyediakan pengikatan toast generik, yang dapat berisi teks, gambar, dan banyak lagi. Elemen-elemen ini akan dirender di berbagai perangkat Windows, termasuk desktop, ponsel, tablet, dan Xbox.

Untuk semua atribut yang didukung di bagian visual dan elemen anaknya, lihat dokumentasi skema.

Elemen teks

Setiap roti panggang harus memiliki setidaknya satu elemen teks, dan dapat berisi dua elemen teks tambahan, semua jenis AdaptiveText.

Cuplikan layar pemberitahuan toast dengan tiga baris teks. Baris atas teks tebal.

Karena Windows 10 Anniversary Update, Anda dapat mengontrol berapa banyak baris teks yang ditampilkan dengan menggunakan properti HintMaxLines pada teks. Default (dan maksimum) adalah hingga 2 baris teks untuk judul, dan hingga 4 baris (gabungan) untuk dua elemen deskripsi tambahan ( AdaptiveText kedua dan ketiga).

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

Gambar sebaris

Secara default, gambar ditampilkan sebaris, setelah elemen teks apa pun, mengisi lebar penuh area visual.

Cuplikan layar pemberitahuan toast yang menunjukkan penempatan gambar default, sebaris, mengisi lebar penuh area visual.

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

Penimpaan logo aplikasi

Menentukan nilai penempatan appLogoOverride akan menyebabkan gambar ditampilkan dalam persegi di sisi kiri area visual. Nama properti ini mencerminkan perilaku di versi Windows sebelumnya, di mana gambar akan menggantikan gambar logo aplikasi default. Dalam Windows 11, logo aplikasi ditampilkan di area atribusi, sehingga tidak ditimpa oleh penempatan gambar appLogoOverride.

Dimensi gambar adalah 48x48 piksel pada penskalan 100%. Kami umumnya merekomendasikan untuk menyediakan versi setiap aset ikon untuk setiap faktor skala: 100%, 125%, 150%, 200%, dan 400%.

Cuplikan layar pemberitahuan toast yang menunjukkan logo aplikasi menimpa penempatan gambar dalam persegi di sisi kiri area visual roti panggang.

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

Pemangkasan petunjuk

Panduan gaya Microsoft merekomendasikan untuk mewakili gambar profil dengan gambar melingkar untuk memberikan representasi orang yang konsisten di seluruh aplikasi dan shell. Atur properti HintCrop ke Lingkaran untuk merender gambar dengan pemotongan melingkar.

Cuplikan layar pemberitahuan toast yang menunjukkan logo aplikasi mengambil alih penempatan gambar yang dipangkas menjadi lingkaran di sisi kiri area visual toast.

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

Gambar hero

Baru dalam Anniversary Update: Toasts dapat menampilkan gambar hero, yang merupakan ToastGenericHeroImage unggulan yang ditampilkan secara menonjol dalam banner toast dan saat berada di dalam Notification Center. Dimensi gambar adalah 364x180 piksel pada penskalakan 100%.

Cuplikan layar pemberitahuan toast yang menunjukkan penempatan gambar hero, di atas area atribusi.

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

Pembatasan ukuran gambar

Gambar yang Anda gunakan dalam pemberitahuan roti panggang Anda dapat bersumber dari...

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

Untuk gambar web jarak jauh http dan https, ada batasan pada ukuran file setiap gambar individu. Dalam Pembaruan Fall Creators (16299), kami meningkatkan batas menjadi 3 MB pada koneksi normal dan 1 MB pada koneksi terukur. Sebelum itu, gambar selalu dibatasi hingga 200 KB.

Koneksi normal Koneksi terukur Sebelum Pembaruan Pembuat Musim Gugur
3 MB 1 MB 200 KB

Jika gambar melebihi ukuran file, atau gagal diunduh, atau waktu habis, gambar akan dihilangkan dan pemberitahuan lainnya akan ditampilkan.

Teks atribusi

Baru di Pembaruan Hari Jadi: Jika Anda perlu mereferensikan sumber konten Anda, Anda dapat menggunakan teks atribusi. Teks ini selalu ditampilkan di bawah elemen teks apa pun, tetapi di atas gambar sebaris. Teks menggunakan ukuran yang sedikit lebih kecil daripada elemen teks standar untuk membantu membedakan dari elemen teks biasa.

Pada versi Windows yang lebih lama yang tidak mendukung teks atribusi, teks hanya akan ditampilkan sebagai elemen teks lain (dengan asumsi Anda belum memiliki maksimum tiga elemen teks).

Cuplikan layar pemberitahuan toast yang menunjukkan teks atribusi

new ToastContentBuilder()
    ...
    
    .AddAttributionText("Via SMS");

Tanda waktu kustom

Baru di Pembaruan Kreator: Anda sekarang dapat mengganti tanda waktu yang disediakan sistem dengan tanda waktu Anda sendiri yang secara akurat mewakili kapan pesan/informasi/konten dibuat. Tanda waktu ini terlihat dalam Pusat Pemberitahuan.

Cuplikan layar pemberitahuan di Pusat Pemberitahuan dengan tanda waktu kustom

Untuk mempelajari selengkapnya tentang menggunakan tanda waktu kustom, silakan lihat tanda waktu kustom pada toast.

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

Bilah kemajuan

Baru di Pembaruan Kreator: Anda dapat memberikan bilah kemajuan pada pemberitahuan toast Anda untuk memberi tahu pengguna tentang kemajuan operasi seperti unduhan.

Cuplikan layar pemberitahuan toast memperlihatkan bilah kemajuan.

Untuk mempelajari selengkapnya tentang menggunakan bilah kemajuan, silakan lihat Bilah kemajuan toast.

Header

Baru di Pembaruan Pembuat: Anda dapat mengelompokkan pemberitahuan di bawah header dalam Pusat Pemberitahuan. Misalnya, Anda dapat mengelompokkan pesan dari obrolan grup di bawah header, atau pemberitahuan grup tema umum di bawah header, atau lebih.

Cuplikan layar pusat tindakan memperlihatkan beberapa pemberitahuan untuk aplikasi Penampil Pemberitahuan yang diatur di bawah header berlabel

Untuk mempelajari selengkapnya tentang menggunakan header, silakan lihat Header toast.

Konten adaptif

Baru dalam Pembaruan Hari Jadi: Selain konten yang ditentukan di atas, Anda juga dapat menampilkan konten adaptif tambahan yang terlihat saat toast diperluas.

Konten tambahan ini ditentukan menggunakan Adaptif, yang dapat Anda pelajari lebih lanjut dengan membaca dokumentasi Petak Peta Adaptif.

Perhatikan bahwa konten adaptif apa pun harus terkandung dalam AdaptiveGroup. Jika tidak, itu tidak akan dirender menggunakan adaptif.

Kolom dan elemen teks

Berikut adalah contoh di mana kolom dan beberapa elemen teks adaptif tingkat lanjut digunakan. Karena elemen teks berada dalam AdaptiveGroup, elemen tersebut mendukung semua properti gaya adaptif yang kaya.

Cuplikan layar pemberitahuan toast yang memperlihatkan grup elemen teks yang diratakan ke kiri dan kanan area visual toast.

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
                    }
                }
            }
        }
    });

Tombol

Tombol membuat toast Anda interaktif, memungkinkan pengguna mengambil tindakan cepat pada pemberitahuan toast Anda tanpa mengganggu alur kerja mereka saat ini. Misalnya, pengguna dapat membalas pesan langsung dari dalam toast, atau menghapus email tanpa membuka aplikasi email. Tombol muncul di bagian pemberitahuan Anda yang diperluas.

Untuk mempelajari selengkapnya tentang menerapkan tombol end-to-end, lihat Mengirim toast lokal.

Tombol dapat melakukan tindakan berbeda berikut ini...

  • Mengaktifkan aplikasi di latar depan, dengan argumen yang dapat digunakan untuk menavigasi ke halaman/konteks tertentu.
  • Mengaktifkan tugas latar belakang aplikasi, untuk skenario balasan cepat atau serupa.
  • Mengaktifkan aplikasi lain melalui peluncuran protokol.
  • Melakukan tindakan sistem, seperti menunda atau menutup pemberitahuan.

Catatan

Anda hanya dapat memiliki hingga 5 tombol (termasuk item menu konteks yang kita bahas nanti).

Cuplikan layar pemberitahuan toast yang memperlihatkan baris teks mengikuti baris dengan dua tombol yang ditentukan oleh elemen tindakan

new ToastContentBuilder()
    ...
    
    .AddButton(new ToastButton()
        .SetContent("See more details")
        .AddArgument("action", "viewDetails"))

    .AddButton(new ToastButton()
        .SetContent("Remind me later")
        .AddArgument("action", "remindLater")
        .SetBackgroundActivation());

Tombol dengan ikon

Anda dapat menambahkan ikon ke tombol Anda. Ikon ini berwarna putih transparan gambar 16x16 piksel pada penskalan 100%, dan seharusnya tidak memiliki padding yang disertakan dalam gambar itu sendiri. Jika Anda memilih untuk memberikan ikon pada pemberitahuan toast, Anda harus menyediakan ikon untuk SEMUA tombol Anda di pemberitahuan, karena mengubah gaya tombol Anda menjadi tombol ikon.

Catatan

Untuk aksesibilitas, pastikan untuk menyertakan versi ikon kontras-putih (ikon hitam untuk latar belakang putih), sehingga ketika pengguna mengaktifkan mode Putih Kontras Tinggi, ikon Anda terlihat. Pelajari selengkapnya di halaman aksesiblitas toast.

Cuplikan layar pemberitahuan toast yang menggunakan tombol dengan ikon.

new ToastContentBuilder()
    ...
    
    .AddButton(new ToastButton()
        .SetContent("Dismiss")
        .AddArgument("action", "dismiss")
        .SetImageUri(new Uri("Assets/NotificationButtonIcons/Dismiss.png", UriKind.Relative))
        .SetBackgroundActivation());

Baru di Windows 11 Update: Anda bisa menambahkan tipsalat ke ikon Anda dengan properti HintToolTip di XML. Ini sangat ideal jika tombol Anda memiliki ikon tetapi tidak ada konten, karena ini akan memastikan Anda dapat meneruskan teks yang dapat dibaca Windows Narrator. Namun, jika konten ada, maka Narator akan membaca konten, apa pun yang diteruskan dalam tipsalat.

// The builder syntax does not support icon tooltips yet. 

Tombol dengan warna

Baru di Windows 11 Update: Anda dapat menambahkan warna merah atau hijau ke tombol Anda dengan menambahkan atribut useButtonStyle ke elemen XML toast dan atribut hint-buttonStyle ke elemen XML tindakan seperti yang terlihat di bawah ini.

Cuplikan layar pemberitahuan dengan tiga tombol, dua tombol kiri berwarna hijau dengan ikon untuk memulai panggilan video atau memulai panggilan audio. Tombol ketiga berwarna merah dan memiliki ikon untuk menolak panggilan.

// The builder syntax does not support red and green button colors yet.

Tombol dengan aktivasi pembaruan tertunda

Baru di Fall Creators Update: Pada tombol aktivasi latar belakang, Anda dapat menggunakan perilaku setelah aktivasi PendingUpdate untuk membuat interaksi multi-langkah di pemberitahuan toast Anda. Ketika pengguna mengklik tombol Anda, tugas latar belakang Anda diaktifkan, dan roti panggang ditempatkan dalam status "pembaruan tertunda", di mana ia tetap di layar sampai tugas latar belakang Anda mengganti roti panggang dengan roti panggang baru.

Untuk mempelajari cara menerapkan ini, lihat Toast tertunda pembaruan.

Toast dengan pembaruan tertunda

Tindakan menu konteks

Baru di Pembaruan Hari Jadi: Anda dapat menambahkan tindakan menu konteks tambahan ke menu konteks yang ada yang muncul saat pengguna mengklik kanan pemberitahuan toast Anda atau memilih ikon menu konteks.

Catatan

Pada perangkat yang lebih lama, tindakan menu konteks tambahan ini hanya akan muncul sebagai tombol normal pada roti panggang Anda.

Tindakan menu konteks tambahan yang Anda tambahkan (seperti "Matikan suara obrolan grup selama 1 jam") muncul di atas dua entri sistem default.

Toast dengan menu konteks

Sintaks penyusun tidak mendukung tindakan menu konteks, jadi sebaiknya gunakan sintaks penginisialisasi.

ToastContent content = new ToastContent()
{
    ...
 
    Actions = new ToastActionsCustom()
    {
        ContextMenuItems =
        {
            new ToastContextMenuItem("Mute group chat for 1 hour", "action=muteId")
        }
    }
};

Catatan

Item menu konteks tambahan berkontribusi pada batas total 5 tombol pada toast.

Aktivasi item menu konteks tambahan ditangani identik dengan tombol toast.

Input

Input ditentukan dalam wilayah Tindakan dari wilayah toast toast, yang berarti mereka hanya terlihat ketika toast diperluas.

Kotak teks balasan cepat

Untuk mengaktifkan kotak teks balasan cepat (misalnya, di aplikasi olahpesan) tambahkan input teks dan tombol, dan referensiKAN ID bidang input teks sehingga tombol ditampilkan di samping bidang input. Ikon opsional untuk tombol, jika disediakan, harus berupa gambar 32x32 piksel tanpa padding, piksel putih diatur ke transparan, dan skala 100%.

Cuplikan layar pemberitahuan toast dengan gambar profil dan beberapa baris teks. Kotak teks untuk mengetik langsung ke toast disertakan serta tombol untuk mengirim balasan.

new ToastContentBuilder()
    ...
    
    .AddInputTextBox("tbReply", "Type a reply")

    .AddButton(new ToastButton()
        .SetContent("Reply")
        .SetTextBoxId("tbReply") // To place button next to text box, reference text box's id
        .SetImageUri(new Uri("Assets/Reply.png", UriKind.Relative))
        .AddArgument("action", "reply")
        .SetBackgroundActivation());

Input dengan bilah tombol

Anda juga dapat memiliki satu (atau banyak) input dengan tombol normal yang ditampilkan di bawah input.

Cuplikan layar pemberitahuan toast memperlihatkan baris teks, kotak teks, dan baris dengan dua tombol berlabel

new ToastContentBuilder()
    ...
    
    .AddInputTextBox("tbReply", "Type a reply")

    .AddButton(new ToastButton()
        .SetContent("Reply")
        .AddArgument("action", "reply")
        .SetBackgroundActivation())

    .AddButton(new ToastButton()
        .SetContent("Video call")
        .AddArgument("action", "videoCall"));

Input pilihan

Selain kotak teks, Anda juga dapat menggunakan menu pilihan.

Cuplikan layar pemberitahuan toast memperlihatkan baris teks, input pilihan dengan

new ToastContentBuilder()
    ...
    
    .AddToastInput(new ToastSelectionBox("time")
    {
        DefaultSelectionBoxItemId = "lunch",
        Items =
        {
            new ToastSelectionBoxItem("breakfast", "Breakfast"),
            new ToastSelectionBoxItem("lunch", "Lunch"),
            new ToastSelectionBoxItem("dinner", "Dinner")
        }
    })

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

Tunda/tutup

Dengan menggunakan menu pilihan dan dua tombol, kita dapat membuat pemberitahuan pengingat yang menggunakan tindakan tunda dan tutup sistem. Pastikan untuk mengatur skenario ke Reminder agar pemberitahuan berperilaku seperti pengingat.

pemberitahuan pengingat ! [Cuplikan layar toast dengan baris teks yang menjelaskan waktu dan lokasi rapat. Kotak pilihan dipilih "15 menit" dan ada tombol berlabel Tunda dan Tutup.] (gambar/toast-content-snooze-dismiss.png)

Kami menautkan tombol Tunda ke input menu pilihan menggunakan properti SelectionBoxId pada tombol toast.

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());

Untuk menggunakan tindakan tunda dan tutup sistem:

  • Tentukan ToastButtonSnooze atau ToastButtonDismiss
  • Secara opsional tentukan string konten kustom:
    • Jika Anda tidak menyediakan string, kami akan secara otomatis menggunakan string yang dilokalkan untuk "Tunda" dan "Tutup".
  • Secara opsional tentukan SelectionBoxId:
    • Jika Anda tidak ingin pengguna memilih interval tunda dan sebaliknya hanya ingin pemberitahuan Anda menunda hanya sekali untuk interval waktu yang ditentukan sistem (yang konsisten di seluruh OS), maka jangan membuat input> sama <sekali.
    • Jika Anda ingin memberikan pilihan interval tunda:
      • Tentukan SelectionBoxId dalam tindakan tunda
      • Cocokkan id input dengan SelectionBoxId dari tindakan tunda
      • Tentukan nilai ToastSelectionBoxItem menjadi nonNegativeInteger yang mewakili interval tunda dalam hitungan menit.

Audio

Audio kustom selalu didukung oleh Seluler, dan didukung di Desktop Versi 1511 (build 10586) atau yang lebih baru. Audio kustom dapat dirujuk melalui jalur berikut:

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

Atau, Anda dapat memilih dari daftar ms-winsoundevents, yang selalu didukung di kedua platform.

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

Lihat halaman skema audio untuk informasi tentang audio dalam pemberitahuan toast. Untuk mempelajari cara mengirim toast menggunakan audio kustom, lihat audio kustom pada roti panggang.

Skenario

Untuk membuat pemberitahuan penting, alarm, pengingat, dan pemberitahuan panggilan masuk, Anda cukup menggunakan pemberitahuan toast normal dengan nilai Skenario yang ditetapkan untuknya. Skenario ini menyesuaikan beberapa perilaku untuk menciptakan pengalaman pengguna yang konsisten dan terpadu. Ada empat kemungkinan nilai Skenario :

  • Pengingat
  • Alarm
  • IncomingCall
  • Mendesak

Pengingat

Dalam skenario pengingat, pemberitahuan akan tetap berada di layar hingga pengguna menutupnya atau mengambil tindakan. Di Windows Mobile, toast juga akan menampilkan pra-perluasan. Suara pengingat akan diputar. Anda harus menyediakan setidaknya satu tombol pada pemberitahuan toast Anda. Jika tidak, roti panggang akan diperlakukan sebagai roti panggang normal.

new ToastContentBuilder()
    .SetToastScenario(ToastScenario.Reminder)
    ...

Alarm

Alarm berprilaku sama dengan pengingat, kecuali alarm juga akan mengulang audio dengan suara alarm default. Anda harus menyediakan setidaknya satu tombol pada pemberitahuan toast Anda. Jika tidak, roti panggang akan diperlakukan sebagai roti panggang normal.

new ToastContentBuilder()
    .SetToastScenario(ToastScenario.Alarm)
    ...

Panggilan masuk

Pemberitahuan panggilan masuk ditampilkan sebelum diperluas dalam format panggilan khusus dan tetap berada di layar pengguna sampai dihentikan. Audio nada dering akan mengulang secara default. Di perangkat Windows Mobile, perangkat tersebut menampilkan layar penuh.

Pemberitahuan toast panggilan masuk

new ToastContentBuilder()
    .SetToastScenario(ToastScenario.IncomingCall)
    ...

Pemberitahuan Penting

Penting

Memerlukan: Anda harus menjalankan Windows Insider Preview Build 22546 atau yang lebih baru untuk menggunakan pemberitahuan penting.

Pemberitahuan penting memungkinkan pengguna untuk memiliki kontrol lebih besar atas apa yang dapat dikirim oleh aplikasi pihak ke-1 dan pihak ke-3 kepada mereka pemberitahuan toast berprioritas tinggi (mendesak/penting) yang dapat menerobos Bantuan Fokus (Jangan Diganggu). Ini dapat dimodifikasi di pengaturan pemberitahuan.

Cuplikan layar pemberitahuan toast mendesak yang memiliki tanda seru di area atribusi di samping nama aplikasi. Gambar juga menunjukkan pemberitahuan toast yang dimulai sistem yang menyediakan tombol bagi pengguna untuk mengizinkan atau melarang pemberitahuan mendesak dari aplikasi.

// The builder syntax does not support important notifications yet.

Pelokalan dan aksesibilitas

Petak peta dan roti panggang Anda dapat memuat string dan gambar yang disesuaikan untuk bahasa tampilan, faktor skala tampilan, kontras tinggi, dan konteks runtime lainnya. Untuk informasi selengkapnya, lihat Dukungan pemberitahuan petak peta dan toast untuk bahasa, skala, dan kontras tinggi.

Menangani aktivasi

Untuk mempelajari cara menangani aktivasi toast (pengguna mengklik roti panggang atau tombol pada toast), lihat Mengirim toast lokal.