В цій статті
У цій статті показано, як використовувати елементи простору імен Windows.ApplicationModel.Store для включення покупок продуктів в додатку. Якщо ваше додаток призначений для Windows 10 версії 1607 або більш пізньої, для управління покупками з програми рекомендується використовувати елементи, що входять до простір імен Windows.Services.Store. а не Windows.ApplicationModel.Store. Додаткові відомості див. У цій статті.
Незалежно від того, чи є ваше додаток безкоштовним чи ні, ви можете продавати вміст, інші додатки або нові функціональні можливості (наприклад, розблокування наступного рівня гри) прямо з програми. У цьому розділі розповідається про те, як вирішити такі покупки.
Внутрішні продукти програми не можуть пропонуватися в пробної версії. Користувачі пробної версії програми зможуть купити внутрішній продукт додатки, тільки якщо придбають повну версію цього додатка.
Необхідні умови
- Додаток для Windows, в яке передбачається додати компоненти для продажу.
- Коли ви створите код для продажів внутрішніх продуктів додатки і будете перевіряти його в перший раз, використовуйте об'єкт CurrentAppSimulator замість об'єкта CurrentApp. В цьому випадку ви зможете перевірити логіку ліцензування шляхом імітації звернення до сервера ліцензування замість виклику реального сервера. Для цього необхідно змінити файл з ім'ям WindowsStoreProxy.xml в папці% userprofile% \ AppData \ local \ packages \<имя пакета>\ LocalState \ Microsoft \ Windows Store \ ApiData. Імітатор Microsoft Visual Studio створює цей файл при першому запуску програми. Також можна завантажити власний його варіант під час виконання. Додаткові відомості див. У розділі Використання файлу WindowsStoreProxy.xml з CurrentAppSimulator.
- У цьому розділі також наведені посилання на приклади коду зі статті Приклад для Магазину. Цей приклад дає відмінну можливість поекспериментувати з різними способами оплати, доступними для додатків універсальної платформи Windows (UWP).
Крок 1. Ініціалізація відомостей про ліцензії для додатка
Під час ініціалізації програми отримаєте для нього об'єкт LicenseInformation шляхом ініціалізації CurrentApp або CurrentAppSimulator. щоб включити покупки внутрішніх продуктів додатки.
Крок 2. Додавання в додаток функції продажу з програми
Для кожного компонента, який повинен бути доступний як продукт всередині програми, реалізуйте функцію продажу і додайте її в свій додаток.
В додаток необхідно додати всі продукти, які призначені для продажу клієнтам, до відправки в Магазин. Якщо потім ви захочете додати нові продукти з програми, вам доведеться оновити додаток і відправити в Магазин нову версію.
Створення маркера продажу з програми
Ви визначаєте кожен внутрішній продукт додатки в своєму додатку по маркеру. Маркер- це рядок, яку ви визначаєте і використовуєте в своєму додатку і в Магазині для ідентифікації певного продукту з програми. Дайте маркеру ім'я, зрозуміле і унікальне для вашого застосування, щоб швидко визначати, який компонент він представляє, при написанні коду. Ось кілька прикладів імен:
- "SpaceMissionLevel4"
- "ContosoCloudSave"
- "RainbowThemePack"
Приміщення коду компонента в умовний блок
Код компонента, пов'язаного з внутрішнім продуктом додатки, необхідно помістити в умовний блок, який перевіряє наявність у користувача ліцензії на використання цього компонента.
Ось приклад коду для можливості продукту під назвою featureName в умовному блоці ліцензування. Рядок featureName - це маркер, однозначно визначає цей продукт в додатку і в Магазині.
Додавання користувальницького інтерфейсу покупки для даного компонента
У додатку вам також слід реалізувати можливість покупки продукту або компонента, пропонованого для продукту з програми. Його користувачі не можуть придбати їх через Магазин, як придбали сам додаток.
Крок 3. Заміна тестового коду остаточною версією
Крок 4. Налаштування продажу продукту з програми в Магазині
На інформаційній панелі Центру розробки перейдіть до додатка і створіть надбудову. відповідну пропонованого продукту в додатку. Визначте код продукту, тип, ціну та інші властивості для надбудови. Переконайтеся, що налаштування ідентична виконаної в WindowsStoreProxy.xml налаштування при тестуванні.
Маркер продажу з програми, який використовується в коді, повинен відповідати значенням коду продукту. яке вказується при визначенні відповідної надбудови на інформаційній панелі.
Примітки
Якщо ви хочете надати користувачам можливість купувати споживані товари з програми (елементи, які можна придбати, використовувати, а потім за бажанням придбати ще раз), перейдіть до розділу Підтримка покупок споживаних внутрішніх продуктів додатки.
Якщо вам потрібні квитанції для підтвердження здійснення користувачем покупки з програми, ознайомтеся з розділом Перевірка покупок продуктів за допомогою квитанцій.