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

장치 Presence 변경 처리기 추가

추적 중인 사용자의 장치 Presence가 변경될 때 XSAPI가 호출하는 처리기를 등록합니다. xblContextHandle 또는 handler가 null이면 이 함수는 0을 반환합니다.
자세한 내용은 XblPresenceDeviceType을 참조하세요.

장치 Presence 변경에 대한 사용자 추적

장치 Presence 변경 처리기는 XblPresenceTrackUsers로 추적하는 사용자에 대해서만 알림을 받습니다. 각 호출은 기존 추적 사용자 목록에 사용자를 추가합니다. 추적 사용자 목록은 처리기와 별개로 업데이트할 수 있습니다.
추적은 참조 횟수로 관리됩니다. 같은 사용자를 두 번 이상 추적하는 경우 성공한 각 XblPresenceTrackUsers 호출에 대응하는 XblPresenceStopTrackingUsers 호출을 수행하세요. 추적 사용자 목록은 장치 Presence 알림과 타이틀 Presence 알림 모두에 적용됩니다.

사용자 추적 중지

사용자에 대한 Presence 업데이트가 더 이상 필요하지 않으면 해당 사용자의 추적을 중지합니다.

장치 Presence 변경 처리기 제거

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

참고 항목

XblPresenceAddDevicePresenceChangedHandler XblPresenceRemoveDevicePresenceChangedHandler XblPresenceTrackUsers XblPresenceStopTrackingUsers 타이틀 Presence 변경 처리
마지막 수정일 2026년 10월 30일