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

# GS2-Showcase API リファレンス

商品販売機能




ゲーム内ストア機能を提供します。

販売する商品には対価と報酬を設定します。対価にも報酬にも複数のリソースを設定できます。

ステップガチャや、初回のみディスカウントといった仕組みを実現するために、商品グループという仕組みがあります。<br>
商品グループは、商品ごとに優先度を付けて複数の商品をまとめる仕組みで、購入可能な条件を満たし、かつもっとも優先度の高い商品が陳列されます。

スタンダード陳列棚は指定した DisplayItem が全て陳列されます。<br>
DisplayItem には2種類存在し《SalesItem》と《SalesItemGroup》が存在します。

- SalesItem には購入するために必要な対価と、購入した際に得られる報酬を設定できます。
- SalesItemGroup は購入回数に応じて販売する SalesItem が変化する仕組みを実現します。

ランダム陳列棚は、マスターデータに指定した DisplayItem のうち指定した数がランダムに抽選されて陳列されます。

抽選結果はプレイヤーごとに `RandomShowcaseStatus` として保存され、購入時には在庫が消費されます。再抽選間隔を迎えると次回アクセス時に陳列内容が更新されます。

GS2-Buff と連携すると DisplayItem および RandomDisplayItemModel の `acquireActions`・`verifyActions`・`consumeActions` を動的に補正でき、ランダム陳列商品では `stock` の上書きも可能です。イベントやキャンペーンに合わせて報酬や必要対価、在庫数を柔軟に変更できます。

[マイクロサービス紹介 / GS2-Showcase](../../microservices/showcase)



- [GS2-Showcase Buff リファレンス](/ja/api_reference/showcase/buff/)
  
- [GS2-Showcase Deploy/CDK リファレンス](/ja/api_reference/showcase/deploy/)
  
- [GS2-Showcase SDK API リファレンス](/ja/api_reference/showcase/sdk/)
  
- [GS2-Showcase SDK for Game Engine API リファレンス](/ja/api_reference/showcase/game_engine/)
  
- [GS2-Showcase スクリプト トリガー リファレンス](/ja/api_reference/showcase/script/)
  
- [GS2-Showcase トランザクションアクション](/ja/api_reference/showcase/stamp_sheet/)
  
- [GS2-Showcase マスターデータリファレンス](/ja/api_reference/showcase/master_data/)