使用 title 实体访问 PlayFab

与以玩家身份登录并进行 PlayFab 调用的方式类似，你也可以以 title 实体的身份进行身份验证，并通过它进行 PlayFab 调用。Title 实体可以使用某些玩家实体无法使用的函数。这些函数中许多都以 “server” 一词为前缀，一个例子是 ServerAddPlayerTag。获取 title 实体句柄的初始化步骤与以玩家身份登录相同。有关详细信息，请参阅 Win32 快速入门文章的 “Initialization” 部分。注意：目前，服务器函数仅在 SDK 的 Win32 版本中可用。

对 title 实体进行身份验证

在初始步骤中创建 PFServiceConfigHandle 之后，你可以通过调用 PFAuthenticationGetEntityWithSecretKeyAsync 获取一个 title 实体句柄。获取实体调用成功完成后，它将返回 S_OK 以及一个 PFEntityHandle。此过程类似于以玩家身份登录。PFEntityHandle 的返回类型相同，只是在此情况下实体句柄表示 title 实体而非玩家实体。我们可以称此实体为游戏服务器。

    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 后端进行调用。以下是一个为 title 中特定玩家添加玩家标签的示例。

    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月19日

⌘I