本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# C\+\+（虚幻）服务器 SDK 5.x 适用于 亚马逊 GameLift 服务器 --数据类型
<a name="integration-server-sdk5-unreal-datatypes"></a>

使用 Amazon GameLift Servers Unreal 服务器 SDK 5.x 参考，帮助您为多人游戏准备好与 Amazon GameLift Servers 配合使用。有关集成过程的详细信息，请参阅[添加 亚马逊 GameLift 服务器 使用服务器 SDK 到您的游戏服务器](gamelift-sdk-server-api.md)。如果您使用的是适用于 Unreal 的 Amazon GameLift Servers 插件，还可以参阅[亚马逊 GameLift 服务器 虚幻引擎插件](unreal-plugin.md)。

**注意**  
本主题介绍在为 Unreal Engine 构建时可以使用的 Amazon GameLift Servers C\+\+ API。具体而言，本文档适用于使用该`-DBUILD_FOR_UNREAL=1`选项编译的代码。

[C\+\+（虚幻）服务器 SDK 5.x 适用于 亚马逊 GameLift 服务器 --动作](integration-server-sdk5-unreal-actions.md)

**Topics**
+ [FProcessParameters](#integration-server-sdk5-unreal-dataypes-process)
+ [UpdateGameSession](#integration-server-sdk5-unreal-dataypes-updategamesession)
+ [GameSession](#integration-server-sdk5-unreal-dataypes-gamesession)
+ [FServerParameters](#integration-server-sdk5-unreal-dataypes-serverparameters)
+ [FStartMatchBackfillRequest](#integration-server-sdk5-unreal-dataypes-startmatchbackfillrequest)
+ [fPlayer](#integration-server-sdk5-unreal-dataypes-player)
+ [FGameLiftDescribePlayerSessionsRequest](#integration-server-sdk5-unreal-dataypes-playersessions)
+ [FStopMatchBackfillRequest](#integration-server-sdk5-unreal-dataypes-stopmatchbackfillrequest)
+ [FAttributeValue](#integration-server-sdk5-unreal-dataypes-attributevalue)
+ [FGameLiftGetFleetRoleCredentialsRequest](#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsrequest)
+ [FGameLiftLongOutcome](#integration-server-sdk5-unreal-dataypes-awslongoutcome)
+ [FGameLiftStringOutcome](#integration-server-sdk5-unreal-dataypes-awsstringoutcome)
+ [FGameLiftDescribePlayerSessionsOutcome](#integration-server-sdk5-unreal-dataypes-describeplayersessionsoutcome)
+ [FGameLiftDescribePlayerSessionsResult](#integration-server-sdk5-unreal-dataypes-describeplayersessionresult)
+ [FGenericOutcome](#integration-server-sdk5-unreal-dataypes-genericoutcome)
+ [FGameLiftPlayerSession](#integration-server-sdk5-unreal-dataypes-playersession)
+ [FGameLiftGetComputeCertificateOutcome](#integration-server-sdk5-unreal-dataypes-getcomputecertificateoutcome)
+ [FGameLiftGetComputeCertificateResult](#integration-server-sdk5-unreal-dataypes-getcomputecertificateresult)
+ [FGameLiftGetFleetRoleCredentialsOutcome](#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsoutcome)
+ [FGetFleetRoleCredentialsResult](#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsresult)
+ [FGameLiftListContainersNetworkInfoOutcome](#integration-server-sdk5-unreal-dataypes-listcontainersnetworkinfooutcome)
+ [FGameLiftListContainersNetworkInfoResult](#integration-server-sdk5-unreal-dataypes-listcontainersnetworkinforesult)
+ [FContainerNetworkInfo](#integration-server-sdk5-unreal-dataypes-containernetworkinfo)
+ [FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)
+ [枚举](#integration-server-sdk5-unreal-dataypes-enums)

## FProcessParameters
<a name="integration-server-sdk5-unreal-dataypes-process"></a>

此数据类型包含一组在 [ProcessReady()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-processready) 中发送到 Amazon GameLift Servers 的参数。


|  |  | 
| --- |--- |
| **属性** | 描述 | 
| LogParameters | 一个对象，其中包含游戏会话期间生成的文件的目录路径。Amazon GameLift Servers 会复制并存储这些文件，以便将来访问。**类型**：`TArray<FString>`<br />**必需**：否 | 
| OnHealthCheck | Amazon GameLift Servers 为向服务器进程请求运行状况报告而调用的回调函数。Amazon GameLift Servers 每隔 60 秒调用此函数一次，并等待 60 秒以获取响应。TRUE如果运行状况良好，则服务器进程会返回，FALSE如果不健康，则返回。如果没有返回任何响应，Amazon GameLift Servers 会将服务器进程记录为运行状况不佳。此属性是一个委托函数，定义为`DECLARE_DELEGATE_RetVal(bool, FOnHealthCheck)`;<br /> **类型**：`FOnHealthCheck`<br />**必需**：否 | 
| OnProcessTerminate | Amazon GameLift Servers 为强制关闭服务器进程而调用的回调函数。调用此函数之后，Amazon GameLift Servers 会等待 5 分钟，以确保服务器进程关闭并通过 [ProcessEnding()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-processending) 调用作出响应，随后才会终止该服务器进程。**类型**：`FSimpleDelegate`<br />**是否必需**：是 | 
| OnStartGameSession | 调Amazon GameLift Servers用以激活新游戏会话的回调函数。Amazon GameLift Servers调用此函数以响应客户请求[CreateGameSession](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_CreateGameSession.html)。回调函数将传递一个 [GameSession](#integration-server-sdk5-unreal-dataypes-gamesession) 对象。此属性是一个委托函数，定义为 `DECLARE_DELEGATE_OneParam(FOnStartGameSession, Aws::GameLift::Server::Model::GameSession);` <br />**类型**：`FOnStartGameSession`<br />**是否必需**：是 | 
| OnUpdateGameSession | Amazon GameLift Servers 为向服务器进程传递更新的游戏会话对象而调用的回调函数。当对战回填请求处理完毕时，Amazon GameLift Servers 会调用此函数以提供更新的对战构建器数据。它将传递一个 [GameSession](#integration-server-sdk5-unreal-dataypes-gamesession) 对象、一个状态更新（updateReason）以及对战回填票证 ID。此属性是一个委托函数，定义为 `DECLARE_DELEGATE_OneParam(FOnUpdateGameSession, Aws::GameLift::Server::Model::UpdateGameSession);`<br />**类型**：`FOnUpdateGameSession`<br />**必需**：否 | 
| 端口： | 服务器进程用于侦听新玩家连接的端口号。该值必须在部署此游戏服务器构建的任意实例集上所配置的端口范围内。此端口号包含在游戏会话和玩家会话对象中，游戏会话在连接到服务器进程时会使用该端口号。**类型**：`int`<br />**是否必需**：是 | 

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

此数据类型更新为游戏会话对象，其中包括更新游戏会话的原因以及相关的回填票证 ID（如果使用回填来填充游戏会话中的玩家会话）。


| Properties | **描述** | 
| --- | --- | 
| GameSession | 一个 [GameSession](#integration-server-sdk5-unreal-dataypes-gamesession) 对象。该GameSession对象包含描述游戏会话的属性。**类型**：`Aws::GameLift::Server::GameSession`<br />**必需**：否 | 
| UpdateReason | 更新游戏会话的原因。**类型**：`enum class UpdateReason`+ 对战数据已更新<br />+ 回填失败<br />+ BACKFILL\_TIMED\_OUT<br />+ 回填已取消<br />**必需**：否  | 
| BackfillTicketId | 尝试更新游戏会话的回填票证的 ID。**类型**：`char[]`<br />**必需**：否 | 

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

此数据类型提供游戏会话的详细信息。


| Properties | **描述** | 
| --- | --- | 
| GameSessionId | 会话的唯一标识符。游戏会话ARN具有以下格式:. `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>` <br />**类型**：`char[]`<br />**必需**：否 | 
| Name | 游戏会话的描述性标签。<br />**类型**：`char[]`<br />**必需**：否 | 
| FleetId | 运行游戏会话的集的唯一标识符。<br />**类型**：`char[]`<br />**必需**：否 | 
| MaximumPlayerSessionCount |  机群中已连接到游戏会话的玩家数量。<br />**类型**：`int`<br />**必需**：否 | 
| 端口： | 游戏会话的端口号。要连接到Amazon GameLift Servers游戏服务器，应用程序需要 IP 地址和端口号。<br />**类型**：`int`<br />**必需**：否 | 
| IpAddress | 游戏会话的 IP 地址。要连接到Amazon GameLift Servers游戏服务器，应用程序需要 IP 地址和端口号。<br />**类型**：`char[]`<br />**必需**：否 | 
| GameSessionData | 一组自定义游戏会话属性，采用单个字符串值格式。<br />**类型**：`char[]`<br />**必需**：否 | 
| MatchmakerData | 有关用于创建游戏会话的对战过程的信息，采用 JSON 语法，格式为字符串。除了使用的对战配置外，它还包含分配到对战的所有玩家的数据，包括玩家属性和队伍分配。<br />**类型**：`char[]`<br />**必需**：否 | 
| GameProperties | 游戏会话的一组自定义属性，采用键值对格式。这些属性将通过启动新游戏会话的请求传递到游戏服务器进程。<br />**类型**：`GameProperty[]`<br />**必需**：否 | 
| DnsName | 分配给正在运行游戏会话的实例的 DNS 标识符。CRL 采用以下格式：+  TLS-enabled 舰队：`<unique identifier>.<region identifier>.amazongamelift.com`。 <br />+  Non-TLS-enabled 舰队：`ec2-<unique identifier>.compute.amazonaws.com`。 <br />连接到在 TLS-enabled舰队上运行的游戏会话时，必须使用 DNS 名称，而不是 IP 地址。<br />**类型**：`char[]`<br />**必需**：否 | 

## FServerParameters
<a name="integration-server-sdk5-unreal-dataypes-serverparameters"></a>

用于维护 Amazon GameLift Servers Anywhere 服务器与 Amazon GameLift Servers 服务之间连接的信息。使用启动新的服务器进程时会使用此信息[InitSDK()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-initsdk)。对于托管在 Amazon GameLift Servers 托管式 EC2 实例上的服务器，请使用空对象。


| Properties | **描述** | 
| --- | --- | 
| 网页 SocketUrl | 当您为 Amazon GameLift Servers Anywhere 计算资源调用 [`RegisterCompute`](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html) 时，`GameLiftServerSdkEndpoint` Amazon GameLift Servers 会返回结果。<br />**类型**：`char[]`<br />**是否必需**：是  | 
| ProcessID | 注册到托管游戏的服务器进程的唯一标识符。<br />**类型**：`char[]`<br />**是否必需**：是 | 
| hostId | HostID是在您注册计算机时ComputeName使用的。有关更多信息，请参阅[RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)。**类型**：`char[]`<br />**是否必需**：是 | 
| FleetId | 计算注册到的实例集的唯一标识符。有关更多信息，请参阅[RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)。**类型**：`char[]`<br />**是否必需**：是 | 
| AuthToken | 由 Amazon GameLift Servers 生成的身份验证令牌，用于向 Amazon GameLift Servers 对您的服务器进行身份验证。有关更多信息，请参阅[GetComputeAuthToken](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_GetComputeAuthToken.html)。**类型**：`char[]`<br />**是否必需**：是 | 

## FStartMatchBackfillRequest
<a name="integration-server-sdk5-unreal-dataypes-startmatchbackfillrequest"></a>

用于创建对战回填请求的信息。游戏服务器通过调用 [StartMatchBackfill()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-startmatchbackfill) 将这些信息传达给 Amazon GameLift Servers。


| Properties | **描述** | 
| --- | --- | 
| GameSessionArn | 游戏会话的唯一标识符。此 API 操作 `[GetGameSessionId](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk5-unreal-actions.html#integration-server-sdk5-unreal-getgamesessionid)` 返回采用 ARN 格式的标识符。<br />**类型**：`char[]`<br />**是否必需**：是 | 
| MatchmakingConfigurationArn | 采用 ARN 格式的唯一标识符，适用于用于此请求的对战构建器。要查找用于创建原始游戏会话的对战构建器，请查看对战构建器数据属性中的游戏会话对象。在[使用对战构建器数据](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-server.html#match-server-data.html)中了解有关对战构建器数据的更多信息。<br />**类型**：`char[]`<br />**是否必需**：是 | 
| 玩家 | 一组表示当前正在游戏会话中的所有玩家的数据。对战构建器使用此信息搜索与当前玩家非常匹配的新玩家。<br />**类型**：`TArray<FPlayer>`<br />**是否必需**：是 | 
| TicketId | 对战或匹配回填请求票证的唯一标识符。如果不提供值，Amazon GameLift Servers 会生成值。使用此标识符可跟踪对战回填票证状态或取消请求（如需要）。<br />**类型**：`char[]`<br />**必需**：否 | 

## fPlayer
<a name="integration-server-sdk5-unreal-dataypes-player"></a>

此数据类型代表对战中的玩家。启动对战请求时，玩家会有玩家 ID、属性数据以及可能的延迟数据。对战结束后，Amazon GameLift Servers 会添加团队信息。


| Properties | **描述** | 
| --- | --- | 
| LatencyInMS | 一组以毫秒为单位的值，表示玩家在连接到某个位置时所经历的延迟量。<br />如果使用此属性，则仅匹配列出的位置的玩家。如果对战构建器具有评估玩家延迟的规则，玩家必须报告延迟才能进行匹配。<br />**类型**：`TMap>FString, int32<`<br />**必需**：否 | 
| PlayerAttributes | 键/值对的集合，其中包含用于对战的玩家信息。玩家的属性键必须与配对规则集中 PlayerAttributes 使用的属性键相匹配。<br />有关玩家属性的更多信息，请参阅[AttributeValue](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_AttributeValue.html)。<br />**类型**：`TMap>FString, FAttributeValue<`<br />**必需**：否 | 
| PlayerId | 玩家的唯一标识符。<br />**类型**：`std::string`<br />**必需**：否 | 
| Team | 玩家在对战中被分配到的团队的名称。在对战规则集中定义团队名称。<br />**类型**：`FString`<br />**必需**：否 | 

## FGameLiftDescribePlayerSessionsRequest
<a name="integration-server-sdk5-unreal-dataypes-playersessions"></a>

一个对象，用于指定要检索哪些玩家会话。服务器进程通过向 Amazon GameLift Servers 调用 [DescribePlayerSessions()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-describeplayersessions) 来提供此信息。


| Properties | **描述** | 
| --- | --- | 
| GameSessionId | 游戏会话的唯一标识符。使用此参数可请求指定游戏会话的所有玩家会话。<br />游戏会话 ID 的格式为`FString`。`GameSessionID`是自定义 ID 字符串或<br />**类型**：`std::string`<br />**必需**：否 | 
| PlayerSessionId | 玩家会话的唯一标识符。使用此参数请求单个特定的玩家会话。<br />**类型**：`FString`<br />**必需**：否 | 
| PlayerId |  玩家的唯一标识符。使用此参数可请求指定游戏会话的所有玩家会话。请参阅[生成玩家 ID](player-sessions-player-identifiers.md)。<br />**类型**：`FString`<br />**必需**：否 | 
| PlayerSessionStatusFilter | 用于筛选结果的玩家会话状态。可能的玩家会话状态包括以下内容：+  RESERVED - 已收到玩家会话请求，但玩家尚未连接到服务器进程和/或进行验证。 <br />+  ACTIVE - 服务器进程已验证玩家，当前已连接。 <br />+  COMPLETED - 玩家连接已断开。 <br />+  TIMEDOUT - 收到了玩家会话请求，但玩家未连接和/或在超时限制 (60 秒) 内验证。 <br />**类型**：`FString`<br />**必需**：否 | 
| NextToken | 令牌指示结果的下一个连续页面的开头。要指定结果集的开始，请不要指定值。如果指定玩家会话 ID，将忽略此参数。<br />**类型**：`FString`<br />**必需**：否 | 
| 限制 | 要返回的最大结果数量。如果指定玩家会话 ID，将忽略此参数。<br />**类型**：`int`<br />**必需**：否 | 

## FStopMatchBackfillRequest
<a name="integration-server-sdk5-unreal-dataypes-stopmatchbackfillrequest"></a>

用于取消对战回填请求的信息。游戏服务器通过调用 [StopMatchBackfill()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-stopmatchbackfill) 将此信息传达给 Amazon GameLift Servers 服务。


| Properties | **描述** | 
| --- | --- | 
| GameSessionArn | 与被取消的请求关联的唯一游戏会话标识符。<br />**类型**：`FString`<br />**是否必需**：是 | 
| MatchmakingConfigurationArn | 此请求发送到的对战构建器的唯一标识符。<br />**类型**：`FString`<br />**是否必需**：是 | 
| TicketId | 要取消的回填请求票证的唯一标识符。<br />**类型**：`FString`<br />**是否必需**：是 | 

## FAttributeValue
<a name="integration-server-sdk5-unreal-dataypes-attributevalue"></a>

在[fPlayer](#integration-server-sdk5-unreal-dataypes-player)属性密钥-值对中使用。此对象允许您使用任何有效的数据类型来指定属性值：字符串、数字、字符串数组或数据映射。每个`AttributeValue`对象只能使用一个可用属性。


| Properties | 说明 | 
| --- | --- | 
| 属性类型 | 指定属性值的类型。<br />**类型：**一个 `FAttributeType` [枚举](#integration-server-sdk5-unreal-dataypes-enums)值。<br />**必需**：否 | 
| S | 表示字符串属性值。<br />**类型**：`FString`<br />**必需**：否 | 
| N | 表示属性值。<br />**类型**：`double`<br />**必需**：否 | 
| sl | 表示字符串属性值的数组。<br />**类型**：`TArray<FString>`<br />**必需**：否 | 
| SDM | 表示字符串键和双精度值的字典。<br />**类型**：`TMap<FString, double>`<br />**必需**：否 | 

## FGameLiftGetFleetRoleCredentialsRequest
<a name="integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsrequest"></a>

此数据类型提供角色凭证，可将对 AWS 资源的有限访问权限扩展到游戏服务器。有关更多信息，请参阅[为 Amazon GameLift Servers 设置 IAM 服务角色](setting-up-role.md)。


| Properties | **描述** | 
| --- | --- | 
| RoleArn | 服务角色的亚马逊资源名称 (ARN)，用于扩展对您的 AWS 资源的有限访问权限。**类型**：`FString`<br />**必需**：否 | 
| RoleSessionName | 描述角色证书使用情况的会话名称。**类型**：`FString`<br />**必需**：否 | 

## FGameLiftLongOutcome
<a name="integration-server-sdk5-unreal-dataypes-awslongoutcome"></a>

此数据类型由操作生成，并生成具有以下属性的对象：


| Properties | 说明 | 
| --- | --- | 
| 结果 | 操作的结果。<br />**类型**：`long`<br />**必需**：否 | 
| ResultWithOwnership |  操作的结果，转换为右值，以便调用代码可以拥有该对象的所有权。<br />**类型**：`long&&`<br />**必需**：否 | 
| 成功 | 操作是否成功。<br />**类型**：`bool`<br />**是否必需**：是 | 
| 错误 | 操作失败时发生的错误。<br />**类型**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必需**：否 | 

## FGameLiftStringOutcome
<a name="integration-server-sdk5-unreal-dataypes-awsstringoutcome"></a>

此数据类型由操作生成，并生成具有以下属性的对象：


| Properties | 说明 | 
| --- | --- | 
| 结果 | 操作的结果。<br />**类型**：`FString`<br />**必需**：否 | 
| ResultWithOwnership |  操作的结果，转换为右值，以便调用代码可以拥有该对象的所有权。<br />**类型**：`FString&&`<br />**必需**：否 | 
| 成功 | 操作是否成功。<br />**类型**：`bool`<br />**是否必需**：是 | 
| 错误 | 操作失败时发生的错误。<br />**类型**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必需**：否 | 

## FGameLiftDescribePlayerSessionsOutcome
<a name="integration-server-sdk5-unreal-dataypes-describeplayersessionsoutcome"></a>

此数据类型由操作生成，并生成具有以下属性的对象：


| Properties | 说明 | 
| --- | --- | 
| 结果 | 操作的结果。<br />**类型**：[FGameLiftDescribePlayerSessionsResult](#integration-server-sdk5-unreal-dataypes-describeplayersessionresult)<br />**必需**：否  | 
| ResultWithOwnership |  操作的结果，转换为右值，以便调用代码可以拥有该对象的所有权。<br />**类型**：`FGameLiftDescribePlayerSessionsResult&&`<br />**必需**：否 | 
| 成功 | 操作是否成功。<br />**类型**：`bool`<br />**是否必需**：是 | 
| 错误 | 操作失败时发生的错误。<br />**类型**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必需**：否 | 

## FGameLiftDescribePlayerSessionsResult
<a name="integration-server-sdk5-unreal-dataypes-describeplayersessionresult"></a>


| Properties | 说明 | 
| --- | --- | 
| PlayerSessions | <br />**类型**：`TArray<FGameLiftPlayerSession>`<br />**是否必需**：是 | 
| NextToken | 令牌指示结果的下一个连续页面的开头。要指定结果集的开始，请不要指定值。如果指定玩家会话 ID，将忽略此参数。<br />**类型**：`FString`<br />**必需**：否 | 
| 成功 | 操作是否成功。<br />**类型**：`bool`<br />**是否必需**：是 | 
| 错误 | 操作失败时发生的错误。<br />**类型**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必需**：否 | 

## FGenericOutcome
<a name="integration-server-sdk5-unreal-dataypes-genericoutcome"></a>

此数据类型由操作生成，并生成具有以下属性的对象：


| Properties | 说明 | 
| --- | --- | 
| 成功 | 操作是否成功。<br />**类型**：`bool`<br />**是否必需**：是 | 
| 错误 | 操作失败时发生的错误。<br />**类型**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必需**：否 | 

## FGameLiftPlayerSession
<a name="integration-server-sdk5-unreal-dataypes-playersession"></a>


| Properties | 说明 | 
| --- | --- | 
| CreationTime | **类型**：`long`<br />**是否必需**：是 | 
| FleetId | **类型**：`FString`<br />**是否必需**：是 | 
| GameSessionId | **类型**：`FString`<br />**是否必需**：是 | 
| IpAddress | **类型**：`FString`<br />**是否必需**：是 | 
| PlayerData | **类型**：`FString`<br />**是否必需**：是 | 
| PlayerId | **类型**：`FString`<br />**是否必需**：是 | 
| PlayerSessionId | **类型**：`FString`<br />**是否必需**：是 | 
| 端口： | **类型**：`int`<br />**是否必需**：是 | 
| Status | **类型：`PlayerSessionStatus`**[枚举](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-enums)。<br />**是否必需**：是 | 
| TerminationTime | **类型**：`long`<br />**是否必需**：是 | 
| DnsName | **类型**：`FString`<br />**是否必需**：是 | 

## FGameLiftGetComputeCertificateOutcome
<a name="integration-server-sdk5-unreal-dataypes-getcomputecertificateoutcome"></a>

此数据类型由操作生成，并生成具有以下属性的对象：


| Properties | 说明 | 
| --- | --- | 
| 结果 | 操作的结果。<br />**类型**：[FGameLiftGetComputeCertificateResult](#integration-server-sdk5-unreal-dataypes-getcomputecertificateresult)<br />**必需**：否  | 
| ResultWithOwnership |  操作的结果，转换为右值，以便调用代码可以拥有该对象的所有权。<br />**类型**：`FGameLiftGetComputeCertificateResult&&`<br />**必需**：否 | 
| 成功 | 操作是否成功。<br />**类型**：`bool`<br />**是否必需**：是 | 
| 错误 | 操作失败时发生的错误。<br />**类型**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必需**：否 | 

## FGameLiftGetComputeCertificateResult
<a name="integration-server-sdk5-unreal-dataypes-getcomputecertificateresult"></a>

计算机上 TLS 证书的路径和计算机的主机名。


| Properties | 说明 | 
| --- | --- | 
| CertificatePath | **类型**：`FString`<br />**是否必需**：是 | 
| ComputeName | **类型**：`FString`<br />**是否必需**：是 | 

## FGameLiftGetFleetRoleCredentialsOutcome
<a name="integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsoutcome"></a>

此数据类型由操作生成，并生成具有以下属性的对象：


| Properties | 说明 | 
| --- | --- | 
| 结果 | 操作的结果。<br />**类型**：[FGetFleetRoleCredentialsResult](#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsresult)<br />**必需**：否  | 
| ResultWithOwnership |  操作的结果，转换为右值，以便调用代码可以拥有该对象的所有权。<br />**类型**：`FGameLiftGetFleetRoleCredentialsResult&&`<br />**必需**：否 | 
| 成功 | 操作是否成功。<br />**类型**：`bool`<br />**是否必需**：是 | 
| 错误 | 操作失败时发生的错误。<br />**类型**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必需**：否 | 

## FGetFleetRoleCredentialsResult
<a name="integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsresult"></a>


| Properties | 说明 | 
| --- | --- | 
| AccessKeyId | 用于对您的 AWS 资源进行身份验证和提供访问权限的访问密钥 ID。<br />**类型**：`FString`<br />**必需**：否 | 
| AssumedRoleId | 服务角色所属的用户 ID。<br />**类型**：`FString`<br />**必需**：否 | 
| AssumedRoleUserArn | 用户应承担的角色的 Amazon 资源名称 (ARN)。<br />**类型**：`FString`<br />**必需**：否 | 
| 过期 | 您的会话凭证到期之前的时间。<br />**类型**：`FDateTime`<br />**必需**：否 | 
| SecretAccessKey | 指定 S3 验证的访问密钥 ID。<br />**类型**：`FString`<br />**必需**：否 | 
| SessionToken | 用于识别当前与您的 AWS 资源交互的活跃会话的令牌。<br />**类型**：`FString`<br />**必需**：否 | 
| 成功 | 操作是否成功。<br />**类型**：`bool`<br />**是否必需**：是 | 
| 错误 | 操作失败时发生的错误。<br />**类型**：[GameLiftError](integration-server-sdk5-csharp-datatypes.md#integration-server-sdk5-csharp-datatypes-gamelifterror)<br />**必需**：否 | 

## FGameLiftListContainersNetworkInfoOutcome
<a name="integration-server-sdk5-unreal-dataypes-listcontainersnetworkinfooutcome"></a>

此数据类型由操作生成，并生成具有以下属性的对象：


| Properties | 说明 | 
| --- | --- | 
| 结果 | 操作的结果。<br />**类型**：[FGameLiftListContainersNetworkInfoResult](#integration-server-sdk5-unreal-dataypes-listcontainersnetworkinforesult)<br />**必需**：否  | 
| ResultWithOwnership |  操作的结果，转换为右值，以便调用代码可以拥有该对象的所有权。<br />**类型**：`FGameLiftListContainersNetworkInfoResult&&`<br />**必需**：否 | 
| 成功 | 操作是否成功。<br />**类型**：`bool`<br />**是否必需**：是 | 
| 错误 | 操作失败时发生的错误。<br />**类型**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必需**：否 | 

## FGameLiftListContainersNetworkInfoResult
<a name="integration-server-sdk5-unreal-dataypes-listcontainersnetworkinforesult"></a>

与调用游戏服务器进程在同一实例上运行的所有容器的网络信息。


| Properties | 说明 | 
| --- | --- | 
| ContainersNetworkInfo | 在实例上运行的每个容器的网络信息列表。<br />**类型**：`TArray<FContainerNetworkInfo>`<br />**必需**：否 | 

## FContainerNetworkInfo
<a name="integration-server-sdk5-unreal-dataypes-containernetworkinfo"></a>

在实例上运行的单个容器的网络信息。


| Properties | 说明 | 
| --- | --- | 
| ContainerName | 容器的名称，如容器组定义中所定义。<br />**类型**：`FString`<br />**必需**：否 | 
| ContainerId | 容器的唯一标识符。<br />**类型**：`FString`<br />**必需**：否 | 
| IpAddress | 容器在 Docker 桥接网络上的本地 IPv4 地址。<br />**类型**：`FString`<br />**必需**：否 | 
| ContainerGroupType | 容器所属的容器组的类型。<br />**类型：**`EContainerGroupType`[枚举](#integration-server-sdk5-unreal-dataypes-enums)。<br />**必需**：否 | 

## FGameLiftError
<a name="integration-server-sdk5-unreal-dataypes-gamelifterror"></a>


| Properties | 说明 | 
| --- | --- | 
| ErrorType | 错误的类型。<br />**类型：`GameLiftErrorType`**[枚举](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-enums)。<br />**必需**：否  | 
| ErrorName | 错误类型的名称。<br /> **类型**：`std::string`<br />**必需**：否  | 
| ErrorMessage | 错误消息。<br /> **类型**：`std::string`<br />**必需**：否  | 

## 枚举
<a name="integration-server-sdk5-unreal-dataypes-enums"></a>

为适用于 Amazon GameLift Servers（Unreal）的服务器 SDK 定义了以下枚举类型：

**FAttributeType**  
+ **NONE**
+ **string**
+ DOUBLE
+ **字符串列表**
+ **字符串\_DOUBLE\_MAP**

**GameLiftErrorType**  
表示错误类型的字符串值。有效值包括：  
+ **SERVICE\_CALL\_FAILED ** — 对服务的调用失败。 AWS 
+ **LOCAL\_CONNECTION\_FAILED** – 与 Amazon GameLift Servers 的本地连接失败。
+ **NETWORK\_NOT\_INITIALIZED – 网络尚未初始化**。
+ **GAMESESSION\_ID\_NOT\_SET – 尚未设置**游戏会话 ID。
+ **错误的请求\_异常** 
+ **内部服务异常** 
+ **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** – 适用于 Amazon GameLift Servers 的服务器 SDK 无法联系服务部门报告游戏会话已结束。
+ **GAME\_SESSION\_NOT\_READY** – Amazon GameLift Servers 服务器游戏会话未激活。
+ **GAME\_SESSION\_READY\_FAILED** – 适用于 Amazon GameLift Servers 的服务器 SDK 无法联系服务部门报告游戏会话已准备就绪。
+ INITI@@ **ALIZATION\_MISMATCH – 在 Server::In** itialization () 之后调用了客户端方法，反之亦然。
+ **NOT\_INITIALIZED** – Amazon GameLift Servers 服务器或客户端尚未使用 Initialize() 进行初始化。
+ **NO\_TARGET\_ALIASID\_SET – 尚未设置**目标 AliasID。
+ **NO\_TARGET\_FLEET\_SET – 尚未设置**目标实例集。
+ **PROCESS\_ENDING\_FAILED** – 适用于 Amazon GameLift Servers 的服务器 SDK 无法联系服务部门报告流程即将结束。
+ **PROCESS\_NOT\_ACTIVE ** — 服务器进程尚未激活，未绑定到 GameSession，无法接受或处理。 PlayerSessions
+ **PROCESS\_NOT\_READ** Y – 服务器进程尚未准备好激活。
+ **PROCESS\_READY\_FAILED** – 适用于 Amazon GameLift Servers 的服务器 SDK 无法联系服务部门报告流程已准备就绪。
+ **SDK\_VERSION\_DETECTION\_FAILED – 软件开发工具包 版本检测失败。**
+ **STX\_CALL\_FAILED – 对 xstX 服务器后端组件的调用失败**。
+ **STX\_INITIALIZATION\_FAILED – xSTX 服务器后端组件无法初始化**。
+ E@@ **XPRENTED\_PLAYER\_SESSION – 服务器遇到了未注册的玩家会话**。
+ **网络套接字连接失败** 
+ **禁止网络套接字连接失败** 
+ **WEBSOCKET\_CONNECT\_FAILURE\_INVALID\_UR** 
+ **WEBSOCKET\_CONNECT\_FAILURE\_** 
+ **WEBSOCKET\_RETRIABLE\_SEND\_MESSAGE\_FAILURE — 向服务发送消息失败可检索**失败。 GameLift WebSocket
+ **WEBSOCKET\_SEND\_MESSAGE\_FAILURE — 无法向服务发送消息**。 GameLift WebSocket
+ **MATCH\_BACKFILL\_REQUEST\_VALIDATION – 请求验证失败**。
+ **PLAYER\_SESSION\_REQUEST\_VALIDATION – 请求验证失败**。
+ **UNSUPPORTED\_COMPUTE\_TYPE\_EXCEPTION ** — 计算类型不支持调用的 API。

**EPlayerSessionCreationPolicy**  
用于指示游戏会话是否接受新玩家的字符串值。有效值包括：  
+ **ACCEPT\_ALL** - 接受所有新玩家会话。
+ **DENY\_ALL** - 拒绝所有新玩家会话。
+ **NOT\_SET** – 游戏会话未设置为接受或拒绝新玩家会话。

**EPlayerSessionStatus**  
+ ACTIVE (处于活动状态)
+ **COMPLETED**
+ **NOT\_SET**
+ 预留
+ 超时

**EContainerGroupType**  
容器所属的容器组的类型。有效值包括：  
+ **GAME\_SERVER ** — 游戏服务器副本容器组。一个实例可以运行多个游戏服务器容器组。
+ **PER\_INSTANCE ** — 每个实例的守护程序容器组。一个实例只能运行一个每个实例的容器组。