Sdílet prostřednictvím

Nákupy v aplikaci a zkušební verze

Sada Windows SDK poskytuje rozhraní API, která můžete použít k implementaci následujících funkcí, abyste z vaší aplikace pro Univerzální platformu Windows (UPW) vydělali více peněz:

  • Nákupy v aplikaci Bez ohledu na to, jestli je vaše aplikace bezplatná nebo ne, můžete prodat obsah nebo nové funkce aplikace (například odemknout další úroveň hry) přímo v aplikaci.

  • funkce zkušební verze Pokud aplikaci nakonfigurovat jako bezplatnou zkušební verzi v Partnerském centru, můžete své zákazníky přivést k nákupu plné verze aplikace tím, že vyloučíte nebo omezíte některé funkce během zkušebního období. Můžete také povolit funkce, jako jsou bannery nebo vodoznaky, které se zobrazují jenom během zkušební verze, než si zákazník koupí vaši aplikaci.

Tento článek obsahuje přehled toho, jak fungují nákupy a zkušební verze v aplikacích pro UPW.

Důležité

Funkce nákupu v aplikaci se v současné době nepodporuje v aplikacích se zvýšenými oprávněními.

Vyberte obor názvů, který chcete použít.

Existují dva různé obory názvů, které můžete použít k přidání nákupů v aplikacích a zkušebních verzí aplikací pro UPW v závislosti na tom, na jakou verzi Windows 10 nebo Windows 11 cílí vaše aplikace. I když rozhraní API v těchto oborech názvů slouží stejným cílům, jsou navržena poměrně odlišně a kód není kompatibilní mezi těmito dvěma rozhraními API.

Důležité

Obor názvů Windows.ApplicationModel.Store se už neaktualizuje novými funkcemi a pokud je to možné, doporučujeme místo toho použít obor názvů Windows.Services.Store. Obor názvů Windows.ApplicationModel.Store není podporován v desktopových aplikacích Windows, které používají Desktop Bridge nebo v aplikacích nebo hrách, které používají vývojový sandbox v Partner Center (například to platí pro jakoukoliv hru, která se integruje s Xbox Live).

Základní koncepty

Každá položka, která je nabízena v obchodě, se obecně nazývá produkt. Většina vývojářů pracuje jenom s následujícími typy produktů: aplikace a doplňky.

Doplněk je produkt nebo funkce, kterou zákazníkům zpřístupníte v kontextu vaší aplikace: například měna, která se má použít v aplikaci nebo hře, nové mapy nebo zbraně pro hru, možnost používat aplikaci bez reklam nebo digitální obsah, jako je hudba nebo videa pro aplikace, které mají možnost nabízet tento typ obsahu. Každá aplikace a doplněk mají přidruženou licenci, která označuje, jestli má uživatel nárok na používání aplikace nebo doplňku. Pokud má uživatel nárok na používání aplikace nebo doplňku jako zkušební verzi, poskytuje licence také další informace o zkušební verzi.

Pokud chcete zákazníkům ve vaší aplikaci nabídnout doplněk, musíte ho definovat v Partnerském centru, aby o něm Store věděl. Aplikace pak může používat rozhraní API v oboru názvů Windows.Services.Store nebo Windows.ApplicationModel.Store k nabídnutí nákupu doplňku uživateli v rámci nákupu v aplikaci.

Aplikace pro UPW můžou nabízet následující typy doplňků.

Typ doplňku Popis
Trvalý Doplněk, který trvá po celou dobu života, který zadat v Partnerském centru.

Ve výchozím nastavení trvalé doplňky nikdy nevyprší platnost, v takovém případě je možné zakoupit pouze jednou. Pokud zadáte určitou dobu trvání doplňku, uživatel může doplněk po vypršení jeho platnosti znovu koupit.
Spotřební materiál spravovaný vývojářem Doplněk, který je možné zakoupit, použít a potom ho znovu zakoupit po jeho spotřebě. Zodpovídáte za sledování uživatelského zůstatku položek, které představuje doplněk.

Když uživatel spotřebuje všechny položky, které jsou přidružené k doplňku, zodpovídáte za udržování zůstatku uživatele a za hlášení nákupu doplňku tak, jak je splněno ve Storu poté, co uživatel spotřeboval všechny položky. Uživatel nemůže doplněk koupit znovu, dokud vaše aplikace nenahlásila předchozí nákup doplňku jako splněný.

Pokud například doplněk představuje 100 mincí ve hře a uživatel spotřebovává 10 mincí, vaše aplikace nebo služba musí udržovat nový zůstatek 90 mincí pro uživatele. Jakmile uživatel spotřebuje všech 100 mincí, musí vaše aplikace nahlásit doplněk jako splněný a pak si uživatel může doplněk 100 mincí koupit znovu.
Spotřební materiál spravovaný obchodem Doplněk, který je možné kdykoli koupit, použít a koupit znovu. Store sleduje zůstatek položek uživatele, které doplněk představuje.

Když uživatel spotřebuje všechny položky, které jsou přidružené k doplňku, zodpovídáte za hlášení těchto položek jako splněné ve Storu a Store aktualizuje zůstatek uživatele. Uživatel si může doplněk koupit tolikrát, kolikrát chce (nemusí nejdřív spotřebovávat položky). Aplikace se může kdykoli dotazovat na aktuální zůstatek uživatele.

Pokud například doplněk představuje počáteční množství 100 mincí ve hře a uživatel spotřebovává 50 mincí, vaše aplikace hlásí do Storu, že bylo splněno 50 jednotek doplňku a Store aktualizuje zbývající zůstatek. Pokud si uživatel pak doplněk koupí znovu, aby získal 100 dalších mincí, bude mít nyní celkem 150 mincí.

Poznámka Pro použití spotřebního zboží spravovaného obchodem musí vaše aplikace cílit na Windows 10 Anniversary Edition (10.0; Build 14393) nebo novější verzi ve Visual Studiu a musí používat obor názvů Windows.Services.Store místo oboru názvů Windows.ApplicationModel.Store.
Předplatné Dlouhodobý doplněk, kde je zákazníkovi nadále účtováno v pravidelných intervalech, aby mohl doplněk dále používat. Zákazník může předplatné kdykoli zrušit, aby se zabránilo dalším poplatkům.

Poznámka Pokud chcete používat doplňky předplatného, musí vaše aplikace cílit na Windows 10 Anniversary Edition (10.0; Build 14393) nebo novější verze v sadě Visual Studio a musí místo oboru názvů Windows.ApplicationModel.Store používat Windows.Services.Store obor názvů.

Poznámka:

Další typy doplňků, jako jsou trvalé doplňky s balíčky (označované také jako obsah ke stažení nebo DLC), jsou dostupné jenom omezené sadě vývojářů a nejsou popsané v této dokumentaci.

Nákupy v aplikaci a zkušební verze s využitím namespace Windows.Services.Store

Tato část obsahuje přehled důležitých úloh a konceptů pro obor názvů Windows.Services.Store . Tento obor názvů je dostupný jenom pro aplikace, které cílí na Windows 10 Anniversary Edition (10.0; Build 14393) nebo novější verze v sadě Visual Studio (to odpovídá Windows 10 verze 1607). Pokud je to možné, doporučujeme, aby aplikace místo Windows.ApplicationModel.Store oboru názvů používaly obor názvů Windows.Services.Store. Informace o oboru názvů Windows.ApplicationModel.Store naleznete v tomto článku.

V této části

Začínáme s třídou StoreContext

Hlavní vstupní bod do oboru názvů Windows.Services.Store je StoreContext třída. Tato třída poskytuje metody, které můžete použít k získání informací pro aktuální aplikaci a jejích dostupných doplňků, získání informací o licenci pro aktuální aplikaci nebo jejích doplňků, zakoupení aplikace nebo doplňku pro aktuálního uživatele a provádění dalších úloh. Pokud chcete získat objekt StoreContext , proveďte jednu z následujících věcí:

  • V aplikaci s jedním uživatelem (tj. aplikace, která běží pouze v kontextu uživatele, který aplikaci spustil), použijte statickou metodu GetDefault k získání objektu StoreContext , který můžete použít pro přístup k datům souvisejícím s Microsoft Storem pro uživatele. Většina aplikací pro Univerzální platformu Windows (UPW) je určena pro jednoho uživatele.

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

  • V aplikaci pro více uživatelů použijte statickou metodu GetForUser k získání objektu StoreContext , který můžete použít pro přístup k datům souvisejícím s Microsoft Storem pro konkrétního uživatele, který je přihlášen pomocí svého účtu Microsoft při používání aplikace. Následující příklad získá objekt StoreContext pro prvního dostupného uživatele.

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

Poznámka:

Desktopové aplikace systému Windows, které používají desktopový most , musí před použitím tohoto objektu provést další kroky ke konfiguraci objektu StoreContext . Další informace najdete v této části.

Jakmile máte objekt StoreContext , můžete začít volat metody tohoto objektu, abyste získali informace o produktu Store pro aktuální aplikaci a její doplňky, načetli informace o licenci pro aktuální aplikaci a její doplňky, koupili aplikaci nebo doplněk pro aktuálního uživatele a provedli další úlohy. Další informace o běžných úlohách, které můžete provádět pomocí tohoto objektu, najdete v následujících článcích:

cs-CZ: Ukázkovou aplikaci, která používá StoreContext a další typy v rámci oboru názvů Windows.Services.Store, naleznete v ukázce Store .

Implementace nákupů v aplikaci

Pokud chcete zákazníkům ve vaší aplikaci nabídnout nákup v aplikaci pomocí oboru názvů Windows.Services.Store :

  1. Pokud vaše aplikace nabízí doplňky, které si zákazníci můžou koupit, vytvářet podání pro doplňky vaší aplikace v Partnerském centru .

  2. Napište v aplikaci kód, který načíst informace o produktu pro vaši aplikaci nebo doplněk nabízený vaší aplikací a pak určit, jestli je licence aktivní (to znamená, jestli má uživatel licenci k používání aplikace nebo doplňku). Pokud licence není aktivní, zobrazte uživatelské rozhraní, které nabízí aplikaci nebo doplněk k prodeji uživateli jako nákup v aplikaci.

  3. Pokud se uživatel rozhodne koupit aplikaci nebo doplněk, použijte k nákupu produktu příslušnou metodu:

  4. Otestujte implementaci podle pokynů k testování v tomto článku.

Implementace zkušebních funkcí

Vyloučení nebo omezení funkcí ve zkušební verzi aplikace pomocí oboru názvů Windows.Services.Store :

  1. Nakonfigurujte aplikaci jako bezplatnou zkušební verzi v Partnerském centru.

  2. Napište v aplikaci kód, který načíst informace o produktu pro vaši aplikaci nebo doplněk nabízený vaší aplikací a pak určit, jestli je licence přidružená k aplikaci zkušební licencí.

  3. Pokud se jedná o zkušební verzi, vyloučíte nebo omezíte některé funkce ve vaší aplikaci a povolíte funkce, když si uživatel koupí úplnou licenci. Další informace a příklad kódu najdete v tématu Implementace zkušební verze aplikace.

  4. Otestujte implementaci podle pokynů k testování v tomto článku.

Otestujte svou implementaci nákupů v aplikaci nebo zkušební verzi

Pokud vaše aplikace používá rozhraní API v oboru názvů Windows.Services.Store k implementaci funkcí nákupu nebo zkušební verze aplikace v aplikaci, musíte aplikaci publikovat do Storu a stáhnout ji do vývojového zařízení, aby používala jeho licenci k testování. Postupujte podle tohoto postupu a otestujte kód:

  1. Pokud vaše aplikace ještě není publikovaná a dostupná ve Storu, ujistěte se, že vaše aplikace splňuje minimální požadavky na certifikaci aplikací pro Windows, odešlete aplikaci v Partnerském centru a ujistěte se, že vaše aplikace projde procesem certifikace. Aplikaci můžete nakonfigurovat tak, aby při testování nebyla v Storu zjistitelná. Vezměte na vědomí správnou konfiguraci balíčkových letů. Nesprávně nakonfigurované lety balíčků nemusí být možné stáhnout.

  2. Dále se ujistěte, že jste dokončili následující:

  3. Po otevření projektu v sadě Visual Studio klikněte na nabídku projektu, přejděte na Obchod, a potom klikněte na Přidružit aplikaci kObchodu. Dokončete pokyny v průvodci, abyste přidružili projekt aplikace k aplikaci v účtu Partnerského centra, který chcete použít k testování.

    Poznámka:

    Pokud svůj projekt nepřidružíte k aplikaci ve Storu, metody StoreContext nastaví vlastnost ExtendedError jejich návratových hodnot na hodnotu kódu chyby 0x803F6107. Tato hodnota označuje, že Store nemá žádné znalosti o aplikaci.

  4. Pokud jste to ještě neudělali, nainstalujte aplikaci ze Storu, který jste zadali v předchozím kroku, spusťte aplikaci jednou a pak tuto aplikaci zavřete. Tím se zajistí, že se do vývojového zařízení nainstaluje platná licence pro aplikaci.

  5. V sadě Visual Studio začněte spouštět nebo ladit projekt. Kód by měl načíst data aplikace a doplňku z aplikace Obchod, kterou jste přidružili k místnímu projektu. Pokud se zobrazí výzva k přeinstalaci aplikace, postupujte podle pokynů a pak projekt spusťte nebo laďte.

    Poznámka:

    Po dokončení těchto kroků můžete dál aktualizovat kód aplikace a potom ladit aktualizovaný projekt na vývojovém počítači bez odeslání nových balíčků aplikací do Storu. K získání místní licence, která se použije k testování, stačí stáhnout verzi aplikace z Storu do vývojového počítače. Jakmile dokončíte testování a budete chtít zpřístupnit svým zákazníkům funkce související s nákupem v aplikaci nebo zkušební verzí, potřebujete do Storu odeslat nové balíčky aplikací.

Pokud vaše aplikace používá obor názvů Windows.ApplicationModel.Store , můžete před odesláním aplikace do Storu simulovat informace o licenci pomocí třídy CurrentAppSimulator ve vaší aplikaci. Další informace najdete v tématu Začínáme s třídami CurrentApp a CurrentAppSimulator.

Poznámka:

Obor názvů Windows.Services.Store neposkytuje třídu, kterou můžete použít k simulaci informací o licencích během testování. Pokud k implementaci nákupů nebo zkušebních verzí v aplikaci používáte obor názvů Windows.Services.Store , musíte aplikaci publikovat do Storu a stáhnout si ji do vývojového zařízení, aby používala licenci k testování, jak je popsáno výše.

Účtenky pro nákupy v aplikaci

Obor názvů Windows.Services.Store neposkytuje rozhraní API, které můžete použít k získání potvrzení transakce pro úspěšné nákupy v kódu vaší aplikace. Toto je jiný zážitek než aplikace, které používají obor názvů Windows.ApplicationModel.Store, které mohou použít klientskou API k načtení potvrzení transakce.

Pokud implementujete nákupy v aplikaci pomocí oboru názvů Windows.Services.Store a chcete ověřit, jestli daný zákazník zakoupil aplikaci nebo doplněk, můžete použít dotaz na metodu produktů v rozhraní REST API kolekce Microsoft Store. Vrácená data pro tuto metodu potvrzuje, jestli má zadaný zákazník nárok na daný produkt, a poskytuje data pro transakci, ve které uživatel produkt získal. Rozhraní API pro kolekce v Microsoft Store používá k načtení těchto informací ověřování Azure AD.

Použití třídy StoreContext s desktopovým mostem

Desktopové aplikace, které používají desktopový most , můžou pomocí třídy StoreContext implementovat nákupy a zkušební verze v aplikaci. Pokud ale máte desktopovou aplikaci Win32 nebo desktopovou aplikaci s popisovačem okna (HWND), která je přidružená k rozhraní vykreslování (například aplikace WPF nebo Windows App SDK), musí aplikace nakonfigurovat objekt StoreContext tak, aby určila, které okno aplikace je okno vlastníka pro modální dialogy zobrazené objektem.

Mnoho členů StoreContext (a členů jiných souvisejících typů, ke kterým se přistupuje prostřednictvím objektu StoreContext) zobrazí uživateli modální dialog pro operace související s obchodem, jako je nákup produktu. Pokud desktopová aplikace nenakonfiguruje objekt StoreContext tak, aby určil okno vlastníka pro modální dialogy, vrátí tento objekt nepřesná data nebo chyby.

Chcete-li nakonfigurovat objekt StoreContext v desktopové aplikaci, která používá desktopový most, postupujte takto.

Pro .NET 6 nebo novější

Pokud je vaše aplikace napsaná v jazyce C# s .NET 6 nebo novějším, postupujte podle těchto kroků.

  1. Ujistěte se, že TargetFramework je vlastnost v souboru projektu nastavená na konkrétní verzi sady Windows SDK pro přístup k rozhraním API prostředí Windows Runtime, která poskytuje přístup k oboru názvů WinRT.Interop . Například:

    <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. Získejte objekt StoreContext pomocí metody GetDefault (nebo GetForUser, pokud je vaše aplikacevíce uživatelů). Chcete-li inicializovat dialogové okno pomocí zadaného popisovače okna, použijte WinRT.Interop.WindowNative.GetWindowHandle a WinRT.Interop.InitializeWithWindow.Initialize metody (viz Načtení úchytu okna (HWND) a Zobrazení objektů uživatelského rozhraní WinRT, které závisí na 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);

Pro starší verze .NET nebo C++

Pokud je vaše aplikace napsaná pomocí starší verze .NET nebo v jazyce C++, postupujte podle těchto kroků.

  1. Pokud chcete aplikaci povolit přístup k rozhraní IInitializeWithWindow , proveďte jednu z následujících věcí:

    • Pokud je vaše aplikace napsaná ve spravovaném jazyce, jako je C# nebo Visual Basic (před rozhraním .NET 6), deklarujte rozhraní IInitializeWithWindow v kódu vaší aplikace pomocí atributu ComImport , jak je znázorněno v následujícím příkladu jazyka C#. Tento příklad předpokládá, že váš soubor kódu obsahuje příkaz pro obor názvů System.Runtime.InteropServices.

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

    • Pokud je vaše aplikace napsaná v jazyce C++, přidejte do kódu odkaz na hlavičkový shobjidl.h soubor. Tento hlavičkový soubor obsahuje deklaraci IInitializeWithWindow rozhraní.

  2. Získat StoreContext objekt pomocí GetDefault metoda (nebo GetForUser pokud je vaše aplikace víceuživatelská aplikace), jak je popsáno výše v tomto článku, a přetypovat tento objekt na IInitializeWithWindow objektu. Potom zavolejte metodu IInitializeWithWindow.Initialize a předejte popisovač okna, které má být vlastníkem všech modálních dialogů, zobrazených metodami StoreContext. Následující příklad jazyka C# ukazuje, jak předat metodě identifikátor hlavního okna vaší aplikace. Podívejte se také na Načtení identifikátoru okna (HWND) a Zobrazení objektů uživatelského rozhraní WinRT, které závisí na CoreWindow.

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

Produkty, skladové položky a dostupnost

Každý produkt v obchodě má alespoň jednu skladovou položkua každá skladová položka má alespoň jednu dostupnost. Tyto koncepty jsou abstrahovány od většiny vývojářů v Partnerském centru a většina vývojářů nikdy nedefinuje skladové položky nebo dostupnost pro své aplikace nebo doplňky. Vzhledem k tomu, že objektový model pro produkty Store v oboru názvů Windows.Services.Store zahrnuje skladové položky a dostupnost, může být pro některé scénáře užitečné základní porozumění těmto konceptům.

Objekt Popis
Výrobek Produkt odkazuje na jakýkoli typ produktu, který je dostupný ve Storu, včetně aplikace nebo doplňku.

Každý produkt ve Storu má odpovídající objekt StoreProduct . Tato třída poskytuje vlastnosti, které můžete použít pro přístup k datům, jako je ID obchodu produktu, obrázky a videa pro výpis ze Storu a informace o cenách. Poskytuje také metody, které můžete použít k nákupu produktu.
skladová jednotka (SKU) Skladová položka je konkrétní verze produktu s vlastním popisem, cenou a dalšími jedinečnými podrobnostmi o produktu. Každá aplikace nebo doplněk má výchozí skladovou položku. Jedinou dobou, kdy bude mít většina vývojářů pro aplikaci více skladových položek, je, že publikují plnou verzi aplikace a zkušební verzi (v katalogu Storu je každá z těchto verzí jinou skladovou jednotkou stejné aplikace).

Někteří vydavatelé mají možnost definovat vlastní skladové položky. Například velký vydavatel her může vydat hru s jednou skladovou jednotkou, která ukazuje zelenou krev na trzích, které neumožňují červenou krev a jinou SKU, která zobrazuje červenou krev na všech ostatních trzích. Alternativně může vydavatel, který prodává digitální videoobsah, publikovat dva produktové kódy pro video: jeden pro verzi ve vysokém rozlišení a jiný pro verzi ve standardním rozlišení.

Každá skladová položka ve Storu má odpovídající objekt StoreSku . Každý StoreProduct má vlastnost SKUs, kterou můžete použít pro přístup ke SKU produktu.
Dostupnost dostupnost je konkrétní varianta skladové položky (SKU) s jedinečnými cenovými informacemi. Každá skladová položka má výchozí dostupnost. Někteří vydavatelé mají možnost definovat své vlastní dostupné možnosti zavedení různých cenových možností pro danou skladovou položku.

Každá dostupnost ve Storu má odpovídající objekt StoreAvailability . Každý StoreSku má vlastnost dostupnosti, kterou můžete použít pro přístup k dostupnostem skladové jednotky. Pro většinu vývojářů má každá skladová položka jednu výchozí dostupnost.

ID obchodů

Každá aplikace, doplněk nebo jiný produkt v Obchodě má přidružené ID Obchodu (toto se také někdy nazývá ID produktu Obchodu). Mnoho rozhraní API vyžaduje ID Storu, aby bylo možné provést operaci v aplikaci nebo doplňku.

ID libovolného produktu v obchodě je 12místný alfanumerický řetězec, například 9NBLGGH4R315. ID obchodu pro produkt ve Storu můžete získat několika různými způsoby:

  • V případě aplikace můžete ID Storu získat na stránce identit aplikace v Partnerském centru.
  • U doplňku můžete ID obchodu získat na stránce přehledu doplňku v Partnerském centru.
  • Pro jakýkoli produkt můžete ID obchodu získat také programově pomocí vlastnosti StoreId objektu StoreProduct, který představuje produkt.

U produktů s skladovými jednotkami a dostupností mají skladové položky a dostupnost také vlastní ID obchodů s různými formáty.

Objekt Formát ID úložiště
skladová jednotka (SKU) ID obchodu pro SKU má formát <product Store ID>/xxxx, kde xxxx je 4místný alfanumerický řetězec, který identifikuje SKU produktu. Například: 9NBLGGH4R315/000N. Toto ID je vráceno vlastností StoreId objektu StoreSku a někdy se označuje jako ID úložiště skladových položek.
Dostupnost ID obchodu pro dostupnost má formát <product Store ID>/xxxx/yyyyyyyyyyyy, kde xxxx je čtyřmístný alfanumerický řetězec, který identifikuje skladovou položku pro produkt, a yyyyyyyyyyyy je dvanáctimístný alfanumerický řetězec, který identifikuje dostupnost pro tuto skladovou položku. Například: 9NBLGGH4R315/000N/4KW6QZD2VN6X. ID je vráceno vlastností StoreId objektu StoreAvailability a někdy se nazývá ID dostupnosti úložiště .

Jak používat ID produktů pro doplňky v kódu

Pokud chcete zákazníkům zpřístupnit doplněk v kontextu vaší aplikace, musíte zadat jedinečné ID produktu pro doplněk, když vytváříte podání doplňku v Partnerském centru. Toto ID produktu můžete použít k odkazování na doplněk v kódu, i když konkrétní scénáře, ve kterých můžete použít ID produktu, závisí na tom, který obor názvů používáte pro nákupy v aplikaci.

Poznámka:

ID produktu, které zadáte v Partnerském centru pro doplněk, se liší od ID obchodu doplňku. ID obchodu vygeneruje Partnerské centrum.

Aplikace, které používají obor názvů Windows.Services.Store

Pokud vaše aplikace používá obor názvů Windows.Services.Store , můžete pomocí ID produktu snadno identifikovat StoreProduct , který představuje váš doplněk nebo StoreLicense , který představuje licenci doplňku. ID produktu je vystaveno vlastnostmi StoreProduct.InAppOfferToken a StoreLicense.InAppOfferToken .

Poznámka:

I když je ID produktu užitečným způsobem, jak identifikovat doplněk v kódu, většina operací v oboru názvů Windows.Services.Store používá místo ID produktu ID úložiště doplňku. Pokud například chcete programově načíst jeden nebo více známých doplňků pro aplikaci, předejte ID obchodu (místo ID produktů) doplňků do metody GetStoreProductsAsync. Podobně, pokud chcete nahlásit použitelný doplněk jako splněný, předejte ID obchodu doplňku (nikoli ID produktu) metodě ReportConsumableFulfillmentAsync.

Aplikace, které používají obor názvů Windows.ApplicationModel.Store

Pokud vaše aplikace používá obor názvů Windows.ApplicationModel.Store , budete muset pro většinu operací použít ID produktu, které přiřadíte k doplňku v Partnerském centru. Například:

  • Last updated on