Skip to main content
本文件列出將 PlayFab Party 整合到 Android 應用程式所需的基本先決條件和需求。依照本文件設定好系統後,請參閱 PlayFab Party 快速入門,以設定 PlayFab Party 的各項建置組塊。

先決條件

開始本教學課程之前,請確定已符合下列先決條件:
  1. 您已建立 PlayFab 開發人員帳戶。
  2. 您已建立 PlayFab 遊戲,且您的遊戲已加入 PlayFab Party 的允許清單。
  3. 您已安裝 Android Studio 3.2 版或更新版本。
  4. 您的應用程式以 Android 4.4 (Kitkat) 或更新版本為目標。
  5. 您已安裝 Android NDK 18.1.5063045 或更新版本。
  6. 您可以存取 PlayFab Party 平台存放庫
  7. 您已建立 Android 簽署憑證,並使用該憑證設定簽署您的應用程式以進行部署。
  8. 在 Android 平台上建置的應用程式必須確保應用程式資訊清單中包含 BLUETOOTH_CONNECT,Party 才能監視並連線到可用的藍牙裝置。

包含必要的程式庫和標頭檔案

您需要包含來自 PlayFab Party 發佈存放庫的下列標頭檔案。 LIB 檔案
  1. libParty.a
  2. libcrypto.a
  3. libssl.a
SSL 程式庫是從 Open SSL 版本 3.5.7 建置而成。請使用 3.5.7 或更新版本的 openSSL。
標頭包含 Party 標頭
除了上述 lib 檔案和標頭之外,您還需要 PlayFab SDK 的程式庫和標頭,以及應用程式所需的任何其他平台專屬相依性。如需詳細資訊,請參閱 Android 範例的專案檔案組織。

讓 PlayFab Party 在 Android 上運作的步驟

由於核心 Party 程式庫是以 C++ 撰寫,我們需要建立一個簡單的 JNI 包裝函式類別來存取 Party 程式庫的功能。概括來說,您需要一個能存取 Party API 方法的類別,以建立網路、連線到網路,以及在網路上傳送訊息。我們在示範應用程式中透過 NetworkManager Java 類別實現了這一點。
上述 JNI 橋接器背後是一個純 C++ 實作檔案,它會呼叫 NetworkManager.cpp,而後者再呼叫 Party API。 以下是顯示各個層級的範例程式碼片段: NetworkManager Java 介面公開了一個加入 Party 網路的方法。
joinNetwork 的實作位於 C++ 層的 PartyDemo.cpp 中,如下所示。
在上述程式碼片段中,joinNetwork 會呼叫 NetworkManager::CreateAndConnectToNetwork(),而後者再呼叫 Party.h 中公開的原始 Party API
同樣地,NetworkManager JNI 介面中的每個方法都會透過 PartyDemo 和 NetworkManager 對應到 Party API。

後續步驟

在本文中,我們了解了如何開始將 Party 程式庫整合到您的 Android 應用程式中。請參閱 PlayFab Party 快速入門,以設定 PlayFab Party 的其餘建置組塊。
Last modified on October 6, 2026