跳轉到主要內容
本教學課程說明使用 Kongregate 和 Unity 在 PlayFab 中驗證玩家所需的最低設定。

需求

設定 Kongregate 應用程式

Kongregate 要求您先上傳應用程式的預覽版本,之後您才能存取必要的應用程式資訊。我們的第一步是準備一個包含下列內容的 index.html 檔案。
瀏覽至 Kongregate 網站。
  1. 選取 Games 索引標籤。
  2. 然後選取 Upload your game 按鈕。
Kongregate Games 索引標籤 隨即開啟用於設定新應用程式的頁面。
  1. 務必輸入 Application Name。
  2. 輸入 Game Description。
  3. 然後選取 Category。
  4. 選取 Continue 按鈕以提交新應用程式。
Kongregate 上傳您的遊戲 您會被轉送至 Application Upload 頁面。 首先,也是最重要的,務必將網址列中的 URL 儲存在安全且容易存取的位置。這樣可在您關閉頁面後,節省大量還原應用程式存取權的時間。
  1. 完成後,選取準備好的 index.html 檔案作為您的 Game File。
  2. 然後設定畫面大小。
  3. 務必接受所有必要的授權。
  4. 最後,選取 Upload 按鈕以上傳您的應用程式。
Kongregate 應用程式上傳頁面 預覽開啟後,請忽略其內容並開啟 api information 連結。 Kongregate 預覽 API 資訊 API Information 頁面開啟時,找出 API Key 並將其保存在安全且容易存取的位置,以供稍後使用。 Kongregate API 金鑰

設定 PlayFab 遊戲

在您的 PlayFab 遊戲 Game Manager 中:
  1. 從左側功能表選取 Add-ons。
  2. 找到並選取 Kongregate 圖示。
PlayFab 選取 Kongregate 附加元件 隨即開啟新頁面,讓您設定 Kongregate 整合:
  1. 輸入您在上一節取得的 API Key。
  2. 選取 Install Kongregate 按鈕。
PlayFab 設定 Kongregate 整合 此時,如果您沒有收到錯誤訊息,表示您已正確設定 PlayFab 遊戲與 Kongregate 應用程式的整合。

設定 Unity 專案

使用此 Unity 設定檢查清單: Unity Assets/WebGL Templates 資料夾 現在讓我們建立您的工作場景。
  1. 為了測試,請使用具有幾個文字標籤的螢幕縮放畫布。
我們只需要一個文字標籤來顯示偵錯訊息。
  1. 建立一個空的 GameObject,並將其重新命名為 Kongregate。
Unity BootScene 此 GameObject 將包含一個 KongregateHandler 元件,並連接一個用於偵錯訊息的文字標籤。 Unity GameObject Kongregate Handler KongregateHandler 元件的程式碼如下所示。

測試

真正測試整合的唯一方法,是將您的原型上傳至 Kongregate。
  1. 開啟 Build 視窗,並確認已從功能表選取 WebGL。
  2. 然後選取按鈕以開啟 Player Settings。
Kongregate 建置設定 在 Player Settings 畫面中,找到 Settings for WebGL 建置:
  1. 確認您已正確設定大小。
  2. 然後選取 Kongregate Preloader Template。
Kongregate WebGL 設定 建置應用程式並開啟 Build 資料夾。
  • 您會得到 index.html 以及其他一些檔案 (視 Unity 版本而定)。
  • 將除了 index.html 以外的所有檔案放入 zip 封存檔中,如下列範例所示。
Unity 建置資料夾 使用您稍早儲存的 URL 存取您的 Application Upload 頁面。
  1. 選取 index.html 作為您的 Game File。
  2. 然後選取 zip 封存檔作為 Additional files。
    • 接受授權並上傳。
Kongregate 應用程式上傳頁面 - 新增檔案 預覽開啟後,您應該可以在訊息變更時看到您的遊戲即時執行。 完成時,訊息應指出已透過 PlayFab 成功登入。 此時,您已成功整合 PlayFab 和 Kongregate。
最後修改於 2026年10月8日