피플 시스템에서 사람 표시
이 항목에서는 피플 시스템을 사용하여 사용자를 표시하는 코드 흐름에 대해 설명합니다. 다음은 타이틀이 피플과 관련된 서비스에서 데이터를 가져오는 방법을 보여 주는 몇 가지 호출 흐름 시나리오 예제입니다.
Xbox Live 서비스에서는 해당 서비스가 소유한 데이터만 반환하고 사용자에게 XUID 참조만 반환합니다. 다음은 몇 가지 예제입니다.
- 피플 서비스는 사용자의 사용자 목록에 있는 XUID만 소유하고 반환하며 이러한 각 XUID에 대한 매우 기본적인 정보(예: 즐겨찾기 상태)를 반환합니다.
- 프레즌스 서비스는 XUID의 온라인 상태 정보에 대한 데이터를 소유합니다.
- 순위표 서비스는 XUID 목록에 있는 순위 정보를 소유합니다.
환경에서 사용자 목록을 렌더링하려면 여러 서비스를 호출해야 합니다. 이는 표시 이름 및 게이머태그 정보가 프로필 서비스 이외의 서비스에서 반환되지 않으므로 발생합니다.
서비스 API에 대한 일반적인 호출 패턴은 한 번의 왕복을 통해 먼저 목록에서 가장 잘 필터링하거나 정렬할 수 있는 XUID 목록을 가져온 다음, 필요에 따라 다른 서비스에 대한 동시 왕복 호출을 만들어 각 XIUD에 필요한 추가 메타데이터를 가져오는 것입니다. 이미지의 경우 이미지 URL에서 이미지를 가져오려면 세 번째 왕복 호출이 필요할 수 있습니다.
사용자의 사용자 목록에 대한 데이터를 가져오는 데 필요한 왕복 횟수를 줄이기 위해 사용자 모니커가 관련 서비스에 도입되었습니다. 이 기능을 사용하면 호출자가 피플 서비스에서 사용자의 피플 목록을 가져와야 한다는 것을 기본 서비스에 추상적으로 표현한 다음, 해당 XUID 집합을 사용하여 반환 범위를 지정합니다.
현재 게임에 있는 사용자 목록
타이틀에 포함된 항목:
게임에서 다른 사용자의 임의 XUID 목록입니다.
목표:
다른 각 사용자에 대해 최소한의 정보를 렌더링합니다.
렌더링할 필드 소유 중인 서비스:
GameDisplayName [프로필]
호출 흐름:
XUID 목록을 사용하여 Profile을(를) 호출합니다.
온라인 상태인 현재 사용자의 피플 목록
타이틀에 포함된 항목:
현재 사용자의 XUID
목표:
현재 사용자의 사용자 목록에 있는 다양한 온라인 사용자 목록을 렌더링합니다.
렌더링할 필드 [소유 중인 서비스]:
- 즐겨찾기 표시기 [피플]
- 공개 사진 [프로필]
GameDisplayName[프로필]- 기본 온라인 상태(녹색 원) [프레즌스]
호출 흐름:
Presence을(를) 호출하고People모니커를 전달하여 각 사용자의 피플에 대한 XUID 및 온라인 상태를 가져옵니다.- 병렬:
Profile을(를) 호출하고 XUID의 전체 목록을 전달하여 각각에 대한 표시 이름 및 그림 URL을 가져옵니다. 그런 다음 각 사진 URL에 대한 이미지를 가져옵니다.People을(를) 호출하여 XUID 목록을 전달하여 사용자의 즐겨찾기인지 확인합니다.
임의 사용자가 포함된 글로벌 순위표
타이틀에 포함된 항목:
순위표의 ID/이름
목표:
순위표에서 각 사용자에 대한 기본 정보를 렌더링합니다.
렌더링할 필드 [소유 중인 서비스]:
- 즐겨찾기 표시기 [피플]
GameDisplayName[프로필]- 순위 [순위표]
- 점수 [순위표]
호출 흐름:
Leaderboards을(를) 호출하여 특정 순위표에 대한 XUID, 순위 및 점수를 가져옵니다.- 병렬:
Profile을(를) 호출하고 XUID 목록을 전달하여 각각에 대한 표시 이름 및 그림 URL을 가져옵니다.People을(를) 호출하여 XUID 목록을 전달하여 사용자의 즐겨찾기인지 확인합니다.
사용자의 피플 순위표
타이틀에 포함된 항목:
- 순위표의 ID/이름
- 현재 사용자의 XUID
목표:
순위표에서 각 사용자에 대한 기본 정보를 렌더링합니다.
렌더링할 필드 [소유 중인 서비스]:
- 즐겨찾기 표시기 [피플]
GameDisplayName[프로필]- 순위 [순위표]
- 점수 [순위표]
호출 흐름:
Leaderboards을(를) 호출하고People모니커를 전달하여 사용자의 사용자 목록으로 제한된 특정 순위표에 대한 XUID, 순위 및 점수를 가져옵니다.- 병렬:
Profile을(를) 호출하고 XUID 목록을 전달하여 각각에 대한 표시 이름 및 그림 URL을 가져옵니다.People을(를) 호출하여 XUID 목록을 전달하여 사용자의 즐겨찾기인지 확인합니다.