People 시스템에서 사람 표시하기

이 항목에서는 People 시스템을 사용하여 사람을 표시하는 코드 흐름을 설명합니다. 다음은 타이틀이 People과 관련된 서비스에서 데이터를 가져오는 방법을 보여주는 몇 가지 예제 호출 흐름 시나리오입니다.

• 현재 게임 중인 사용자 목록
• 현재 사용자의 People 중 온라인 상태인 사용자 목록
• 무작위 사용자를 포함하는 전역 리더보드
• 사용자의 People로 구성된 리더보드

XBOX Live 전반의 서비스는 해당 서비스가 소유한 데이터만 반환하며, 사용자에 대한 XUID 참조만 반환합니다. 다음은 몇 가지 예입니다.

• People 서비스는 사용자의 People 목록에 있는 XUID와 각 XUID에 대한 매우 기본적인 정보(예: 즐겨찾기 상태)만 소유하고 반환합니다.
• Presence 서비스는 XUID의 온라인 상태 정보에 대한 데이터를 소유합니다.
• Leaderboards 서비스는 XUID 목록의 순위 정보를 소유합니다.

체험에서 사람 목록을 렌더링하려면 여러 서비스를 호출해야 합니다. 표시 이름과 게이머태그 정보는 Profile 서비스 이외의 어떤 서비스에서도 반환되지 않기 때문입니다. 서비스 API의 일반적인 호출 패턴은, 목록을 가장 잘 필터링하거나 정렬할 수 있는 서비스에서 먼저 XUID 목록을 가져오기 위해 왕복 호출을 한 번 수행한 다음, 각 XUID에 필요한 추가 메타데이터를 얻기 위해 필요한 만큼 다른 서비스에 동시에 왕복 호출을 하는 것입니다. 이미지의 경우 이미지 URL에서 이미지를 가져오기 위해 세 번째 왕복 호출이 필요할 수 있습니다. 사용자의 People 목록에 대한 데이터를 가져오는 데 필요한 왕복 호출 수를 줄이기 위해 관련 서비스에 People moniker가 도입되었습니다. 이 기능을 사용하면 호출자가 기본 서비스에 대해 People 서비스에서 사용자의 People 목록을 가져와 해당 XUID 집합을 사용하여 반환 범위를 지정하도록 추상적으로 표현할 수 있습니다. 이 항목의 맨 위로 돌아가기.

​

현재 게임 중인 사용자 목록

타이틀이 가진 것: 게임 중인 다른 사용자의 무작위 XUID 목록. 목표: 다른 사용자 각각에 대해 최소한의 정보를 렌더링합니다. 렌더링할 필드 [소유 서비스]: GameDisplayName [Profile] 호출 흐름: XUID 목록으로 Profile을 호출합니다. 이 항목의 맨 위로 돌아가기.

​

현재 사용자의 People 중 온라인 상태인 사용자 목록

타이틀이 가진 것: 현재 사용자의 XUID. 목표: 현재 사용자의 People 목록에 있는 온라인 사용자의 풍부한 목록을 렌더링합니다. 렌더링할 필드 [소유 서비스]:

• 즐겨찾기 표시기 [People]
• 표시 사진 [Profile]
• GameDisplayName [Profile]
• 기본 온라인 상태(녹색 원) [Presence]

호출 흐름:

1. Presence를 호출하고 People moniker를 전달하여 사용자의 각 People에 대한 XUID와 온라인 상태를 가져옵니다.
2. 병렬로:
   1. 전체 XUID 목록을 전달하여 Profile을 호출하여 각각의 표시 이름과 사진 URL을 가져옵니다. 그런 다음 각 사진 URL에 대한 이미지를 가져옵니다.
   2. XUID 목록을 전달하여 People을 호출하여 어떤 것이 사용자의 즐겨찾기인지 확인합니다.

이 항목의 맨 위로 돌아가기.

​

무작위 사용자를 포함하는 전역 리더보드

타이틀이 가진 것: 리더보드의 ID/이름. 목표: 리더보드의 각 사용자에 대한 기본 정보를 렌더링합니다. 렌더링할 필드 [소유 서비스]:

• 즐겨찾기 표시기 [People]
• GameDisplayName [Profile]
• 순위 [Leaderboards]
• 점수 [Leaderboards]

호출 흐름:

1. Leaderboards를 호출하여 특정 리더보드에 대한 XUID, 순위, 점수를 가져옵니다.
2. 병렬로:
   • XUID 목록을 전달하여 Profile을 호출하여 각각의 표시 이름과 사진 URL을 가져옵니다.
   • XUID 목록을 전달하여 People을 호출하여 어떤 것이 사용자의 즐겨찾기인지 확인합니다.

이 항목의 맨 위로 돌아가기.

​

사용자의 People로 구성된 리더보드

타이틀이 가진 것:

• 리더보드의 ID/이름
• 현재 사용자의 XUID

목표: 리더보드의 각 사용자에 대한 기본 정보를 렌더링합니다. 렌더링할 필드 [소유 서비스]:

• 즐겨찾기 표시기 [People]
• GameDisplayName [Profile]
• 순위 [Leaderboards]
• 점수 [Leaderboards]

호출 흐름:

1. Leaderboards를 호출하고 People moniker를 전달하여 사용자의 People 목록으로 제한된 특정 리더보드에 대한 XUID, 순위, 점수를 가져옵니다.
2. 병렬로:
   • XUID 목록을 전달하여 Profile을 호출하여 각각의 표시 이름과 사진 URL을 가져옵니다.
   • XUID 목록을 전달하여 People을 호출하여 어떤 것이 사용자의 즐겨찾기인지 확인합니다.

이 항목의 맨 위로 돌아가기.