Audio kustom pada roti panggang

  • Artikel

Pemberitahuan toast dapat menggunakan audio kustom, yang memungkinkan aplikasi Anda mengekspresikan efek suara unik merek Anda. Misalnya, aplikasi olahpesan dapat menggunakan suara olahpesan mereka sendiri pada pemberitahuan Toast mereka, sehingga pengguna dapat langsung mengetahui bahwa mereka menerima pemberitahuan dari aplikasi, daripada mendengar suara pemberitahuan generik.

Instal paket UWP Community Toolkit NuGet

Untuk membuat pemberitahuan melalui kode, sebaiknya gunakan pustaka Pemberitahuan Toolkit Komunitas UWP, yang menyediakan model objek untuk konten XML pemberitahuan. Anda dapat membuat XML pemberitahuan secara manual, tetapi itu rawan kesalahan dan berantakan. Pustaka Pemberitahuan di dalam Toolkit Komunitas UWP dibangun dan dikelola oleh tim yang memiliki pemberitahuan di Microsoft.

Instal Microsoft.Toolkit.Uwp.Notifications dari NuGet.

Menambahkan deklarasi namespace

using Microsoft.Toolkit.Uwp.Notifications;

Menambahkan audio kustom

Windows Mobile selalu mendukung audio kustom di pemberitahuan Toast. Namun, Desktop hanya menambahkan dukungan untuk audio kustom di Versi 1511 (build 10586). Jika Anda mengirim Toast yang berisi audio kustom ke perangkat Desktop sebelum Versi 1511, toast akan diam. Oleh karena itu, untuk Desktop pra-Versi 1511, Anda TIDAK boleh menyertakan audio kustom dalam pemberitahuan Toast Anda, sehingga pemberitahuan setidaknya akan menggunakan suara pemberitahuan default.

Masalah Umum: Jika Anda menggunakan Desktop Versi 1511, audio toast kustom hanya akan berfungsi jika aplikasi Anda diinstal melalui Store. Itu berarti Anda tidak dapat menguji audio kustom Anda secara lokal di Desktop sebelum mengirimkan ke Store - tetapi audio akan berfungsi dengan baik setelah diinstal dari Store. Kami memperbaiki ini di Pembaruan Hari Jadi, sehingga audio kustom dari aplikasi anda yang disebarkan secara lokal akan berfungsi dengan benar.

var contentBuilder = new ToastContentBuilder()
    .AddText("New message");

    
bool supportsCustomAudio = true;
 
// If we're running on Desktop before Version 1511, do NOT include custom audio
// since it was not supported until Version 1511, and would result in a silent toast.
if (AnalyticsInfo.VersionInfo.DeviceFamily.Equals("Windows.Desktop")
    && !ApiInformation.IsApiContractPresent("Windows.Foundation.UniversalApiContract", 2))
{
    supportsCustomAudio = false;
}
 
if (supportsCustomAudio)
{
    contentBuilder.AddAudio(new Uri("ms-appx:///Assets/Audio/CustomToastAudio.m4a"));
}

// Send the toast
contentBuilder.Show();

Jenis file audio yang didukung meliputi:

  • .Aac
  • .Flac
  • .M4a
  • .mp3
  • .Wav
  • .wma

Sumber file audio yang didukung:

  • ms-appx:///
  • ms-resource

Sumber file audio yang tidak didukung:

  • ms-appdata
  • http://, https://
  • C:/, F:/, dll.

Mengirim pemberitahuan

Mengirim pemberitahuan dengan audio sama dengan mengirim pemberitahuan reguler (cukup panggil metode Tampilkan). Lihat Mengirim toast lokal untuk mempelajari selengkapnya.