適用於 -- 資料類型的 C++ 伺服器 SDK Amazon GameLift Servers 5.x - Amazon GameLift Servers
LogParametersProcessParametersUpdateGameSessionGameSessionServerParametersStartMatchBackfillRequestPlayerDescribePlayerSessionsRequestStopMatchBackfillRequestAttributeValueGetFleetRoleCredentialsRequestAwsLongOutcomeAwsStringOutcomeDescribePlayerSessionsOutcomeDescribePlayerSessionsResultGenericOutcomeGenericOutcomeCallablePlayerSessionStartMatchBackfillOutcomeStartMatchBackfillResultGetComputeCertificateOutcomeGetComputeCertificateResultGetFleetRoleCredentialsOutcomeGetFleetRoleCredentialsResultInitSDKOutcomeGameLiftError列舉

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

適用於 -- 資料類型的 C++ 伺服器 SDK Amazon GameLift Servers 5.x

使用 Amazon GameLift Servers C++ 伺服器 SDK 5.x 參考來整合多玩家遊戲，以便與 進行託管。 Amazon GameLift Servers如需整合程序的指引，請參閱 Amazon GameLift Servers 新增至您的遊戲伺服器。

注意

本主題說明使用 Amazon GameLift Servers C++ 標準程式庫 () 建置時可以使用的 C++ APIstd。具體而言，本文件適用於您使用 -DDGAMELIFT_USE_STD=1選項編譯的程式碼。

適用於 -- 動作的 C++ 伺服器 SDK Amazon GameLift Servers 5.x

LogParameters

識別在遊戲工作階段期間產生的檔案的物件，Amazon GameLift Servers您想要在遊戲工作階段結束後上傳和存放。遊戲伺服器會將 Amazon GameLift Servers做為ProcessReady()呼叫中ProcessParameters物件的一部分LogParameters提供給 。

屬性

 Description
LogPaths

Amazon GameLift Servers 您要存放以供日後存取的遊戲伺服器日誌檔案的目錄路徑清單。伺服器程序會在每個遊戲工作階段期間產生這些檔案。您可以在遊戲伺服器中定義檔案路徑和名稱，並將其存放在根遊戲建置目錄中。

日誌路徑必須是絕對的。例如，如果您的遊戲組建將遊戲工作階段日誌儲存在類似 的路徑中MyGame\sessionLogs\，則路徑會位於 Windows 執行個體c:\game\MyGame\sessionLogs上。

Type (類型)：std:vector<std::string>

必要：否

ProcessParameters

此資料類型包含傳送至 Amazon GameLift Servers的一組參數ProcessReady()。

屬性

 Description
LogParameters 具有在遊戲工作階段期間產生之檔案目錄路徑的物件。 會Amazon GameLift Servers複製和存放檔案以供日後存取。

Type (類型)：Aws::GameLift::Server::LogParameters

必要：否
OnHealthCheck Amazon GameLift Servers 呼叫 從伺服器程序請求運作狀態報告的回呼函數。 每 60 秒會Amazon GameLift Servers呼叫此函數，並等待 60 秒進行回應。FALSE 如果運作狀態TRUE不良，伺服器程序會傳回 。如果未傳回任何回應， 會將伺服器程序Amazon GameLift Servers記錄為運作狀態不佳。

Type (類型)：std::function<bool()> onHealthCheck

必要：否
OnProcessTerminate Amazon GameLift Servers 呼叫 以強制伺服器程序關閉的回呼函數。呼叫此函數後， 會Amazon GameLift Servers等待 5 分鐘讓伺服器程序關閉，並在關閉伺服器程序之前回應ProcessEnding()呼叫。

Type (類型)：std::function<void()> onProcessTerminate

必要：是
OnStartGameSession Amazon GameLift Servers 叫用以啟用新遊戲工作階段的回呼函數。 會Amazon GameLift Servers呼叫此函數以回應用戶端請求 CreateGameSession。回呼函數會傳遞GameSession物件。

Type (類型)：const std::function<void(Aws::GameLift::Model::GameSession)> onStartGameSession

必要：是
OnUpdateGameSession Amazon GameLift Servers 呼叫 以將更新後的遊戲工作階段物件傳遞至伺服器程序的回呼函數。 會在處理配對回填請求時Amazon GameLift Servers呼叫此函數，以提供更新後的配對建構器資料。它會傳遞GameSession物件、狀態更新 (updateReason) 和相符回填票證 ID。

Type (類型)：std::function<void(Aws::GameLift::Server::Model::UpdateGameSession)> onUpdateGameSession

必要：否
連線埠 伺服器程序接聽新玩家連線的連接埠號碼。值必須屬於為部署此遊戲伺服器組建之機群所設定的連接埠範圍。此連接埠號碼包含在遊戲工作階段和遊戲工作階段物件中，遊戲工作階段會使用該物件來連接到伺服器程序。

Type (類型)：Integer

必要：是

UpdateGameSession

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

屬性 Description
GameSession GameSession 物件。GameSession 物件包含描述遊戲工作階段的屬性。

Type (類型)：Aws::GameLift::Server::GameSession

必要：是
UpdateReason 正在更新遊戲工作階段的原因。

Type (類型)：Aws::GameLift::Server::UpdateReason

必要：是
BackfillTicketId 嘗試更新遊戲工作階段的回填票證 ID。

Type (類型)：std::string

必要：否

GameSession

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

屬性 Description
GameSessionId

遊戲工作階段的唯一識別符。遊戲工作階段 ARN 的格式如下：arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>。

Type (類型)：std::string

必要：否
名稱

遊戲工作階段的描述性標籤。

Type (類型)：std::string

必要：否
FleetId

遊戲工作階段執行所在的機群的唯一識別符。

Type (類型)：std::string

必要：否
MaximumPlayerSessionCount

遊戲工作階段的玩家連線數目上限。

Type (類型)：int

必要：否
連線埠

遊戲工作階段的連接埠號碼。若要連線到Amazon GameLift Servers遊戲伺服器，應用程式需要 IP 地址和連接埠號碼。

Type (類型)：in

必要：否
IpAddress

遊戲工作階段的 IP 地址。若要連線到Amazon GameLift Servers遊戲伺服器，應用程式需要 IP 地址和連接埠號碼。

Type (類型)：std::string

必要：否
GameSessionData

一組自訂遊戲工作階段屬性，格式為單一字串值。

Type (類型)：std::string

必要：否
MatchmakerData

用於建立遊戲工作階段的配對程序資訊，以 JSON 語法格式為字串。除了使用的配對組態之外，還包含指派給配對的所有玩家的資料，包括玩家屬性和團隊指派。

Type (類型)：std::string

必要：否
GameProperties

一組遊戲工作階段的自訂屬性，格式為 key：value 對。這些屬性會與啟動新遊戲工作階段的請求一起傳遞。

Type (類型)：std :: vector < GameProperty >

必要：否
DnsName

指派給執行遊戲工作階段之執行個體的 DNS 識別符。值的格式如下：

  • 啟用 TLS 的機群：<unique identifier>.<region identifier>.amazongamelift.com。

  • Non-TLS-enabled 的機群：ec2-<unique identifier>.compute.amazonaws.com。

連線至在啟用 TLS 的機群上執行的遊戲工作階段時，您必須使用 DNS 名稱，而非 IP 地址。

Type (類型)：std::string

必要：否

ServerParameters

遊戲伺服器程序用來建立與服務連線的資訊Amazon GameLift Servers。InitSDK() 只有在遊戲伺服器建置將部署到沒有 Amazon GameLift Servers代理程式的 Anywhere 機群或容器機群時，才呼叫時包含這些參數。對於所有其他部署案例，請呼叫 InitSDK()而不使用參數。

屬性 Description
webSocketUrl

當您RegisterCompute使用 Amazon GameLift ServersAnywhere 運算資源時， 會GameLiftServerSdkEndpointAmazon GameLift Servers傳回 。

Type (類型)：std::string

必要：是

processId

向託管遊戲的伺服器程序註冊的唯一識別符。

Type (類型)：std::string

必要：是
hostId HostID 是當您註冊運算ComputeName時使用的 。如需詳細資訊，請參閱 RegisterCompute。

Type (類型)：std::string

必要：是
fleetId 運算註冊目的地機群的唯一識別符。如需詳細資訊，請參閱 RegisterCompute。

Type (類型)：std::string

必要：是
authToken 產生的身分驗證字符Amazon GameLift Servers，用於向 驗證您的伺服器Amazon GameLift Servers。如需詳細資訊，請參閱 GetComputeAuthToken。

Type (類型)：std::string

必要：是

StartMatchBackfillRequest

用來建立配對回填請求的資訊。遊戲伺服器會在StartMatchBackfill()通話Amazon GameLift Servers中將此資訊傳達給 。

屬性 Description
GameSessionArn

唯一的遊戲工作階段識別符。API 操作會以 ARN 格式GetGameSessionId傳回識別符。

Type (類型)：std::string

必要：是
MatchmakingConfigurationArn

配對建構器用於此請求的唯一識別符，格式為 ARN。原始遊戲工作階段的配對建構器 ARN 位於配對建構器資料屬性中的遊戲工作階段物件中。進一步了解使用配對建構器資料中的配對建構器資料。

Type (類型)：std::string

必要：是
Players

一組資料，代表遊戲工作階段中的所有玩家。配對建構器使用此項資訊搜尋適合配對現有玩家的新玩家。

Type (類型)：std::vector<Player>

必要：是
TicketId

配對或配對回填請求票證的唯一識別符。如果您不提供值， Amazon GameLift Servers會產生值。您可使用此識別項依據需求追蹤配對回填票證狀態或取消要求。

Type (類型)：std::string

必要：否

Player

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

屬性 Description
LatencyInMS

一組以毫秒為單位的值，指出玩家連線到位置時所經歷的延遲量。

如果使用此屬性，則播放器只會符合列出的位置。若配對構建器有評估玩家延遲的規則，玩家則必須回報延遲度，方可配對。

Type (類型)：Dictionary<string,int>

必要：否
PlayerAttributes

包含玩家資訊的金鑰：值對集合，可用於配對。玩家屬性金鑰必須符合配對規則集中使用的 PlayerAttributes。

如需玩家屬性的詳細資訊，請參閱 AttributeValue。

Type (類型)：std::map<std::string,AttributeValue>

必要：否
PlayerId

玩家的唯一識別符。

Type (類型)：std::string

必要：否
團隊

玩家在配對中獲指派的隊伍名稱。您可以在配對規則集中定義團隊名稱。

Type (類型)：std::string

必要：否

DescribePlayerSessionsRequest

指定要擷取哪些玩家工作階段的物件。伺服器程序會在DescribePlayerSessions()呼叫 時提供此資訊Amazon GameLift Servers。

屬性 Description
GameSessionId

唯一的遊戲工作階段識別符。請使用此參數要求特定遊戲工作階段的所有玩家工作階段。

遊戲工作階段 ID 格式為 arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>。GameSessionID 是自訂 ID 字串或

Type (類型)：std::string

必要：否
PlayerSessionId

玩家工作階段的唯一識別符。使用此參數請求單一特定玩家工作階段。

Type (類型)：std::string

必要：否
PlayerId

玩家的唯一識別符。使用此參數來請求特定玩家的所有玩家工作階段。請參閱 產生玩家 IDs。

Type (類型)：std::string

必要：否
PlayerSessionStatusFilter

要篩選結果的玩家工作階段狀態。可能的玩家工作階段狀態包括：

  • RESERVED – 已收到玩家工作階段請求，但玩家尚未連線到伺服器程序或已經過驗證。

  • ACTIVE – 播放器已由伺服器程序驗證並連線。

  • 已完成 – 玩家連線中斷。

  • TIMEDOUT – 已收到玩家工作階段請求，但玩家未連線或未在逾時限制 (60 秒） 內驗證。

Type (類型)：std::string

必要：否
NextToken

表示結果下一頁開始的字符。若要指定結果集的開頭，請不要提供值。如果您提供玩家工作階段 ID，則會忽略此參數。

Type (類型)：std::string

必要：否
限制

回傳結果的數量上限。如果您提供玩家工作階段 ID，則會忽略此參數。

Type (類型)：int

必要：否

StopMatchBackfillRequest

用來取消配對回填請求的資訊。遊戲伺服器會在StopMatchBackfill()通話中將此資訊傳達給 Amazon GameLift Servers 服務。

屬性 Description
GameSessionArn

取消請求的唯一遊戲工作階段識別符。

Type (類型)：char[]

必要：否
MatchmakingConfigurationArn

此請求傳送至之配對建構器的唯一識別符。

Type (類型)：char[]

必要：否
TicketId

要取消之回填請求票證的唯一識別符。

Type (類型)：char[]

必要：否

AttributeValue

在Player屬性鍵值對中使用這些值。此物件可讓您使用任何有效的資料類型來指定屬性值：字串、數字、字串陣列或資料映射。每個AttributeValue物件必須完全使用其中一個可用的屬性：S、SL、 N或 SDM。

屬性 描述
AttrType

指定屬性值的類型。可能的屬性值類型包括：

  • NONE

  • STRING

  • DOUBLE

  • STRING_LIST

  • STRING_DOUBLE_MAP

必要：否
S

代表字串屬性值。

Type (類型)：std::string

必要：否
N

代表數值屬性值。

Type (類型)：double

必要：否
SL

代表字串屬性值的陣列。

Type (類型)：std::vector<std::string>

必要：否
SDM

代表字串索引鍵和雙值的字典。

Type (類型)：std::map<std::string, double>

必要：否

GetFleetRoleCredentialsRequest

此資料類型可讓遊戲伺服器有限地存取您的其他 AWS 資源。如需詳細資訊，請參閱 設定 的 IAM 服務角色 Amazon GameLift Servers。

屬性 Description
RoleArn 服務角色的 Amazon Resource Name (ARN)，可延伸 AWS 資源的有限存取權。

Type (類型)：std::string

必要：否
RoleSessionName 角色工作階段名稱，可用來唯一識別 AWS Security Token Service AssumeRole 工作階段。此名稱會在稽核日誌中公開，例如 CloudTrail 中的稽核日誌。

Type (類型)：std::string

必要：否

AwsLongOutcome

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

屬性 描述
結果

動作的結果。

Type (類型)：long

必要：否
ResultWithOwnership

動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。

Type (類型)：long&&

必要：否
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

AwsStringOutcome

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

屬性 描述
結果

動作的結果。

Type (類型)：std::string

必要：否
ResultWithOwnership

動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。

Type (類型)：long&&

必要：否
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

DescribePlayerSessionsOutcome

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

屬性 描述
結果

動作的結果。

Type (類型)：DescribePlayerSessionsResult

必要：否

ResultWithOwnership

動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。

Type (類型)：Aws::GameLift::Server::Model::DescribePlayerSessionsResult&&

必要：否
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

DescribePlayerSessionsResult

包含符合請求之每個玩家工作階段屬性的物件集合。

屬性 描述
NextToken

表示結果下一個序列頁面開始的字符。使用先前呼叫此操作時傳回的字符。若要從結果集的開頭開始，請勿指定值。若指定玩家工作階段 ID，此參數將遭到忽略。

Type (類型)：std::string

必要：是
PlayerSessions

Type (類型)：IList<PlayerSession>

必要：
ResultWithOwnership

動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。

Type (類型)：std::string&&

必要：否
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

GenericOutcome

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

屬性 描述
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

GenericOutcomeCallable

此資料類型是非同步的一般結果。它具有下列屬性：

屬性 描述
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

PlayerSession

此資料類型代表Amazon GameLift Servers傳遞至遊戲伺服器的玩家工作階段。如需詳細資訊，請參閱 PlayerSession。

屬性 描述
CreationTime

Type (類型)：long

必要：否
FleetId

Type (類型)：std::string

必要：否
GameSessionId

Type (類型)：std::string

必要：否
IpAddress

Type (類型)：std::string

必要：否
PlayerData

Type (類型)：std::string

必要：否
PlayerId

Type (類型)：std::string

必要：否
PlayerSessionId

Type (類型)：std::string

必要：否
連線埠

Type (類型)：int

必要：否
Status

用於篩選結果的玩家工作階段狀態。提供 PlayerSessionId 或 PlayerId 時，則 PlayerSessionStatusFilter 不會影響回應。

類型：PlayerSessionStatus列舉。可能的值包括以下：

  • ACTIVE

  • COMPLETED (已完成)

  • NOT_SET

  • RESERVED

  • 逾時

必要：否
TerminationTime

Type (類型)：long

必要：否
DnsName

Type (類型)：std::string

必要：否

StartMatchBackfillOutcome

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

屬性 描述
結果

動作的結果。

Type (類型)：StartMatchBackfillResult

必要：否
ResultWithOwnership

動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。

Type (類型)：StartMatchBackfillResult&&

必要：否
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

StartMatchBackfillResult

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

屬性 描述
TicketId

配對票證的唯一識別符。如果此處未指定票證 ID， Amazon GameLift Servers將以 UUID 的形式產生票證 ID。使用此識別符來追蹤配對回填票證狀態，並擷取配對結果。

Type (類型)：std::string

必要：否

GetComputeCertificateOutcome

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

屬性 描述
結果

動作的結果。

Type (類型)：GetComputeCertificateResult

必要：否

ResultWithOwnership

動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。

Type (類型)：Aws::GameLift::Server::Model::GetComputeCertificateResult&&

必要：否
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

GetComputeCertificateResult

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

屬性 描述
CertificatePath

運算資源上 TLS 憑證的路徑。使用 Amazon GameLift Servers受管機群時，此路徑包含：

  • certificate.pem：最終使用者憑證。完整的憑證鏈是certificateChain.pem附加到此憑證的 組合。

  • certificateChain.pem：包含根憑證和中繼憑證的憑證鏈。

  • rootCertificate.pem：根憑證。

  • privateKey.pem：最終使用者憑證的私有金鑰。

Type (類型)：std::string

必要：否
ComputeName

運算資源的名稱。

Type (類型)：std::string

必要：否

GetFleetRoleCredentialsOutcome

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

屬性 描述
結果

動作的結果。

Type (類型)：GetFleetRoleCredentialsResult

必要：否

ResultWithOwnership

動作的結果會轉換為 rvalue，以便呼叫程式碼可以取得物件的擁有權。

Type (類型)：Aws::GameLift::Server::Model::GetFleetRoleCredentialsResult

必要：否
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

GetFleetRoleCredentialsResult

屬性 描述
AccessKeyId

驗證和提供 AWS 資源存取權的存取金鑰 ID。

Type (類型)：string

必要：否
AssumedRoleId

服務角色所屬的使用者 ID。

Type (類型)：string

必要：否
AssumedRoleUserArn

服務角色所屬使用者的 Amazon Resource Name (ARN)。

Type (類型)：string

必要：否
過期

工作階段登入資料過期前的時間長度。

Type (類型)：DateTime

必要：否
SecretAccessKey

用於身分驗證的私密存取金鑰 ID。

Type (類型)：string

必要：否
SessionToken

識別目前作用中工作階段與 AWS 資源互動的字符。

Type (類型)：string

必要：否
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

InitSDKOutcome

注意

InitSDKOutcome 只有在您使用 std旗標建置 SDK 時，才會傳回 。如果您使用 nostd旗標建置 ，GenericOutcome則會改為傳回 。

屬性 描述
成功

動作是否成功。

Type (類型)：bool

必要：是
錯誤

動作失敗時發生的錯誤。

Type (類型)：GameLiftError

必要：否

GameLiftError

屬性 描述
ErrorType

錯誤類型。

類型：GameLiftErrorType列舉。

必要：否

ErrorName

錯誤的名稱。

Type (類型)：std::string

必要：否

ErrorMessage

錯誤訊息。

Type (類型)：std::string

必要：否

列舉

為適用於 Amazon GameLift Servers(C++) 的伺服器 SDK 定義的列舉定義如下：

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 – 的 伺服器開發套件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 – 驗證請求失敗。

PlayerSessionCreationPolicy

字串值代表遊戲工作階段是否可接受新玩家。有效值包含：

  • ACCEPT_ALL – 接受所有新玩家工作階段。

  • DENY_ALL – 拒絕所有新玩家工作階段。

  • NOT_SET – 遊戲工作階段未設定為接受或拒絕新的玩家工作階段。