使用遊戲實體存取 PlayFab

就像您可以以玩家身分登入並進行 PlayFab 呼叫一樣，您也可以以遊戲實體身分進行驗證，並透過它進行 PlayFab 呼叫。遊戲實體可以使用某些玩家實體無法使用的函式。其中許多函式都以「server」一詞作為前置詞，例如 ServerAddPlayerTag。取得遊戲實體控制代碼的初始化步驟與以玩家身分登入相同。如需詳細資訊，請參閱 Win32 快速入門文章的「初始化」一節。注意：目前伺服器函式僅適用於 Win32 版本的 SDK。

驗證遊戲實體

在初始步驟中建立 PFServiceConfigHandle 之後，您可以呼叫 PFAuthenticationGetEntityWithSecretKeyAsync 來取得遊戲實體控制代碼。取得實體呼叫順利完成後，會傳回 S_OK 以及 PFEntityHandle。此程序與以玩家身分登入類似。傳回的 PFEntityHandle 類型相同，只不過在此情況下，實體控制代碼代表的是遊戲實體而非玩家實體。我們可以將此實體稱為遊戲伺服器。

    PFAuthenticationGetEntityRequest request{};
    XAsyncBlock async{};

    // Add your own error handling when FAILED(hr) == true
    HRESULT hr = PFAuthenticationGetEntityWithSecretKeyAsync(
        serviceConfigHandle,
        secretKey, // title specific secret key
        &request,
        &async
    );

    hr = XAsyncGetStatus(&async, true); // This is doing a blocking wait for completion, but you can use the XAsyncBlock to set a callback instead for async style usage

    PFEntityHandle entityHandle;
    hr = PFAuthenticationGetEntityWithSecretKeyGetResult(
        &async,
        &entityHandle
    );

服務呼叫

建立遊戲伺服器之後，您就可以對 PlayFab 後端進行呼叫。以下範例示範如何將玩家標記新增至遊戲中的特定玩家。

    XAsyncBlock async{};
    PFSegmentsAddPlayerTagRequest request{};
    addSegmentRequest.PlayFabId = "ABCDEF123456";
    addSegmentRequest.tagName = "tagName";
    HRESULT hr = PFSegmentsServerAddPlayerTagAsync(entityHandle, &request, &async);
    hr = XAsyncGetStatus(&async, true);

如同 AddPlayerTag 範例，遊戲伺服器使用的許多函式都涉及取得或變更玩家資料。此函式需要特定玩家的 PlayFab ID。已連線的用戶端可以提供 PlayFab ID，或者伺服器可以透過 GetPlayFabIDsFromXboxLiveIDs 等呼叫直接從 PlayFab 擷取。

參考

API 參考文件

最後修改於 2026年10月8日

⌘I