> For the complete documentation index, see [llms.txt](/llms.txt)

# 通貨

ゲーム内通貨の残高（ウォレット）と、通貨を購入するストア商品を扱います。




**このデモについて**

デモは匿名アカウントで自動的にログインします。このアカウントはショールームのすべてのデモで共有されるため、あるデモで手に入れたアイテムや通貨が別のデモにも反映されます。読み込みには少し時間がかかります。画面が小さい場合は新しいタブで開いてお試しください。

## 概要

ゲーム内通貨のウォレットと、そこへ入金する 2 つのボタンを表示するデモです。GS2-Money2 は無償で付与された通貨と有償で購入された通貨を別々の残高として管理しており、どちらのボタンを押したかでどの残高が動くかを確認できます。ページ上の表示とボタンはすべてパッケージから生成された UI コンポーネントで、デモ専用のスクリプトは使っていません。

## 試し方

1. **Your coins** に **Free balance**（無償残高）、**Paid balance**（有償残高）、**Total balance**（合計）が表示されます。
1. **Get coins** の **Deposit**（横に **Deposit 100 free coins** と表示）を押すと、**Free balance** と **Total balance** が 100 増えます。
1. **Get paid coins** の **Deposit**（横に **Deposit 50 paid coins** と表示）を押すと、**Paid balance** と **Total balance** が 50 増えます。この入金は 120 JPY の購入として記録されます。

ウォレットはショールームの全デモで共有されます。ショップなど通貨を使う他のデモで消費した分も、このページの残高に反映されます。

## 使用している GS2 のサービス

- [GS2-Money2](/ja/microservices/money2/): GS2-Money2 のウォレットが無償残高と有償残高を分けて保持します。有償の入金は価格と通貨コードを伴って記録され、無償の入金とは区別されます。
- [GS2-Exchange](/ja/microservices/exchange/): GS2-Exchange の 2 つの交換レートが、各 **Deposit** ボタンで GS2-Money2 へ入金するトランザクションを定義し、サーバー側で自動実行します。

## GS2 Studio で使う

GS2 Studio のシンプルモードで **機能を追加** を開き、**通貨** の **追加** を押すと、この機能を自分のプロジェクトに取り込めます。パッケージを直接指定する場合は **GitHub から追加** を選び、次のパッケージを指定します。

```text
https://github.com/gs2io/gs2-studio-package/tree/main/foundation-economy-currency/packages/foundation-economy-currency
```

- オーナー: `gs2io`
- リポジトリ: `gs2-studio-package`
- サブディレクトリ: `foundation-economy-currency/packages/foundation-economy-currency`

## ソースコード

- デモのプロジェクト: <https://github.com/gs2io/gs2-studio-package/tree/main/foundation-economy-currency/live-demo>
- 機能パッケージ: <https://github.com/gs2io/gs2-studio-package/tree/main/foundation-economy-currency>



