Gruppera aviseringar i samlingar

Använd samlingar för att organisera din apps aviseringar i Åtgärdscenter. Samlingar hjälper användarna att hitta information i Åtgärdscenter enklare och gör det möjligt för utvecklare att bättre hantera sina meddelanden. API:erna nedan gör det möjligt att ta bort, skapa och uppdatera meddelandesamlingar.

Du kan se exemplet nedan med en meddelandeapp som separerar meddelandena baserat på chattgruppen. varje rubrik (Comp Sci 160A Project Chat, Direct Messages, Lacrosse Team Chat) är en separat samling. Observera hur meddelandena grupperas tydligt som om de vore från en separat app, även om de alla är meddelanden från samma app. Om du vill ha ett mer subtilt sätt att organisera dina meddelanden kan du läsa popup-huvuden.

Creating collections

När du skapar varje samling måste du ange ett visningsnamn och en ikon som visas i Åtgärdscenter som en del av samlingens rubrik, enligt bilden ovan. Samlingar kräver också ett startargument som hjälper appen att navigera till rätt plats i appen när samlingens rubrik klickas på av användaren.

Skapa en samling

// Create a toast collection
public async void CreateToastCollection()
{
	string displayName = "Work Email"; 
	string launchArg = "NavigateToWorkEmailInbox"; 
	Uri icon = new Windows.Foundation.Uri("ms-appx:///Assets/workEmail.png");

	// Constructor
	ToastCollection workEmailToastCollection = new ToastCollection(
		"MyToastCollection", 
		displayName,
 		launchArg, 
		icon);

	// Calls the platform to create the collection
	await ToastNotificationManager.GetDefault().GetToastCollectionManager().SaveToastCollectionAsync(workEmailToastCollection);  								
}

Skicka meddelanden till en samling

Vi tar upp att skicka notiser från tre olika toast-pipelines: lokala, schemalagda och push. För vart och ett av dessa exempel skapar vi ett popup-exempel som ska skickas med koden direkt nedan. Sedan fokuserar vi på hur du lägger till popup-brödet i en samling via varje pipeline.

Konstruera toastinnehållet:

// Construct the content
var content = new ToastContentBuilder()
	.AddText("Adam sent a message to the group")
	.GetToastContent();

Skicka ett meddelande till en samling

// Create the toast
ToastNotification toast = new ToastNotification(content.GetXml());

// Get the collection notifier
var notifier = await ToastNotificationManager.GetDefault().GetToastNotifierForToastCollectionIdAsync("MyToastCollection");

// And show the toast
notifier.Show(toast);

Lägg till en schemalagd avisering i en samling

// Create scheduled toast from XML above
ScheduledToastNotification scheduledToast = new ScheduledToastNotification(content.GetXml(), DateTimeOffset.Now.AddSeconds(10));

// Get notifier
var notifier = await ToastNotificationManager.GetDefault().GetToastNotifierForToastCollectionIdAsync("MyToastCollection");
    
// Add to schedule
notifier.AddToSchedule(scheduledToast);

Skicka en push-notis till en samling

För push-aviseringar måste du lägga till X-WNS-CollectionId-huvudet i POST-meddelandet.

// Add header to HTTP request
request.Headers.Add("X-WNS-CollectionId", collectionId); 

Managing collections

Skapa toast-samlingshanteraren

För resten av kodfragmenten i det här avsnittet "Hantera samlingar" använder vi collectionManager nedan.

ToastCollectionManger collectionManager = ToastNotificationManager.GetDefault().GetToastCollectionManager();

Hämta alla samlingar

IReadOnlyList<ToastCollection> collections = await collectionManager.FindAllToastCollectionsAsync();

Hämta antalet samlingar som skapats

int toastCollectionCount = (await collectionManager.FindAllToastCollectionsAsync()).Count;

Ta bort en samling

await collectionManager.RemoveToastCollectionAsync("MyToastCollection");

Uppdatera en samling

Du kan uppdatera samlingar genom att skapa en ny samling med samma ID och spara den nya instansen av samlingen.

string displayName = "Updated Display Name"; 
string launchArg = "UpdatedLaunchArgs"; 
Uri icon = new Windows.Foundation.Uri("ms-appx:///Assets/updatedPicture.png");

// Construct a new toast collection with the same collection id
ToastCollection updatedToastCollection = new ToastCollection(
	"MyToastCollection", 
	displayName,
	launchArg, 
	icon);

// Calls the platform to update the collection by saving the new instance
await collectionManager.SaveToastCollectionAsync(updatedToastCollection);  								

Hantera notifieringar i en samling

Egenskaper för grupper och taggar

Grupp- och taggegenskaperna identifierar tillsammans ett meddelande i en samling unikt. Gruppen (och taggen) fungerar som en sammansatt primärnyckel (mer än en identifierare) för att identifiera ditt meddelande. Om du till exempel vill ta bort eller ersätta ett meddelande måste du kunna ange vilket meddelande du vill ta bort/ersätta. det gör du genom att ange taggen och gruppen. Ett exempel är en meddelandeapp. Utvecklaren kan använda konversations-ID:t som grupp och meddelande-ID:t som tagg.

Ta bort ett toastmeddelande från en samling

Du kan ta bort enskilda notiser med tagg- och grupp-ID, eller rensa alla notiser i en samling.

// Get the history
var collectionHistory = await ToastNotificationManager.GetDefault().GetHistoryForToastCollectionAsync("MyToastCollection");

// Remove toast
collectionHistory.Remove(tag, group); 

Rensa alla aviseringar i en samling

// Get the history
var collectionHistory = await ToastNotificationManager.GetDefault().GetHistoryForToastCollectionAsync("MyToastCollection");

// Remove toast
collectionHistory.Clear();

Samlingar i Notisvisualiseraren

Du kan använda verktyget Notifications Visualizer för att utforma dina samlingar. Följ stegen nedan:

• Klicka på kugghjulsikonen i det nedre högra hörnet.
• Välj Toast-samlingar.
• Ovanför förhandsvisningen av meddelanderutan finns det en rullgardinsmeny för samling av toastmeddelanden. Välj Hantera samlingar.
• Klicka på Lägg till samling, fyll i informationen för samlingen och spara.
• Du kan lägga till fler samlingar eller klicka på av rutan Hantera samlingar för att återgå till huvudskärmen.
• Välj den samling du vill lägga till toast-notisen i från listrutan Toastsamling.
• När du skickar aviseringen läggs den till i lämplig samling i Åtgärdscenter.

Other details

De toastmeddelanden som du skapar visas också i användarens meddelandeinställningar. Användare kan växla inställningarna för varje enskild samling för att aktivera eller inaktivera dessa undergrupper. Om meddelanden inaktiveras på den översta nivån för appen inaktiveras även alla samlingars meddelanden. Dessutom visar varje samling som standard 3 meddelanden i Åtgärdscenter och användaren kan expandera den för att visa upp till 20 meddelanden.

Related topics

• Toast content
• Toast headers
• Notifications-biblioteket på GitHub (en del av Windows Community Toolkit)