翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon GameLift サーバー SDK (Go) リファレンス: データ型
この Amazon GameLift Go サーバーSDKリファレンスを使用すると、Amazon で使用するマルチプレイヤーゲームの準備に役立ちます GameLift。統合プロセスの詳細については、「Amazon GameLift をゲームサーバーに追加する」を参照してください。
データ型
LogParameters
ゲームセッション中に生成されたファイルを識別するオブジェクトで、ゲームセッションの終了後 GameLift に Amazon がアップロードして保存します。ゲームサーバーはLogParameters
、ProcessReady()呼び出しのProcessParameters
オブジェクト GameLift の一部として Amazon に を提供します。
プロパティ |
説明 |
LogPaths |
Amazon が将来のアクセスのために GameLift 保存するゲームサーバーログファイルへのディレクトリパスのリスト。サーバープロセスは各ゲームセッション中にこれらのファイルを生成します。ファイルのパスと名前はゲームサーバーで定義し、ルートゲームビルドディレクトリに保存します。 ログパスは絶対パスである必要があります。例えば、ゲームビルドによって タイプ: 必須: いいえ |
ProcessParameters
サーバープロセスと Amazon 間の通信を記述するオブジェクト GameLift。サーバープロセスは、 への呼び出し GameLift でこの情報を Amazon に提供しますProcessReady()。
プロパティ |
説明 |
LogParameters |
ゲームセッション中に生成されるファイルへのディレクトリパスを含むオブジェクト。Amazon は、将来のアクセスのためにファイル GameLift をコピーして保存します。 タイプ: 必須: いいえ |
OnHealthCheck |
サーバープロセスからヘルスステータスレポートをリクエストするために Amazon が GameLift 呼び出すコールバック関数。Amazon は 60 秒ごとにこの関数を GameLift 呼び出し、応答を 60 秒待ちます。サーバープロセスは正常であれば TRUE を返し、正常でない場合は FALSE を返します。応答が返されない場合、Amazon はサーバープロセスを正常ではないと GameLift 記録します。タイプ: 必須: いいえ |
OnProcessTerminate |
サーバープロセスを強制的にシャットダウンするために Amazon が GameLift 呼び出すコールバック関数。この関数を呼び出すと、Amazon はサーバープロセスがシャットダウンするのを 5 分 GameLift 待ってProcessEnding()から、サーバープロセスをシャットダウンします。 タイプ: 必須: はい |
OnStartGameSession |
更新されたゲームセッションオブジェクトをサーバープロセスに渡すために Amazon が GameLift 呼び出すコールバック関数。Amazon は、マッチバックフィルリクエストが処理され、更新されたマッチメーカーデータが提供されると、この関数を GameLift 呼び出します。GameSession オブジェクト、ステータス更新 (updateReason )、およびマッチバックフィルチケット ID を渡します。タイプ: 必須: はい |
OnUpdateGameSession |
更新されたゲームセッション情報をサーバープロセスに渡すために Amazon が GameLift 呼び出すコールバック関数。Amazon は、マッチバックフィルリクエストを処理した後、この関数を GameLift 呼び出して、更新されたマッチメーカーデータを提供します。 タイプ: 必須: いいえ |
Port |
サーバープロセスが新しいプレイヤーの接続をリスンするポート番号。値は、このゲームサーバービルドをデプロイするすべてのフリートで設定されているポート番号の範囲に含まれる必要があります。このポート番号は、ゲームセッションオブジェクトとプレイヤーセッションオブジェクトに含まれ、ゲームセッションがサーバープロセスに接続するときに使用します。 タイプ: 必須: はい |
UpdateGameSession
ゲームセッションオブジェクトの更新。これには、ゲームセッションが更新された理由と、バックフィルを使用してゲームセッション内のプレイヤーセッションを埋めるための関連するバックフィルチケット ID が含まれます。
プロパティ | 説明 |
---|---|
GameSession | GameSession オブジェクト。GameSession オブジェクトにはゲームセッションを説明するプロパティが含まれています。タイプ: 必須: はい |
UpdateReason | ゲームセッションが更新されている理由。 タイプ: 必須: はい |
BackfillTicketId | ゲームセッションの更新を試みるバックフィルチケットの ID。 タイプ: 必須: いいえ |
GameSession
ゲームセッションの詳細。
プロパティ | 説明 |
---|---|
GameSessionId |
ゲームセッションの一意の識別子。ゲームセッションの Amazon リソースネーム (ARN) の形式は です タイプ: 必須: いいえ |
名前 |
ゲームセッションについて説明するラベル。 タイプ: 必須: いいえ |
FleetId |
ゲームセッションが実行されているフリートの一意の識別子。 タイプ: 必須: いいえ |
MaximumPlayerSessionCount |
ゲームセッションへのプレーヤー接続の最大数。 タイプ: 必須: いいえ |
[ポート] |
ゲームセッションのポート番号。Amazon GameLift ゲームサーバーに接続するには、アプリに IP アドレスとポート番号の両方が必要です。 タイプ: 必須: いいえ |
IpAddress |
ゲームセッションの IP アドレス。Amazon GameLift ゲームサーバーに接続するには、アプリに IP アドレスとポート番号の両方が必要です。 タイプ: 必須: いいえ |
GameSessionData |
単一の文字列値としてフォーマットされたカスタムゲームセッションプロパティのセット。 タイプ: 必須: いいえ |
MatchmakerData |
ゲームセッションの作成に使用されたマッチメーキングプロセスに関する情報を、文字列としてフォーマットされたJSON構文で示します。使用されたマッチメーキング設定に加えて、プレイヤー属性やチーム割り当てなど、マッチに割り当てられた全プレイヤーに関するデータが含まれます。 タイプ: 必須: いいえ |
GameProperties |
ゲームセッションのカスタムプロパティのセットで、キーと値のペアとしてフォーマットされます。これらのプロパティは、新しいゲームセッションを開始するリクエストとともに渡されます。 タイプ: 必須: いいえ |
DnsName |
ゲームセッションを実行しているインスタンスに割り当てられたDNS識別子。値の形式は次のとおりです。
TLSが有効なフリートで実行されているゲームセッションに接続する場合は、IP アドレスではなくDNS名前を使用する必要があります。 タイプ: 必須: いいえ |
ServerParameters
Amazon GameLift Anywhere サーバーと Amazon GameLift サービス間の接続を維持するために使用される情報。この情報は、InitSDK() で新しいサーバープロセスを起動するときに使用されます。Amazon GameLift マネージドEC2インスタンスでホストされているサーバーの場合は、空のオブジェクトを使用します。
プロパティ | 説明 |
---|---|
WebSocketURL |
タイプ: 必須: はい |
ProcessID |
ゲームをホストするサーバープロセスに登録された固有の識別子。 タイプ: 必須: はい |
HostID |
新しいサーバープロセスをホストしているコンピュートリソースの一意の識別子。
タイプ: 必須: はい |
FleetID |
コンピューティングが登録されているフリートの固有識別子。詳細については、「」を参照してくださいRegisterCompute。 タイプ: 必須: はい |
AuthToken |
サーバーを Amazon に認証 GameLift する Amazon によって生成された認証トークン GameLift。詳細については、「」を参照してくださいGetComputeAuthToken。 タイプ: 必須: はい |
StartMatchBackfillRequest
マッチメーキングバックフィルリクエストの作成に使用される情報。ゲームサーバーは、この情報をStartMatchBackfill()通話 GameLift で Amazon に通信します。
プロパティ | 説明 |
---|---|
GameSessionArn |
一意のゲームセッション識別子。API オペレーションは識別子を ARN形式で タイプ: 必須: はい |
MatchmakingConfigurationArn |
このリクエストに使用するマッチメーカーの一意の識別子 ( の形式ARN)。元のゲームセッションARNのマッチメーカーは、マッチメーカーデータプロパティのゲームセッションオブジェクトにあります。マッチメーカーデータの詳細については「マッチメーカーデータの処理」を参照してください。 タイプ: 必須: はい |
プレイヤー |
現在ゲームセッションに参加しているすべてのプレイヤーを表すデータのセット。マッチメーカーはこの情報を使用して、現在のプレイヤーとマッチする新しいプレイヤーを検索します。 タイプ: 必須: はい |
TicketId |
マッチメーキングまたはバックフィルリクエストチケットの一意の識別子。値を指定しない場合、Amazon は値 GameLift を生成します。この識別子を使用してマッチバックフィルチケットのステータスを追跡したり、必要に応じてリクエストをキャンセルしたりします。 タイプ: 必須: いいえ |
プレイヤー
マッチメーキングでプレイヤーを表すオブジェクト。マッチメーキングリクエストを開始すると、プレイヤーはプレイヤー ID、属性、場合によってはレイテンシーデータを保有します。Amazon は、試合後にチーム情報 GameLift を追加します。
プロパティ | 説明 |
---|---|
LatencyInMS |
プレイヤーがロケーションに接続したときに発生するレイテンシーの量を示すミリ秒単位の値のセット。 このプロパティを使用すると、プレーヤーはリストに表示されている場所でのみマッチングされます。マッチメーカーにプレイヤーレイテンシーを評価するルールがある場合、プレイヤーはレイテンシーを報告しないとマッチングされません。 タイプ: 必須: いいえ |
PlayerAttributes |
マッチメーキングに使用するプレイヤー情報を含むキーと値のペアの集合。プレイヤー属性キーは、マッチメーキングルールセット PlayerAttributes で使用される と一致する必要があります。 プレイヤー属性の詳細については、「」を参照してくださいAttributeValue。 タイプ: 必須: いいえ |
PlayerId |
プレイヤーを表す一意の識別子。 タイプ: 必須: いいえ |
Team |
マッチでプレーヤーが割り当てられるチームの名前。チーム名はマッチメーキングルールセットで定義します。 タイプ: 必須: いいえ |
DescribePlayerSessionsRequest
取得するプレイヤーセッションを指定するオブジェクト。サーバープロセスは、この情報に Amazon へのDescribePlayerSessions()呼び出しを提供します GameLift。
プロパティ | 説明 |
---|---|
GameSessionID |
一意のゲームセッション識別子。このパラメータを使用して、指定したゲームセッションのすべてのプレイヤーセッションをリクエストします。 ゲームセッション ID の形式は タイプ: 必須: いいえ |
PlayerSessionID |
プレイヤーセッションを表す一意の識別子。このパラメータを使用して、特定の 1 つのプレイヤーセッションをリクエストします。 タイプ: 必須: いいえ |
PlayerID |
プレイヤーの一意識別子。このパラメータを使用して、特定の 1 人のプレイヤーに対するすべてのプレイヤーセッションをリクエストします。プレイヤー ID を生成する を参照してください。 タイプ: 必須: いいえ |
PlayerSessionStatusFilter |
結果をフィルタリングするプレイヤーセッションステータス。可能なプレイヤーセッションステータスには以下が含まれます。
タイプ: 必須: いいえ |
NextToken |
結果の次のページの先頭を示すトークン。結果セットの先頭を指定するには、値を指定しないでください。プレイヤーセッション ID を提供する場合、このパラメータは無視されます。 タイプ: 必須: いいえ |
Limit |
返される結果の最大数。プレイヤーセッション ID を提供する場合、このパラメータは無視されます。 タイプ: 必須: いいえ |
StopMatchBackfillRequest
マッチメーキングバックフィルリクエストのキャンセルに使用される情報。ゲームサーバーは、この情報をStopMatchBackfill()通話で Amazon GameLift サービスに伝えます。
プロパティ | 説明 |
---|---|
GameSessionArn |
キャンセルされるリクエストの一意のゲームセッション識別子。 タイプ: 必須: いいえ |
MatchmakingConfigurationArn |
このリクエストが送信されたマッチメーカーの一意の識別子。 タイプ: 必須: いいえ |
TicketId |
キャンセルされるバックフィルリクエストチケットの一意の識別子。 タイプ: 必須: いいえ |
GetFleetRoleCredentialsRequest
AWS リソースへの制限付きアクセスをゲームサーバーに拡張するロール認証情報。詳細については、Amazon の IAM サービスロールを設定する GameLift を参照してください。
プロパティ | 説明 |
---|---|
RoleArn | リソースへの制限付きアクセスを拡張するサービスロールARNの AWS 。 タイプ: 必須: はい |
RoleSessionName | ロール認証情報の使用を説明するセッションの名前。 タイプ: 必須: はい |