​

快速入門：Unity 中適用於 C# 的 PlayFab Client 程式庫

開始使用 Unity 中適用於 C# 的 PlayFab Client 程式庫。請依照步驟安裝套件，並試用基本工作的範例程式碼。 本快速入門可協助您在 Unity 引擎中進行第一次 PlayFab API 呼叫。

​

需求

• PlayFab 開發人員帳戶。
• 已安裝的 Unity 編輯器。若要透過 Unity Hub 安裝供個人使用的 Unity，或供專業使用的 Unity+，請參閱下載 Unity。

• 下列任一類型的 Unity 專案：
  • 全新的專案。如需詳細資訊，請參閱第一次啟動 Unity。
  • 引導式教學課程專案。如需詳細資訊，請參閱開始使用 Unity。
  • 現有的專案。
• PlayFab Unity SDK。

​

下載並安裝 PlayFab SDK

您可以使用 PlayFab 編輯器延伸模組套件來安裝 SDK，或直接安裝 SDK。PlayFab 編輯器延伸模組是一個獨立的 Unity 外掛程式，可簡化 SDK 的安裝，以及為您的遊戲設定某些 PlayFab 設定。如需在不使用 PlayFab 編輯器延伸模組的情況下安裝 SDK 的相關資訊，請參閱在 Unity 中不使用編輯器延伸模組安裝 PlayFab SDK。

1. 下載 PlayFab Unity 編輯器延伸模組資產套件。
2. 開啟您的 Unity 專案。
3. 瀏覽至您下載檔案的位置，然後按兩下 PlayFabEditorExtensions.UnityPackage 檔案，以在 Unity 編輯器中開啟 Import Unity Package 對話方塊。
4. 若要將 PlayFab Unity 編輯器延伸模組匯入您的專案，請選取 Import。
5. 匯入完成時，PlayFab Unity 編輯器延伸模組面板應該會自動開啟，並顯示 SDK 安裝對話方塊。

6. 選取 Install PlayFab SDK，將 SDK 自動匯入您的專案，或升級目前安裝的版本。

​

設定您的遊戲設定

您必須先建立 PlayFabSharedSettings.asset 並指定要接收呼叫的遊戲識別碼，才能進行 API 呼叫。若要設定遊戲識別碼：

1. 選取 PlayFab > MakePlayFabSharedSettings，這應該會建立設定資產並在 Inspector 面板中將其開啟。
2. 在 Inspector 中設定您的 Title ID。
3. 現在，您隨時都可以從編輯器延伸模組面板的 Settings 索引標籤查看及變更目前的遊戲識別碼。

Developer Secret Key 預設不會設定。如果您要進行伺服器組建，請務必在 PlayFabSharedSettings.asset 中提供祕密金鑰。 Developer Secret Key 會自動設定為遊戲的預設祕密金鑰。如需祕密金鑰的詳細資訊，請參閱祕密金鑰管理。 否則，在建置您的遊戲用戶端時，請務必不要設定祕密金鑰。如需祕密金鑰的詳細資訊，請參閱祕密金鑰管理。

​

進行您的第一次 API 呼叫

本指南的這個部分提供進行第一次 PlayFab API 呼叫所需的最少步驟。此範例不提供任何 GUI 或畫面上的回饋。確認會顯示在主控台記錄中。

1. 如果您的 Unity 專案還沒有 Scripts 資料夾 (HDRP 和 LWRP/URP 範本預設會有一個)，請在 Project 面板中以滑鼠右鍵按一下 Assets 資料夾，然後選取 Create > Folder。
2. 在 Assets 視窗中，將資料夾命名為 Scripts。
3. 以滑鼠右鍵按一下 Scripts 資料夾，然後選取 Create > C# Script。
4. 將指令碼命名為 PlayFabLogin。
5. 按兩下檔案，以在程式碼編輯器中開啟它。
6. 在您的程式碼編輯器中，將 PlayFabLogin.cs 的內容取代為提供的程式碼，然後儲存檔案。
   using PlayFab;
   using PlayFab.ClientModels;
   using UnityEngine;
   
   public class PlayFabLogin : MonoBehaviour
   {
       public void Start()
       {
           if (string.IsNullOrEmpty(PlayFabSettings.staticSettings.TitleId)){
               /*
               Please change the titleId below to your own titleId from PlayFab Game Manager.
               If you have already set the value in the Editor Extensions, this can be skipped.
               */
               PlayFabSettings.staticSettings.TitleId = "42";
           }
           var request = new LoginWithCustomIDRequest { CustomId = "GettingStartedGuide", CreateAccount = true};
           PlayFabClientAPI.LoginWithCustomID(request, OnLoginSuccess, OnLoginFailure);
       }
   
       private void OnLoginSuccess(LoginResult result)
       {
           Debug.Log("Congratulations, you made your first successful API call!");
       }
   
       private void OnLoginFailure(PlayFabError error)
       {
           Debug.LogWarning("Something went wrong with your first API call.  :(");
           Debug.LogError("Here's some debug information:");
           Debug.LogError(error.GenerateErrorReport());
       }
   }
   

LoginWithAndroidDeviceID、LoginWithIOSDeviceID，或某種形式的社交登入，例如 LoginWithFacebook。 7. 在 Hierarchy 面板中，以滑鼠右鍵按一下您的場景，然後選取 Create Empty (在較舊版本的 Unity 中為 Game Object > Create Empty)。 8. 選取新的 Game Object，然後在 Inspector 面板中選取 Add Component。 9. 從元件下拉式功能表中，選取 Scripts > PlayFabLogin。 如需在 Unity 編輯器中建立和使用指令碼的詳細資訊，請參閱 Unity 文件中的建立和使用指令碼。

​

完成並執行

您現在已準備好測試此範例。

• 請務必儲存所有檔案並返回 Unity 編輯器
• 按下編輯器頂端的 Play 按鈕

您應該會在 Unity Console 面板中看到下列訊息。 如需所有可用用戶端 API 呼叫的清單，請參閱 PlayFab API 參考。

​

後續步驟

本快速入門示範了驗證使用者的簡化程序。如需使用者驗證的詳細資訊，請參閱登入基本概念和最佳做法。 了解如何將帳戶繫結至多個裝置和登入機制：帳戶連結快速入門。