GS2-Datastore SDK for Game Engine API リファレンス
ゲームエンジン向け GS2-Datastore SDK の モデルの仕様 と API のリファレンス
任意のバイナリデータをサーバに保存する機能を提供します。
アップロードされたデータはアクセス権限管理(ACL - Access Control List)が適用されます。
データには誰でもデータにアクセスが可能な public
指定したユーザーIDのゲームプレイヤーにのみアクセスが可能な protected
自身のみがアクセスが可能な private の3種類のACLが設定できます。
アップロードされたデータはバージョニングされており、データを更新・削除しても
古い世代のデータは30日間保持されます。
世代IDを指定してダウンロードすることで、更新前・削除前のデータを取得できます。
アップロードされたデータには固有のID(UUID v4)と世代IDが割り当てられ、 データを更新・削除すると世代IDが更新されます。
データをダウンロードする際には世代IDを指定して、具体的なファイルを特定します。
データを更新するのと同時に他プレイヤーがデータにアクセスしようとしたときに 意図せず新しいバージョンのデータを取得しないようにダウンロードリクエストには世代IDを含めることができます。
世代IDをダウンロードリクエストに付加することで、確実にリストアップした時点でのデータをダウンロードすることを保証することができます。
ただし、いつまでも世代の古いデータにアクセスできることは望まないゲームもあるかもしれません。
そのため、データの所有者以外に対して、更新後60分以内かつ1つ前の世代に限り古い世代のデータのダウンロードを許可するオプションが存在します。
本機能を使用してセーブデータの管理をする際には、不正行為に対する耐性を考えてください。
他のGS2のサービスではゲームの仕様に合わせて加算・減算を自由に行えないようコントロールされています。
しかし、ローカルのセーブデータを信頼することはチート行為の原因となりえます。
GS2の機能が提供されている場合はそちらを優先して使用し、 UGCコンテンツの交換や、コンフィグの設定値など改ざんされても影響が軽微な要素のみを管理するようにしてください。
ゲームエンジン向け GS2-Datastore SDK の モデルの仕様 と API のリファレンス
各種プログラミング言語向け GS2-Datastore SDK の モデルの仕様 と API のリファレンス
拡張スクリプトを呼び出すイベントトリガーのリファレンス
GS2-Deployのスタックを作成する際に使用するテンプレートのフォーマットと、CDKによる各種言語のテンプレート出力の実装例