Windows.ApplicationModel.Store 名前空間を使用するアプリ内購入と試用版

[アーティクル]
06/02/2023

Windows.ApplicationModel.Store 名前空間のメンバーを使って、ユニバーサル Windows プラットフォーム (UWP) アプリにアプリ内購入機能や試用版機能を追加し、アプリの収益化に役立てることができます。このような API では、アプリのライセンス情報にもアクセスできます。

このセクションの記事では、いくつかの一般的なシナリオにおいて Windows.ApplicationModel.Store 名前空間のメンバーを使用するための詳しいガイダンスとコード例を示します。 UWP アプリのアプリ内での購入に関する基本概念の概要については、「アプリ内購入と試用版」をご覧ください。 Windows.ApplicationModel.Store 名前空間を使用した試用版とアプリ内購入の実装方法を示す完全なサンプルについては、ストアサンプルをご覧ください。

重要

Windows.ApplicationModel.Store 名前空間は今後更新されず、新機能も追加されません。 Visual Studio でプロジェクトのターゲットを Windows 10 Anniversary Edition (10.0、ビルド 14393) 以降のリリースに設定している (つまり、Windows 10 Version 1607 以降をターゲットとしている) 場合は、代わりに Windows.Services.Store 名前空間を使うことをお勧めします。詳しくは、「アプリ内購入と試用版」をご覧ください。 Windows.ApplicationModel.Store 名前空間は、デスクトップブリッジを使う Windows デスクトップアプリケーションや、パートナーセンターの開発サンドボックスを使うアプリまたはゲーム (たとえば、Xbox Live と統合されるゲームがすべて該当します) ではサポートされません。このような製品では、Windows.Services.Store 名前空間を使ってアプリ内購入と試用版を実装する必要があります。

CurrentApp クラスと CurrentAppSimulator クラスの概要

Windows.ApplicationModel.Store 名前空間へのメインエントリポイントは、CurrentApp クラスです。このクラスには、現在のアプリとその利用可能なアドオンに関する情報の取得、現在のアプリまたはそのアドオンに関するライセンス情報の取得、現在のユーザー向けのアプリまたはアドオンの購入、およびその他のタスクを行う際に使用できる静的プロパティおよびメソッドが用意されています。

CurrentApp クラスは Microsoft Store からデータを取得するため、アプリ内でこのクラスを使うには、開発者が開発者アカウントを持っていて、アプリが Microsoft Store で公開されている必要があります。アプリをまだ Microsoft Store に提出していない場合は、このクラスのシミュレートされたバージョンである CurrentAppSimulator を使ってコードをテストすることができます。アプリのテストが完了したら、Microsoft Store に提出する前に CurrentAppSimulator のインスタンスを CurrentApp に置き換える必要があります。アプリで CurrentAppSimulator が使用されている場合は、認定が不合格になります。

CurrentAppSimulator を使う場合、アプリのライセンスとアプリ内製品の初期状態は、開発コンピューター上にある WindowsStoreProxy.xml という名前のローカルファイルに記述されています。このファイルについて詳しくは、「CurrentAppSimulator での WindowsStoreProxy.xml ファイルの使用」をご覧ください。

CurrentApp と CurrentAppSimulator を使って実行できる一般的なタスクについて詳しくは、次の記事をご覧ください。

トピック	説明
試用版での機能の除外または制限	ユーザーがアプリを無料で使うことができる試用期間を設け、その期間中は一部の機能を除外または制限することで、アプリを通常版にアップグレードするようユーザーに促すことができます。
アプリ内製品購入の有効化	アプリが無料であるかどうかにかかわらず、コンテンツ、その他のアプリ、アプリの新機能 (ゲームの次のレベルのロック解除など) をアプリ内から直接販売できます。ここでは、アプリ内で製品を販売できるようにする方法について説明します。
コンシューマブルなアプリ内製品購入の有効化	ストアの商取引プラットフォームを使ってコンシューマブルなアプリ内製品 (購入、使用、再購入が可能なアイテム) をサポートすると、堅牢かつ信頼性の高いアプリ内購入エクスペリエンスを顧客に提供できます。これは、購入して、特定のパワーアップを購入するために使うことができるゲーム内通貨 (ゴールド、コインなど) 用に特に便利です。
アプリ内製品の大規模なカタログの管理	アプリ内製品のカタログが大きくなる場合、カタログを管理するためにこのトピックで説明するプロセスを採用できます。
受領通知を使った製品購入の確認	製品購入が成功した各 Microsoft Store トランザクションでは、必要に応じてトランザクションの通知を返し、掲載製品と料金についての情報をユーザーに提供できます。この情報は、ユーザーがアプリを購入したことや、Microsoft Store からアプリ内製品の購入が行われたことをアプリで確認する必要がある場合に役立ちます。

CurrentAppSimulator での WindowsStoreProxy.xml ファイルの使用

CurrentAppSimulator を使う場合、アプリのライセンスとアプリ内製品の初期状態は、開発コンピューター上にある WindowsStoreProxy.xml という名前のローカルファイルに記述されています。 CurrentAppSimulator メソッドは、ライセンスの購入やアプリ内での購入処理などに応じてアプリの状態を変更しますが、更新されるのはメモリ内の CurrentAppSimulator オブジェクトの状態のみです。 WindowsStoreProxy.xml の内容は変更されません。アプリを再起動すると、ライセンスの状態は、WindowsStoreProxy.xml に記述されている内容に戻ります。

WindowsStoreProxy.xml ファイルは、既定で %UserProfile%\AppData\Local\Packages\<Local\Packages>\LocalState\Microsoft\Windows Store\ApiData に作成されます。このファイルを編集して、シミュレートするシナリオを CurrentAppSimulator プロパティで定義できます。

このファイルの値を変更することは可能ですが、直接変更するのではなく、独自の WindowsStoreProxy.xml ファイルを (Visual Studio プロジェクトのデータフォルダーに) 作成し、CurrentAppSimulator で使うことをお勧めします。トランザクションをシミュレートするには、ReloadSimulatorAsync を呼び出して、作成したファイルを読み込みます。 ReloadSimulatorAsync を呼び出して独自の WindowsStoreProxy.xml ファイルを読み込まない場合、CurrentAppSimulator は既定の WindowsStoreProxy.xml ファイルを作成して読み込みます (上書きはしません)。

注意

CurrentAppSimulator は、ReloadSimulatorAsync が完了するまで完全には初期化されません。 ReloadSimulatorAsync は非同期メソッドであるため、1 つのスレッドで CurrentAppSimulator が照会されているときに、別のスレッドでそれが初期化されているといった競合状態が起こらないように注意する必要があります。これにはフラグを使って初期化の完了を示すのも 1 つの方法です。 Microsoft Store からインストールされるアプリでは、CurrentAppSimulator ではなく CurrentApp を使う必要があります。これにより、ReloadSimulatorAsync が呼び出されなくなり、そのような競合状態は発生しなくなります。このため、コードは同期と非同期の両方で動作するように設計する必要があります。

例

以下の例では、試用モードのアプリを記述する WindowsStoreProxy.xml ファイル (UTF-16 エンコード) を示します。このアプリは、2015 年 1 月 19 日午前 5 時 (UTC) に試用モードの有効期限が切れます。

<?xml version="1.0" encoding="UTF-16"?>
<CurrentApp>
  <ListingInformation>
    <App>
      <AppId>2B14D306-D8F8-4066-A45B-0FB3464C67F2</AppId>
      <LinkUri>http://apps.windows.microsoft.com/app/2B14D306-D8F8-4066-A45B-0FB3464C67F2</LinkUri>
      <CurrentMarket>en-US</CurrentMarket>
      <AgeRating>3</AgeRating>
      <MarketData xml:lang="en-us">
        <Name>App with a trial license</Name>
        <Description>Sample app for demonstrating trial license management</Description>
        <Price>4.99</Price>
        <CurrencySymbol>$</CurrencySymbol>
      </MarketData>
    </App>
  </ListingInformation>
  <LicenseInformation>
    <App>
      <IsActive>true</IsActive>
      <IsTrial>true</IsTrial>
      <ExpirationDate>2015-01-19T05:00:00.00Z</ExpirationDate>
    </App>
  </LicenseInformation>
  <Simulation SimulationMode="Automatic">
    <DefaultResponse MethodName="LoadListingInformationAsync_GetResult" HResult="E_FAIL"/>
  </Simulation>
</CurrentApp>

次の例では、購入済みのアプリを記述する WindowsStoreProxy.xml ファイル (UTF-16 エンコード) を示します。このアプリには、2015 年 1 月 19 日午前 5 時 (UTC) に有効期限が切れる機能と、コンシューマブルなアプリ内での購入があります。

<?xml version="1.0" encoding="utf-16" ?>
<CurrentApp>
  <ListingInformation>
    <App>
      <AppId>988b90e4-5d4d-4dea-99d0-e423e414ffbc</AppId>
      <LinkUri>http://apps.windows.microsoft.com/app/988b90e4-5d4d-4dea-99d0-e423e414ffbc</LinkUri>
      <CurrentMarket>en-us</CurrentMarket>
      <AgeRating>3</AgeRating>
      <MarketData xml:lang="en-us">
        <Name>App with several in-app products</Name>
        <Description>Sample app for demonstrating an expiring in-app product and a consumable in-app product</Description>
        <Price>5.99</Price>
        <CurrencySymbol>$</CurrencySymbol>
      </MarketData>
    </App>
    <Product ProductId="feature1" LicenseDuration="10" ProductType="Durable">
      <MarketData xml:lang="en-us">
        <Name>Expiring Item</Name>
        <Price>1.99</Price>
        <CurrencySymbol>$</CurrencySymbol>
      </MarketData>
    </Product>
    <Product ProductId="consumable1" LicenseDuration="0" ProductType="Consumable">
      <MarketData xml:lang="en-us">
        <Name>Consumable Item</Name>
        <Price>2.99</Price>
        <CurrencySymbol>$</CurrencySymbol>
      </MarketData>
    </Product>
  </ListingInformation>
  <LicenseInformation>
    <App>
      <IsActive>true</IsActive>
      <IsTrial>false</IsTrial>
    </App>
    <Product ProductId="feature1">
      <IsActive>true</IsActive>
      <ExpirationDate>2015-01-19T00:00:00.00Z</ExpirationDate>
    </Product>
  </LicenseInformation>
  <ConsumableInformation>
    <Product ProductId="consumable1" TransactionId="00000001-0000-0000-0000-000000000000" Status="Active"/>
  </ConsumableInformation>
</CurrentApp>

スキーマ

このセクションでは、WindowsStoreProxy.xml ファイルの構造を定義する XSD ファイルを示します。 WindowsStoreProxy.xml ファイルで作業するときに、このスキーマを Visual Studio の XML エディターに適用するには、次の操作を行います。

Visual Studio で WindowsStoreProxy.xml ファイルを開きます。
[XML] メニューの [スキーマの作成]をクリックします。 XML ファイルの内容に基づいて、WindowsStoreProxy.xsd 一時ファイルが作成されます。
その .xsd ファイルの内容を下記のスキーマと置き換えます。
複数のアプリプロジェクトに適用できる場所に、作成したファイルを保存します。
Visual Studio で、この WindowsStoreProxy.xml ファイルに切り替えます。
[XML] メニューで [スキーマ] をクリックし、一覧から WindowsStoreProxy.xsd ファイルの行を探します。ファイルの場所が適切でない場合 (たとえば、一時ファイルがまだ表示されている場合) は、[追加] をクリックします。適切なファイルに移動し、[OK] をクリックします。一覧にそのファイルが表示されます。そのスキーマの[使用] 列にチェックマークが入っていることを確認します。

この操作を完了すると、WindowsStoreProxy.xml に加えた変更内容がスキーマに適用されます。詳しくは、「方法: 使用する XML スキーマを選択する」をご覧ください。

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:import namespace="http://www.w3.org/XML/1998/namespace"/>
  <xs:element name="CurrentApp" type="CurrentAppDefinition"></xs:element>
  <xs:complexType name="CurrentAppDefinition">
    <xs:sequence>
      <xs:element name="ListingInformation" type="ListingDefinition" minOccurs="1" maxOccurs="1"/>
      <xs:element name="LicenseInformation" type="LicenseDefinition" minOccurs="1" maxOccurs="1"/>
      <xs:element name="ConsumableInformation" type="ConsumableDefinition" minOccurs="0" maxOccurs="1"/>
      <xs:element name="Simulation" type="SimulationDefinition" minOccurs="0" maxOccurs="1"/>
    </xs:sequence>
  </xs:complexType>
  <xs:simpleType name="ResponseCodes">
    <xs:restriction base="xs:string">
      <xs:enumeration value="S_OK">
        <xs:annotation>
          <xs:documentation>0x00000000</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
      <xs:enumeration value="E_INVALIDARG">
        <xs:annotation>
          <xs:documentation>0x80070057</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
      <xs:enumeration value="E_CANCELLED">
        <xs:annotation>
          <xs:documentation>0x800704C7</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
      <xs:enumeration value="E_FAIL">
        <xs:annotation>
          <xs:documentation>0x80004005</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
      <xs:enumeration value="E_OUTOFMEMORY">
        <xs:annotation>
          <xs:documentation>0x8007000E</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
      <xs:enumeration value="ERROR_ALREADY_EXISTS">
        <xs:annotation>
          <xs:documentation>0x800700B7</xs:documentation>
        </xs:annotation>
      </xs:enumeration>
    </xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="ConsumableStatus">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Active"/>
      <xs:enumeration value="PurchaseReverted"/>
      <xs:enumeration value="PurchasePending"/>
      <xs:enumeration value="ServerError"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="StoreMethodName">
    <xs:restriction base="xs:string">
      <xs:enumeration value="RequestAppPurchaseAsync_GetResult" id="RPPA"/>
      <xs:enumeration value="RequestProductPurchaseAsync_GetResult" id="RFPA"/>
      <xs:enumeration value="LoadListingInformationAsync_GetResult" id="LLIA"/>
      <xs:enumeration value="ReportConsumableFulfillmentAsync_GetResult" id="RPFA"/>
      <xs:enumeration value="LoadListingInformationByKeywordsAsync_GetResult" id="LLIKA"/>
      <xs:enumeration value="LoadListingInformationByProductIdAsync_GetResult" id="LLIPA"/>
      <xs:enumeration value="GetUnfulfilledConsumablesAsync_GetResult" id="GUC"/>
      <xs:enumeration value="GetAppReceiptAsync_GetResult" id="GARA"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:simpleType name="SimulationMode">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Interactive"/>
      <xs:enumeration value="Automatic"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:complexType name="ListingDefinition">
    <xs:sequence>
      <xs:element name="App" type="AppListingDefinition"/>
      <xs:element name="Product" type="ProductListingDefinition" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>
  <xs:complexType name="ConsumableDefinition">
    <xs:sequence>
      <xs:element name="Product" type="ConsumableProductDefinition" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>
  <xs:complexType name="AppListingDefinition">
    <xs:sequence>
      <xs:element name="AppId" type="xs:string" minOccurs="1" maxOccurs="1"/>
      <xs:element name="LinkUri" type="xs:anyURI" minOccurs="1" maxOccurs="1"/>
      <xs:element name="CurrentMarket" type="xs:language" minOccurs="1" maxOccurs="1"/>
      <xs:element name="AgeRating" type="xs:unsignedInt" minOccurs="1" maxOccurs="1"/>
      <xs:element name="MarketData" type="MarketSpecificAppData" minOccurs="1" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>
  <xs:complexType name="MarketSpecificAppData">
    <xs:sequence>
      <xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
      <xs:element name="Description" type="xs:string" minOccurs="1" maxOccurs="1"/>
      <xs:element name="Price" type="xs:float" minOccurs="1" maxOccurs="1"/>
      <xs:element name="CurrencySymbol" type="xs:string" minOccurs="1" maxOccurs="1"/>
      <xs:element name="CurrencyCode" type="xs:string" minOccurs="0" maxOccurs="1"/>
    </xs:sequence>
    <xs:attribute ref="xml:lang" use="required"/>
  </xs:complexType>
  <xs:complexType name="MarketSpecificProductData">
    <xs:sequence>
      <xs:element name="Name" type="xs:string" minOccurs="1" maxOccurs="1"/>
      <xs:element name="Price" type="xs:float" minOccurs="1" maxOccurs="1"/>
      <xs:element name="CurrencySymbol" type="xs:string" minOccurs="1" maxOccurs="1"/>
      <xs:element name="CurrencyCode" type="xs:string" minOccurs="0" maxOccurs="1"/>
      <xs:element name="Description" type="xs:string" minOccurs="0" maxOccurs="1"/>
      <xs:element name="Tag" type="xs:string" minOccurs="0" maxOccurs="1"/>
      <xs:element name="Keywords" type="KeywordDefinition" minOccurs="0" maxOccurs="1"/>
      <xs:element name="ImageUri" type="xs:anyURI" minOccurs="0" maxOccurs="1"/>
    </xs:sequence>
    <xs:attribute ref="xml:lang" use="required"/>
  </xs:complexType>
  <xs:complexType name="ProductListingDefinition">
    <xs:sequence>
      <xs:element name="MarketData" type="MarketSpecificProductData" minOccurs="1" maxOccurs="unbounded"/>
    </xs:sequence>
    <xs:attribute name="ProductId" use="required">
      <xs:simpleType>
        <xs:restriction base="xs:string">
          <xs:maxLength value="100"/>
          <xs:pattern value="[^,]*"/>
        </xs:restriction>
      </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="LicenseDuration" type="xs:integer" use="optional"/>
    <xs:attribute name="ProductType" type="xs:string" use="optional"/>
  </xs:complexType>
  <xs:simpleType name="guid">
    <xs:restriction base="xs:string">
      <xs:pattern value="[\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12}"/>
    </xs:restriction>
  </xs:simpleType>
  <xs:complexType name="ConsumableProductDefinition">
    <xs:attribute name="ProductId" use="required">
      <xs:simpleType>
        <xs:restriction base="xs:string">
          <xs:maxLength value="100"/>
          <xs:pattern value="[^,]*"/>
        </xs:restriction>
      </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="TransactionId" type="guid" use="required"/>
    <xs:attribute name="Status" type="ConsumableStatus" use="required"/>
    <xs:attribute name="OfferId" type="xs:string" use="optional"/>
  </xs:complexType>
  <xs:complexType name="LicenseDefinition">
    <xs:sequence>
      <xs:element name="App" type="AppLicenseDefinition"/>
      <xs:element name="Product" type="ProductLicenseDefinition" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
  </xs:complexType>
  <xs:complexType name="AppLicenseDefinition">
    <xs:sequence>
      <xs:element name="IsActive" type="xs:boolean" minOccurs="1" maxOccurs="1"/>
      <xs:element name="IsTrial" type="xs:boolean" minOccurs="1" maxOccurs="1"/>
      <xs:element name="ExpirationDate" type="xs:dateTime" minOccurs="0" maxOccurs="1"/>
    </xs:sequence>
  </xs:complexType>
  <xs:complexType name="ProductLicenseDefinition">
    <xs:sequence>
      <xs:element name="IsActive" type="xs:boolean" minOccurs="1" maxOccurs="1"/>
      <xs:element name="ExpirationDate" type="xs:dateTime" minOccurs="0" maxOccurs="1"/>
    </xs:sequence>
    <xs:attribute name="ProductId" type="xs:string" use="required"/>
    <xs:attribute name="OfferId" type="xs:string" use="optional"/>
  </xs:complexType>
  <xs:complexType name="SimulationDefinition" >
    <xs:sequence>
      <xs:element name="DefaultResponse" type="DefaultResponseDefinition" minOccurs="0" maxOccurs="unbounded"/>
    </xs:sequence>
    <xs:attribute name="SimulationMode" type="SimulationMode" use="optional"/>
  </xs:complexType>
  <xs:complexType name="DefaultResponseDefinition">
    <xs:attribute name="MethodName" type="StoreMethodName" use="required"/>
    <xs:attribute name="HResult" type="ResponseCodes" use="required"/>
  </xs:complexType>
  <xs:complexType name="KeywordDefinition">
    <xs:sequence>
      <xs:element name="Keyword" type="xs:string" minOccurs="0" maxOccurs="10"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

要素と属性の説明

このセクションでは、WindowsStoreProxy.xml ファイル内の要素と属性について説明します。

このファイルのルート要素は、現在のアプリを表す CurrentApp要素です。この要素には、次の子要素が含まれます。

要素	必須	Quantity	説明
ListingInformation	はい	1	アプリの登録情報のデータが含まれています。
LicenseInformation	はい	1	このアプリで利用可能なライセンスと永続的なアドオンが記述されています。
ConsumableInformation	No	0 または 1	このアプリで利用可能なコンシューマブルなアドオンが記述されています。
Simulation	No	0 または 1	テストで、さまざまな CurrentAppSimulator メソッドを呼び出したときに行われる動作が記述されています。

ListingInformation 要素

この要素には、アプリの登録情報のデータが含まれています。 ListingInformation は、CurrentApp 要素の必須の子要素です。

ListingInformation には、次の子要素が含まれます。

要素	必須	Quantity	説明
アプリ	はい	1	アプリに関するデータを提供します。
製品	No	0 以上	アプリのアドオンを記述します。

App 要素 (ListingInformation の子要素)

この要素は、アプリのライセンスを記述します。 App は、ListingInformation 要素の必須の子要素です。

App には、次の子要素が含まれます。

要素	必須	Quantity	説明
AppId	はい	1	ストアでアプリを識別する GUID です。テストでは任意の GUID を使用できます。
LinkUri	はい	1	ストアの登録情報ページの URI です。テストでは任意の有効な URI を使用できます。
CurrentMarket	はい	1	顧客の国/地域です。
AgeRating	はい	1	アプリの年齢区分の下限を表す整数です。これは、アプリの提出時にパートナーセンターで指定する値と同じです。ストアで使われる値は、3、7、12、および 16 です。これらの年齢区分について詳しくは、「年齢区分」をご覧ください。
MarketData	はい	1 つ以上	アプリに関する特定の国/地域向けの情報が含まれています。アプリが掲載される国/地域ごとに、MarketData要素を含める必要があります。

MarketData 要素 (App の子要素)

この要素は、アプリに関する特定の国/地域向けの情報を提供します。アプリが掲載される国/地域ごとに、MarketData要素を含める必要があります。 MarketData は、App 要素の必須の子要素です。

MarketData には、次の子要素が含まれます。

要素	必須	Quantity	説明
名前	はい	1	この国/地域でのアプリの名前です。
説明	はい	1	この国/地域向けのアプリの説明です。
価格	はい	1	この国/地域でのアプリの価格です。
CurrencySymbol	はい	1	この国/地域で使われている通貨記号です。
CurrencyCode	No	0 または 1	この国/地域で使われている通貨コードです。

MarketData には次の属性があります。

属性	必須	説明
xml:lang	はい	市場データ情報を適用する国/地域を指定します。

Product 要素 (ListingInformation の子要素)

この要素は、アプリのアドオンを記述します。 Product は、ListingInformation 要素のオプションの子要素であり、1 つ以上の MarketData 要素が含まれます。

Product には次の属性があります。

属性	必須	説明
ProductId	はい	アプリがこのアドオンを特定するために使う文字列が含まれています。
LicenseDuration	No	アイテム購入後、ライセンスが有効な日数を示します。製品の購入によって作成される新しいライセンスの有効期限は、購入日にライセンス期間を加算した日付です。この属性は、ProductType 属性が Durable の場合のみ使用され、コンシューマブルなアドオンの場合には無視されます。
ProductType	No	アプリ内製品が永続的かどうかを識別する値が含まれています。サポートされている値は、Durable (既定) と Consumable です。永続的なアドオンについて詳しくは、LicenseInformation の下の Product要素をご覧ください。コンシューマブルなアドオンについて詳しくは、ConsumableInformation の Product 要素をご覧ください。

MarketData 要素 (Product の子要素)

この要素は、アドオンに関する特定の国/地域向けの情報を提供します。アドオンが掲載される国/地域ごとに、MarketData要素を含める必要があります。 MarketData は、Product 要素の必須の子要素です。

MarketData には、次の子要素が含まれます。

要素	必須	Quantity	説明
名前	はい	1	この国/地域でのアドオンの名前です。
価格	はい	1	この国/地域でのアドオンの価格です。
CurrencySymbol	はい	1	この国/地域で使われている通貨記号です。
CurrencyCode	No	0 または 1	この国/地域で使われている通貨コードです。
説明	いいえ	0 または 1	この国/地域向けのアドオンの説明です。
Tag	No	0 または 1	アドオンのカスタム開発者データ (タグとも呼ばれます) です。
キーワード	No	0 または 1	アドオンのキーワードが含まれた最大 10 個の Keyword 要素を含みます。
ImageUri	No	0 または 1	アドオンの登録情報に表示する画像の URI です。

MarketData には次の属性があります。

属性	必須	説明
xml:lang	はい	市場データ情報を適用する国/地域を指定します。

LicenseInformation 要素

この要素は、このアプリで利用可能なライセンスと永続的なアプリ内製品を記述します。 LicenseInformation は、CurrentApp 要素の必須の子要素です。

LicenseInformation には、次の子要素が含まれます。

要素	必須	Quantity	説明
アプリ	はい	1	アプリのライセンスを記述します。
製品	No	0 以上	アプリ内の永続的なアドオンのライセンスの状態を記述します。

次の表では、App 要素と Product 要素の下で値を組み合わせて、いくつかの一般的な条件をシミュレートする方法を示します。

シミュレートする条件	IsActive	IsTrial	ExpirationDate
完全なライセンスを保有	true	false	指定しません。実際には有効期限が存在し、将来の日付を指定する場合でも、その要素は XML ファイルから省略することをお勧めします。有効期限が存在し、過去の日付が指定されている場合、IsActive は無視され、false として扱われます。
試用期間中	true	true	<将来の日付と時刻>IsTrial が true であるため、この要素を指定する必要があります。残りの試用期間に対応する有効期限は、現在の協定世界時 (UTC) を表示する Web サイトにアクセスして確認できます。
有効期限が切れた試用版	false	true	<IsTrial が true であるため、過去>の datetime This 要素が存在する必要があります。 UTC で表した "過去の" 有効期限は、現在の協定世界時 (UTC) を表示する Web サイトにアクセスして確認できます。
無効	false	false	<任意の値または省略>

App 要素 (LicenseInformation の子要素)

この要素は、アプリのライセンスを記述します。 App は、LicenseInformation 要素の必須の子要素です。

App には、次の子要素が含まれます。

要素	必須	Quantity	説明
IsActive	はい	1	このアプリの現在のライセンスの状態を記述します。値 true はライセンスが有効であることを示し、false はライセンスが無効であることを示します。この値はアプリが使用モードであるかどうかに関係なく、通常、true です。ライセンスが無効な場合にアプリがどのように動作するかをテストするには、この値を false に設定します。
IsTrial	はい	1	このアプリが現在、試用期間中かどうかの状態を記述します。値 true はアプリが試用期間中であることを示します。false は、アプリが購入済みであるか、試用期限が切れたために、アプリが試用期間中でないことを示します。
ExpirationDate	No	0 または 1	このアプリの試用期間が期限切れとなる日付 (協定世界時 (UTC)) です。日付は、yyyy-mm-ddThh:mm:ss.ssZ の形式で表す必要があります。たとえば、2015 年 1 月 19 日午前 5 時は、2015-01-19T05:00:00.00Z と表します。この要素は、IsTrial が true の場合に必須です。そうでない場合は、必須ではありません。

Product 要素 (LicenseInformation の子要素)

この要素は、アプリ内の永続的なアドオンのライセンスの状態を記述します。 Product は、LicenseInformation 要素のオプションの子要素です。

Product には、次の子要素が含まれます。

要素	必須	Quantity	説明
IsActive	はい	1	このアドオンの現在のライセンスの状態を記述します。値 true はアドオンを追加できることを示し、false はアドオンを使用できないか、購入していないことを示します。
ExpirationDate	No	0 または 1	協定世界時 (UTC) で表したアドオンの有効期限日です。日付は、yyyy-mm-ddThh:mm:ss.ssZ の形式で表す必要があります。たとえば、2015 年 1 月 19 日午前 5 時は、2015-01-19T05:00:00.00Z と表します。この要素が存在する場合、アドオンには有効期限日があります。存在しない場合、アドオンに有効期限はありません。

Product には次の属性があります。

属性	必須	説明
ProductId	はい	アプリがこのアドオンを特定するために使う文字列が含まれています。
OfferId	No	アプリが、このアドオンが属するカテゴリを特定するために使う文字列が含まれています。これを使うことで、「アプリ内製品の大規模なカタログの管理」で説明されている大規模なアイテムのカタログに対応できます。

Simulation 要素

この要素は、テストにおいて、さまざまな CurrentAppSimulator メソッドへの呼び出しがどのように動作するかを記述します。 Simulation は CurrentApp 要素のオプションの子要素であり、0 個以上の DefaultResponse 要素が含まれます。

Simulation には次の属性があります。

属性	必須	説明
SimulationMode	No	値は Interactive か Automatic のいずれかです。この属性を Automatic に設定すると、指定した HRESULT エラーコードがメソッドによって自動的に返されます。これは自動化されたテストケースを実行する場合に使用できます。

DefaultResponse 要素

この要素は、CurrentAppSimulator メソッドによって返される既定のエラーコードを記述します。 DefaultResponse は、Simulation 要素のオプションの子要素です。

DefaultResponse には次の属性があります。

属性	必須	説明
MethodName	はい	この属性は、スキーマの StoreMethodName 型で表示される列挙値のいずれかに割り当てます。これらの各列挙値は、テストのときにアプリでエラーコードの戻り値をシミュレートする CurrentAppSimulator メソッドを表します。たとえば、値 RequestAppPurchaseAsync_GetResult は、RequestAppPurchaseAsync メソッドのエラーコードの戻り値をシミュレートすることを示します。
HResult	はい	この属性は、スキーマの ResponseCodes 型で表示される列挙値のいずれかに割り当てます。これらの各列挙値は、この DefaultResponse 要素の MethodName 属性に割り当てるメソッドに対して返すエラーコードを表します。

ConsumableInformation 要素

この要素は、このアプリで利用可能なコンシューマブルなアドオンを記述します。 ConsumableInformation は、CurrentApp 要素のオプションの子要素であり、0 個以上の Product 要素が含まれます。

Product 要素 (ConsumableInformation の子要素)

この要素は、コンシューマブルなアドオンを記述します。 Product は、ConsumableInformation 要素のオプションの子要素です。

Product には次の属性があります。

属性	必須	説明
ProductId	はい	アプリがこのコンシューマブルなアドオンを特定するために使う文字列が含まれています。
TransactionId	はい	アプリが、フルフィルメントのプロセス全体を通じ、コンシューマブルの購入トランザクションを追跡するために使用する GUID (文字列) が含まれています。詳しくは、「コンシューマブルなアプリ内製品購入の有効化」をご覧ください。
状態	はい	アプリが、コンシューマブルのフルフィルメントの状態を示すために使う文字列が含まれています。値は、Active、PurchaseReverted、PurchasePending、または ServerError です。
OfferId	No	アプリが、このコンシューマブルが属するカテゴリを特定するために使う文字列が含まれています。これを使うことで、「アプリ内製品の大規模なカタログの管理」で説明されている大規模なアイテムのカタログに対応できます。

Windows.ApplicationModel.Store 名前空間を使用するアプリ内購入と試用版

CurrentApp クラスと CurrentAppSimulator クラスの概要

CurrentAppSimulator での WindowsStoreProxy.xml ファイルの使用

例

スキーマ

要素と属性の説明

ListingInformation 要素

App 要素 (ListingInformation の子要素)

MarketData 要素 (App の子要素)

Product 要素 (ListingInformation の子要素)

MarketData 要素 (Product の子要素)

LicenseInformation 要素

App 要素 (LicenseInformation の子要素)

Product 要素 (LicenseInformation の子要素)

Simulation 要素

DefaultResponse 要素

ConsumableInformation 要素

Product 要素 (ConsumableInformation の子要素)

フィードバック

フィードバック

その他のリソース