문자열
Rich Presence 문자열의 경우 문자열 세트를 정의해야 합니다. 각 문자열 세트에는 식별자로 사용할 친숙한 이름을 지정하는 것이 좋습니다. 작성하는 각 문자열 세트에는 게임이 출시될 로케일에 맞게 적절히 현지화된 문자열 그룹이 포함되어야 합니다. 현지화된 문자열 외에도 문화권 중립적인 문자열도 제공해야 합니다. 이 문자열은 존재하지 않는 로케일에 대한 요청이 이루어질 때 사용됩니다. 각 문자열 세트는 문자열을 매개 변수화하여 게임 내 데이터를 사용해 더욱 풍부하게 만들 수도 있습니다. 결과 문자열이 문자 제한을 초과하지 않는 한, 문자열 세트에는 원하는 만큼 많은 매개 변수를 가질 수 있습니다. 자세한 내용은 Rich Presence 문자열에 대한 정책 및 제한을 참조하세요.열거형
다음에 설명된 열거형은 XBOX Player Data의 이벤트를 통해 정의됩니다.통계
Rich Presence 문자열에서 이벤트 기반 숫자 통계 값을 사용할 수 있습니다. 예를 들어, 슈팅 게임에서 Rich Presence 문자열이 플레이어의 현재 킬 수를 표시하도록 할 수 있습니다. 구성은 매개 변수가 “Kill Count” 통계로 대체됨을 보여야 합니다. 이는 Common Schema Eventing 시스템을 통해 생성되었으며 XBOX Player Stats 서비스로 전달되거나 전송되어 플레이어 데이터로 전환됩니다. 통계는 통계 구성을 사용하여 정의되어야 합니다. 문자열을 다른 플레이어가 읽을 때, Rich Presence 서비스는 “Kill Count” 통계의 최신 값을 가져옵니다. 그 결과, 문자열은 항상 최신 상태를 유지합니다. 변수가 있는 Rich Presence 문자열은 이벤트 기반 숫자 통계와만 호환되며, 타이틀 관리 통계와는 호환되지 않습니다.상태
Rich Presence 문자열에서 실제 상태 값을 나타내는 통계를 사용하도록 선택할 수도 있습니다. 예를 들어, 레이싱 게임에서 Rich Presence 문자열을 사용하여 플레이어가 현재 어떤 자동차를 운전 중인지 또는 어떤 맵이나 트랙에서 레이싱을 하고 있는지 표시할 수 있습니다. 상태 정보를 구성하려면- 게임 내 문자열에 대한 열거형을 정의합니다. 예를 들어, 게임에 다섯 개의 맵이 있고 이러한 맵을 Rich Presence 문자열의 일부로 포함하려면, 다섯 개의 맵도 현지화된 문자열로 열거되어야 합니다.
- 열거형을 통계에 연결합니다. Rich Presence 서비스는 통계 값을 조회하여 플레이어 데이터에서 최신 값을 다시 가져옵니다. 그런 다음 서비스는 통계가 어떤 열거형 값으로 변환되는지 결정합니다.
예제 게임
이 예제의 나머지 부분에서는 최신 양동이 차기 게임을 개발 중이라고 가정합니다. 걷어차인 각 양동이 유형에 대한 통계를 만들고 Rich Presence 문자열을 사용하여 통계를 표시하려고 합니다. 게임 규칙이 다음과 같다고 가정합니다.- 양동이 종류는 나무, 은, 금입니다.
- 위치는 산, 사막, 해변입니다.
- 양동이가 걷어차이면 부서집니다. 플레이어는 항상 더 많은 양동이를 찾아야 합니다.
- 일부 양동이는 성공적으로 걷어차기 위해 특수 장비가 필요합니다. 예를 들어, 부츠는 발차기를 견딜 수 있을 만큼 튼튼해야 합니다.
- 게임에는 멀티플레이어 모드가 있습니다. 충분한 플레이어가 동시에 양동이를 걷어차려고 하면, 특정 부츠는 필요하지 않습니다.
Rich Presence에 대한 통계 구성
Rich Presence 문자열에서 XBOX Player Data가 생성한 통계를 사용하려면 Rich Presence 서비스의 이름을 제공합니다.열거형 구성 예제
다음은 몇 가지 열거형을 정의하는 예제입니다.- 게임의 맵에 대한 열거형을 만듭니다. 게임에는 세 개의 맵이 있습니다. 각각은 쉽게 참조할 수 있도록 친숙한 이름을 가집니다.
- 각 로케일에 대해 해당 맵 이름의 현지화된 문자열을 만듭니다. 전체 기본 현지화와 문화권 중립적인 현지화가 있음에 유의하세요.
- 게임의 세 가지 무기를 고려합니다. 이들은 친숙한 이름과 현지화된 문자열을 가집니다. 이는 모든 열거형에 해당합니다.
문자열 구성 예제
이제 열거형과 통계가 정의되었으므로 문자열을 만듭니다. 다음 예제 표에서 첫 번째 열은 하나의 문자열 세트와 다른 문자열 세트를 참조하는 데 도움이 되는 친숙한 이름입니다. 이 예제에서는 첫 번째 문자열 세트에 “playingMap”, 두 번째에 “totalKicked”, 세 번째에 “multiplayer”라는 문자열이 사용됩니다.로케일-문자열 쌍
다음 두 개의 열은 함께 들어갑니다. Rich Presence 문자열에 대한 로케일-문자열 쌍입니다. 첫 번째 예제에서는 영어로 된 문자열 “Playing on “이 사용됩니다. 토큰은 값으로 대체됩니다. 그런 다음 문자열은 다른 로케일에 대해 현지화됩니다. 열거형과 마찬가지로 기본 문자열과 문화권 중립적인 문자열이 있어야 합니다. 이들은 로케일-문자열 쌍을 지정하지 않은 로케일을 사용자가 사용할 때 사용됩니다. 열거형에 사용되는 로케일은 문자열의 로케일과 일치해야 합니다.문자열을 구성하기 위한 매개 변수
마지막 열은 Rich Presence 문자열의 빈칸을 채우는 데 사용되는 매개 변수를 위한 것입니다. Presence 서비스가 Statistics 서비스에서 매개 변수 값을 조회하도록 하려면 여기서 통계 이름을 사용하여 매개 변수를 참조해야 합니다. 문자열에서 통계를 사용하면 한 번만 설정하면 됩니다. 다시 작성할 필요가 없습니다. 문자열에 맵 이름이 있고 빈칸을 채우기 위해CurrentMap 통계를 사용하고 있다면, Rich Presence 서비스는 플레이어가 게임 내에서 맵에서 맵으로 이동할 때 문자열을 적절히 업데이트합니다.
Rich Presence 문자열에서 통계를 사용하지 않는다면 매개 변수를 지정할 수 없습니다.
다음 예제 표에서는 첫 번째 문자열에서 통계로 생성되는 현재 맵을 사용합니다. 두 번째 문자열에서는 BucketsKicked 통계를 사용합니다.
세 번째 예제에는 매개 변수가 포함되어 있지 않습니다.
문자열은 자체적으로 정의되며, 통계를 참조하지 않습니다.
작성할 수 있는 문자열 수에는 제한이 없지만, 게임에는 최소 하나의 문자열이 있어야 합니다.
BucketsKicked는 문자열에서 대체되는 단순한 숫자입니다.
CurrentMap은 열거형에서 문자열이 오는 통계의 예입니다.
게임이 Rich Presence를 이러한 문자열 중 하나로 설정할 때, 어떤 매개 변수가 필요한지 알기 위해 구성을 사용합니다.