跳轉到主要內容
使用 Facebook 存取權杖讓使用者登入,並傳回工作階段識別碼,之後可用於需要已驗證使用者的 API 呼叫

語法

參數

serviceConfigHandle   PFServiceConfigHandle 從 PFServiceConfigCreateHandle 呼叫傳回的 PFServiceConfigHandle。 request   PFAuthenticationLoginWithFacebookRequest* 已填入的要求物件。 async   XAsyncBlock*
Inout
用於非同步作業的 XAsyncBlock。

傳回值

類型:HRESULT 此 API 作業的結果代碼。

備註

此 API 適用於 Android 和 iOS。Facebook 登入是使用 Facebook 使用者存取權杖 (User Access Token) 完成。如需權杖的詳細資訊,請參閱 Facebook 開發人員文件 (https://developers.facebook.com/docs/facebook-login/access-tokens/)。例如,在 Unity 中,權杖可透過 Facebook SDK ScriptableObject FB 中的 AccessToken 取得。如果這是使用者第一次使用 Facebook 帳戶登入,且 CreateAccount 設定為 true,將會建立新的 PlayFab 帳戶,並連結到所提供帳戶的 Facebook ID。在此情況下,不會有任何電子郵件或使用者名稱與 PlayFab 帳戶相關聯。否則,如果沒有任何 PlayFab 帳戶連結到該 Facebook 帳戶,將會傳回表示此情況的錯誤,讓遊戲可以引導使用者建立 PlayFab 帳戶。請注意,遊戲絕對不應在不同的 PlayFab Title ID 之間重複使用相同的 Facebook 應用程式,因為 Facebook 會為每個應用程式提供唯一的使用者識別碼,這樣做可能會導致使用者 PlayFab 帳戶資訊中的 Facebook ID 發生問題。如果您必須在新的 PlayFab Title ID 中重複使用應用程式,請務必先從 Facebook 取消連結所有帳戶,或刪除第一個 Title ID 中的所有使用者。注意:如果使用者是以 AuthenticationToken 而非 AccessToken 進行驗證,GetFriendsList API 將會傳回空白清單。另請參閱 ClientLinkFacebookAccountAsync、ClientUnlinkFacebookAccountAsync。非同步工作完成時,呼叫 PFAuthenticationLoginWithFacebookGetResult 以取得結果。

需求

標頭: PFAuthentication.h

另請參閱

PFAuthentication 成員
最後修改於 2026年10月6日