Покупки из приложения и пробные версии

Покупки и пробные версии в приложении с помощью пространства имен Windows.Services.Store

В этом разделе представлен обзор важных задач и концепций для пространства имен Windows.Services.Store . Это пространство имен доступно только для приложений, предназначенных для Windows 10 Anniversary Edition (10.0; Сборка 14393) или более поздняя версия в Visual Studio (это соответствует Windows 10 версии 1607). Мы рекомендуем приложениям использовать пространство имен Windows.Services.Store вместо пространства имен Windows.ApplicationModel.Store , если это возможно. Сведения о пространстве имен Windows.ApplicationModel.Store см . в этой статье.

В этом разделе

• Видео
• Начало работы с классом StoreContext
• Реализация покупок в приложении
• Реализация функциональных возможностей пробной версии
• Тестирование реализации покупки или пробной версии в приложении
• Квитанции для покупок в приложении
• Использование класса StoreContext с мост для классических приложений
• Продукты, номера SKU и доступность
• Идентификаторы магазина

Начало работы с классом StoreContext

Основная точка входа в пространство имен Windows.Services.Store — класс StoreContext . Этот класс предоставляет методы, которые можно использовать для получения сведений о текущем приложении и его доступных надстройках, получения сведений о лицензии для текущего приложения или его надстроек, приобретения приложения или надстройки для текущего пользователя и выполнения других задач. Чтобы получить объект StoreContext , выполните одно из следующих действий:

• В однопользовательском приложении (то есть приложение, которое выполняется только в контексте пользователя, запускающего приложение), используйте статический метод GetDefault для получения объекта StoreContext , который можно использовать для доступа к данным, связанным с Microsoft Store для пользователя. Большинство приложений универсальная платформа Windows (UWP) — это однопользовательские приложения.

  Windows.Services.Store.StoreContext context = StoreContext.GetDefault();
  

• В многопользовательском приложении используйте статический метод GetForUser , чтобы получить объект StoreContext , который можно использовать для доступа к данным, связанным с Microsoft Store, для конкретного пользователя, вошедшего в систему с учетной записью Майкрософт при использовании приложения. В следующем примере возвращается объект StoreContext для первого доступного пользователя.

  var users = await Windows.System.User.FindAllAsync();
  Windows.Services.Store.StoreContext context = StoreContext.GetForUser(users[0]);
  

После того как у вас есть объект StoreContext , можно начать вызывать методы этого объекта, чтобы получить сведения о продукте Store для текущего приложения и его надстроек, получить сведения о лицензии для текущего приложения и его надстройки, приобрести приложение или надстройку для текущего пользователя и выполнить другие задачи. Дополнительные сведения о распространенных задачах, которые можно выполнить с помощью этого объекта, см. в следующих статьях:

• Получение сведений о продукте для приложений и надстроек
• Получение сведений о лицензии для приложений и надстроек
• Включение покупок в приложении приложений и надстроек
• Включение покупок потребляемых надстроек
• Включение надстроек подписки для приложения
• Реализация пробной версии приложения

Пример приложения, демонстрирующего использование StoreContext и других типов в пространстве имен Windows.Services.Store , см. в примере Магазина.

Реализация покупок в приложении

Чтобы предложить клиентам в приложении покупку в приложении с помощью пространства имен Windows.Services.Store :

1. Если ваше приложение предлагает надстройки, которые клиенты могут приобрести, создайте отправки надстроек для вашего приложения в Центре партнеров.

2. Напишите код в приложении, чтобы получить сведения о продукте для приложения или надстройки, предлагаемой приложением , а затем определить, активна ли лицензия (т. е. имеет ли пользователь лицензию на использование приложения или надстройки). Если лицензия не активна, отобразите пользовательский интерфейс, который предлагает приложение или надстройку для продажи пользователю в качестве покупки в приложении.

3. Если пользователь решит приобрести приложение или надстройку, используйте соответствующий метод для покупки продукта:

   • Если пользователь приобретает приложение или устойчивую надстройку, следуйте инструкциям в разделе "Включение покупок в приложении" приложений и надстроек.
   • Если пользователь приобретает потребляемую надстройку, следуйте инструкциям в разделе "Включить покупки потребляемых надстроек".
   • Если пользователь приобретает надстройку подписки, следуйте инструкциям в разделе "Включение надстроек подписки" для приложения.

4. Протестируйте реализацию, следуя инструкциям по тестированию в этой статье.

Реализация функциональных возможностей пробной версии

Чтобы исключить или ограничить функции в пробной версии приложения с помощью пространства имен Windows.Services.Store :

1. Настройте приложение в качестве бесплатной пробной версии в Центре партнеров.

2. Напишите код в приложении, чтобы получить сведения о продукте для приложения или надстройки, предлагаемой приложением, а затем определить, является ли лицензия, связанная с приложением, является пробной лицензией.

3. Исключите или ограничьте некоторые функции в приложении, если это пробная версия, а затем включите функции, когда пользователь приобретает полную лицензию. Дополнительные сведения и пример кода см. в статье "Реализация пробной версии приложения".

4. Протестируйте реализацию, следуя инструкциям по тестированию в этой статье.

Тестирование реализации покупки или пробной версии в приложении

Если приложение использует API в пространстве имен Windows.Services.Store для реализации функций покупки или пробной версии приложения, необходимо опубликовать приложение в Магазине и скачать приложение на устройство разработки, чтобы использовать ее лицензию для тестирования. Выполните этот процесс, чтобы проверить код:

1. Если ваше приложение еще не опубликовано и доступно в Магазине, убедитесь, что ваше приложение соответствует минимальным требованиям комплекта сертификации приложений Для Windows, отправьте приложение в Центр партнеров и убедитесь, что ваше приложение проходит сертификационный процесс. Вы можете настроить приложение так, чтобы оно было недоступно для обнаружения в Магазине во время его тестирования. Обратите внимание на правильную конфигурацию пакетов. Неправильно настроенные рейсы пакетов могут быть не в состоянии скачать.

2. Затем убедитесь, что вы выполнили следующее:

   • Напишите код в приложении, использующего класс StoreContext и другие связанные типы в пространстве имен Windows.Services.Store для реализации покупок в приложении или пробной версии.
   • Если ваше приложение предлагает надстройку, которую клиенты могут приобрести, создайте отправку надстройки для вашего приложения в Центре партнеров.
   • Если вы хотите исключить или ограничить некоторые функции в пробной версии приложения, настройте приложение в качестве бесплатной пробной версии в Центре партнеров.

3. Открыв проект в Visual Studio, щелкните меню "Проект", наведите указатель на Магазин и выберите пункт "Связать приложение с Магазином". Выполните инструкции в мастере, чтобы связать проект приложения с приложением в учетной записи Центра партнеров, которую вы хотите использовать для тестирования.

   Примечание.

   Если проект не связан с приложением в Магазине, методы StoreContext задают свойство ExtendedError возвращаемых значений значением кода ошибки 0x803F6107. Это значение указывает, что в Магазине нет знаний о приложении.

4. Если это еще не сделано, установите приложение из Магазина, указанного на предыдущем шаге, запустите приложение один раз и закройте это приложение. Это гарантирует, что на устройстве разработки установлена действительная лицензия для приложения.

5. В Visual Studio запустите или отладите проект. Код должен получать данные приложения и надстройки из приложения Store, связанного с локальным проектом. Если вам будет предложено переустановить приложение, следуйте инструкциям, а затем запустите или отладите проект.

   Примечание.

   После выполнения этих действий можно продолжить обновление кода приложения, а затем выполнить отладку обновленного проекта на компьютере разработки без отправки новых пакетов приложений в Магазин. Чтобы получить локальную лицензию, которая будет использоваться для тестирования, необходимо скачать только версию приложения Store на компьютер разработки. После завершения тестирования необходимо отправить новые пакеты приложений в Магазин, и вы хотите приобрести в приложении или пробные возможности, доступные вашим клиентам.

Если приложение использует пространство имен Windows.ApplicationModel.Store , можно использовать класс CurrentAppSimulator в приложении для имитации сведений о лицензии во время тестирования перед отправкой приложения в Магазин. Дополнительные сведения см. в статье "Начало работы с классами CurrentApp и CurrentAppSimulator".

Квитанции для покупок в приложении

Пространство имен Windows.Services.Store не предоставляет API, который можно использовать для получения квитанции о транзакциях для успешных покупок в коде приложения. Это отличается от приложений, использующих пространство имен Windows.ApplicationModel.Store , которое может использовать клиентский API для получения квитанции о транзакциях.

Если вы реализуете покупки в приложении с помощью пространства имен Windows.Services.Store и хотите проверить, приобрел ли данный клиент приложение или надстройку, можно использовать запрос к продуктам в REST API коллекции Microsoft Store. Возвращаемые данные для этого метода подтверждают, имеет ли указанный клиент право на определенный продукт и предоставляет данные для транзакции, в которой пользователь приобрел продукт. API коллекции Microsoft Store использует проверку подлинности Azure AD для получения этих сведений.

Использование класса StoreContext с мост для классических приложений

Классические приложения, использующие мост для классических приложений, могут использовать класс StoreContext для реализации покупок и пробных версий в приложении. Однако если у вас есть классическое приложение Win32 или классическое приложение с дескриптором окна (HWND), связанное с платформой отрисовки (например, приложением WPF или windows App SDK), приложение должно настроить объект StoreContext , чтобы указать, какое окно приложения является окном владельца для модальных диалогов, отображаемых объектом.

Многие члены StoreContext (и члены других связанных типов, к которым обращается объект StoreContext), отображают модальное диалоговое окно пользователю для операций, связанных с Магазином, таких как покупка продукта. Если классическое приложение не настраивает объект StoreContext для указания окна владельца для модальных диалогов, этот объект вернет неточные данные или ошибки.

Чтобы настроить объект StoreContext в классическом приложении, использующее мост для классических приложений, выполните следующие действия.

Для .NET 6 или более поздней версии

Если приложение написано на C# с .NET 6 или более поздней версии, выполните следующие действия.

1. Убедитесь, что TargetFramework для свойства в файле проекта задана определенная версия пакета SDK для Windows для доступа к API среда выполнения Windows, которая предоставляет доступ к пространству имен WinRT.Interop. Например:

   <PropertyGroup>
     <!-- You can also target other versions of the Windows SDK and .NET, e.g. "net6.0-windows10.0.19041.0" -->
     <TargetFramework>net6.0-windows10.0.22000.0</TargetFramework>
   </PropertyGroup>
   

2. Получите объект StoreContext с помощью метода GetDefault (или GetForUser, если приложение является многопользовательским приложением), как описано ранее в этой статье. Чтобы инициализировать диалоговое окно с указанным дескриптором окна, используйте методы WinRT.Interop.WindowNative.GetWindow.GetWindow.Interop.Initialize (см. дескриптор окна (HWND) и объекты пользовательского интерфейса WinRT, зависящие от CoreWindow.

   StoreContext context = StoreContext.GetDefault();
   // Obtain window handle by passing in pointer to the window object
   var hwnd = WinRT.Interop.WindowNative.GetWindowHandle(windowObject);
   // Initialize the dialog using wrapper function for IInitializeWithWindow
   WinRT.Interop.InitializeWithWindow.Initialize(context, hwnd); 
   

Для более ранних версий .NET или C++

Если приложение написано с более ранней версией .NET или C++, выполните следующие действия.

1. Выполните одно из следующих действий, чтобы разрешить приложению доступ к интерфейсу IInitializeWithWindow :

   • Если приложение написано на управляемом языке, например C# или Visual Basic (до .NET 6), объявите интерфейс IInitializeWithWindow в коде приложения с атрибутом ComImport , как показано в следующем примере C#. В этом примере предполагается, что файл кода содержит инструкцию using для пространства имен System.Runtime.InteropServices .

     [ComImport]
     [Guid("3E68D4BD-7135-4D10-8018-9FB6D9F33FA1")]
     [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
     public interface IInitializeWithWindow
     {
         void Initialize(IntPtr hwnd);
     }
     

   • Если приложение написано на языке C++, добавьте ссылку на файл заголовка shobjidl.h в коде. Этот файл заголовка содержит объявление интерфейса IInitializeWithWindow .

2. Получите объект StoreContext с помощью метода GetDefault (или GetForUser, если приложение является мультипользовательским приложением), как описано ранее в этой статье, и приведение этого объекта к объекту IInitializeWithWindow. Затем вызовите метод IInitializeWithWindow.Initialize и передайте дескриптор окна, который вы хотите быть владельцем для любых модальных диалогов, отображаемых методами StoreContext . В следующем примере C# показано, как передать дескриптор главного окна приложения методу. См. также статью Получение дескриптора окна (HWND) и Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

   StoreContext context = StoreContext.GetDefault();
   IInitializeWithWindow initWindow = (IInitializeWithWindow)(object)context;
   initWindow.Initialize(System.Diagnostics.Process.GetCurrentProcess().MainWindowHandle);
   

Продукты, номера SKU и доступность

Каждый продукт в Магазине имеет по крайней мере один номер SKU, и каждый номер SKU имеет по крайней мере одну доступность. Эти понятия абстрагируются от большинства разработчиков в Центре партнеров, и большинство разработчиков никогда не определяют номера SKU или доступность для своих приложений или надстроек. Однако, поскольку объектная модель для продуктов Store в пространстве имен Windows.Services.Store включает номера SKU и доступность, базовое понимание этих понятий может оказаться полезным для некоторых сценариев.

Идентификаторы магазина

Каждое приложение, надстройка или другой продукт в Магазине имеет связанный идентификатор Магазина (это также иногда называется идентификатором магазина продуктов). Для выполнения операции с приложением или надстройкой требуется идентификатор Магазина.

Идентификатор магазина любого продукта в Магазине — 12-символьная буквенно-числовая строка, например 9NBLGGH4R315. Существует несколько различных способов получения идентификатора Магазина для продукта в Магазине:

• Для приложения можно получить идентификатор Магазина на странице удостоверений приложения в Центре партнеров.
• Для надстройки можно получить идентификатор Магазина на странице обзора надстройки в Центре партнеров.
• Для любого продукта можно также получить идентификатор Магазина программным способом с помощью свойства StoreId объекта StoreProduct, представляющего продукт.

Для продуктов с номерами SKU и доступностью номера SKU и доступности также имеют собственные идентификаторы Магазина с различными форматами.

Использование идентификаторов продуктов для надстроек в коде

Если вы хотите сделать надстройку доступной для клиентов в контексте приложения, необходимо ввести уникальный идентификатор продукта для надстройки при создании отправки надстройки в Центре партнеров. Этот идентификатор продукта можно использовать для ссылки на надстройку в коде, хотя конкретные сценарии, в которых можно использовать идентификатор продукта, зависят от пространства имен, используемого для покупок в приложении.

Приложения, использующие пространство имен Windows.Services.Store

Если приложение использует пространство имен Windows.Services.Store , можно использовать идентификатор продукта, чтобы легко определить StoreProduct , представляющий надстройку или StoreLicense , представляющую лицензию надстройки. Идентификатор продукта предоставляется свойствами StoreProduct.InAppOfferToken и StoreLicense.InAppOfferToken .

Приложения, использующие пространство имен Windows.ApplicationModel.Store

Если приложение использует пространство имен Windows.ApplicationModel.Store , необходимо использовать идентификатор продукта, назначенный надстройке в Центре партнеров для большинства операций. Например:

• Используйте идентификатор продукта для идентификации ProductListing , представляющей надстройку или ProductLicense , которая представляет лицензию вашей надстройки. Идентификатор продукта предоставляется свойствами ProductListing.ProductId и ProductLicense.ProductId .

• Укажите идентификатор продукта при покупке надстройки для пользователя с помощью метода RequestProductPurchaseAsync . Дополнительные сведения см. в разделе "Включение покупок в приложении".

• Укажите идентификатор продукта при отчете о используемой надстройке как выполненной с помощью метода ReportConsumableFulfillmentAsync . Дополнительные сведения см. в разделе "Включение потребляемых покупок в приложении".

См. также

• Получение сведений о продукте для приложений и надстроек
• Получение сведений о лицензии для приложений и надстроек
• Включение покупок в приложении приложений и надстроек
• Включение покупок потребляемых надстроек
• Включение надстроек подписки для приложения
• Реализация пробной версии приложения
• Коды ошибок для операций Магазина
• Покупки и пробные версии в приложении с помощью пространства имен Windows.ApplicationModel.Store