跳轉到主要內容
使用其他服務 (例如配對) 提供的安排字串加入大廳。如果尚無人加入大廳,則會使用設定參數初始化大廳。

語法

參數

handle   PFMultiplayerHandle PFMultiplayer API 執行個體的控制代碼。 newMember   PFEntityKey* 加入大廳的本機 PlayFab 實體。 arrangementString   char*
以 null 結尾
實體用於加入大廳的安排字串。 configuration   PFLobbyArrangedJoinConfiguration* 如果尚無人加入大廳,用於初始化大廳的初始設定資料。 asyncContext   void*
選用
選用的應用程式定義指標大小內容值,可用來將完成狀態變更與此呼叫建立關聯。 lobby   PFLobbyHandle*
選用,程式庫配置的輸出
選用的輸出大廳物件,可用於將作業排入佇列,以便在此作業完成時立即執行。

傳回值

類型:HRESULT 如果呼叫成功,則為 S_OK;否則為錯誤碼。可透過 PFMultiplayerGetErrorMessage() 擷取錯誤碼的人類可讀形式。

備註

這是一項非同步作業。成功完成時,遊戲會收到 PFLobbyMemberAddedStateChange,接著收到 PFLobbyJoinArrangedLobbyCompletedStateChange::result 欄位設定為 S_OK 的 PFLobbyJoinArrangedLobbyCompletedStateChange。 失敗完成時,遊戲會收到 PFLobbyJoinArrangedLobbyCompletedStateChange::result 欄位設定為失敗的 PFLobbyJoinArrangedLobbyCompletedStateChange。

透過此程式庫使用配對時,可以將 PFMatchmakingMatchDetails::lobbyArrangementString 與此方法搭配使用,與所有已配對在一起的使用者加入同一個大廳。

需求

標頭: PFLobby.h

另請參閱

PFLobby 成員
最後修改於 2026年10月8日