> ## Documentation Index
> Fetch the complete documentation index at: https://frenglish.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Unityでトランザクションが多いゲームを構築する

> 一部のゲームでは、ゲームの状態を頻繁に保存します。ブロックチェーンを利用する場合、これにはコストがかかり、遅延も発生します。本ガイドでは、ユーザー体験や運用コストを損なわずにこれらの制約を回避する方法を解説します。

## はじめに

他のデータベースと異なり、ブロックチェーンへの書き込み（トランザクション）には[ガス代](https://ethereum.org/en/developers/docs/gas/)という費用がかかります。ブロックチェーンやWeb3ゲームを開発する際は、ガス代を考慮する必要があります。[Sequenceのガススポンサー機能](/solutions/builder/gas-tank)により、ユーザー側の複雑さは大幅に軽減されますが、開発者としてもガス代についていくつか配慮すべき点があります。

<Tip>
  ゲーム開発時には、ブロックチェーンへトランザクションを送信する**頻度**を考慮し、ランタイムコストを最小限に抑えるようにしましょう。
</Tip>

ブロックチェーン特有の追加の難しさとして、ブロックチェーンへの書き込み（つまりトランザクション）は即時ではなく、非同期でネットワーク接続が必要です。

<Warning>
  トランザクションは、インターネット接続の不具合や残高不足など、様々な理由で失敗することがあります。
</Warning>

まず、どの所有権（例：アイテム、パワーアップ、アンロックなど）をブロックチェーン上でトークン化すべきかを検討しましょう。

次に、ゲーム内で発生するトランザクションの「種類」を考えます。多くの場合、トランザクションは複数のカテゴリに分類できます。例えば、ピックアップ（コイン収集など）、クラフト、トレード、販売、購入などが挙げられます。

各トランザクションを分類したら、ユーザーの期待値や開発者としての期待値も考慮しましょう。ユーザー視点でどの程度の遅延が許容されるか？トランザクションが成功する前提で即時フィードバックを与えても問題ないか？もし失敗した場合、ユーザーや運営に悪影響を与えずにリカバリーできるか？

本ガイドの執筆者は、トランザクションを一般的に「高価値トランザクション」と「低価値トランザクション」に分類しています。

**高価値トランザクション**の場合は、ユーザーにフィードバックを返す前に確認を行う必要があります。トランザクションは、インターネット接続の不具合やガス不足、前提条件の誤りなど、さまざまな理由で失敗する可能性があります。高価値トランザクションが必ず成功すると仮定してすぐにユーザーへフィードバックを返してしまうと、後からトランザクションが失敗した場合、ユーザー体験や収益に悪影響を与えずにリカバリーすることができません。例えば、ゲーム内ストアでユーザーが「剣を購入」するトランザクションが失敗した場合、アカウントから剣を取り消す（プレイヤー体験の損失）か、売上を失う（収益の損失）かのいずれかになります。幸いにも、多くの高価値トランザクションはストアやクラフト、アップグレードなど、従来の（非ブロックチェーン）ゲームでも短い待ち時間が一般的なアクティビティと重なっています。

**低額取引**は、基本的に即座にユーザーへフィードバックを返すことが推奨されます。取引の確認を待たずに、ゲーム内のフィードバックを行って問題ありません。万が一取引が失敗しても、ほとんどの場合、ユーザー体験や開発者の収益に悪影響を与えることなく、簡単にリカバリーできます。従来のゲームでは、プレイヤーはこのようなアクションに対して即時のフィードバックを受け取ることに慣れています。例えば、ユーザーがプラットフォーマーゲームでコインを集めた場合、UIにすぐ反映されることを期待します。プレイヤーが次回のセッションで正確なコイン数を覚えていることはほとんどなく、また、コインをローカル保存してネットワーク復旧後に再送信しても、開発者の収益に影響することはほぼありません。

最後に、ゲーム内でどのくらいの頻度で取引を発生させるべきかも考慮しましょう。ゲームによっては、短時間に多くのアクションがゲーム状態に影響を与えることがあります。例えば、マリオがコインを取るたびにブロックチェーンへ取引を送信していたら…コストがすぐに高額になってしまいます。低額取引はまとめて処理しましょう！

## Unityでこれを実装するには？

まず、ユーザーがオンチェーンで保有しているものをローカルでキャッシュする仕組みを作ります。これは簡単で、[ブロックチェーンからデータを読み取り](/sdk/unity/power/read-from-blockchain)、ユーザーのトークン残高を都合の良い形式でローカル保存するだけです。既存のゲームやプロトタイプでPlayerPrefsなどのローカルストレージや、[RDBMS](https://en.wikipedia.org/wiki/List_of_relational_database_management_systems)のようなリモートストレージを使っている場合は、すでにローカルキャッシュの仕組みがあるはずなので、アダプターを作成するだけで十分です。

次に、Unity SDKが提供する`TransactionQueuer`およびその継承クラスを活用するのがおすすめです。`TransactionQueuer`は高い柔軟性があり、プレイヤーが頻繁に状態を変更するゲームの開発をサポートするために設計されています。例えば、ゲーム内でコインなどの低額取引を大量に集める場合、`PermissionedMinterTransactionQueuer`（`mint`関数に権限が必要な場合、デフォルトでサーバーからミントする場合）や、`SequenceWalletTransactionQueuer`（誰でもミントできる場合）を利用できます。これらを使えば、複数の取引をキューに追加するだけで、可能であれば自動的にまとめてくれます（例：'mint(amount: 5, tokenId: 11)'と'mint(amount: 3, tokenId: 11)'が'mint(amount: 8, tokenId: 11)'にまとめられる）。取引はx秒ごと、または関数呼び出し時に送信できます。また、最短でもy秒ごと（高額取引の場合は上書き可能）といった設定も可能です。`TransactionQueuer`の詳細は[こちらのドキュメント](/sdk/unity/power/write-to-blockchain#transaction-queuers)をご覧ください。

最後に、取引の失敗を検知し、適切にエラー処理を行う必要があります。

```csharp theme={null}
if (transactionReturn is FailedTransactionReturn) {
    // Handle the failed transaction
}
```

## 例

これらの概念をUnity SDKで実際に使っている例として、[Jelly Forestガイド](/guides/jelly-forest-unity-guide#5-mint-in-game-tokens-to-the-players-inventory)や[サンプルコード](https://github.com/0xsequence/sequence-unity-demo/tree/master/Scripts)をご覧ください。