Accéder à PlayFab avec une entité de titre

De la même manière que vous pouvez vous connecter en tant que joueur et effectuer des appels PlayFab, vous pouvez vous authentifier en tant qu’entité de titre et effectuer des appels PlayFab par son intermédiaire. Les entités de titre peuvent utiliser certaines fonctions qui ne sont pas disponibles pour les entités de joueur. Bon nombre de ces fonctions sont préfixées par le mot “server”, par exemple ServerAddPlayerTag. L’obtention d’un handle d’entité de titre suit les mêmes étapes d’initialisation que la connexion en tant que joueur. Pour plus de détails, consultez la section “Initialisation” de l’article Démarrage rapide pour Win32. Remarque : pour le moment, les fonctions serveur ne sont disponibles que dans la version Win32 du SDK.

Authentifier une entité de titre

Après avoir créé un PFServiceConfigHandle lors des étapes initiales, vous pouvez obtenir un handle d’entité de titre en appelant PFAuthenticationGetEntityWithSecretKeyAsync. Une fois l’appel d’obtention d’entité terminé avec succès, il renvoie S_OK ainsi qu’un PFEntityHandle. Ce processus est similaire à la connexion en tant que joueur. Le type de retour PFEntityHandle est le même, sauf que dans ce cas, le handle d’entité représente une entité de titre plutôt qu’une entité de joueur. Nous pouvons appeler cette entité un serveur de jeu.

    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
    );

Appels de service

Une fois le serveur de jeu créé, vous pouvez effectuer des appels au back-end PlayFab. Voici un exemple d’ajout de balises de joueur à un joueur spécifique du titre.

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

Comme dans l’exemple AddPlayerTag, bon nombre des fonctions utilisées par un serveur de jeu consistent à obtenir ou à modifier des données de joueur. Cette fonction nécessite l’ID PlayFab du joueur concerné. Les clients connectés peuvent fournir les ID PlayFab, ou le serveur peut les récupérer directement auprès de PlayFab via des appels tels que GetPlayFabIDsFromXboxLiveIDs.

Référence

Documentation de référence de l’API

XBOX Services

PlayFab

Serveurs de jeu à partir d'une entité de titre

Accéder à PlayFab avec une entité de titre

Authentifier une entité de titre

Appels de service

Référence

​Accéder à PlayFab avec une entité de titre

​Authentifier une entité de titre

​Appels de service

​Référence

Accéder à PlayFab avec une entité de titre

Authentifier une entité de titre

Appels de service

Référence