跳轉到主要內容
本文件列出將 PlayFab Party 整合到 iOS 或 macOS 應用程式所需的基本先決條件和需求。完成平台專屬步驟之後,請參閱 PlayFab Party 快速入門,完成 PlayFab Party 的使用者入門。

先決條件

開始本教學課程之前,請確定已符合下列先決條件:
  1. 您已建立 PlayFab 開發人員帳戶
  2. 您已建立 PlayFab 遊戲,且您的遊戲已加入 PlayFab Party 的允許清單
  3. 您已安裝 Xcode 10.2.1 版或更新版本
  4. 您可以存取 PlayFab Party 平台存放庫
  5. 您已建立可用來簽署應用程式以進行部署的 Apple 開發人員帳戶。
注意:如果您打算使用 XCode 模擬器進行測試,需要將應用程式的目標設為 64 位元 ($(ARCHS_STANDARD_64_BIT)) 架構。目前不支援 32 位元模擬器。

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

標頭

架構

  • 您需要將應用程式連結到下列架構,這些架構也位於 PlayFab Party 發佈套件中。
    • iOS: PlayFabParty
    • macOS: PlayFabPartyMac
SSL 程式庫是從 Open SSL 版本 XXX 建置而成。請使用 XXX 或更新版本的 OpenSSL
標頭包含 Party 標頭 除了上述 lib 檔案和標頭之外,您還需要 PlayFab SDK 的程式庫和標頭,以及應用程式所需的任何其他平台專屬相依性。如需詳細資訊,請參閱 iOS 範例的專案檔案組織。

讓 PlayFab Party 在 iOS 或 macOS 上運作的步驟

由於核心 Party 程式庫是以 C++ 撰寫,因此可以直接從 Objective-C++ 程式碼存取。為了方便起見,我們建立了一個簡單的 Objective-C++ 包裝函式類別來存取 Party 程式庫的功能。概括來說,您需要一個能存取 Party API 方法的類別,以建立網路、連線到網路,以及在網路上傳送訊息。我們的 iOS 示範應用程式以 SimpleClientClass 作為範例。
上述物件橋接器背後是一個純 C++ 實作檔案,它會呼叫 NetworkManager.cpp,而後者再呼叫 Party API。 以下是顯示各個層級的範例程式碼片段: SimpleClient Objective-C 介面公開了一個初始化 PlayFab Party 的方法。
SimpleClient 的實作也包含 C++ 物件的參考,該物件會透過網路管理員呼叫 Party API。
SimpleClientImpl 是一個 C++ 類別,負責建立 Party 網路的主要工作,如下列程式碼片段所示:
在上述程式碼片段中,SimpleClient 會呼叫 NetworkManager::CreateAndConnectToNetwork(),而後者再呼叫 Party.h 中公開的原始 Party API
以類似的方式,SimpleClient Objective-C 介面中的每個方法都會透過 SimpleClientImpl 和 NetworkManager 對應到 Party API。

備註

如果打算將 PlayFab Party 用於語音聊天,就必須授與應用程式麥克風存取權。若要這麼做,請確定已將下列屬性新增至應用程式的 Info.plist 檔案。

後續步驟

完成將 Party 程式庫整合到 iOS 或 macOS 應用程式的平台專屬步驟之後,請參閱 PlayFab Party 快速入門,完成 PlayFab Party 的使用者入門。
最後修改於 2026年10月20日