サンプルとリファレンス on Game Server Services | Docs

今回作るゲームの仕様

Mon, 01 Jan 0001 00:00:00 +0000

このゲームで使う名前や数値をまとめました。Studio でも SDK でも、同じ設定で作っていきます。各章にも、その場で使う値を載せています。この一覧は、あとから設定を見比べたいときに使ってください。

接続先の名前

設定	Studio	SDK（Unity）
Account	`Account`	`adventure-account`
Key のネームスペース / 鍵	`default` / `default`	`default` / `default`
Quest	`Quest`	`adventure-quest`
Money2	`Currency`	`adventure-coin`
Stamina	`Energy`	`adventure-stamina`
Exchange	`EnergyProduct`	`adventure-shop`

Studio の名前は追加したパッケージの設定から決まります。Studio では「引き継ぎ設定」パッケージをデプロイして Account を作ります。SDK では Account を adventure-login、ゲーム設定を adventure-game のスタックで管理します。接続情報と鍵は、どちらも Default を使います。

冒険と報酬

最初に作る冒険は「森の探索」です。クリアするたびに 10 コインを受け取れます。

GS2-Quest では、冒険を「クエスト」と呼びます。クエストをまとめるグループに main、森の探索に forest という識別子を付けます。画面には「森の探索」と表示し、API を呼び出すときには forest を使います。

設定	値
クエストグループ	`main`
クエストの識別子	`forest`
画面に表示する名前	森の探索
通常クリア報酬	無償コイン 10 枚
初回だけの追加報酬	なし
失敗時の報酬	なし

コインは GS2-Money2 のウォレットで管理します。このゲームでは、報酬の受け取りにも商品の支払いにもスロット 0 のウォレットを使います。

ゲームのデータと処理の流れ

Mon, 01 Jan 0001 00:00:00 +0000

各章で使うデータの考え方を、まとめて確認したいときの資料です。手順に必要な説明は、各章にも載せています。

ゲームの設定とプレイヤーのデータ

ゲームを作るときには、「ルールとして決めておくこと」と「遊ぶうちに変わっていくこと」があります。

たとえば「森の探索をクリアすると 10 コインもらえる」はゲームの設定です。一方、「このプレイヤーは 30 コイン持っている」は、プレイヤーごとのデータです。GS2 では、この二つを分けて管理します。

用語	このゲームでの例	更新するタイミング
マスターデータ	森の探索の報酬は 10 コイン	開発者が設定を変更して反映する
ユーザーデータ	このプレイヤーは 30 コイン持っている	プレイヤーの操作やサーバーの処理

たとえば、30 コイン持っているプレイヤーが森の探索をクリアすると、GS2 は報酬の設定を見て 10 コインを加えます。保存されている残高は、これで 40 コインになります。

画面や演出、ボタン操作は、Unity で作るゲームクライアントが担当します。「冒険を開始する」ボタンが押されたら、Unity から GS2 に開始をリクエストします。GS2 が設定とプレイヤーのデータを調べて処理したあと、Unity がその結果を受け取り、画面に表示する流れです。

開発者が設定を反映する

flowchart LR
 A[報酬や消費量を設定する] --> B[GS2へデプロイ]
 A --> C[Unityで使う表示データ]
 B --> D[GS2が処理に使う設定]
 C --> E[一覧と画面の表示]

まず、報酬の枚数や冒険に必要なスタミナを設定し、GS2 にデプロイします。Unity 側に商品名や価格を表示するためのアセットがあるときは、そちらも更新しておきます。

たとえば商品の価格を変えるなら、実際に支払うコインだけでなく、画面に出る価格も変える必要があります。両方が同じ金額になっているか、購入するときに確かめてみましょう。

プレイヤーが操作する

sequenceDiagram
 participant P as プレイヤー
 participant U as Unity
 participant G as GS2
 P->>U: 冒険を開始
 U->>G: プレイヤーと冒険を指定
 G->>G: 開始条件を確認して冒険を開始
 G-->>U: 処理結果
 U-->>P: 進行状況とスタミナを表示
 P->>U: 冒険を完了
 U->>G: 冒険のクリアを報告
 G->>G: 報酬を付与して冒険を終了
 G-->>U: 処理結果
 U-->>P: コインと進行状況を表示

このゲームで使うサービス

サービス	このチュートリアルでの役割
GS2-Account と認証機能	プレイヤーを識別し、ログインする
GS2-Quest	冒険の設定と、進行中の冒険を管理する
GS2-Money2	報酬として得た無償コインを管理する
GS2-Stamina	冒険で消費するスタミナを管理する
GS2-Exchange	コインの消費とスタミナの回復を一つの操作として処理する

GS2-Exchange は、コインを支払ってスタミナを回復するショップに使います。コインの支払いとスタミナの回復をまとめて処理できるよう、TransactionSettingV2（別タブ）を設定します。

困ったとき：症状から確認する

Mon, 01 Jan 0001 00:00:00 +0000

作っている途中で「あれ？」と思ったら、このページを見てみてください。よくあるつまずきと、調べる場所をまとめています。

再起動するとコインがなくなる

まずは、再起動する前と後でプレイヤー ID を比べてみましょう。起動するたびに新しいアカウントを作っていると、別のプレイヤーとしてログインしてしまい、前に集めたコインが表示されません。

ID が同じなら、次の点も見てみてください。

同じ GS2 プロジェクト、リージョン、ネームスペースに接続しているか。
同じスロットのウォレットを取得しているか。
データの読み込みが終わる前に、初期値の 0 を表示していないか。

関連：ログイン、再起動して続きを遊ぶ

冒険が一覧に表示されない

クエストを登録した場所と、Unity の接続先は同じでしょうか。まずネームスペースを見比べ、次に、読み込むときに指定したグループやクエストの識別子を調べてみてください。

読み込み中にエラーが出ていれば、そのメッセージが手がかりになります。Studio の表示用アセットを使っている方は、クエストを追加したあとにアセットも生成し直したか確かめてみましょう。

もらえるコインが思っていた枚数と違う

最初の 1 回だけ多くもらえるなら、初回クリア報酬が付いているかもしれません。通常の報酬と合わせて、設定を見てみましょう。

設定を変えても以前の報酬が出るときは、その冒険を始めたタイミングを確かめてみてください。開始時点の設定が使われるので、変更前から進めていた冒険はクリアし、新しい冒険で試します。設定の反映には最大5分かかるため、デプロイ直後なら少し待ってから始めてください。

関連：報酬を受け取る、設定変更

スタミナの増減が計算と合わない

操作を試している間に、自然回復していないでしょうか。商品で 10 回復する間に、時間経過で 1 回復すれば、合わせて 11 増えます。

上限の近くで回復したときは、上限を超えられる設定かどうかも見ておきましょう。

関連：スタミナ消費、スタミナ回復商品の購入

コインがあるのに購入できない

画面に出している残高と、支払いに使う残高が同じかを調べてみましょう。ウォレットのスロットが違うと、別の残高を見ていることになります。

また、有償コインだけを使う設定になっていないか確認してください。このチュートリアルのコインは無償コインなので、有償限定の商品には使えません。

どちらも合っていれば、エラーの詳しい内容を見てみてください。持ち物がいっぱいで商品を受け取れないなど、支払い以外の理由で買えないこともあります。

購入中に通信が途切れた

ネットワーク接続を戻し、処理の完了またはエラーの表示を待ちます。第8章のコードで 同じ購入を再試行 と表示されたら、Unity を再生したまま押してください。同じ duplicationAvoider を使って購入を送り直します。

エラーメッセージが出ていないことと、コイン・スタミナの増減を確認してください。購入が完了した後に通常の購入ボタンを押すと、新しい購入になります。

関連：通信エラーとボタンの連打に対応する

解決しないときは

相談するときは、次の情報があると状況を伝えやすくなります。

取り組んでいる章と、Studio／SDK のどちらのコースか。
Studio、SDK、Unity のバージョン。
何を操作し、どうなるはずだったか。実際にはどうなったか。
エラーメッセージと、発生した時刻。
接続先やアカウントを切り替えたか。

ログを送るときは、パスワードやトークン、クレデンシャルが入っていないか、先に確かめておいてください。

サンプルとリファレンスへ戻る