購入

Use the SDK to make virtual purchases and redeem real money purchases.

読み終わるまでの所要時間 3 分

最終更新 1日前

Purchases

名前空間のメソッドを使用すると、現在サインインしているプレイヤーのために購入を行うことができます。

注

この名前空間のすべてのメソッドは、EconomyException をスローする可能性があります。

MakeVirtualPurchaseAsync

ID によって指定される仮想購入を行います。このメソッドには

MakeVirtualPurchaseOptions

オブジェクトを任意で指定できます。これは、購入のコストに含める必要がある、プレイヤーインベントリ内のアイテムの

PlayersInventoryItems

ID を指定するために使用できます。これらを指定しないと、コストに含めるアイテムが自動的に選択されます。

MakeVirtualPurchaseResult

を返します。例:


string purchaseID = "BUY_A_SWORD";MakeVirtualPurchaseResult purchaseResult = await EconomyService.Instance.Purchases.MakeVirtualPurchaseAsync(purchaseID);

PlayersInventoryItem

ID を使用する代わりの例:


string purchaseID = "BUY_A_SWORD";MakeVirtualPurchaseOptions options = new MakeVirtualPurchaseOptions{    PlayersInventoryItemIds = new List<string> { "playersInventoryItemId1", "playersInventoryItemId2" }};MakeVirtualPurchaseResult purchaseResult = await EconomyService.Instance.Purchases.MakeVirtualPurchaseAsync(purchaseID, options);

MakeVirtualPurchaseOptions

MakeVirtualPurchaseAsync

呼び出しの任意のオブジェクト。これには以下のフィールドがあります。

```
PlayersInventoryItemIds
```
: 文字列のリスト。デフォルトは
```
null
```
です。購入のコストに含める、プレイヤーインベントリ内のアイテムの
```
PlayersInventoryItem
```
ID。

MakeVirtualPurchaseResult

このオブジェクトは、

MakeVirtualPurchaseAsync

呼び出しによって返されます。以下のフィールドが含まれます。

```
Costs
```
: この購入にかかったコストを表す
```
Costs
```
オブジェクト。これにはさらに 2 つのフィールドがあります。
- ```
Currency
```
  : この購入を行うために使用された通貨を示す
```
CurrencyExchangeItem
```
  のリスト。
- ```
Inventory
```
  : この購入を行うためにコストとして使用されるアイテムを示す
```
InventoryExchangeItem
```
  のリスト。
```
Rewards
```
: この購入と引き換えに与えられるゲーム内報酬を表す
```
Rewards
```
オブジェクト。これにも上記と同じ 2 つのフィールドがあります。
- ```
Currency
```
  : この購入において与えられるゲーム内報酬の通貨を示す
```
CurrencyExchangeItem
```
  のリスト。
- ```
Inventory
```
  : この購入においてゲーム内報酬として与えられるアイテムを示す
```
InventoryExchangeItem
```
  のリスト。

RedeemAppleAppStorePurchaseAsync

Apple App Store のレシートを送信してリアルマネーでの購入に対してアイテムを授受します。これは検証されます。有効な場合、設定で定義されたゲーム内報酬がプレイヤーのインベントリと通貨残高に適用されます。必須の

RedeemAppleAppStorePurchaseArgs

オブジェクトを指定します。これを使用して購入の詳細情報を指定します。


RedeemAppleAppStorePurchaseArgs args = new RedeemAppleAppStorePurchaseArgs("PURCHASE_ID", "RECEIPT_FROM_APP_STORE", 0, "USD");RedeemAppleAppStorePurchaseResult purchaseResult = await EconomyService.Instance.RedeemAppleAppStorePurchaseAsync(args);

RedeemAppleAppStorePurchaseArgs

RedeemAppleAppStorePurchaseAsync

呼び出しの引数オブジェクト。これには以下のフィールドがあります。

```
RealMoneyPurchaseId
```
: 文字列。行う購入の設定 ID。
```
Receipt
```
: 文字列。Apple App Store から返されるレシートデータ。
```
LocalCost
```
: 整数。購入のコスト (補助通貨形式の整数)。例えば、$1.99 USD は 199 です。
```
LocalCurrency
```
: 文字列。購入で使用された通貨の ISO-4217 コード。

RedeemAppleAppStorePurchaseResult

このオブジェクトは、

RedeemAppleAppStorePurchaseAsync

呼び出しによって返されます。以下のフィールドが含まれます。

```
Verification
```
: 検証サービスからのレシート確認の詳細。
- ```
Status
```
  : レシート確認のステータス。以下のどれかになります。
  - ```
  VALID
```
  : 購入は有効でした。
- ```
VALID_NOT_REDEEMED
```
    : 購入は有効でしたが、前に確認されています。まだアイテム授受が行われていません。
  - ```
  INVALID_ALREADY_REDEEMED
```
  : 購入についてすでにアイテム授受が行われました。
- ```
INVALID_VERIFICATION_FAILED
```
    : レシート検証サービスから、レシートデータが有効でないと返されました。
  - ```
  INVALID_ANOTHER_PLAYER
```
  : レシートが、以前に別のプレイヤーによって使用され、検証されています。
- ```
INVALID_CONFIGURATION
```
    : サービス設定が無効です。その他の情報はレスポンスの詳細セクションを参照してください。
  - ```
  INVALID_PRODUCT_ID_MISMATCH
```
  : 購入設定のストア製品識別子がレシートのものと一致しません。
- ```
Store
```
  : レシート検証サービスの詳細情報。これには 3 つのフィールドがあります。
  - ```
  Code
```
  : Apple App Store 確認サービスから送信されたステータスコード。
- ```
Message
```
    : 返されたステータスコードのテキストによる説明。
  - ```
  Receipt
```
  : 購入レシートデータ。
```
Rewards
```
: この購入と引き換えに与えられるゲーム内報酬を表す
```
Rewards
```
オブジェクト。これには以下のフィールドがあります。
- ```
Currency
```
  : この購入において与えられるゲーム内報酬の通貨を示す
```
CurrencyExchangeItem
```
  のリスト。
- ```
Inventory
```
  : この購入においてゲーム内報酬として与えられるアイテムを示す
```
InventoryExchangeItem
```
  のリスト。

EconomyAppleAppStorePurchaseFailedException

RedeemAppleAppStorePurchaseAsync

は、タイプ

EconomyAppleAppStorePurchaseFailedException

の例外をスローすることがあります。これは

EconomyException

を継承し、

Data

と呼ばれる 1 つの追加フィールドがあります。

Data

フィールドのタイプは

RedeemAppleAppStorePurchaseResult

です (上記を参照)。

注

この

Data

フィールドは、

Exception

基本クラスの

Data

フィールドとは違います。

RedeemGooglePlayPurchaseAsync

Google Play ストアのレシートを送信してリアルマネーでの購入に対してアイテムを授受します。これは検証されます。有効な場合、設定で定義されたゲーム内報酬がプレイヤーのインベントリと通貨残高に適用されます。必須の

RedeemGooglePlayStorePurchaseArgs

オブジェクトを指定します。これを使用して購入の詳細情報を指定します。


RedeemGooglePlayStorePurchaseArgs args = new RedeemGooglePlayStorePurchaseArgs("PURCHASE_ID", "PURCHASE_DATA", "PURCHASE_DATA_SIGNATURE", 0, "USD");RedeemGooglePlayPurchaseResult purchaseResult = await EconomyService.Instance.RedeemGooglePlayPurchaseAsync(args);

RedeemGooglePlayStorePurchaseArgs

RedeemGooglePlayPurchaseAsync

呼び出しの引数オブジェクト。これには以下のフィールドがあります。

```
RealMoneyPurchaseId
```
: 文字列。行う購入の設定 ID。
```
PurchaseData
```
: 文字列。アプリ内課金が正常に行われると返される、JSON でエンコードされた文字列。
```
PurchaseDataSignature
```
: 文字列。アプリ内課金が正常に行われると返される、
```
PurchaseData
```
のシグネチャ。
```
LocalCost
```
: 整数。購入のコスト (補助通貨形式の整数)。例えば、$1.99 USD は 199 です。
```
LocalCurrency
```
: 文字列。購入で使用された通貨の ISO-4217 コード。

RedeemGooglePlayPurchaseResult

このオブジェクトは、

RedeemGooglePlayPurchaseAsync

呼び出しによって返されます。以下のフィールドが含まれます。

```
Verification
```
: 検証サービスからのレシート確認の詳細。
- ```
Status
```
  : レシート確認のステータス。以下のどれかになります。
  - ```
  VALID
```
  : 購入は有効でした。
- ```
VALID_NOT_REDEEMED
```
    : 購入は有効でしたが、前に確認されています。まだアイテム授受が行われていません。
  - ```
  INVALID_ALREADY_REDEEMED
```
  : 購入についてすでにアイテム授受が行われました。
- ```
INVALID_VERIFICATION_FAILED
```
    : レシート検証サービスから、レシートデータが有効でないと返されました。
  - ```
  INVALID_ANOTHER_PLAYER
```
  : レシートが、以前に別のプレイヤーによって使用され、検証されています。
- ```
INVALID_CONFIGURATION
```
    : サービス設定が無効です。その他の情報はレスポンスの詳細セクションを参照してください。
  - ```
  INVALID_PRODUCT_ID_MISMATCH
```
  : 購入設定のストア製品識別子がレシートのものと一致しません。
- ```
Store
```
  : レシート検証サービスの詳細情報。これには 1 つのフィールドがあります。
  - ```
  Receipt
```
  : 購入レシートデータ。
```
Rewards
```
: この購入と引き換えに与えられるゲーム内報酬を表す
```
Rewards
```
オブジェクト。これには以下のフィールドがあります。
- ```
Currency
```
  : この購入において与えられるゲーム内報酬の通貨を示す
```
CurrencyExchangeItem
```
  のリスト。
- ```
Inventory
```
  : この購入においてゲーム内報酬として与えられるアイテムを示す
```
InventoryExchangeItem
```
  のリスト。

EconomyGooglePlayStorePurchaseFailedException

RedeemGooglePlayPurchaseAsync

は、タイプ

EconomyGooglePlayStorePurchaseFailedException

の例外をスローすることがあります。これは

EconomyException

を継承し、

Data

と呼ばれる 1 つの追加フィールドがあります。

Data

フィールドのタイプは

RedeemGooglePlayPurchaseResult

です (上記を参照)。

注

この

Data

フィールドは、

Exception

基本クラスの

Data

フィールドとは違います。

CurrencyExchangeItem

このオブジェクトは、購入で使用された通貨を表します。これには以下のフィールドがあります。

```
Id
```
: 通貨の ID。
```
Amount
```
: 購入で使用された通貨の金額。

InventoryExchangeItem

このオブジェクトは、購入に含まれるインベントリアイテムを表します。これには以下のフィールドがあります。

```
Id
```
: 通貨の ID。
```
Amount
```
: 購入で使用された/ゲーム内報酬を与えられた、このインベントリアイテムの数量。
```
InstanceIds
```
: 購入で使用された/ゲーム内報酬を与えられた、インスタンス ID のリスト。

ドキュメント

Development

User Acquisition

Monetization

産業

ドキュメント

Development

User Acquisition

Monetization

産業

Economy

Economy

購入

MakeVirtualPurchaseAsync

MakeVirtualPurchaseOptions

MakeVirtualPurchaseResult

RedeemAppleAppStorePurchaseAsync

RedeemAppleAppStorePurchaseArgs

RedeemAppleAppStorePurchaseResult

EconomyAppleAppStorePurchaseFailedException

RedeemGooglePlayPurchaseAsync

RedeemGooglePlayStorePurchaseArgs

RedeemGooglePlayPurchaseResult

EconomyGooglePlayStorePurchaseFailedException

CurrencyExchangeItem

InventoryExchangeItem