購入

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

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

最終更新 21日前

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 のリスト。

ドキュメント

エンジン

サービス

Grow

産業

サポート

Economy

Economy

購入

MakeVirtualPurchaseAsync

MakeVirtualPurchaseOptions

MakeVirtualPurchaseResult

RedeemAppleAppStorePurchaseAsync

RedeemAppleAppStorePurchaseArgs

RedeemAppleAppStorePurchaseResult

EconomyAppleAppStorePurchaseFailedException

RedeemGooglePlayPurchaseAsync

RedeemGooglePlayStorePurchaseArgs

RedeemGooglePlayPurchaseResult

EconomyGooglePlayStorePurchaseFailedException

CurrencyExchangeItem

InventoryExchangeItem