翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# C\+\+ サーバー SDK 5.x for Amazon GameLift Servers -- データ型
<a name="integration-server-sdk5-cpp-datatypes"></a>

Amazon GameLift Servers C\+\+ サーバー SDK 5.x リファレンスを使用して、Amazon GameLift Servers でホスティングするマルチプレイヤーゲームを統合します。統合プロセスのガイダンスについては、「[サーバー SDK を使用して、Amazon GameLift Servers をゲームサーバーに追加します。](gamelift-sdk-server-api.md)」を参照してください。

**注記**  
このトピックでは、C\+\+ 標準ライブラリ (`std`) を使用して構築するときに利用できる Amazon GameLift Servers C\+\+ API について説明します。特に、このドキュメントは `-DDGAMELIFT_USE_STD=1` オプションを使用してコンパイルするコードが対象です。

[C\+\+ サーバー SDK 5.x for Amazon GameLift Servers -- アクション](integration-server-sdk5-cpp-actions.md)

**Topics**
+ [LogParameters](#integration-server-sdk5-cpp-dataypes-log)
+ [MetricsParameters](#integration-server-sdk5-cpp-datatypes-metricsparameters)
+ [ProcessParameters](#integration-server-sdk5-cpp-dataypes-process)
+ [UpdateGameSession](#integration-server-sdk5-cpp-dataypes-updategamesession)
+ [GameSession](#integration-server-sdk5-cpp-dataypes-gamesession)
+ [ServerParameters](#integration-server-sdk5-cpp-dataypes-serverparameters)
+ [StartMatchBackfillRequest](#integration-server-sdk5-cpp-dataypes-startmatchbackfillrequest)
+ [プレイヤー](#integration-server-sdk5-cpp-dataypes-player)
+ [DescribePlayerSessionsRequest](#integration-server-sdk5-cpp-dataypes-playersessions)
+ [StopMatchBackfillRequest](#integration-server-sdk5-cpp-dataypes-stopmatchbackfillrequest)
+ [AttributeValue](#integration-server-sdk5-cpp-dataypes-attributevalue)
+ [GetFleetRoleCredentialsRequest](#integration-server-sdk5-cpp-dataypes-getfleetrolecredentialsrequest)
+ [AwsLongOutcome](#integration-server-sdk5-cpp-datatypes-awslongoutcome)
+ [AwsStringOutcome](#integration-server-sdk5-cpp-datatypes-awsstringoutcome)
+ [DescribePlayerSessionsOutcome](#integration-server-sdk5-cpp-datatypes-describeplayersessionsoutcome)
+ [DescribePlayerSessionsResult](#integration-server-sdk5-cpp-datatypes-describeplayersessionsresult)
+ [GenericOutcome](#integration-server-sdk5-cpp-datatypes-genericoutcome)
+ [GenericOutcomeCallable](#integration-server-sdk5-cpp-datatypes-genericoutcomecallable)
+ [PlayerSession](#integration-server-sdk5-cpp-datatypes-playersession)
+ [StartMatchBackfillOutcome](#integration-server-sdk5-cpp-datatypes-startmatchbackfilloutcome)
+ [StartMatchBackfillResult](#integration-server-sdk5-cpp-datatypes-startmatchbackfillresult)
+ [GetComputeCertificateOutcome](#integration-server-sdk5-cpp-datatypes-getcomputecertificateoutcome)
+ [GetComputeCertificateResult](#integration-server-sdk5-cpp-datatypes-getcomputecertificateresult)
+ [GetFleetRoleCredentialsOutcome](#integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsoutcome)
+ [GetFleetRoleCredentialsResult](#integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsresult)
+ [InitSDKOutcome](#integration-server-sdk5-cpp-datatypes-initsdkoutcome)
+ [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)
+ [列挙型](#integration-server-sdk5-cpp-dataypes-enums)

## LogParameters
<a name="integration-server-sdk5-cpp-dataypes-log"></a>

ゲームセッション中に生成されたファイルを識別するオブジェクトで、ゲームセッション終了時に Amazon GameLift Servers でアップロードして保存します。ゲームサーバーは、[ProcessReady()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-processready) 呼び出しで `ProcessParameters` オブジェクトの一部として `LogParameters` を Amazon GameLift Servers に提供します。


|  |  | 
| --- |--- |
| **プロパティ** | 説明 | 
| LogPaths | Amazon GameLift Servers で将来のアクセスに備えて保存するゲームサーバーログファイルへのディレクトリパスのリスト。サーバープロセスは各ゲームセッション中にこれらのファイルを生成します。ファイルのパスと名前はゲームサーバーで定義し､ルートゲームビルドディレクトリに保存します。<br />ログパスは絶対パスである必要があります。例えば、ゲームビルドによって `MyGame\sessionLogs\` などのパスに保存されるゲームセッションログの場合、パスは `c:\game\MyGame\sessionLogs` (Windows インスタンスの場合) となります。<br />**タイプ**: `std:vector<std::string>`<br />**必須:** いいえ | 

## MetricsParameters
<a name="integration-server-sdk5-cpp-datatypes-metricsparameters"></a>

このデータ型を使用して、ゲームサーバーのメトリクス収集とクラッシュレポートを設定します。ゲームサーバーは、[InitMetrics()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initmetrics) 呼び出しで `MetricsParameters` を Amazon GameLift Servers に送信します。


|  |  | 
| --- |--- |
| **プロパティ** | 説明 | 
| StatsdHost | メトリクス収集用の StatsD サーバーのホスト名または IP アドレス。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| StatsdPort | メトリクス収集用の StatsD サーバーのポート番号です。<br />**タイプ**: `int`<br />**必須:** いいえ | 
| CrashReporterHost | クラッシュレポーターサーバーのホスト名または IP アドレスです。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| CrashReporterPort | クラッシュレポーターサーバーのポート番号です。<br />**タイプ**: `int`<br />**必須:** いいえ | 
| FlushIntervalMs | メトリクスデータをサーバーにフラッシュする際のミリ秒単位の間隔です。<br />**タイプ**: `int`<br />**必須:** いいえ | 
| MaxPacketSize | サーバーに送信されるメトリクスパケットの最大サイズ (バイト) です。<br />**タイプ**: `int`<br />**必須:** いいえ | 

## ProcessParameters
<a name="integration-server-sdk5-cpp-dataypes-process"></a>

このデータ型には、[ProcessReady()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-processready) の中で Amazon GameLift Servers に送信されるパラメータのセットが含まれます。


|  |  | 
| --- |--- |
| **プロパティ** | 説明 | 
| LogParameters | ゲームセッション中に生成されるファイルへのディレクトリパスを持つオブジェクトです。Amazon GameLift Servers はこれらのファイルをコピーして保存し、後で参照できるようにします。**タイプ**: `Aws::GameLift::Server::LogParameters`<br />**必須:** いいえ | 
| OnHealthCheck | Amazon GameLift Servers がサーバープロセスにヘルスステータスレポートを要求するために呼び出すコールバック関数です。Amazon GameLift Servers はこの関数を 60 秒ごとに呼び出し、応答を最大 60 秒間待機します。サーバープロセスは正常であれば TRUE を返し、正常でない場合は FALSE を返します。応答が返されない場合、Amazon GameLift Servers はサーバープロセスを正常ではないと記録します。**タイプ**: `std::function<bool()> onHealthCheck`<br />**必須:** いいえ | 
| OnProcessTerminate | Amazon GameLift Servers がサーバープロセスを強制的にシャットダウンするために呼び出すコールバック関数です。この関数を呼び出すと、Amazon GameLift Servers はサーバープロセスがシャットダウンするまで最大 5 分間待機し、サーバープロセスがシャットダウンする前に [ProcessEnding()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-processending) 呼び出しで応答するのを待ちます。**タイプ**: `std::function<void()> onProcessTerminate`<br />**必須:** はい | 
| OnStartGameSession | Amazon GameLift Servers が新しいゲームセッションをアクティブ化するために呼び出すコールバック関数。Amazon GameLift Servers は、クライアントリクエスト [CreateGameSession](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_CreateGameSession.html) に応じてこの関数を呼び出します。コールバック関数は [GameSession](#integration-server-sdk5-cpp-dataypes-gamesession) オブジェクトを渡します。**タイプ**: `const std::function<void(Aws::GameLift::Model::GameSession)> onStartGameSession`<br />**必須:** はい | 
| OnUpdateGameSession | 更新されたゲームセッションオブジェクトをサーバープロセスに渡すために、Amazon GameLift Servers が呼び出すコールバック関数。Amazon GameLift Servers は、更新されたマッチメーカーデータを提供するために、マッチバックフィルリクエストが処理された際にこの関数を呼び出します。これは、[GameSession](#integration-server-sdk5-cpp-dataypes-gamesession) オブジェクト、ステータス更新 (updateReason) そして、マッチバックフィルチケット ID を渡します。**タイプ**: `std::function<void(Aws::GameLift::Server::Model::UpdateGameSession)> onUpdateGameSession`<br />**必須:** いいえ | 
| ポート | サーバープロセスが新しいプレイヤーの接続をリスンするポート番号。値は、このゲームサーバービルドをデプロイするすべてのフリートで設定されているポート番号の範囲に含まれる必要があります。このポート番号は、ゲームセッションオブジェクトとプレイヤーセッションオブジェクトに含まれ、ゲームセッションがサーバープロセスに接続するときに使用します。**タイプ**: `Integer`<br />**必須:** はい | 

## UpdateGameSession
<a name="integration-server-sdk5-cpp-dataypes-updategamesession"></a>

このデータ型はゲームセッションオブジェクトに更新されます。これには、ゲームセッションが更新された理由と、バックフィルを使用してゲームセッション内のプレイヤーセッションを埋めるための関連するバックフィルチケット ID が含まれます。


| プロパティ | **説明** | 
| --- | --- | 
| GameSession | [GameSession](#integration-server-sdk5-cpp-dataypes-gamesession) オブジェクト。GameSession オブジェクトにはゲームセッションを説明するプロパティが含まれています。**タイプ**: `Aws::GameLift::Server::GameSession`<br />**必須:** はい | 
| UpdateReason | ゲームセッションが更新されている理由。**タイプ**: `Aws::GameLift::Server::UpdateReason`<br />**必須:** はい | 
| BackfillTicketId | ゲームセッションの更新を試みるバックフィルチケットの ID。**タイプ**: `std::string`<br />**必須:** いいえ | 

## GameSession
<a name="integration-server-sdk5-cpp-dataypes-gamesession"></a>

このデータ型はゲームセッションの詳細を提供します。


| プロパティ | **説明** | 
| --- | --- | 
| GameSessionId | ゲームセッションの一意の識別子。ゲームセッション ARN の形式 は `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>` です。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| 名前 | ゲームセッションについて説明するラベル。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| FleetId | ゲームセッションが実行されているフリートの一意の識別子。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| MaximumPlayerSessionCount | ゲームセッションへのプレーヤー接続の最大数。<br />**タイプ**: `int`<br />**必須:** いいえ | 
| ポート | ゲームセッションのポート番号。Amazon GameLift Servers ゲームサーバーに接続するには、アプリに IP アドレスとポート番号の両方が必要です。<br />**タイプ**: `in`<br />**必須:** いいえ | 
| IpAddress | ゲームセッションの IP アドレス。Amazon GameLift Servers ゲームサーバーに接続するには、アプリに IP アドレスとポート番号の両方が必要です。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| GameSessionData | 単一の文字列値としてフォーマットされたカスタムゲームセッションプロパティのセット。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| MatchmakerData | ゲームセッションの作成に使用されたマッチメーキングプロセスに関する情報。JSON 構文で、文字列としてフォーマットされています。使用されたマッチメーキング設定に加えて、プレイヤー属性やチーム割り当てなど、マッチに割り当てられた全プレイヤーに関するデータが含まれます。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| GameProperties | ゲームセッションのカスタムプロパティのセットで、キーと値のペアとしてフォーマットされます。これらのプロパティは、新しいゲームセッションを開始するリクエストとともに渡されます。<br />**タイプ**: `std :: vector < GameProperty >`<br />**必須:** いいえ | 
| DnsName | ゲームセッションを実行しているインスタンスに割り当てられた DNS 識別子。値の形式は次のとおりです。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html)<br />TLS 対応フリートで実行しているゲームセッションに接続する場合、IP アドレスではなく DNS 名を使用する必要があります。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 

## ServerParameters
<a name="integration-server-sdk5-cpp-dataypes-serverparameters"></a>

ゲームサーバープロセスが、Amazon GameLift Servers サービスへの接続を確立するために使用する情報。ゲームサーバービルドが、Amazon GameLift Servers エージェントを使用しない Anywhere フリートまたはコンテナフリートにデプロイされる場合にのみ、[InitSDK()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk-anywhere) を呼び出す際にこれらのパラメータを含めます。他のすべてのデプロイシナリオでは、パラメータなしで [InitSDK()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-initsdk) が呼び出されます。


| プロパティ | **説明** | 
| --- | --- | 
| webSocketUrl | Amazon GameLift Servers Anywhere コンピューティングリソース用に [https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html) を実行すると、`GameLiftServerSdkEndpoint` Amazon GameLift Servers が返されます。<br />**タイプ**: `std::string`<br />**必須:** はい  | 
| processId | ゲームをホストするサーバープロセスに登録された固有の識別子。<br />**タイプ**: `std::string`<br />**必須:** はい | 
| hostId | HostID はコンピューティングを登録したときに使用される ComputeName です。詳細については、「[RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)」を参照してください。**タイプ**: `std::string`<br />**必須:** はい | 
| fleetId | コンピューティングが登録されているフリートの固有識別子。詳細については、「[RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)」を参照してください。**タイプ**: `std::string`<br />**必須:** はい | 
| authToken | Amazon GameLift Servers によって生成され、サーバーを Amazon GameLift Servers に対して認証するための認証トークン。詳細については、「[GetComputeAuthToken](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_GetComputeAuthToken.html)」を参照してください。**タイプ**: `std::string`<br />**必須:** はい | 

## StartMatchBackfillRequest
<a name="integration-server-sdk5-cpp-dataypes-startmatchbackfillrequest"></a>

マッチメーキングバックフィルリクエストの作成に使用される情報。ゲームサーバーは、この情報を [StartMatchBackfill()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-startmatchbackfill) 呼び出しで Amazon GameLift Servers に送信します。


| プロパティ | **説明** | 
| --- | --- | 
| GameSessionArn | 一意のゲームセッション識別子。API オペレーション `[GetGameSessionId](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-actions.html#integration-server-sdk5-cpp-getgamesessionid)` は ARN 形式の識別子を返します。<br />**タイプ**: `std::string`<br />**必須:** はい | 
| MatchmakingConfigurationArn | このリクエストに使用されるマッチメーカーの ARN 形式の一意な識別子。元のゲームセッションののマッチメーカー ARN は、マッチメーカーデータプロパティのゲームセッションオブジェクトにあります。マッチメーカーデータの詳細については「[マッチメーカーデータの処理](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-server.html#match-server-data.html)」を参照してください。<br />**タイプ**: `std::string`<br />**必須:** はい | 
| プレイヤー | ゲームセッションに参加しているすべてのプレイヤーを表すデータのセット。マッチメーカーはこの情報を使用して、現在のプレイヤーとマッチする新しいプレイヤーを検索します。<br />**タイプ**: `std::vector<Player>`<br />**必須:** はい | 
| TicketId | マッチメーキングまたはバックフィルリクエストチケットの一意の識別子。値を指定しない場合、Amazon GameLift Servers ソリューションが値を生成します。この識別子を使用してマッチバックフィルチケットのステータスを追跡したり、必要に応じてリクエストをキャンセルしたりします。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 

## プレイヤー
<a name="integration-server-sdk5-cpp-dataypes-player"></a>

このデータ型はマッチメーキングのプレイヤーを表します。マッチメーキングリクエストを開始すると、プレイヤーにはプレイヤー ID、属性、必要に応じてレイテンシーデータが含まれます。マッチが成立すると、Amazon GameLift Servers がチーム情報を追加します。


| プロパティ | **説明** | 
| --- | --- | 
| LatencyInMS | プレイヤーがロケーションに接続したときに発生するレイテンシーの量を示すミリ秒単位の値のセット。<br />このプロパティを使用すると、プレーヤーはリストに表示されている場所でのみマッチングされます。マッチメーカーにプレイヤーレイテンシーを評価するルールがある場合、プレイヤーはレイテンシーを報告しないとマッチングされません。<br />**タイプ**: `Dictionary<string,int>`<br />**必須:** いいえ | 
| PlayerAttributes | マッチメーキングに使用するプレイヤー情報を含むキーと値のペアの集合。プレイヤー属性キーは、マッチメーキングルールセットで使用されている PlayerAttributes と一致する必要があります。<br />プレイヤー属性の詳細については、「[AttributeValue](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_AttributeValue.html)」を参照してください。<br />**タイプ**: `std::map<std::string,AttributeValue>`<br />**必須:** いいえ | 
| PlayerId | プレイヤーを表す一意の識別子。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| チーム | マッチでプレーヤーが割り当てられるチームの名前。チーム名はマッチメーキングルールセットで定義します。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 

## DescribePlayerSessionsRequest
<a name="integration-server-sdk5-cpp-dataypes-playersessions"></a>

取得するプレイヤーセッションを指定するオブジェクト。サーバープロセスは、この情報を [DescribePlayerSessions()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-describeplayersessions) 呼び出しで Amazon GameLift Servers に提供します。


| プロパティ | **説明** | 
| --- | --- | 
| GameSessionId | 一意のゲームセッション識別子。このパラメータを使用して、指定したゲームセッションのすべてのプレイヤーセッションをリクエストします。<br />ゲームセッション ID の形式は `arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>` です。`GameSessionID` はカスタム ID 文字列または<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| PlayerSessionId | プレイヤーセッションを表す一意の識別子。このパラメータを使用して、特定の 1 つのプレイヤーセッションをリクエストします。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| PlayerId | プレイヤーの一意識別子。このパラメータを使用して、特定の 1 人のプレイヤーに対するすべてのプレイヤーセッションをリクエストします。「[プレイヤー ID を生成する](player-sessions-player-identifiers.md)」を参照してください。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| PlayerSessionStatusFilter | 結果をフィルタリングするプレイヤーセッションステータス。可能なプレイヤーセッションステータスには以下が含まれます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html)<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| NextToken | 結果の次のページの先頭を示すトークン。結果セットの先頭を指定するには、値を指定しないでください。プレイヤーセッション ID を提供する場合、このパラメータは無視されます。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| 制限 | 返される結果の最大数。プレイヤーセッション ID を提供する場合、このパラメータは無視されます。<br />**タイプ**: `int`<br />**必須:** いいえ | 

## StopMatchBackfillRequest
<a name="integration-server-sdk5-cpp-dataypes-stopmatchbackfillrequest"></a>

マッチメーキングバックフィルリクエストのキャンセルに使用される情報。ゲームサーバーは、この情報を [StopMatchBackfill()](integration-server-sdk5-cpp-actions.md#integration-server-sdk5-cpp-stopmatchbackfill) 呼び出しで Amazon GameLift Servers サービスに送信します。


| プロパティ | **説明** | 
| --- | --- | 
| GameSessionArn | キャンセルされるリクエストの一意のゲームセッション識別子。<br />**タイプ**: `char[]`<br />**必須:** いいえ | 
| MatchmakingConfigurationArn | このリクエストが送信されたマッチメーカーの一意の識別子。<br />**タイプ**: `char[]`<br />**必須:** いいえ | 
| TicketId | キャンセルされるバックフィルリクエストチケットの一意の識別子。<br />**タイプ**: `char[]`<br />**必須:** いいえ | 

## AttributeValue
<a name="integration-server-sdk5-cpp-dataypes-attributevalue"></a>

これらの値を [プレイヤー](#integration-server-sdk5-cpp-dataypes-player) 属性のキーと値のペアで使用します。このオブジェクトでは、文字列、数値、文字列配列、データマップのいずれかの有効なデータ型を使用して属性値を指定できます。各 `AttributeValue` オブジェクトは `S`、`N`、`SL`、または `SDM` の使用可能なプロパティのうちの 1 つだけを使用する必要があります。


| プロパティ | 説明 | 
| --- | --- | 
| AttrType | 属性値のタイプを指定します。可能な属性値のタイプは次のとおりです。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html)<br />**必須:** いいえ | 
| S | 文字列の属性値を表します。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| いいえ | 数値の属性値を表します。<br />**タイプ**: `double`<br />**必須:** いいえ | 
| SL | 文字列の属性値の配列を表します。<br />**タイプ**: `std::vector<std::string>`<br />**必須:** いいえ | 
| SDM | 文字列キーと二重値のディクショナリを表します。<br />**タイプ**: `std::map<std::string, double>`<br />**必須:** いいえ | 

## GetFleetRoleCredentialsRequest
<a name="integration-server-sdk5-cpp-dataypes-getfleetrolecredentialsrequest"></a>

このデータ型により、ゲームサーバーは他の AWS リソースへのアクセスが制限されます。詳細については、[Amazon GameLift Servers 用に IAM サービスロールをセットアップする](setting-up-role.md) を参照してください。


| プロパティ | **説明** | 
| --- | --- | 
| RoleArn | リソースへの制限付きアクセスを拡張するサービスロールの Amazon AWS リソースネーム (ARN)。**タイプ**: `std::string`<br />**必須:** いいえ | 
| RoleSessionName |  AWS Security Token Service [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) セッションを一意に識別するために使用できるロールセッション名。この名前は、CloudTrail などの監査ログに公開されます。**タイプ**: `std::string` <br />**必須:** いいえ  | 

## AwsLongOutcome
<a name="integration-server-sdk5-cpp-datatypes-awslongoutcome"></a>

このデータ型はアクションの結果で、以下のプロパティを持つオブジェクトを生成します。


| プロパティ | 説明 | 
| --- | --- | 
| 結果 | アクションの結果。<br />**タイプ**: `long`<br />**必須:** いいえ | 
| ResultWithOwnership |  アクションの結果を rvalue としてキャストし、呼び出し元のコードがオブジェクトの所有権を取得できるようにします。<br />**タイプ**: `long&&`<br />**必須:** いいえ | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## AwsStringOutcome
<a name="integration-server-sdk5-cpp-datatypes-awsstringoutcome"></a>

このデータ型はアクションの結果で、以下のプロパティを持つオブジェクトを生成します。


| プロパティ | 説明 | 
| --- | --- | 
| 結果 | アクションの結果。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| ResultWithOwnership |  アクションの結果を rvalue としてキャストし、呼び出し元のコードがオブジェクトの所有権を取得できるようにします。<br />**タイプ**: `long&&`<br />**必須:** いいえ | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## DescribePlayerSessionsOutcome
<a name="integration-server-sdk5-cpp-datatypes-describeplayersessionsoutcome"></a>

このデータ型はアクションの結果で、以下のプロパティを持つオブジェクトを生成します。


| プロパティ | 説明 | 
| --- | --- | 
| 結果 | アクションの結果。<br />**タイプ**: [DescribePlayerSessionsResult](#integration-server-sdk5-cpp-datatypes-describeplayersessionsresult)<br />**必須:** いいえ  | 
| ResultWithOwnership |  アクションの結果を rvalue としてキャストし、呼び出し元のコードがオブジェクトの所有権を取得できるようにします。<br />**タイプ**: `Aws::GameLift::Server::Model::DescribePlayerSessionsResult&&`<br />**必須:** いいえ | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## DescribePlayerSessionsResult
<a name="integration-server-sdk5-cpp-datatypes-describeplayersessionsresult"></a>

リクエストに一致する各プレイヤーセッションのプロパティを含むオブジェクトの集合。


| プロパティ | 説明 | 
| --- | --- | 
| NextToken | 結果の次の順次ページの先頭を示すトークン。このオペレーションの以前の呼び出しで返されたトークンを使用します。結果セットの先頭で開始するには、値を指定しないでください。プレイヤーセッション ID を指定した場合、このパラメータは無視されます。<br />**タイプ**: `std::string`<br />**必須:** はい | 
| PlayerSessions | **タイプ**: `IList<PlayerSession>`<br />**必須:**  | 
| ResultWithOwnership |  アクションの結果を rvalue としてキャストし、呼び出し元のコードがオブジェクトの所有権を取得できるようにします。<br />**タイプ**: `std::string&&`<br />**必須:** いいえ | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## GenericOutcome
<a name="integration-server-sdk5-cpp-datatypes-genericoutcome"></a>

このデータ型はアクションの結果で、以下のプロパティを持つオブジェクトを生成します。


| プロパティ | 説明 | 
| --- | --- | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## GenericOutcomeCallable
<a name="integration-server-sdk5-cpp-datatypes-genericoutcomecallable"></a>

このデータ型は非同期の一般的な結果です。以下のプロパティがあります。


| プロパティ | 説明 | 
| --- | --- | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## PlayerSession
<a name="integration-server-sdk5-cpp-datatypes-playersession"></a>

このデータ型は、Amazon GameLift Servers がゲームサーバーに渡すプレイヤーセッションを表します。詳細については、「[PlayerSession](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_PlayerSession.html)」を参照してください。


| プロパティ | 説明 | 
| --- | --- | 
| CreationTime | **タイプ**: `long`<br />**必須:** いいえ | 
| FleetId | **タイプ**: `std::string`<br />**必須:** いいえ | 
| GameSessionId | **タイプ**: `std::string`<br />**必須:** いいえ | 
| IpAddress | **タイプ**: `std::string`<br />**必須:** いいえ | 
| PlayerData | **タイプ**: `std::string`<br />**必須:** いいえ | 
| PlayerId | **タイプ**: `std::string`<br />**必須:** いいえ | 
| PlayerSessionId | **タイプ**: `std::string`<br />**必須:** いいえ | 
| ポート | **タイプ**: `int`<br />**必須:** いいえ | 
| ステータス | 結果をフィルタリングするプレイヤーセッションステータス。PlayerSessionId または PlayerId が提供された場合、PlayerSessionStatusFilter はレスポンスに影響を与えません。<br />**型:** `PlayerSessionStatus` enum。以下に示しているのは、可能な値です。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html)<br />**必須:** いいえ | 
| TerminationTime | **タイプ**: `long`<br />**必須:** いいえ | 
| DnsName | **タイプ**: `std::string`<br />**必須:** いいえ | 

## StartMatchBackfillOutcome
<a name="integration-server-sdk5-cpp-datatypes-startmatchbackfilloutcome"></a>

このデータ型はアクションの結果で、以下のプロパティを持つオブジェクトを生成します。


| プロパティ | 説明 | 
| --- | --- | 
| 結果 | アクションの結果。<br />**タイプ**: [StartMatchBackfillResult](#integration-server-sdk5-cpp-datatypes-startmatchbackfillresult)<br />**必須:** いいえ | 
| ResultWithOwnership |  アクションの結果を rvalue としてキャストし、呼び出し元のコードがオブジェクトの所有権を取得できるようにします。<br />**タイプ**: `StartMatchBackfillResult&&`<br />**必須:** いいえ | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## StartMatchBackfillResult
<a name="integration-server-sdk5-cpp-datatypes-startmatchbackfillresult"></a>

このデータ型はアクションの結果で、以下のプロパティを持つオブジェクトを生成します。


| プロパティ | 説明 | 
| --- | --- | 
| TicketId | マッチメーキングチケットの一意の識別子。ここでチケット ID を指定しない場合、Amazon GameLift Servers が UUID 形式の ID を自動生成します。この識別子を使用して、マッチバックフィルチケットのステータスを追跡し、マッチ結果を取得します。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 

## GetComputeCertificateOutcome
<a name="integration-server-sdk5-cpp-datatypes-getcomputecertificateoutcome"></a>

このデータ型はアクションの結果で、以下のプロパティを持つオブジェクトを生成します。


| プロパティ | 説明 | 
| --- | --- | 
| 結果 | アクションの結果。<br />**タイプ**: [GetComputeCertificateResult](#integration-server-sdk5-cpp-datatypes-getcomputecertificateresult)<br />**必須:** いいえ  | 
| ResultWithOwnership |  アクションの結果を rvalue としてキャストし、呼び出し元のコードがオブジェクトの所有権を取得できるようにします。<br />**タイプ**: `Aws::GameLift::Server::Model::GetComputeCertificateResult&&`<br />**必須:** いいえ | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## GetComputeCertificateResult
<a name="integration-server-sdk5-cpp-datatypes-getcomputecertificateresult"></a>

コンピューティングの TLS 証明書へのパスとコンピューティングのホスト名。


| プロパティ | 説明 | 
| --- | --- | 
| CertificatePath | コンピューティングリソースの TLS 証明書へのパス。Amazon GameLift Serversマネージドフリートを使用する場合、このパスには次の内容が含まれます。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/gameliftservers/latest/developerguide/integration-server-sdk5-cpp-datatypes.html)<br />**タイプ**: `std::string`<br />**必須:** いいえ | 
| ComputeName | コンピューティングリソースの名前。<br />**タイプ**: `std::string`<br />**必須:** いいえ | 

## GetFleetRoleCredentialsOutcome
<a name="integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsoutcome"></a>

このデータ型はアクションの結果で、以下のプロパティを持つオブジェクトを生成します。


| プロパティ | 説明 | 
| --- | --- | 
| 結果 | アクションの結果。<br />**タイプ**: [GetFleetRoleCredentialsResult](#integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsresult)<br />**必須:** いいえ  | 
| ResultWithOwnership |  アクションの結果を rvalue としてキャストし、呼び出し元のコードがオブジェクトの所有権を取得できるようにします。<br />**タイプ**: `Aws::GameLift::Server::Model::GetFleetRoleCredentialsResult`<br />**必須:** いいえ | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## GetFleetRoleCredentialsResult
<a name="integration-server-sdk5-cpp-datatypes-getfleetrolecredentialsresult"></a>


| プロパティ | 説明 | 
| --- | --- | 
| AccessKeyId |  AWS へのアクセスを認証して提供するためのアクセスキー ID。<br />**タイプ**: `string`<br />**必須:** いいえ | 
| AssumedRoleId | サービスロールが属するユーザーの ID。<br />**タイプ**: `string`<br />**必須:** いいえ | 
| AssumedRoleUserArn | サービスロールが属するユーザーの Amazon リソースネーム (ARN)。<br />**タイプ**: `string`<br />**必須:** いいえ | 
| 有効期限 | セッション認証情報の有効期限が切れるまでの時間。<br />**タイプ**: `DateTime`<br />**必須:** いいえ | 
| SecretAccessKey | 認証のためのシークレットアクセスキー ID。<br />**タイプ**: `string`<br />**必須:** いいえ | 
| SessionToken |  AWS リソースとやり取りする現在のアクティブなセッションを識別するトークン。<br />**タイプ**: `string`<br />**必須:** いいえ | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](integration-server-sdk5-csharp-datatypes.md#integration-server-sdk5-csharp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## InitSDKOutcome
<a name="integration-server-sdk5-cpp-datatypes-initsdkoutcome"></a>

**注記**  
`InitSDKOutcome` は `std` フラグを付けて SDK を構築した場合にのみ返されます。`nostd` フラグを付けて構築すると、代わりに [GenericOutcome](#integration-server-sdk5-cpp-datatypes-genericoutcome) が返されます。


| プロパティ | 説明 | 
| --- | --- | 
| Success | アクションが成功したかどうか。<br />**タイプ**: `bool`<br />**必須:** はい | 
| エラー | アクションが失敗した場合に発生したエラー。<br />**タイプ**: [GameLiftError](#integration-server-sdk5-cpp-datatypes-gamelifterror)<br />**必須:** いいえ | 

## GameLiftError
<a name="integration-server-sdk5-cpp-datatypes-gamelifterror"></a>


| プロパティ | 説明 | 
| --- | --- | 
| ErrorType | エラーのタイプ。<br />**型:** `GameLiftErrorType` [enum](#integration-server-sdk5-cpp-dataypes-enums)。<br />**必須:** いいえ  | 
| ErrorName | エラータイプの名前。<br /> **タイプ**: `std::string` <br />**必須:** いいえ  | 
| ErrorMessage | エラーメッセージです。<br /> **タイプ**: `std::string` <br />**必須:** いいえ  | 

## 列挙型
<a name="integration-server-sdk5-cpp-dataypes-enums"></a>

サーバー SDK for Amazon GameLift Servers (C\+\+) で定義されている列挙体は、次のとおりです。

**GameLiftErrorType**  
エラータイプを示す文字列値。有効な値を次に示します。  
+ **BAD\_REQUEST\_EXCEPTION** 
+ **GAMESESSION\_ID\_NOT\_SET** - ゲームセッション ID が設定されていません。
+ **INTERNAL\_SERVICE\_EXCEPTION** 
+ **LOCAL\_CONNECTION\_FAILED** - Amazon GameLift Serversへのローカル接続に失敗しました。
+ **NETWORK\_NOT\_INITIALIZED** - ネットワークは初期化されていません。
+ **SERVICE\_CALL\_FAILED** – AWS サービスへの呼び出しに失敗しました。
+ **WEBSOCKET\_CONNECT\_FAILURE** 
+ **WEBSOCKET\_CONNECT\_FAILURE\_FORBIDDEN** 
+ **WEBSOCKET\_CONNECT\_FAILURE\_INVALID\_URL** 
+ **WEBSOCKET\_CONNECT\_FAILURE\_TIMEOUT** 
+ **ALREADY\_INITIALIZED** - Amazon GameLift Servers サーバーまたはクライアントはすでに Initialize() で初期化されています。
+ **FLEET\_MISMATCH** - ターゲットフリートが gameSession または playerSession のフリートと一致しません。
+ **GAMELIFT\_CLIENT\_NOT\_INITIALIZED** - Amazon GameLift Servers クライアントは初期化されていません。
+ **GAMELIFT\_SERVER\_NOT\_INITIALIZED** - Amazon GameLift Servers クライアントは初期化されていません。
+ **GAME\_SESSION\_ENDED\_FAILED** - サーバー SDK for Amazon GameLift Servers はサービスにアクセスしてゲームセッションが終了したことを報告できませんでした。
+ **GAME\_SESSION\_NOT\_READY** - Amazon GameLift Servers サーバーのゲームセッションがアクティブ化されませんでした。
+ **GAME\_SESSION\_READY\_FAILED** - サーバー SDK for Amazon GameLift Servers は、サービスにアクセスしてゲームセッションの準備が完了したことを報告できませんでした。
+ **INITIALIZATION\_MISMATCH** - Server:: Initialize() の後にクライアントメソッドが呼び出されました。その逆も同様です。
+ **NOT\_INITIALIZED** - Amazon GameLift Servers サーバーまたはクライアントは Initialize() で初期化されていません。
+ **NO\_TARGET\_ALIASID\_SET** - ターゲットの aliasId が設定されていません。
+ **NO\_TARGET\_FLEET\_SET** - ターゲットフリートが設定されていません。
+ **PROCESS\_ENDING\_FAILED** - サーバー SDK for Amazon GameLift Servers はサービスにアクセスしてプロセスの終了を報告できませんでした。
+ **PROCESS\_NOT\_ACTIVE** - サーバープロセスはまだアクティブではなく、GameSession にバインドされていないため、PlayerSessions を受け入れたり処理したりすることはできません。
+ **PROCESS\_NOT\_READY** - サーバープロセスをまだアクティブ化する準備ができていません。
+ **PROCESS\_READY\_FAILED** - サーバー SDK for Amazon GameLift Servers はサービスにアクセスしてプロセスの準備が完了したことを報告できませんでした。
+ **SDK\_VERSION\_DETECTION\_FAILED** - SDK バージョン検出に失敗しました。
+ **STX\_CALL\_FAILED** - XStx サーバーのバックエンドコンポーネントへの呼び出しが失敗しました。
+ **STX\_INITIALIZATION\_FAILED** - XStx サーバーのバックエンドコンポーネントが初期化に失敗しました。
+ **UNEXPECTED\_PLAYER\_SESSION** - 未登録のプレイヤーセッションがサーバーによって検出されました。
+ **WEBSOCKET\_CONNECT\_FAILURE** 
+ **WEBSOCKET\_CONNECT\_FAILURE\_FORBIDDEN** 
+ **WEBSOCKET\_CONNECT\_FAILURE\_INVALID\_URL** 
+ **WEBSOCKET\_CONNECT\_FAILURE\_TIMEOUT** 
+ **WEBSOCKET\_RETRIABLE\_SEND\_MESSAGE\_FAILURE** - GameLift Service WebSocket にメッセージを送信する際に再試行可能な障害が発生しました。
+ **WEBSOCKET\_SEND\_MESSAGE\_FAILURE** - GameLift Service WebSocket へのメッセージの送信に失敗しました。
+ **MATCH\_BACKFILL\_REQUEST\_VALIDATION** - リクエストの検証に失敗しました。
+ **PLAYER\_SESSION\_REQUEST\_VALIDATION** - リクエストの検証に失敗しました。

**PlayerSessionCreationPolicy**  
ゲームセッションで新しいプレイヤーを承諾するかどうかを示す文字列値。有効な値を次に示します。  
+ **ACCEPT\_ALL** - すべての新しいプレイヤーセッションを承諾します。
+ **DENY\_ALL** - すべての新しいプレイヤーセッションを拒否します。
+ **NOT\_SET** - ゲームセッションは、新規プレイヤーセッションを受け入れたり拒否したりするように設定されていません。