快顯上的自訂音訊

快顯通知可以使用自訂音訊,讓您的應用程式表達您品牌獨特的音效。 例如,傳訊應用程式可以在快顯通知上使用自己的傳訊音效,讓使用者能夠立即得知收到來自應用程式的通知,有別於聽到一般通知音效。

安裝 UWP 社群工具組 NuGet 套件

為了透過程式碼建立通知,我們強烈建議使用 UWP 社群工具組通知程式庫,當中提供了通知 XML 內容的物件模型。 您可以手動建構通知 XML,但這樣做容易出錯且較為複雜。 UWP 社群工具組內的通知程式庫是由 Microsoft 中擁有通知的團隊所建置並維護。

從 NuGet 安裝 Microsoft.Toolkit.Uwp.Notifications

新增命名空間宣告

using Microsoft.Toolkit.Uwp.Notifications;

新增自訂音訊

Windows Mobile 一直都在快顯通知中支援自訂音訊。 不過,電腦版是從 1511 版才加入了自訂音訊的支援 (組建 10586)。 如果您將包含自訂音訊的快顯傳送至 1511 版以前的電腦版裝置,則快顯會是無訊息的。 因此,若是 1511 版以前的電腦版,則「不應」在快顯通知中包含自訂音訊,讓通知至少會使用預設通知音效。

已知問題:如果您使用 1511 電腦版,則只有透過商店安裝應用程式時,自訂快顯音效才能運作。 這表示,在提交至商店之前,您無法在本機上測試電腦版上的自訂音訊,不過,一旦從商店安裝後,音訊將會正常運作。 我們已在年度更新版中修正此問題,現在來自本機部署應用程式的自訂音訊將會正確運作。

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

支援的音訊檔案類型包括:

  • .aac
  • .flac
  • .m4a
  • .mp3
  • .wav
  • .wma

支援的音訊檔案來源:

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

支援的音訊檔案來源:

  • ms-appdata
  • http://, https://
  • C:/、F:/ 等

傳送通知

傳送包含音訊之通知的方式與傳送一般通知相同 (只要呼叫 Show 方法即可)。 若要了解詳細資訊,請參閱傳送本機快顯