Създаване на програмата за целеви лицеви уведомления - uwp програмисти на приложения, Microsoft документи

В тази статия,

Можете да използвате страницата с информация за Център за развитие на панелни Лицеви уведомления за Windows за директна комуникация с клиентите чрез изпращане насочени лицеви уведомления за устройства, които са инсталирали приложението ви е универсална платформа Windows (UWP). Например, можете да използвате целевата тласък уведомление за насърчаване на потребителите към конкретни действия, като отбеляза своето приложение или използване на новите функции на. Можете да изпращате различни видове лицеви уведомления, включително изскачащи съобщения, уведомяване на плочките и уведомяването на суровия XML. Можете също така да следите броя на изстрелвания на приложения, произведени от лицеви уведомления. За повече информация относно тази функция. Изпращането на лицеви уведомления за потребителите на приложението си.

Преди да изпратите насочени лицеви известия до потребителите на Центъра за развитие, трябва да използвате определен метод в StoreServicesEngagementManager клас Microsoft Store Услуги SDK пакет, заявлението за регистрация, за да получавате известия. Допълнителни методи на този клас могат да бъдат използвани, за да информира за развитието на Центъра, че кандидатурата ви бъде пуснат в отговор на целевата тласък уведомление (ако искате да следите броя на изстрелвания на приложения от уведомления), както и да спрете да получавате известия.

Създаване на проекта

Преди да се напише код, следвайте тези стъпки, за да добавите препратка към Microsoft Store SDK за услуги, за да си проект.

Регистрирайте се за лицеви уведомления

Регистрация молби за целеви лицеви уведомления от Центъра за развитие.

В този проект, потърсете секцията код изпълнена в момента на старта, където можете да се регистрирате на приложението да получавате известия.

Добави в началото на файла с кода следния израз:

Вземи StoreServicesEngagementManager обект и се обадете на един от най-претоварванията на RegisterNotificationChannelAsync да тече код, определен от вас по-рано. Този метод трябва да се нарича всеки път, когато се стартира приложението.

Ако искате да създадете свой собствен център за дизайн Uniform Resource Identifier (URI) канал за уведомления, обадете се на задръстванията RegisterNotificationChannelAsync ().

В случай че то също така призовава CreatePushNotificationChannelForApplicationAsync за създаване на канал за уведомяване за WNS, уверете се, че кодът не поставя CreatePushNotificationChannelForApplicationAsync и RegisterNotificationChannelAsync (претоварване едновременно). Ако имате нужда да се обадя и двете от тези методи, се уверете, че сте ги наричат последователно и да изчака завръщането на един метод, преди да се обадите на другия.

Ако искате да посочите URI канали да използват целенасочено лицеви уведомяване на Центъра за развитие, обадете се на задръстванията RegisterNotificationChannelAsync (StoreServicesNotificationChannelParameters). Например, може да се наложи, ако молбата Ви вече използва услугите лицеви уведомления прозорци (WNS) и искате да използвате един и същ канал URI. Първо трябва да се създаде обект и възлага StoreServicesNotificationChannelParameters имот CustomNotificationChannelUri си универсален код ресурс (URI) канал.

забележка

Когато се обадите на метод в RegisterNotificationChannelAsync данни за локално приложение хранилище създава файл с име MicrosoftStoreEngagementSDKId.txt за вашето приложение (папка върна ApplicationData.LocalFolder имот). Този файл съдържа идентификатор, използван от инфраструктурни насочена уведомления лицеви. Уверете се, че приложението ви не се променя или изтрива файла. В противен случай, вашите потребители могат да получат множество копия на уведомленията или уведомленията няма да работят правилно.

целеви трансфер лицеви известия до потребителите

Реакцията на вашата кандидатура, когато той работи на потребителя

След регистриране на заявлението, за да получавате известия и изпращане на лицеви известия до потребителите на приложението Ви от Центъра за развитие ще бъде обажда един от тези входни точки в молбата Ви, когато потребителят да стартирате приложението, в отговор на вашия тласък уведомление. Ако имате код, който се изисква, когато потребителят работи кандидатурата си, можете да добавите този код в една от входните точки в заявлението.

Ако механизмът за уведомяване е типът на активиране на преден план, замени метод OnActivated App клас в проекта си и да добавите код по този метод.

Ако механизмът за уведомяване е типът на фона на активиране, добавете кода на метода на Run за задача на фона.

Например, може да реши да възнагради потребителите на приложението си, които са закупили всяка платена добавка в приложение, като им предоставя безплатни добавки. В този случай, можете да изпратите лицеви уведомление определен сегмент от потребители. насочена към тези потребители. След това можете да добавите код, за да им позволи правото на безплатни покупки на приложения. в един от горните входните точки.

Център за уведомяване за развитие на вашите започва кандидатстване

Ако Център за развитие, която сте избрали Track броя на прилагане на пуска на вашата целева лицеви уведомление, обадете метод ParseArgumentsAndTrackAppLaunch от съответния входен пункт в молбата за уведомяване на Центъра за разработка да стартира приложението ви в отговор на лицеви уведомление.

Този метод също се връща първоначалните стартови аргументи за приложението. Когато изберете опцията за проследяване на броя на заявленията за стартирането на вашите лицеви уведомления до аргументите започне проследяване добавя непрозрачен идентификатор за изстрелвания за кандидатстване преброяване в Центъра за развитие. Трябва да издържите аргументи, за да се движат метод заявление ParseArgumentsAndTrackAppLaunch на. и този метод ще изпрати идентификационен номер за проследяване в Центъра за развитие, го премахнете от аргументите на стартиране и връщане на оригиналните аргументи вашият код ще работи.

Метод на обадите на този метод зависи от вида активиране тласък уведомление:

Ако механизмът за уведомяване е типът на активиране на преден план, обадете се на този метод от първостепенни метод OnActivated в молбата си и да премине аргументи, които са налични в ToastNotificationActivatedEventArgs обекта. предавани по този метод. Следният код пример предполага, че файлът съдържа твърдения код с помощта на Microsoft.Services.Store.Engagement и Windows.ApplicationModel.Activation именни пространства.

Ако механизмът за уведомяване е типът на фона на активиране, обадете се на този метод от метода Run на фона на задача и да премине на наличните в ToastNotificationActionTriggerDetail обекта аргументи. предавани по този метод. Следният код пример предполага, че кодът файл съдържа използващи отчети за Microsoft.Services.Store.Engagement именни пространства. Windows.ApplicationModel.Background и Windows.UI.Notifications.

Отписване на лицеви уведомления

Ако искате приложението си спря изпращане насочена лицеви уведомяване на Центъра за развитие, да се извика методът UnregisterNotificationChannelAsync.

Имайте предвид, че този метод обезсилва канал, който се използва за изпращане на уведомления, така че приложението ще спре да получава тласък уведомление от каквито и да било услуги. След затваряне на канала вече не може да се използва за каквито и да било услуги, включително целенасочена тласък уведомление от Центъра за развитие и други уведомления, които използват WNS на услуги. За да се възобнови изпращането на лицеви уведомления за това приложение, то ще се наложи да поискате нов канал.