> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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/) 遊戲。
* 已匯入專案並設定遊戲參考的 [PlayFab SDK](https://aka.ms/playfabunitysdkdownload)。
* 熟悉[登入基本概念和最佳做法](/zh-TW/services/playfab/identity/player-identity/login/login-basics-best-practices)。
## 實作
### 註冊 Facebook 應用程式
首先，瀏覽至 [Facebook 開發人員入口網站](https://developers.facebook.com/)：
1. 將滑鼠移至 **My Apps** 按鈕上。
2. 選取 **Add a New App**，如下圖所示。
隨即開啟新的 **Application** 快顯視窗。
1. 輸入您的 **Application** 名稱。
2. 輸入 **Contact Email**。
請務必自行設定*唯一*的 **Application Name** 和 **Email**，如下圖所示。
1. 瀏覽至 **Settings** 索引標籤。
2. 然後移至 **Basic** 子索引標籤。
3. 找到您的 **Application ID**。
* 將它複製到容易存取的安全位置。
我們稍後會使用它來設定 Facebook SDK。
瀏覽至 [Facebook 存取權杖工具](https://developers.facebook.com/tools/accesstoken/)。
1. 在清單中找到您的 **App**。
2. 確認它已指派 **User Token**。
如果您*沒有*已指派的使用者權杖，請使用畫面右側的按鈕要求一個。每當您需要新的使用者權杖時，請參閱此頁面。如果在 PC 上測試期間授權失敗，最可能的原因是權杖已過期。請重新整理頁面以取得新的使用者權杖，然後再次測試。
1. 在您的 **Application Manager** 頁面上，瀏覽至 **+ Add Products**。
2. 找到 **Facebook Login** 項目，然後選取 **Get Started**。
應該會開啟包含 **Login** 產品設定的頁面。
1. 確認您已開啟 **Login** 產品的 **Settings** 頁面。
2. 確認 **Client OAuth** 和 **Web OAuth** 都已開啟。
### 設定 Facebook SDK
開啟您的 **Unity 專案**：
1. 在檔案功能表中選取 **Facebook**。
2. 然後選取 **Edit Settings**。
**Inspector** 視窗會顯示目前的 **Facebook SDK** 設定。
* 在對應欄位中輸入您的 **Application ID**，如下圖所示。
### 簡單的驗證指令碼
建立新的 **Game Object**，並將其重新命名為 **PlayfabFacebookAuthExample**，如下圖所示。
1. 建立名為 **PlayfabFacebookAuthExample.cs** 的指令碼。
2. 將它新增至 **Game Object**，如下圖所示。
在 `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** 按鈕，如下圖所示。
* 檢查主控台輸出。它應該會顯示我們的偵錯陳述式，如下圖所示。
* 如果沒有看到任何錯誤，表示驗證成功。
### 在 Android 上執行應用程式
在 Android 上啟動應用程式之前，您必須執行額外的設定步驟：
* 首先，您必須確認已選取 Android 平台，並已設定唯一的 **Package ID** (如下列範例所示)。
請務必建立您自己的*唯一* **Package ID**。
**選擇性步驟**：安裝 [Open SSL](https://wiki.openssl.org/index.php/Binaries)，並將其新增至 **PATH** 環境變數。如果缺少它，Unity 會在建置期間產生無害的錯誤。此錯誤不會停止建置，也不會影響執行。
接著，在您的 **Facebook Application** 主控台中：
1. 瀏覽至 **Basic** 設定。
2. 選取 **+ Add Platform**，如下方提供的範例所示。
* 然後從可用平台清單中選取 **Android**。
隨即出現包含平台特定設定的面板。
* 填入您的 **Package ID**。
* 選取 **Save** (**Save** 按鈕隱藏在頁面右下角)。
在您的 Android 裝置上正常建置並執行應用程式。
* 應用程式應該會以 Facebook 登入頁面歡迎您。
* 登入後，請留意畫面上的訊息變化。
* 最後，您應該會看到一則訊息，指出已在 PlayFab 中成功驗證。整個程序如下方提供的範例所示。
### 在 iOS 上執行應用程式
在 iOS 上啟動應用程式之前，您必須執行額外的設定步驟。
* 首先，確認您已選取 **iOS** 平台。
* 然後，設定唯一的 **Bundle ID**，如下方提供的範例所示。
* 請務必建立您自己的*唯一* **Package ID**。
接著，在您的 **Facebook Application Console** 中：
1. 瀏覽至 **Basic** 設定。
2. 選取 **+ Add Platform**，如下方提供的範例所示。
* 從可用平台清單中選取 **iOS**。
隨即出現包含平台特定設定的面板。
* 填入您的 **Package ID**。
* 選取 **Save** 按鈕 (**Save** 按鈕隱藏在頁面右下角)。
* 接著，照常建置應用程式。
* 完成後，使用 **XCode** 開啟 **Project**。
* 選取 **Project** 以開啟 **Project Settings**。
* 確認 **Bundle ID** 與您唯一的 **Package ID** 相符。
* 請務必選取正確的裝置。
* 並選取正確的 **Identity Team**。
最後，照常執行應用程式。
* 啟動後，應用程式會讓您使用網頁瀏覽器登入 Facebook。
* 完成後，系統會叫用 PlayFab 驗證，並以訊息指出結果。
### 透過 PlayFab Game Manager 檢查
在 Game Manager 中開啟您的 PlayFab 遊戲。
* 瀏覽至儀表板。
* 參閱 **PlayStream Debugger** 面板以檢查最新事件。您應該會看到 Facebook 驗證事件，如下列範例所示。
此時，您已成功為 PlayFab 整合 Facebook 驗證。
## Related topics
- [平台特定驗證](/zh-TW/services/playfab/identity/player-identity/platform-specific-authentication/index.md)
- [使用 Facebook 和 HTML5 設定 PlayFab 驗證](/zh-TW/services/playfab/identity/player-identity/platform-specific-authentication/facebook-html5.md)
- [使用 Steam 和 Unity 設定 PlayFab 驗證](/zh-TW/services/playfab/identity/player-identity/platform-specific-authentication/steam-unity.md)
- [使用 Kongregate 和 Unity 設定 PlayFab 驗證](/zh-TW/services/playfab/identity/player-identity/platform-specific-authentication/kongregate-unity.md)
- [使用 Google 和 HTML5 設定 PlayFab 驗證](/zh-TW/services/playfab/identity/player-identity/platform-specific-authentication/google-html5.md)