跳轉到主要內容
取得此端點在網路中的唯一識別碼。

語法

參數

uniqueIdentifier   uint16_t*
輸出
輸出的唯一識別碼。

傳回值

PartyError c_partyErrorSuccess (如果呼叫成功),否則為錯誤碼。可透過 PartyManager::GetErrorMessage() 擷取錯誤碼的人類可讀形式。

備註

此識別碼在端點的網路中是唯一的,並且在網路中的所有端點之間保持一致。它的用途是作為精簡的選項,讓遊戲在 PartyLocalEndpoint::SendMessage() 資料緩衝區中參考特定端點,而不會造成太多頻寬額外負荷,也不需要手動交涉識別碼。此識別碼在不同網路之間並非唯一。

對於本機端點,在 PartyManager::StartProcessingStateChanges() 提供 PartyEndpointCreatedStateChange 之前,此方法都會失敗。對於遠端端點,此方法一律會成功。

網路中的所有裝置對於指定端點的唯一識別碼都會一致,但不同的裝置在特定時間點不一定會看到相同的端點。例如,端點 A 可能會傳送訊息給端點 B,其中參考新建立之端點 C 的唯一識別碼,但 A 與 B 之間的該訊息可能會在端點 B 的裝置上產生端點 C 的 PartyEndpointCreatedStateChange 之前送達。

需求

標頭: Party.h

另請參閱

PartyEndpoint
PartyEndpointCreatedStateChange
PartyNetwork::FindEndpointByUniqueIdentifier
最後修改於 2026年10月8日