> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> People moniker와 함께 People, Presence, Profile, Leaderboards 서비스를 결합하여 XBOX Live People 목록 데이터를 표시하기 위한 호출 패턴입니다.

<a id="top" />

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

* [현재 게임 중인 사용자 목록](#loucig)
* [현재 사용자의 People 중 온라인 상태인 사용자 목록](#lotcupwao)
* [무작위 사용자를 포함하는 전역 리더보드](#glcru)
* [사용자의 People로 구성된 리더보드](#loup)

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

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

체험에서 사람 목록을 렌더링하려면 여러 서비스를 호출해야 합니다. 표시 이름과 게이머태그 정보는 *Profile 서비스* 이외의 어떤 서비스에서도 반환되지 않기 때문입니다.

서비스 API의 일반적인 호출 패턴은, 목록을 가장 잘 필터링하거나 정렬할 수 있는 서비스에서 먼저 XUID 목록을 가져오기 위해 왕복 호출을 한 번 수행한 다음, 각 XUID에 필요한 추가 메타데이터를 얻기 위해 필요한 만큼 다른 서비스에 동시에 왕복 호출을 하는 것입니다.
이미지의 경우 이미지 URL에서 이미지를 가져오기 위해 세 번째 왕복 호출이 필요할 수 있습니다.

사용자의 People 목록에 대한 데이터를 가져오는 데 필요한 왕복 호출 수를 줄이기 위해 관련 서비스에 People *moniker*가 도입되었습니다.
이 기능을 사용하면 호출자가 기본 서비스에 대해 People 서비스에서 사용자의 People 목록을 가져와 해당 XUID 집합을 사용하여 반환 범위를 지정하도록 추상적으로 표현할 수 있습니다.

[이 항목의 맨 위로 돌아가기.](#top)

<a id="loucig" />

## 현재 게임 중인 사용자 목록

**타이틀이 가진 것:**

게임 중인 다른 사용자의 무작위 XUID 목록.

**목표:**

다른 사용자 각각에 대해 최소한의 정보를 렌더링합니다.

**렌더링할 필드 \[소유 서비스]:**

`GameDisplayName` \[Profile]

**호출 흐름:**

XUID 목록으로 `Profile`을 호출합니다.

[이 항목의 맨 위로 돌아가기.](#top)

<a id="lotcupwao" />

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

**타이틀이 가진 것:**

현재 사용자의 XUID.

**목표:**

현재 사용자의 People 목록에 있는 온라인 사용자의 풍부한 목록을 렌더링합니다.

**렌더링할 필드 \[소유 서비스]:**

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

**호출 흐름:**

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

[이 항목의 맨 위로 돌아가기.](#top)

<a id="glcru" />

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

**타이틀이 가진 것:**

리더보드의 ID/이름.

**목표:**

리더보드의 각 사용자에 대한 기본 정보를 렌더링합니다.

**렌더링할 필드 \[소유 서비스]:**

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

**호출 흐름:**

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

[이 항목의 맨 위로 돌아가기.](#top)

<a id="loup" />

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

**타이틀이 가진 것:**

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

**목표:**

리더보드의 각 사용자에 대한 기본 정보를 렌더링합니다.

**렌더링할 필드 \[소유 서비스]:**

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

**호출 흐름:**

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

[이 항목의 맨 위로 돌아가기.](#top)


## Related topics

- [People 시스템(친구 목록) 개념](/ko/services/xbox-services/community/people-system/concepts/live-people-system-concepts-nav.md)
- [People 시스템(친구 목록) 개요](/ko/services/xbox-services/community/people-system/live-people-system-overview.md)
- [People 시스템(친구 목록)](/ko/services/xbox-services/community/people-system/live-people-system-nav.md)
- [개념](/ko/services/xbox-services/community/people-system/concepts/index.md)
- [XUserResolveIssueWithUiUtf16Result](/ko/reference/system/xuser/functions/xuserresolveissuewithuiutf16result.md)