메인 콘텐츠로 건너뛰기
이 문서에서는 XBOX services API(XSAPI)를 사용하여 타이틀 Presence 변경을 처리하는 예제 코드를 제공합니다. 타이틀 Presence 알림을 받으려면 먼저 처리기를 등록한 다음 관심 있는 사용자와 타이틀을 추적합니다. 더 이상 알림이 필요하지 않으면 사용자와 타이틀 추적을 중지하고 처리기를 제거합니다. 예제에서 xboxLiveContext는 로그인한 로컬 사용자의 XblContextHandle이고, state는 처리기 토큰을 저장하는 타이틀 정의 개체이며, LogToFile은 타이틀 정의 로깅 함수입니다. 123을 Presence를 추적하려는 사용자의 XBOX 사용자 ID(XUID)로 바꾸고, otherTitleId를 추적하려는 다른 타이틀의 타이틀 ID로 바꾸세요.
XblPresenceSubscribeToTitlePresenceChange 및 XblPresenceUnsubscribeFromTitlePresenceChange는 더 이상 사용되지 않습니다. 새 코드에서는 사용하지 마세요. XblPresenceTrackUsers로 사용자를 추적하고 XblPresenceTrackAdditionalTitles로 타이틀을 추적하면 XSAPI가 RTA(Real-Time Activity) 구독을 대신 관리합니다.

타이틀 Presence 변경 처리기 추가

사용자와 타이틀을 추적하기 전에 처리기를 등록합니다. xblContextHandle 또는 handler가 null이면 이 함수는 0을 반환합니다.
자세한 내용은 XblPresenceTitleState를 참조하세요.

사용자 및 타이틀 추적

타이틀 Presence 변경 처리기는 XblPresenceTrackUsers로 추적하는 사용자와 추적하는 타이틀에 대해서만 알림을 받습니다. 현재 타이틀은 기본적으로 추적되므로 다른 타이틀에 대해서만 XblPresenceTrackAdditionalTitles를 호출하세요. 각 호출은 기존 목록에 추가됩니다. 각 호출의 결과를 확인하세요.
추적은 참조 횟수로 관리됩니다. 성공한 각 추적 호출에 대응하는 중지 호출을 수행하세요. 추적 사용자 목록은 장치 Presence 알림과 타이틀 Presence 알림 모두에 적용됩니다.

사용자 및 타이틀 추적 중지

타이틀 Presence 업데이트가 더 이상 필요하지 않으면 추적한 타이틀과 사용자의 추적을 중지하고 각 결과를 확인합니다. XblPresenceStopTrackingAdditionalTitles는 현재 타이틀의 추적을 중지하지 않습니다.

타이틀 Presence 변경 처리기 제거

XblPresenceAddTitlePresenceChangedHandler가 반환한 토큰을 전달하여 처리기를 제거합니다. 저장된 토큰은 호출이 성공한 후에만 지우세요.

참고 항목

XblPresenceAddTitlePresenceChangedHandler XblPresenceRemoveTitlePresenceChangedHandler XblPresenceTrackUsers XblPresenceTrackAdditionalTitles XblPresenceStopTrackingAdditionalTitles 장치 Presence 변경 처리
마지막 수정일 2026년 10월 30일