Actualización de la presencia de un usuario mediante REST

Este tema proporciona código de ejemplo para actualizar las cadenas de presencia enriquecida. Para actualizar una cadena de presencia enriquecida en su título, llame al URI Write Title con los parámetros adecuados en un objeto JSON. Esta llamada RESTful también está encapsulada por las API de servicios XBOX (XSAPI). Para obtener información sobre la API relacionada con esta llamada, consulte XblPresenceSetPresenceAsync. El URI tiene el siguiente aspecto:

POST /users/xuid({xuid})/devices/current/titles/current

Los siguientes campos son solo para establecer cadenas de presencia enriquecida. Otros campos opcionales están relacionados con la escritura de la presencia de un título, pero no se enumeran en este tema.

Objeto TitleRequest

Propiedad	Tipo	Obligatoria	Descripción
Activity	ActivityRequest	No	El registro que describe la información dentro del título (presencia enriquecida e información multimedia, si está disponible)

Objeto ActivityRequest

Propiedad	Tipo	Obligatoria	Descripción
richPresence	RichPresenceRequest	No	El friendlyName de la cadena de presencia enriquecida que se va a usar

Objeto RichPresenceRequest

Propiedad	Tipo	Obligatoria	Descripción
Id	String	Sí	El friendlyName de la cadena de presencia enriquecida que se va a usar
Scid	String	Sí	El scid que indica dónde están definidas las cadenas de presencia enriquecida

Por ejemplo, para actualizar la presencia enriquecida del usuario cuyo xuid es 12345, la llamada tiene el siguiente aspecto:

POST /users/xuid(12345)/devices/current/titles/current

Tiene el siguiente cuerpo JSON.

          {
            activity:
            {
              richPresence:
              {
                id:"playingMap",
                scid:"0000-0000-0000-0000-01010101"
              }
            }
          }

Con la API contenedora, esto es una llamada a XblPresenceSetPresenceAsync. Si mantiene actualizados los datos de jugador de XBOX, no tiene que restablecer la cadena de presencia enriquecida para rellenar el espacio en blanco cada vez que cambian los datos. En el ejemplo anterior, se está usando el mapa actual. La presencia busca los datos en los datos de jugador de XBOX cuando un usuario intenta leer la cadena para rellenar el valor actual. Aunque el usuario esté cambiando de un mapa a otro, no tiene que restablecer la cadena de presencia enriquecida en su juego siempre que esté enviando los eventos adecuados a los datos de jugador de XBOX. Los datos pueden tardar unos segundos en migrarse a través del sistema de datos de jugador de XBOX. Cuando alguien intenta leer la presencia enriquecida del usuario 12345, el servicio examina qué configuración regional se está solicitando y da formato a la cadena adecuadamente antes de devolverla. En este caso, suponga que un usuario quiere leer la cadena en-US. La lectura de la presencia enriquecida funciona de la siguiente manera.

GET /users/xuid(12345)?level=all

Para obtener más información sobre esta llamada, consulte GET (/users/xuid({xuid})). La API contenedora para esto es XblPresenceGetPresenceAsync o XblPresenceGetPresenceForMultipleUsersAsync. En el ejemplo anterior, ha solicitado el PresenceRecord del usuario cuyo xuid es 12345. También ha solicitado que el nivel de detalle sea all. Si no especificó all, la presencia enriquecida no se devuelve. En cambio, all devuelve lo siguiente en la respuesta JSON.

          {
            xuid:"12345",
            state:"online",
            devices:
            [
              {
                type:"D",
                titles:
                [
                  {
                    id:"12345",
                    name:"Buckets are Awesome",
                    lastModified:"2022-08-17T07:15:23.4930000",
                    placement: "full",
                    state:"active",
                    activity:
                    {
                      richPresence:"Playing on map:Mountains"
                    }
                  }
                ]
              }
            ]
          }

XBOX Services

PlayFab

Actualización de la presencia de un usuario mediante REST

Objeto TitleRequest

Objeto ActivityRequest

Objeto RichPresenceRequest

​Objeto TitleRequest

​Objeto ActivityRequest

​Objeto RichPresenceRequest

Objeto TitleRequest

Objeto ActivityRequest

Objeto RichPresenceRequest