> ## Documentation Index > Fetch the complete documentation index at: https://docs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # 使用 Facebook 和 Unity 设置 PlayFab 身份验证 > 使用 PlayFab SDK 将 Facebook 登录集成到 Unity 项目中的分步教程，涵盖 Facebook 应用设置和玩家身份验证代码。 本教程指导你完成一个使用 Facebook 和 Unity 进行 PlayFab 身份验证的示例。 ## 要求 * [Unity 5+](https://unity3d.com/) 和一个已创建的项目。 * 用于测试的 [Facebook 账户](https://www.facebook.com/)。 * 已导入到项目中的 [Facebook SDK](https://developers.facebook.com/docs/unity/)。 * 已注册的 [PlayFab](https://developer.playfab.com/) title。 * 已导入到项目中且配置了 title 引用的 [PlayFab SDK](https://aka.ms/playfabunitysdkdownload)。 * 熟悉[登录基础和最佳实践](https://docs.xbox.com/zh-CN/services/playfab/identity/player-identity/login/login-basics-best-practices.md)。 ## 实现 ### 注册 Facebook 应用程序 首先导航到 [Facebook Developer Portal](https://developers.facebook.com/)： 1. 将鼠标移到 **My Apps** 按钮上。 2. 如下图所示，选择 **Add a New App**。 ![Facebook add a new app](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-add-a-new-app.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=8f2cf49110ee6fa800418dc19843cb16) 一个新的 **Application** 弹窗将打开。 1. 输入你的 **Application** 名称。 2. 输入 **Contact Email**。 > [!NOTE] > > 请务必设计你自己的*唯一* **Application Name** 和 **Email**，如下图所示。 ![Facebook new app ID](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-new-app-id.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=7a0feb9725217dcca8d4b0fb861e3c3e) 1. 导航到 **Settings** 选项卡。 2. 然后移动到 **Basic** 子选项卡。 3. 找到你的 **Application ID**。 * 将其复制到易于访问的安全位置。 稍后我们将使用它设置 Facebook SDK。 ![Facebook save app ID](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-save-app-id.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=540b62a0ad44a22f49fa944e2d6741d3) 导航到 [Facebook Access Token Tool](https://developers.facebook.com/tools/accesstoken/)。 1. 在列表中找到你的 **App**。 2. 验证它是否已分配 **User Token**。 > [!NOTE] > > 如果你*没有*分配的用户令牌，请使用屏幕右侧的按钮请求一个。每当你需要新的用户令牌时，请参阅此页面。如果在 PC 上测试期间授权失败，令牌过期可能是最可能的原因。刷新页面以获取新的用户令牌并重新测试。 ![Facebook Access Token Tool](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/access-token-tool.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=8bcd65dadccacafbfe04227bd3d5ad4c) 1. 在你的 **Application Manager** 页面上，导航到 **+ Add Products**。 2. 找到 **Facebook Login** 条目并选择 **Get Started**。 ![Facebook login get started](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-html5/login-get-started.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=bd346c82af2a1914bd8dfca79653f5c6) 一个包含 **Login** 产品设置的页面应打开。 1. 确保你已打开 **Login** 产品的 **Settings** 页面。 2. 验证 **Client OAuth** 和 **Web OAuth** 都已开启。 ![Facebook login product settings](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-html5/login-product-settings.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=493c1ca8600489493ca47ced5c579204) ### 设置 Facebook SDK 打开你的 **Unity Project**： 1. 在文件菜单中选择 **Facebook**。 2. 然后选择 **Edit Settings**。 ![Edit Facebook Unity project settings](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/edit-project-settings.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=fbf61a04fb83b8ada1e829f7918cdc14) **Inspector** 窗口将显示当前的 **Facebook SDK** 配置。 * 在相应字段中输入你的 **Application ID**，如下图所示。 ![Enter app ID in Facebook SDK configuration](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/enter-app-id.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=46683d51640caa63de8f3c828b2f7adf) ### 简单的身份验证脚本 创建一个新的 **Game Object**，并将其重命名为 **PlayfabFacebookAuthExample**，如下图所示。 ![Create a new Game Object](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/create-game-object.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=3a19b0150725400f2affedef4c8c0ab8) 1. 创建一个名为 **PlayfabFacebookAuthExample.cs** 的脚本。 2. 将其添加到 **Game Object** 中，如下图所示。 ![Add example script to game object](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/add-example-script.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=df63197b8889dcd5fccadabef66e37e0) 在 `PlayfabFacebookAuthExample.cs` 内放置以下代码。 ```csharp theme={null} // Import statements introduce all the necessary classes for this example. using Facebook.Unity; using PlayFab; using PlayFab.ClientModels; using UnityEngine; using LoginResult = PlayFab.ClientModels.LoginResult; public class PlayfabFacebookAuthExample : MonoBehaviour { // holds the latest message to be displayed on the screen private string _message; public void Start() { SetMessage("Initializing Facebook..."); // logs the given message and displays it on the screen using OnGUI method // This call is required before any other calls to the Facebook API. We pass in the callback to be invoked once initialization is finished FB.Init(OnFacebookInitialized); } private void OnFacebookInitialized() { SetMessage("Logging into Facebook..."); // Once Facebook SDK is initialized, if we are logged in, we log out to demonstrate the entire authentication cycle. if (FB.IsLoggedIn) FB.LogOut(); // We invoke basic login procedure and pass in the callback to process the result FB.LogInWithReadPermissions(null, OnFacebookLoggedIn); } private void OnFacebookLoggedIn(ILoginResult result) { // If result has no errors, it means we have authenticated in Facebook successfully if (result == null || string.IsNullOrEmpty(result.Error)) { SetMessage("Facebook Auth Complete! Access Token: " + AccessToken.CurrentAccessToken.TokenString + "\nLogging into PlayFab..."); /* * We proceed with making a call to PlayFab API. We pass in current Facebook AccessToken and let it create * and account using CreateAccount flag set to true. We also pass the callback for Success and Failure results */ PlayFabClientAPI.LoginWithFacebook(new LoginWithFacebookRequest { CreateAccount = true, AccessToken = AccessToken.CurrentAccessToken.TokenString}, OnPlayfabFacebookAuthComplete, OnPlayfabFacebookAuthFailed); } else { // If Facebook authentication failed, we stop the cycle with the message SetMessage("Facebook Auth Failed: " + result.Error + "\n" + result.RawResult, true); } } // When processing both results, we just set the message, explaining what's going on. private void OnPlayfabFacebookAuthComplete(LoginResult result) { SetMessage("PlayFab Facebook Auth Complete. Session ticket: " + result.SessionTicket); } private void OnPlayfabFacebookAuthFailed(PlayFabError error) { SetMessage("PlayFab Facebook Auth Failed: " + error.GenerateErrorReport(), true); } public void SetMessage(string message, bool error = false) { _message = message; if (error) Debug.LogError(_message); else Debug.Log(_message); } public void OnGUI() { var style = new GUIStyle { fontSize = 40, normal = new GUIStyleState { textColor = Color.white }, alignment = TextAnchor.MiddleCenter, wordWrap = true }; var area = new Rect(0,0,Screen.width,Screen.height); GUI.Label(area, _message,style); } } ``` ## 测试 ### 在编辑器中运行应用程序 1. 选择 **Play** 按钮。**Facebook** 初始化后（并进行身份验证调用），你的游戏视图中将出现一个 **Facebook** 身份验证对话框。 2. 输入 **User Token**。 3. 选择 **Send Success** 按钮，如下图所示。 ![Enter user token in Facebook Auth dialog](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/enter-user-token.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=b3384d650c0264c549d2ef1780c4eb98) * 检查控制台输出。它应显示我们的调试语句，如下图所示。 * 如果没有看到错误，则表示身份验证成功。 ![Debug console output](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/debug-console-output.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=720db9bf8bc65ead9c9ff196c817a2fe) ### 在 Android 上运行应用程序 在 Android 上启动应用程序之前，你需要执行其他配置步骤： * 首先，你需要确保你已选择 Android 平台，并设置了唯一的 **Package ID**（如下例所示）。 > [!NOTE] > > 请务必创建你自己的*唯一* **Package ID**。 ![Set Android package ID](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/set-android-package-id.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=e8bdadc7a8f8bf9ef4318a55f2d28338) > [!TIP] > > **可选步骤**：安装 [Open SSL](https://wiki.openssl.org/index.php/Binaries) 并将其添加到 **PATH** 环境变量。如果缺失，Unity 将在构建期间产生无害的错误。此错误*不会*停止构建或影响执行。 接下来，在你的 **Facebook Application** 控制台中： 1. 导航到 **Basic** 设置。 2. 如下例所示，选择 **+ Add Platform**。 ![Facebook App Console add platform](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/facebook-add-platform.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=7ee5741660e7e45cb2a7c81514e1fd1f) * 然后从可用平台列表中选择 **Android**。 ![Facebook select Android platform](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/select-android-platform.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=eac3fadcf67a0ce0c6abc1181dba3781) 带有平台特定设置的面板将出现。 * 填写你的 **Package ID**。 * 选择 **Save**（**Save** 按钮隐藏在页面右下角）。 ![Android platform settings](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/android-platform-settings.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=b6ffafffedb54020a4a0ad1d51ac078b) 像往常一样在你的 Android 设备上构建并运行应用程序。 * 应用程序应欢迎你出现一个 Facebook 登录页面。 * 登录后，观察屏幕上的消息如何变化。 * 最后，你应该看到一条消息，表明在 PlayFab 中身份验证成功。整个过程如下例所示。 ![PlayFab Facebook authentication on Android](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/playfab-facebook-auth-on-android.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=73ca707fbe085b61bbeaf369702b2386) ### 在 iOS 上运行应用程序 在 iOS 上启动应用程序之前，你必须执行其他配置步骤。 * 首先，确保你已选择 **iOS** 平台。 * 然后，如下例所示，设置一个唯一的 **Bundle ID**。 * 请务必创建你自己的*唯一* **Package ID**。 ![Set iOS bundle ID](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/set-ios-bundle-id.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=3599c6de938ed564cc5dc7ae572ea8c8) 接下来，在你的 **Facebook Application Console** 中： 1. 导航到 **Basic** 设置。 2. 如下例所示，选择 **+ Add Platform**。 ![Facebook App Console add platform](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/facebook-add-platform.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=7ee5741660e7e45cb2a7c81514e1fd1f) * 从可用平台列表中选择 **iOS**。 ![Facebook select iOS platform](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/select-ios-platform.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=396c5464cb9dba1c7da77ec8484bc86e) 带有平台特定设置的面板将出现。 * 填写你的 **Package ID**。 * 选择 **Save** 按钮（**Save** 按钮隐藏在页面右下角）。 ![iOS platform settings](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/ios-platform-settings.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=14c5ccc92e77b857aa2bddf50a6437dd) * 接下来，像往常一样构建应用程序。 * 完成后，使用 **XCode** 打开 **Project**。 ![Open iOS project using XCode](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/open-ios-project.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=8b1b51af9c293e12e99de0f37348575a) * 选择 **Project** 打开 **Project Settings**。 * 验证 **Bundle ID** 与你的唯一 **Package ID** 匹配。 ![iOS project settings: verify bundle ID](https://mintcdn.com/microsoft-4404708b/wQJwYr9vT-FdsCSx/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/ios-project-settings-verify-bundle-id.webp?fit=max\&auto=format\&n=wQJwYr9vT-FdsCSx\&q=85\&s=134ffb82cfab08931fdafae6201a9670) * 请务必选择正确的设备。 ![iOS project settings: select device](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/ios-project-settings-select-device.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=ba4e9bc8666986003c926585554c88e1) * 并选择正确的 **Identity Team**。 ![iOS project settings: select Identity Team](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/ios-project-settings-select-identity-team.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=3875ebcc3d1bdd8c50810b9a94c0ed83) 最后，像往常一样运行应用程序。 * 一旦启动，应用程序将允许你使用 Web 浏览器登录 Facebook。 * 完成后，将调用 PlayFab 身份验证，并显示一条指示结果的消息。 ![PlayFab Facebook authentication on iOS](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/playfab-facebook-auth-on-ios.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=9ec6a4d3c32ebcad5452e897f98c211e) ### 通过 PlayFab Game Manager 检查 在 Game Manager 中打开你的 PlayFab title。 * 导航到仪表板。 * 参考 **PlayStream Debugger** 面板检查最新事件。你应该看到 Facebook 身份验证事件，如下例所示。 ![PlayStream Debugger Facebook authentication event](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/facebook-unity/playfab-facebook-auth-event.png?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=f9d6980c6cef4ca74b9747a5d55d3c45) 至此，你已成功为 PlayFab 集成 Facebook 身份验证。 ## Related topics - [特定平台的身份验证](https://docs.xbox.com/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/index.md) - [使用 Facebook 和 HTML5 设置 PlayFab 身份验证](https://docs.xbox.com/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/facebook-html5.md) - [使用 Steam 和 Unity 设置 PlayFab 身份验证](https://docs.xbox.com/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/steam-unity.md) - [使用 Kongregate 和 Unity 设置 PlayFab 身份验证](https://docs.xbox.com/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/kongregate-unity.md) - [使用 Google 和 HTML5 设置 PlayFab 身份验证](https://docs.xbox.com/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/google-html5.md)