Meldingen groeperen met verzamelingen

Gebruik verzamelingen om de meldingen van de app in het Actiecentrum te ordenen. Met verzamelingen kunnen gebruikers gemakkelijker informatie vinden in het Actiecentrum en kunnen ontwikkelaars hun meldingen beter beheren. Met de onderstaande API's kunt u meldingsverzamelingen verwijderen, maken en bijwerken.

Hieronder ziet u het voorbeeld met een berichten-app die de meldingen scheidt op basis van de chatgroep; elke titel (Comp Sci 160A Project Chat, Direct Messages, Lacrosse Team Chat) is een afzonderlijke verzameling. U ziet hoe de meldingen afzonderlijk zijn gegroepeerd alsof ze afkomstig zijn van een afzonderlijke app, ook al zijn ze allemaal meldingen van dezelfde app. Als u op zoek bent naar een subtielere manier om uw notificaties te organiseren, bekijk dan de toastkoppen .

Verzamelingen maken

Wanneer u elke verzameling maakt, moet u een weergavenaam en een pictogram opgeven, dat wordt weergegeven in het Actiecentrum als onderdeel van de titel van de verzameling, zoals wordt weergegeven in de bovenstaande afbeelding. Verzamelingen vereisen ook een startargument om de app te helpen naar de juiste locatie in de app te navigeren wanneer de titel van de verzameling door de gebruiker wordt geklikt.

Een verzameling maken

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

Meldingen verzenden naar een verzameling

We zullen het verzenden van meldingen via drie verschillende meldingpijplijnen behandelen: lokaal, gepland en pushmeldingen. Voor elk van deze voorbeelden maken we een voorbeeldmelding die wordt verzonden met de code die rechtstreeks hieronder staat. Om vervolgens aandacht te besteden aan hoe de melding kan worden toegevoegd aan een collectie via elke pijplijn.

Maak de pop-upinhoud:

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

Een melding naar een verzameling verzenden

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

Een geplande melding toevoegen aan een verzameling

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

Een push-toast verzenden naar een verzameling

Voor push-toasts moet u de X-WNS-CollectionId-header toevoegen aan het POST-bericht.

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

Verzamelingen beheren

De beheerder van meldingsverzamelingen maken

Voor de rest van de codefragmenten in deze sectie 'Verzamelingen beheren' gebruiken we de collectionManager hieronder.

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

Alle verzamelingen ophalen

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

Aantal gemaakte verzamelingen opvragen

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

Een verzameling verwijderen

await collectionManager.RemoveToastCollectionAsync("MyToastCollection");

Een verzameling bijwerken

U kunt verzamelingen bijwerken door een nieuwe verzameling met dezelfde id te maken en het nieuwe exemplaar van de verzameling op te slaan.

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

Toasts binnen een verzameling beheren

Groeps- en tageigenschappen

De groeps- en tageigenschappen identificeren samen een melding uniek binnen een verzameling. Groep (en tag) fungeert als een samengestelde primaire sleutel (meer dan één id) om uw melding te identificeren. Als u bijvoorbeeld een melding wilt verwijderen of vervangen, moet u opgeven welke melding u wilt verwijderen/vervangen; u doet dit door de tag en groep op te geven. Een voorbeeld is een berichten-app. De ontwikkelaar kan de gespreks-id gebruiken als de groep en de bericht-id als de tag.

Een toastmelding uit een verzameling verwijderen

U kunt afzonderlijke toasts verwijderen met behulp van de tag- en groeps-id's of alle toasts in een verzameling verwijderen.

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

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

Alle meldingen in een verzameling wissen

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

// Remove toast
collectionHistory.Clear();

Verzamelingen in Meldingen visualiseren

U kunt het hulpprogramma Notifications Visualizer gebruiken om uw verzamelingen te ontwerpen. Volg de onderstaande stappen:

• Klik op het tandwielpictogram in de rechterbenedenhoek.
• Selecteer 'Meldingenverzamelingen'.
• Boven de voorbeeldweergave van de melding is er een vervolgkeuzemenu 'Meldingenverzameling'. Selecteer Beheer verzamelingen.
• Klik op Verzameling toevoegen, vul de details voor de verzameling in en sla deze op.
• U kunt meer verzamelingen toevoegen of op het vak Verzamelingen beheren klikken om terug te keren naar het hoofdscherm.
• Selecteer de verzameling waaraan u de melding wilt toevoegen in het vervolgkeuzemenu 'Meldingenverzameling'.
• Wanneer u de toastmelding activeert, wordt deze toegevoegd aan de juiste verzameling in het Actiecentrum.

Overige details

De toastverzamelingen die u maakt, worden ook weergegeven in de notificatie-instellingen van de gebruiker. Gebruikers kunnen de instellingen voor elke afzonderlijke verzameling in- of uitschakelen om deze subgroepen in of uit te schakelen. Als meldingen zijn uitgeschakeld op het hoogste niveau voor de app, worden ook alle meldingen voor verzamelingen uitgeschakeld. Bovendien worden in elke verzameling standaard 3 meldingen weergegeven in het Actiecentrum en kan de gebruiker deze uitbreiden om maximaal 20 meldingen weer te geven.

Verwante onderwerpen

• Pop-upinhoud
• Koppen van meldingen
• Meldingenbibliotheek op GitHub (onderdeel van de Windows Community Toolkit)