기본 사항
RTA는 WebSocket 세션을 사용하여 클라이언트와의 지속적인 연결을 만듭니다. 그것이 서비스가 여러분에게 통계를 전달하는 방식입니다. 클라이언트가 인증된 연결 요청을 보내면 RTA는 제공된 토큰을 사용하여 연결이 가능한지 확인한 다음 이를 설정합니다. 연결이 설정되면 앱은 특정 통계에 대한 구독 요청을 할 수 있습니다. 성공적인 구독 시 RTA는 응답 페이로드의 일부로 현재 값과 통계 유형과 같은 몇 가지 추가 메타데이터를 반환합니다. RTA는 클라이언트가 구독되어 있는 동안 발생하는 모든 통계 업데이트를 전달합니다. 타이틀이 특정 통계에 대한 실시간 업데이트가 필요 없는 경우 해당 통계 추적을 중단합니다.연결 해제
사용자의 인증 토큰이 만료되면 서비스에서 세션이 종료됩니다. 이때 타이틀은 그에 맞게 작동해야 합니다. RTA 연결은 설계상 두 시간 후에 닫히며, 이는 클라이언트가 재연결하도록 강제합니다. 이는 메시지 대역폭을 절약하기 위해 연결에 대한 인증 토큰이 캐싱되기 때문입니다. 결국 그 토큰은 만료됩니다. 연결을 닫고 클라이언트가 재연결하도록 강제함으로써 클라이언트는 인증 토큰을 새로 고칩니다. XBOX Services API(XSAPI)는 90분 후 RTA에 사전에 재연결하고 구독을 다시 제출함으로써 타이틀에 대한 인증 토큰 갱신을 처리합니다. 사용자의 ISP 문제나 타이틀의 프로세스가 중단되면 클라이언트가 연결 해제될 수 있습니다. 이러한 각 경우에 RTA 연결 상태 변경 이벤트에 등록된 타이틀은 연결 해제 이벤트가 발생합니다.일반적으로 연결 해제 시 타이틀에서 별도의 조치가 필요하지 않지만, 타이틀은 RTA 연결이 끊어졌음을 반영하도록 UI를 업데이트하고 싶을 수 있습니다.
클라이언트가 멀티플레이어 세션에 RTA를 사용하고 30초 동안 연결이 끊어지면 Multiplayer Session Directory(MPSD)가 RTA 세션이 닫힌 것을 감지하고 사용자를 세션에서 내보냅니다. XSAPI는 RTA 연결을 자동으로 재설정하지만, RTA 구독이 재설정된 후 MPSD 세션을 다시 작성하는 것은 타이틀의 책임입니다.
구독 해제
불필요한 실시간 업데이트를 위해 통계를 추적하는 것은 권장하지 않습니다. 추적된 각 통계는 RTA 구독에 해당하며 서비스는 사용자가 타이틀당 가질 수 있는 구독 수를 제한합니다. 모든 것을 구독하면 그 한계에 도달할 수 있으며, 이는 중요한 통계를 구독하는 기능을 방해합니다. 예를 들어, 타이틀은 특정 장면 내의 통계에 대해서만 업데이트가 필요할 수 있습니다. 사용자가 해당 장면에 들어가면 타이틀은 해당 통계 추적을 시작해야 합니다. 사용자가 해당 장면을 떠나면 타이틀은 해당 통계 추적을 중단해야 합니다. 마찬가지로 통계가 변경되어도 알림이 필요하지 않은 경우도 있습니다. 모든 통계 변경 처리기를 제거하면 XSAPI가 자동으로 관련 RTA 구독을 해제합니다. 구독 제한에 대한 자세한 내용은 이 항목 뒷부분의 스로틀 섹션을 참조하십시오.큐에 있는 지연된 항목에 대한 인식
통계 구독을 해제할 때 클라이언트에 도달하는 과정에 있는 해당 통계에 대한 업데이트가 여전히 있을 수 있습니다. 따라서 타이틀이 방금 통계 구독을 해제했더라도 해당 통계와 관련된 업데이트를 한두 번 더 받을 수 있음에 유의하십시오. 구독 식별자가 인식되지 않을 때 통계 업데이트를 무시하는 것이 좋습니다.이해할 수 없는 메시지 무시
메시지 프로토콜이 업데이트될 수 있습니다. 앱을 새로운 메시지에 구애받지 않도록 하려면 타이틀이 알 수 없는 메시지 유형을 삭제하는 것이 좋습니다.스로틀
RTA는 1000의UserStats 스로틀과 2500의 Presence 스로틀을 적용합니다.
클라이언트가 스로틀링 제한에 도달하면 구독 또는 구독 해제 호출의 일부로 오류를 수신하거나 연결이 끊어집니다.
어느 경우든 도달한 스로틀링 제한에 대한 추가 정보는 오류 또는 연결 해제 메시지와 함께 클라이언트에 제공됩니다.
타이틀을 개발할 때 이러한 개념을 염두에 두십시오. 극단적인 작업을 하고 있다면
서비스가 호출을 스로틀할 수 있으므로 앱 경험이 저하될 수 있습니다.
현재 RTA 릴리스에서는 앱 인스턴스당 통계에 대한 1000개의 구독을 가질 수 있습니다.
또한 앱 인스턴스는 존재감 업데이트를 위해 사용자의 전체 Friends 목록 길이에도 구독할 수 있습니다.
이 숫자는 향후 릴리스에서 변경될 수 있습니다.