메인 콘텐츠로 건너뛰기
이 항목에서는 사용자의 온라인 Presence 상태를 설정하기 위한 예제 코드를 제공합니다. XBOX services Rich Presence는 다른 플레이어에게 플레이어의 현재 활동을 알리는 기능을 제공합니다. 자세한 내용은 Rich Presence 개요를 참조하세요.

사용자의 온라인 Presence 상태 업데이트

이 예제 코드는 사용자의 온라인 Presence 상태를 설정합니다. 다음 예제에서는 Flat C API를 사용합니다.
자세한 내용은 다음을 참조하세요.

Rich Presence 상태 업데이트

다음 예제에서는 사용자에 대해 playingMap Rich Presence 문자열을 설정합니다. 이 예제에서 playingMap은 토큰이 없는 정적 문자열로 구성되어 있습니다. xboxLiveContext는 사용자의 XblContextHandle이고, queue는 게임의 작업 큐이거나 프로세스 기본 작업 큐를 사용하려면 nullptr입니다.
구성된 Presence 문자열에 명시적인 대체 문자열이 필요한 경우 presenceTokenIds를 자리 표시자 순서대로 구성된 문자열 ID로 설정하고, presenceTokenIdsCount를 배열 길이로 설정하세요. scid 또는 presenceId 멤버가 비어 있으면 요청에는 활성 또는 비활성 상태만 포함되고 Rich Presence 문자열은 포함되지 않습니다. 자세한 내용은 다음을 참조하세요.

속도 제한 및 인증

Presence 서비스는 각 사용자 및 타이틀에 대해 15초에 3회 쓰기와 300초에 30회 쓰기를 허용합니다. 플레이어의 활동이 변경될 때 Rich Presence를 업데이트하고, 빠르게 연속되는 변경 내용은 하나의 업데이트로 결합하세요. Rich Presence를 주기적으로 새로 고치기도 하는 경우 합산된 속도를 두 제한 내로 유지하세요. 호출이 HTTP_E_STATUS_429_TOO_MANY_REQUESTS(XblErrorCondition::Http429TooManyRequests)로 실패하면 루프에서 다시 시도하지 마세요. 서비스 응답에는 Retry-After 헤더가 포함되며 XSAPI는 이를 준수합니다. 인증 테스트 XR-132는 요청 속도가 지속 제한의 10배(300초에 Presence 쓰기 300회) 이상인 타이틀을 불합격 처리합니다. 이 임계값은 안전한 운영 허용치가 아닙니다. 자세한 내용은 세분화된 속도 제한을 참조하세요.
마지막 수정일 2026년 10월 30일