Укажите следственные действия которым свойственны методы рассказа и описания

Покупки из приложения и пробные версии, использующие пространство имен 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. Большинство приложений 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, можно начать вызывать методы этого объекта для получения сведений о продукте из Магазина для текущего приложения и его надстроек, получать сведения о лицензии для текущего приложения и его надстроек, приобретать приложение или надстройку для текущего пользователя и выполнять другие задачи. Дополнительные сведения об общих задачах, которые можно выполнять с помощью этого объекта, см. в следующих статьях:

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

Пример приложения, в котором показано, как использовать класс StoreContext и другие типы в пространстве имен Windows.Services.Store, см. в разделе Образец из Магазина.

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

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

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

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

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

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

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

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

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

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

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

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

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

Проверка вашей покупки из приложения или реализации пробной версии

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

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

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

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

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

   Примечание

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

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

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

   Примечание

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

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

Чеки для покупок из приложения

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

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

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

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

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

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

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

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

1. убедитесь, что для TargetFramework свойства в файле проекта TargetFramework, которые предоставляют доступ к пространству имен WinRT. Interop . Пример:

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

2. Получите объект стореконтекст с помощью метода по умолчанию (или жетфорусер , если приложение является многопользовательским приложением), как описано выше в этой статье. Используйте метод WinRT. Interop. инитиализевисвиндов. Initialize , как описано здесь , чтобы инициализировать диалоговое окно с указанным маркером окна.

   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 funcion for IInitializeWithWindow
   WinRT.Interop.InitializeWithWindow.Initialize(context, hwnd); 
   

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

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

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

   • если приложение написано на управляемом языке, например c# или Visual Basic (до .net 5), объявите интерфейс иинитиализевисвиндов в коде приложения с помощью атрибута 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# показано, как передать в метод маркер главного окна приложения.

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

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

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

Коды продукта в Магазине

Все приложения, надстройки и другие продукты в Магазине имеют соответствующий код в Магазине (его также иногда называют кодом продукта в Магазине). Многие API-интерфейсы требуют указания кода продукта в Магазине для выполнения операции с приложением или надстройкой.

Код любого продукта в Магазине — это буквенно-цифровая строка, состоящая из 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. Дополнительные сведения см. в разделе Поддержка покупок потребляемых внутренних продуктов приложения.

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

Пакет Windows SDK предоставляет API, которые можно использовать для реализации следующих функций, позволяющих получать прибыль от своего приложения универсальной платформы Windows (UWP):

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

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

Эта статья содержит обзорные сведения о том, как в приложениях UWP работают покупки из приложения и пробные версии.

Выбор пространства имен

Существует два разных пространствах имен, которые можно использовать для добавления функций покупок из приложения и пробной версии в приложениях UWP в зависимости от того, для какой версии Windows 10 предназначены ваши приложения. Несмотря на то что API в этих пространствах имен служат тем же целям, они различаются принципами разработки и имеют несовместимый код.

• Windows. Services.Store начиная с Windows 10 версии 1607, приложения могут использовать API в этом пространстве имен для реализации покупок и испытаний в приложении. Рекомендуется использовать элементы из этого пространства имен, если ваше проект вашего приложения предназначен для Windows 10 Anniversary Edition (10.0; сборка 14393) или более позднего выпуска в Visual Studio. Это пространство имен поддерживает новейшие типы надстроек, такие как управляемые хранением надстройки, и предназначено для совместимости с будущими типами продуктов и функций, поддерживаемых центром партнеров и магазином. Дополнительные сведения об этом пространстве имен см. в разделе Покупки из приложения и пробные версии, использующие пространство имен Windows.Services.Store этой статьи.

• Windows. ApplicationModel.Store. все версии Windows 10 также поддерживают более старый API для покупок и испытаний в приложении в этом пространстве имен. Сведения об использовании элементов пространства имен Windows.ApplicationModel.Store см. в разделе Внутренние покупки приложения и пробные версии, использующие пространство имен Windows.ApplicationModel.Store.

Основные понятия

Каждый элемент, предлагаемый в Магазине, как правило, называется продукт. Большинство разработчиков работают только со следующими типами продуктов: приложения и надстройки.

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

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

Приложения UWP могут иметь следующие типы надстроек.