タイトルエンティティを使用した PlayFab へのアクセス

プレイヤーとしてログインして PlayFab 呼び出しを行うのと同様に、タイトルエンティティとして認証し、そのエンティティを介して PlayFab 呼び出しを行うこともできます。タイトルエンティティは、プレイヤーエンティティでは利用できない特定の関数を使用できます。これらの関数の多くは “server” という単語が接頭辞として付いており、その一例が ServerAddPlayerTag です。タイトルエンティティハンドルを取得する初期化手順は、プレイヤーとしてログインする場合と同じです。詳細については、Win32 のクイックスタート記事の「初期化」セクションを参照してください。注意: 現時点では、サーバー関数は SDK の Win32 バージョンでのみ利用可能です。

タイトルエンティティの認証

最初のステップで PFServiceConfigHandle を作成した後、PFAuthenticationGetEntityWithSecretKeyAsync を呼び出してタイトルエンティティハンドルを取得できます。get entity 呼び出しが正常に完了すると、PFEntityHandle とともに S_OK が返されます。このプロセスはプレイヤーとしてログインする場合と似ています。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年8月25日

関連トピック

エンティティグループエンティティファイル利用可能な組み込みエンティティタイプ Game Server Configuration の概要エンティティクイックスタート

⌘I