Sdílet prostřednictvím

Směrování a výrazy značek

  • Článek

Výrazy značek umožňují cílit na konkrétní sady zařízení nebo konkrétnější registrace při odesílání nabízených oznámení přes Notification Hubs.

Cílení na konkrétní registrace

Jediným způsobem, jak cílit na konkrétní registrace, je přidružit je ke značce a pak tuto značku cílit. Jak je popsáno v správa registrací, aby aplikace mohla přijímat nabízená oznámení, musí zaregistrovat popisovač zařízení v centru oznámení. Po vytvoření registrace v centru oznámení může back-end aplikace odesílat nabízená oznámení.

Back-end aplikace může zvolit registrace, které se mají cílit s určitým oznámením, následujícími způsoby:

  1. Broadcast: oznámení obdrží všechny registrace v centru oznámení.

  2. značka: všechny registrace, které obsahují zadanou značku, obdrží oznámení.

  3. výraz značky: všechny registrace, jejichž sada značek odpovídá zadanému výrazu, obdrží oznámení.

Poznámka

Při odesílání datové části specifické pro konkrétní platformu (například oznámení specifické pro Windows Store) obdrží oznámení pouze registrace pro danou konkrétní platformu. Při odesílání oznámení šablony jsou cílem pouze registrace určující šablonu. Další informace naleznete v tématu Správa registrací.

Visačky

Značka může být libovolný řetězec, maximálně 120 znaků obsahující alfanumerické a následující nealnumerické znaky: '_', '@', '#', '.', ':', '-'. Následující příklad ukazuje aplikaci, ze které můžete dostávat informační zprávy o konkrétních hudebních skupinách. V tomto scénáři je jednoduchý způsob, jak směrovat oznámení, označit registrace značkami, které představují různá pásma, jak je znázorněno na následujícím obrázku.

výrazy značek výrazy značek

Na tomto obrázku zpráva označená Beatles dosáhne pouze tabletu zaregistrovaného ve značce Beatles.

Další informace o vytváření registrací pro značky naleznete v tématu Správa registrací.

Oznámení můžete odesílat do značek pomocí odesílat oznámení metody Microsoft.ServiceBus.Notifications.NotificationHubClient třídy v sadě SDK. Můžete také použít Node.jsnebo rozhraní REST API nabízených oznámení.

Všimněte si následujících příkladů:

await hub.SendWindowsNativeNotificationAsync(wnsToast, "tag");

notificationHubService.wns.sendToastText01('tag', {
            text1: 'Hello World!'
        }, callback);

Značky nemusí být předem zřízené a můžou odkazovat na několik konceptů specifických pro aplikaci. Uživatelé této ukázkové aplikace mohou například komentovat kapely a chtějí dostávat informační zprávy, nejen pro komentáře svých oblíbených kapel, ale také pro všechny komentáře od svých přátel, bez ohledu na kapelu, na které komentují. Následující obrázek ukazuje příklad tohoto scénáře:

výrazy značek výrazy značek

Na tomto obrázku má Alice zájem o aktualizace Beatles a Bob má zájem o aktualizace pro Wailers. Bob má také zájem o Charlieho komentáře a Charlie se zajímá o Wailers. Když se odešle oznámení pro Charlieho komentář k Beatles, Alice i Bob ho dostanou.

Důležitý

I když můžete do značek zakódovat více aspektů (například "band_Beatles" nebo "follows_Chanrlie"), značky jsou jednoduché řetězce a ne vlastnosti s hodnotami. Registrace se shoduje pouze s přítomností nebo nepřítomností konkrétní značky.

Úplný podrobný kurz o tom, jak používat značky pro odesílání do skupin zájmů, najdete v tématu Nejnovější zprávy.

Poznámka

V předchozím příkladu byste měli odeslat jedno oznámení na dvě značky (poskytování pole značek nebo použití výrazu značky s or) místo dvou oznámení. Odeslání dvou oznámení jednotlivým značkám vede k duplicitám pro registrace, které mají obě značky, zatímco použití výrazů značek nebude.

Použití značek pro cílové uživatele

Dalším způsobem, jak používat značky, je identifikovat všechna zařízení konkrétního uživatele. Registrace lze označit značkou, která obsahuje ID uživatele, jak je znázorněno na následujícím obrázku:

výrazy značek výrazy značek

Na tomto obrázku zpráva označená uid:Alice dosáhne všech registrací označených uid:Alice; a proto všechna zařízení Alice.

Výrazy značek

Existují případy, kdy oznámení musí cílit na sadu registrací, které nejsou identifikovány jedinou značkou, ale logickým výrazem na značkách.

Představte si sportovní aplikaci, která všem uživatelům v Bostonu pošle připomenutí o hře mezi Red Soxem a Kardinaly. Pokud klientská aplikace zaregistruje značky týkající se zájmu o týmy a umístění, mělo by být oznámení určeno všem uživatelům v Bostonu, kteří mají zájem o Red Sox nebo Kardinaly. Tuto podmínku lze vyjádřit následujícím logickým výrazem:

(follows_RedSox || follows_Cardinals) && location_Boston

výrazy značek výrazy značek

Výrazy značek mohou obsahovat všechny logické operátory, například AND (&&), OR (||) a NOT (!). Mohou také obsahovat závorky. Výrazy značek jsou omezeny na 20 značek, pokud obsahují pouze ORS; jinak jsou omezeny na 6 značek.

Oznámení můžete posílat výrazům značek pomocí odesílat oznámení metody Microsoft.ServiceBus.Notifications.NotificationHubClient třídy v sadě SDK. Můžete také použít Node.jsnebo rozhraní REST API nabízených oznámení. Všimněte si následujících příkladů:

await hub.SendWindowsNativeNotificationAsync(wnsToast, "(tagA && !tagB)");

notificationHubService.wns.sendToastText01('(tagA && !tagB)', {
            text1: 'Hello World!'
        }, callback);

Viz také

Další zdroje informací

reference k rozhraní API
nejnovější novinky – kurz
Posílat oznámení uživatelům – kurz