Exibindo pessoas do sistema de pessoas

Este tópico descreve o fluxo de código para exibir pessoas usando o sistema de pessoas. Aqui estão alguns exemplos de cenários de fluxo de chamadas que mostram como os títulos obtêm dados dos serviços relacionados a pessoas.

• Lista de usuários que estão no jogo no momento
• Lista das pessoas do usuário atual que estão online
• Placar global que contém usuários aleatórios
• Placar das pessoas do usuário

Os serviços do XBOX Live retornam apenas os dados de propriedade daquele serviço e retornam somente referências de XUID para os usuários. Aqui estão alguns exemplos.

• O serviço People possui e retorna apenas os XUIDs que estão na lista de pessoas de um usuário e algumas informações muito básicas sobre cada um desses XUIDs (como o status de favorito).
• O serviço Presence possui os dados sobre as informações de status online dos XUIDs.
• O serviço Leaderboards possui as informações de classificação das listas de XUIDs.

Para renderizar listas de pessoas nas experiências, você precisa chamar vários serviços. Isso ocorre porque as informações de nome de exibição e gamertag nunca são retornadas por nenhum serviço que não seja o serviço Profile. O padrão geral de chamada das APIs de serviço é fazer uma viagem de ida e volta para primeiro obter uma lista de XUIDs do serviço que melhor consegue filtrar ou classificar a lista e, em seguida, fazer chamadas simultâneas de ida e volta para outros serviços, conforme necessário, para obter quaisquer metadados adicionais necessários para cada XUID. Para imagens, pode ser necessária uma terceira rodada de chamadas para obter as imagens a partir das URLs de imagem. Para reduzir o número de viagens de ida e volta necessárias para obter dados sobre a lista de pessoas de um usuário, um moniker People foi introduzido nos serviços relevantes. Esse recurso permite que os chamadores indiquem de forma abstrata ao serviço principal que ele deve obter a lista de pessoas do usuário no serviço People e, em seguida, usar esse conjunto de XUIDs para delimitar o retorno. Voltar ao início deste tópico.

​

Lista de usuários que estão no jogo no momento

O título tem: Uma lista de XUIDs aleatórios de outros usuários no jogo. Objetivo: Renderizar informações mínimas para cada um dos outros usuários. Campo a renderizar [serviço proprietário]: GameDisplayName [Profile] Fluxo de chamadas: Chame Profile com a lista de XUIDs. Voltar ao início deste tópico.

​

Lista das pessoas do usuário atual que estão online

O título tem: O XUID do usuário atual. Objetivo: Renderizar uma lista detalhada dos usuários online que estão na lista de pessoas do usuário atual. Campo a renderizar [serviço proprietário]:

• Indicador de favorito [People]
• Imagem de exibição [Profile]
• GameDisplayName [Profile]
• Status online básico (círculo verde) [Presence]

Fluxo de chamadas:

1. Chame Presence, passando o moniker People para obter os XUIDs e o status online de cada uma das pessoas do usuário.
2. Em paralelo:
   1. Chame Profile, passando a lista inteira de XUIDs para obter o nome de exibição e a URL da imagem de cada um. Em seguida, obtenha as imagens de cada URL de imagem.
   2. Chame People, passando a lista de XUIDs para descobrir se algum deles é favorito do usuário.

Voltar ao início deste tópico.

​

Placar global que contém usuários aleatórios

O título tem: O ID/nome do placar. Objetivo: Renderizar informações básicas de cada usuário no placar. Campo a renderizar [serviço proprietário]:

• Indicador de favorito [People]
• GameDisplayName [Profile]
• Classificação [Leaderboards]
• Pontuação [Leaderboards]

Fluxo de chamadas:

1. Chame Leaderboards para obter os XUIDs, a classificação e as pontuações do placar específico.
2. Em paralelo:
   • Chame Profile, passando a lista de XUIDs para obter o nome de exibição e a URL da imagem de cada um.
   • Chame People, passando a lista de XUIDs para descobrir se algum deles é favorito do usuário.

Voltar ao início deste tópico.

​

Placar das pessoas do usuário

O título tem:

• O ID/nome do placar
• O XUID do usuário atual

Objetivo: Renderizar informações básicas de cada usuário no placar. Campo a renderizar [serviço proprietário]:

• Indicador de favorito [People]
• GameDisplayName [Profile]
• Classificação [Leaderboards]
• Pontuação [Leaderboards]

Fluxo de chamadas:

1. Chame Leaderboards, passando o moniker People para obter os XUIDs, a classificação e as pontuações do placar específico, limitado à lista de pessoas do usuário.
2. Em paralelo:
   • Chame Profile, passando a lista de XUIDs para obter o nome de exibição e a URL da imagem de cada um.
   • Chame People, passando a lista de XUIDs para descobrir se algum deles é favorito do usuário.

Voltar ao início deste tópico.