本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 適用於 -- 資料類型的 C\+\+ (Unreal) 伺服器 SDK Amazon GameLift Servers 5.x
<a name="integration-server-sdk5-unreal-datatypes"></a>

使用 Amazon GameLift Servers Unreal 伺服器 SDK 5.x 參考，協助您準備多玩家遊戲以搭配 使用。 Amazon GameLift Servers如需整合程序的詳細資訊，請參閱 [使用伺服器 SDK 將 Amazon GameLift Servers新增至您的遊戲伺服器](gamelift-sdk-server-api.md)。如果您使用的是 Unreal 的 Amazon GameLift Servers 外掛程式，另請參閱 [Amazon GameLift Servers Unreal Engine 的外掛程式](unreal-plugin.md)。

**注意**  
本主題說明您可以在為 Unreal Engine 建置時使用的 Amazon GameLift Servers C\+\+ API。具體而言，本文件適用於您使用 `-DBUILD_FOR_UNREAL=1`選項編譯的程式碼。

[適用於 -- 動作的 C\+\+ (Unreal) 伺服器 SDK Amazon GameLift Servers 5.x](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)
+ [FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)
+ [列舉](#integration-server-sdk5-unreal-dataypes-enums)

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

此資料類型包含傳送至 Amazon GameLift Servers的一組參數[ProcessReady()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-processready)。


|  |  | 
| --- |--- |
| **屬性** | Description | 
| LogParameters | 具有在遊戲工作階段期間產生之檔案目錄路徑的物件。 會Amazon GameLift Servers複製和存放檔案以供日後存取。**Type (類型)**：`TArray<FString>`<br />**必要**：否 | 
| OnHealthCheck | Amazon GameLift Servers 呼叫 從伺服器程序請求運作狀態報告的回呼函數。 每 60 秒會Amazon GameLift Servers呼叫此函數，並等待 60 秒進行回應。FALSE 如果運作狀態TRUE良好，伺服器程序會傳回 。如果未傳回任何回應， 會將伺服器程序Amazon GameLift Servers記錄為運作狀態不佳。此屬性是定義為 的委派函數`DECLARE_DELEGATE_RetVal(bool, FOnHealthCheck)`；<br /> **Type (類型)**：`FOnHealthCheck`<br />**必要**：否 | 
| OnProcessTerminate | Amazon GameLift Servers 呼叫 以強制伺服器程序關閉的回呼函數。呼叫此函數後， 會Amazon GameLift Servers等待 5 分鐘讓伺服器程序關閉，並在關閉伺服器程序之前回應[ProcessEnding()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-processending)呼叫。**Type (類型)**：`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 />**Type (類型)**：`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 />**Type (類型)**：`FOnUpdateGameSession`<br />**必要**：否 | 
| 站點 | 伺服器程序接聽新玩家連線的連接埠號碼。值必須屬於為部署此遊戲伺服器組建之機群所設定的連接埠範圍。此連接埠號碼包含在遊戲工作階段和遊戲工作階段物件中，遊戲工作階段會使用該物件來連接到伺服器程序。**Type (類型)**：`int`<br />**必要**：是 | 

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

此資料類型會更新至遊戲工作階段物件，其中包括遊戲工作階段已更新的原因，以及如果回填用於填入遊戲工作階段中的玩家工作階段，則相關的回填票證 ID。


| Properties | **Description** | 
| --- | --- | 
| GameSession | [GameSession](#integration-server-sdk5-unreal-dataypes-gamesession) 物件。GameSession 物件包含描述遊戲工作階段的屬性。**Type (類型)**：`Aws::GameLift::Server::GameSession`<br />**必要**：否 | 
| UpdateReason | 正在更新遊戲工作階段的原因。**Type (類型)**：`enum class UpdateReason`[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/gameliftservers/latest/developerguide/integration-server-sdk5-unreal-datatypes.html)<br />**必要**：否  | 
| BackfillTicketId | 嘗試更新遊戲工作階段的回填票證 ID。**Type (類型)**：`char[]`<br />**必要**：否 | 

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

此資料類型提供遊戲工作階段的詳細資訊。


| Properties | **Description** | 
| --- | --- | 
| GameSessionId | 遊戲工作階段的唯一識別符。遊戲工作階段 ARN 的格式如下：`arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>`。<br />**Type (類型)**：`char[]`<br />**必要**：否 | 
| 名稱 | 遊戲工作階段的描述性標籤。<br />**Type (類型)**：`char[]`<br />**必要**：否 | 
| FleetId | 遊戲工作階段執行所在的機群的唯一識別符。<br />**Type (類型)**：`char[]`<br />**必要**：否 | 
| MaximumPlayerSessionCount | 遊戲工作階段的玩家連線數目上限。<br />**Type (類型)**：`int`<br />**必要**：否 | 
| 站點 | 遊戲工作階段的連接埠號碼。若要連線到Amazon GameLift Servers遊戲伺服器，應用程式需要 IP 地址和連接埠號碼。<br />**Type (類型)**：`int`<br />**必要**：否 | 
| IpAddress | 遊戲工作階段的 IP 地址。若要連線到Amazon GameLift Servers遊戲伺服器，應用程式需要 IP 地址和連接埠號碼。<br />**Type (類型)**：`char[]`<br />**必要**：否 | 
| GameSessionData | 一組自訂遊戲工作階段屬性，格式為單一字串值。<br />**Type (類型)**：`char[]`<br />**必要**：否 | 
| MatchmakerData | 用於建立遊戲工作階段的配對程序資訊，以 JSON 語法格式化為字串。除了使用的配對組態之外，還包含指派給配對的所有玩家的資料，包括玩家屬性和團隊指派。<br />**Type (類型)**：`char[]`<br />**必要**：否 | 
| GameProperties | 一組遊戲工作階段的自訂屬性，格式為 key：value 對。這些屬性會與啟動新遊戲工作階段的請求一起傳遞。<br />**Type (類型)**：`GameProperty[]`<br />**必要**：否 | 
| DnsName | 指派給執行遊戲工作階段之執行個體的 DNS 識別符。值的格式如下：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/gameliftservers/latest/developerguide/integration-server-sdk5-unreal-datatypes.html)<br />連線至在啟用 TLS 的機群上執行的遊戲工作階段時，您必須使用 DNS 名稱，而不是 IP 地址。<br />**Type (類型)**：`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 | **Description** | 
| --- | --- | 
| webSocketUrl | 當您[https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)使用 Amazon GameLift Servers Anywhere 運算資源時， 會`GameLiftServerSdkEndpoint`Amazon GameLift Servers傳回 。<br />**Type (類型)**：`char[]`<br />**必要**：是  | 
| processId | 向託管遊戲的伺服器程序註冊的唯一識別符。<br />**Type (類型)**：`char[]`<br />**必要**：是 | 
| hostId | HostID 是當您註冊運算ComputeName時使用的 。如需詳細資訊，請參閱 [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)。**Type (類型)**：`char[]`<br />**必要**：是 | 
| fleetId | 運算註冊目的地機群的唯一識別符。如需詳細資訊，請參閱 [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)。**Type (類型)**：`char[]`<br />**必要**：是 | 
| authToken | 產生的身分驗證字符Amazon GameLift Servers，用於向 驗證您的伺服器Amazon GameLift Servers。如需詳細資訊，請參閱 [GetComputeAuthToken](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_GetComputeAuthToken.html)。**Type (類型)**：`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 | **Description** | 
| --- | --- | 
| GameSessionArn | 唯一的遊戲工作階段識別符。API 操作會以 ARN 格式`[GetGameSessionId](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk5-unreal-actions.html#integration-server-sdk5-unreal-getgamesessionid)`傳回識別符。<br />**Type (類型)**：`char[]`<br />**必要**：是 | 
| MatchmakingConfigurationArn | 配對建構器用於此請求的唯一識別符，格式為 ARN。原始遊戲工作階段的配對建構器 ARN 位於配對建構器資料屬性中的遊戲工作階段物件中。進一步了解使用配對建構器資料中的[配對建構器資料](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-server.html#match-server-data.html)。<br />**Type (類型)**：`char[]`<br />**必要**：是 | 
| Players | 一組資料，代表遊戲工作階段中的所有玩家。配對建構器使用此項資訊搜尋適合配對現有玩家的新玩家。<br />**Type (類型)**：`TArray<FPlayer>`<br />**必要**：是 | 
| TicketId | 配對或配對回填請求票證的唯一識別符。如果您不提供值， Amazon GameLift Servers會產生值。您可使用此識別項依據需求追蹤配對回填票證狀態或取消要求。<br />**Type (類型)**：`char[]`<br />**必要**：否 | 

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

此資料類型代表配對中的玩家。啟動配對請求時，玩家會有玩家 ID、屬性和可能的延遲資料。 會在配對完成後Amazon GameLift Servers新增隊伍資訊。


| Properties | **Description** | 
| --- | --- | 
| LatencyInMS | 一組以毫秒為單位的值，指出玩家連線到某個位置時所經歷的延遲量。<br />如果使用此屬性，則玩家只會符合列出的位置。若配對構建器有評估玩家延遲的規則，玩家則必須回報延遲度，方可配對。<br />**Type (類型)**：`TMap>FString, int32<`<br />**必要**：否 | 
| PlayerAttributes | 金鑰：值對的集合，其中包含用於配對的玩家資訊。玩家屬性金鑰必須符合配對規則集中使用的 PlayerAttributes。<br />如需玩家屬性的詳細資訊，請參閱 [AttributeValue](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_AttributeValue.html)。<br />**Type (類型)**：`TMap>FString, FAttributeValue<`<br />**必要**：否 | 
| PlayerId | 玩家的唯一識別符。<br />**Type (類型)**：`std::string`<br />**必要**：否 | 
| 團隊 | 玩家在配對中獲指派的隊伍名稱。您可以在配對規則集中定義團隊名稱。<br />**Type (類型)**：`FString`<br />**必要**：否 | 

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

指定要擷取哪些玩家工作階段的物件。伺服器程序會在[DescribePlayerSessions()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-describeplayersessions)呼叫 時提供此資訊Amazon GameLift Servers。


| Properties | **Description** | 
| --- | --- | 
| GameSessionId | 唯一的遊戲工作階段識別符。請使用此參數要求特定遊戲工作階段的所有玩家工作階段。<br />遊戲工作階段 ID 格式為 `FString`。`GameSessionID` 是自訂 ID 字串或<br />**Type (類型)**：`std::string`<br />**必要**：否 | 
| PlayerSessionId | 玩家工作階段的唯一識別符。使用此參數請求單一特定玩家工作階段。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| PlayerId | 玩家的唯一識別符。使用此參數來請求特定玩家的所有玩家工作階段。請參閱 [產生玩家 IDs](player-sessions-player-identifiers.md)。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| PlayerSessionStatusFilter | 要篩選結果的玩家工作階段狀態。可能的玩家工作階段狀態包括：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/gameliftservers/latest/developerguide/integration-server-sdk5-unreal-datatypes.html)<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| NextToken | 表示結果下一頁開始的字符。若要指定結果集的開頭，請不要提供值。如果您提供玩家工作階段 ID，則會忽略此參數。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| 限制 | 回傳結果的數量上限。如果您提供玩家工作階段 ID，則會忽略此參數。<br />**Type (類型)**：`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 | **Description** | 
| --- | --- | 
| GameSessionArn | 取消請求的唯一遊戲工作階段識別符。<br />**Type (類型)**：`FString`<br />**必要**：是 | 
| MatchmakingConfigurationArn | 此請求傳送到的配對建構器的唯一識別符。<br />**Type (類型)**：`FString`<br />**必要**：是 | 
| TicketId | 要取消之回填請求票證的唯一識別符。<br />**Type (類型)**：`FString`<br />**必要**：是 | 

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

在[FPlayer](#integration-server-sdk5-unreal-dataypes-player)屬性鍵/值對中使用這些值。此物件可讓您使用任何有效的資料類型來指定屬性值：字串、數字、字串陣列或資料映射。每個`AttributeValue`物件只能使用其中一個可用的屬性。


| Properties | Description | 
| --- | --- | 
| attrType | 指定屬性值的類型。<br />**類型：**`FAttributeType`[列舉](#integration-server-sdk5-unreal-dataypes-enums)值。<br />**必要**：否 | 
| S | 代表字串屬性值。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| N | 代表數值屬性值。<br />**Type (類型)**：`double`<br />**必要**：否 | 
| SL | 代表字串屬性值的陣列。<br />**Type (類型)**：`TArray<FString>`<br />**必要**：否 | 
| SDM | 代表字串索引鍵和雙值的字典。<br />**Type (類型)**：`TMap<FString, double>`<br />**必要**：否 | 

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

此資料類型提供角色登入資料，可將 資源 AWS 的有限存取權延伸到遊戲伺服器。如需詳細資訊，請參閱 [設定 的 IAM 服務角色 Amazon GameLift Servers](setting-up-role.md)。


| Properties | **Description** | 
| --- | --- | 
| RoleArn | 服務角色的 Amazon Resource Name (ARN)，可延伸 AWS 資源的有限存取權。**Type (類型)**：`FString`<br />**必要**：否 | 
| RoleSessionName | 描述使用角色登入資料的工作階段名稱。**Type (類型)**：`FString`<br />**必要**：否 | 

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

此資料類型來自 動作，並產生具有下列屬性的物件：


| Properties | Description | 
| --- | --- | 
| 結果 | 動作的結果。<br />**Type (類型)**：`long`<br />**必要**：否 | 
| ResultWithOwnership |  動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。<br />**Type (類型)**：`long&&`<br />**必要**：否 | 
| 成功 | 動作是否成功。<br />**Type (類型)**：`bool`<br />**必要**：是 | 
| 錯誤 | 動作失敗時發生的錯誤。<br />**Type (類型)**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必要**：否 | 

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

此資料類型來自 動作，並產生具有下列屬性的物件：


| Properties | Description | 
| --- | --- | 
| 結果 | 動作的結果。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| ResultWithOwnership |  動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。<br />**Type (類型)**：`FString&&`<br />**必要**：否 | 
| 成功 | 動作是否成功。<br />**Type (類型)**：`bool`<br />**必要**：是 | 
| 錯誤 | 動作失敗時發生的錯誤。<br />**Type (類型)**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必要**：否 | 

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

此資料類型來自 動作，並產生具有下列屬性的物件：


| Properties | Description | 
| --- | --- | 
| 結果 | 動作的結果。<br />**Type (類型)**：[FGameLiftDescribePlayerSessionsResult](#integration-server-sdk5-unreal-dataypes-describeplayersessionresult)<br />**必要**：否  | 
| ResultWithOwnership |  動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。<br />**Type (類型)**：`FGameLiftDescribePlayerSessionsResult&&`<br />**必要**：否 | 
| 成功 | 動作是否成功。<br />**Type (類型)**：`bool`<br />**必要**：是 | 
| 錯誤 | 動作失敗時發生的錯誤。<br />**Type (類型)**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必要**：否 | 

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


| Properties | Description | 
| --- | --- | 
| PlayerSessions | <br />**Type (類型)**：`TArray<FGameLiftPlayerSession>`<br />**必要**：是 | 
| NextToken | 表示結果下一頁開始的字符。若要指定結果集的開頭，請不要提供值。如果您提供玩家工作階段 ID，則會忽略此參數。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| 成功 | 動作是否成功。<br />**Type (類型)**：`bool`<br />**必要**：是 | 
| 錯誤 | 動作失敗時發生的錯誤。<br />**Type (類型)**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必要**：否 | 

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

此資料類型來自 動作，並產生具有下列屬性的物件：


| Properties | Description | 
| --- | --- | 
| 成功 | 動作是否成功。<br />**Type (類型)**：`bool`<br />**必要**：是 | 
| 錯誤 | 動作失敗時發生的錯誤。<br />**Type (類型)**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必要**：否 | 

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


| Properties | Description | 
| --- | --- | 
| CreationTime | **Type (類型)**：`long`<br />**必要**：是 | 
| FleetId | **Type (類型)**：`FString`<br />**必要**：是 | 
| GameSessionId | **Type (類型)**：`FString`<br />**必要**：是 | 
| IpAddress | **Type (類型)**：`FString`<br />**必要**：是 | 
| PlayerData | **Type (類型)**：`FString`<br />**必要**：是 | 
| PlayerId | **Type (類型)**：`FString`<br />**必要**：是 | 
| PlayerSessionId | **Type (類型)**：`FString`<br />**必要**：是 | 
| 站點 | **Type (類型)**：`int`<br />**必要**：是 | 
| 狀態 | **類型：**`PlayerSessionStatus`[列舉](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-enums)。<br />**必要**：是 | 
| TerminationTime | **Type (類型)**：`long`<br />**必要**：是 | 
| DnsName | **Type (類型)**：`FString`<br />**必要**：是 | 

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

此資料類型來自 動作，並產生具有下列屬性的物件：


| Properties | Description | 
| --- | --- | 
| 結果 | 動作的結果。<br />**Type (類型)**：[FGameLiftGetComputeCertificateResult](#integration-server-sdk5-unreal-dataypes-getcomputecertificateresult)<br />**必要**：否  | 
| ResultWithOwnership |  動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。<br />**Type (類型)**：`FGameLiftGetComputeCertificateResult&&`<br />**必要**：否 | 
| 成功 | 動作是否成功。<br />**Type (類型)**：`bool`<br />**必要**：是 | 
| 錯誤 | 動作失敗時發生的錯誤。<br />**Type (類型)**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必要**：否 | 

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

運算上 TLS 憑證的路徑和運算的主機名稱。


| Properties | Description | 
| --- | --- | 
| CertificatePath | **Type (類型)**：`FString`<br />**必要**：是 | 
| ComputeName | **Type (類型)**：`FString`<br />**必要**：是 | 

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

此資料類型來自 動作，並產生具有下列屬性的物件：


| Properties | Description | 
| --- | --- | 
| 結果 | 動作的結果。<br />**Type (類型)**：[FGetFleetRoleCredentialsResult](#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsresult)<br />**必要**：否  | 
| ResultWithOwnership |  動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。<br />**Type (類型)**：`FGameLiftGetFleetRoleCredentialsResult&&`<br />**必要**：否 | 
| 成功 | 動作是否成功。<br />**Type (類型)**：`bool`<br />**必要**：是 | 
| 錯誤 | 動作失敗時發生的錯誤。<br />**Type (類型)**：[FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)<br />**必要**：否 | 

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


| Properties | Description | 
| --- | --- | 
| AccessKeyId | 要驗證並提供 AWS 資源存取權的存取金鑰 ID。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| AssumedRoleId | 服務角色所屬的使用者 ID。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| AssumedRoleUserArn | 服務角色所屬使用者的 Amazon Resource Name (ARN)。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| Expiration | 工作階段登入資料過期前的時間長度。<br />**Type (類型)**：`FDateTime`<br />**必要**：否 | 
| SecretAccessKey | 用於身分驗證的私密存取金鑰 ID。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| SessionToken | 識別目前作用中工作階段與 AWS 資源互動的字符。<br />**Type (類型)**：`FString`<br />**必要**：否 | 
| 成功 | 動作是否成功。<br />**Type (類型)**：`bool`<br />**必要**：是 | 
| 錯誤 | 動作失敗時發生的錯誤。<br />**Type (類型)**：[GameLiftError](integration-server-sdk5-csharp-datatypes.md#integration-server-sdk5-csharp-datatypes-gamelifterror)<br />**必要**：否 | 

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


| Properties | Description | 
| --- | --- | 
| ErrorType | 錯誤類型。<br />**類型：**`GameLiftErrorType`[列舉](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-enums)。<br />**必要**：否  | 
| ErrorName | 錯誤的名稱。<br /> **Type (類型)**：`std::string`<br />**必要**：否  | 
| ErrorMessage | 錯誤訊息。<br /> **Type (類型)**：`std::string`<br />**必要**：否  | 

## 列舉
<a name="integration-server-sdk5-unreal-dataypes-enums"></a>

為適用於 Amazon GameLift Servers（非真實） 的伺服器 SDK 定義的列舉定義如下：

**FAttributeType**  
+ **NONE**
+ **STRING**
+ **雙倍**
+ **STRING\_LIST**
+ **STRING\_DOUBLE\_MAP**

**GameLiftErrorType**  
指出錯誤類型的字串值。有效值包含：  
+ **SERVICE\_CALL\_FAILED** – 呼叫 AWS 服務失敗。
+ **LOCAL\_CONNECTION\_FAILED** – 與 的本機連線Amazon GameLift Servers失敗。
+ **NETWORK\_NOT\_INITIALIZED** – 網路尚未初始化。
+ **GAMESESSION\_ID\_NOT\_SET** – 尚未設定遊戲工作階段 ID。
+ **BAD\_REQUEST\_EXCEPTION** 
+ **INTERNAL\_SERVICE\_EXCEPTION** 
+ **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無法聯絡 服務以報告遊戲工作階段已結束。
+ **GAME\_SESSION\_NOT\_READY** – Amazon GameLift Servers 伺服器遊戲工作階段未啟用。
+ **GAME\_SESSION\_READY\_FAILED** – 的伺服器 SDK 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 Amazon GameLift Servers 無法聯絡 服務來報告程序即將結束。
+ **PROCESS\_NOT\_ACTIVE** – 伺服器程序尚未啟動、未繫結至 GameSession，且無法接受或處理 PlayerSessions。
+ **PROCESS\_NOT\_READY** – 伺服器程序尚未準備好啟用。
+ **PROCESS\_READY\_FAILED** – 的伺服器 SDK 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** – 驗證請求失敗。

**EPlayerSessionCreationPolicy**  
字串值代表遊戲工作階段是否可接受新玩家。有效值包含：  
+ **ACCEPT\_ALL** – 接受所有新玩家工作階段。
+ **DENY\_ALL** – 拒絕所有新玩家工作階段。
+ **NOT\_SET** – 遊戲工作階段未設定為接受或拒絕新的玩家工作階段。

**EPlayerSessionStatus**  
+ **ACTIVE**
+ **COMPLETED (已完成)**
+ **NOT\_SET**
+ **RESERVED**
+ **逾時**