> ## Documentation Index
> Fetch the complete documentation index at: https://docs.warmcore-tech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ROS 2 아키텍처

> X3 SDK 연동 경계 이해하기

> **개발자 프리뷰 / 하드웨어 미검증:** X3 하드웨어와 실제 로봇에 배포된 실행 환경은 아직 검증되지 않았습니다. 로컬 테스트만으로 장치 호환성, 물리적 동작 또는 안전한 운용을 보장할 수 없습니다.

## 연동 경로

Python 애플리케이션은 호환되는 ROS 환경에서 SDK의 ROS 클라이언트를 사용하거나, 운영자가 승인한 rosbridge를 통해 읽기 전용 WebSocket 클라이언트로 대화 이벤트를 관찰할 수 있습니다. 이 두 경로는 별개이며 WebSocket 관찰 기능은 로봇 명령 접근 권한을 제공하지 않습니다.

## 탐색과 검증 자료

ROS 이름은 네임스페이스나 리매핑에 따라 달라질 수 있습니다. SDK 진단은 관찰된 이름, 타입 및 일부 QoS 경로를 확인합니다. 그래프 결과는 특정 시점의 스냅샷으로, 엔드포인트 신원, 권한, 지속적인 정상 상태, 메시지 전달 또는 물리적 동작을 보장하지 않습니다. 프리뷰 인터페이스 계약은 [토픽과 서비스](https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/topics-services.md)를 참고하세요.

## 네트워크 경계

운영자가 관리하는 네트워크 접근 제어를 사용하세요. 클라이언트 측 토픽 허용 목록은 해당 클라이언트만 제한하며 다른 클라이언트로부터 rosbridge 서버를 보호하지 못합니다. 브리지를 공용 인터넷에 직접 노출하지 마세요. 신뢰할 수 없는 연결에는 인증서 검증과 접근 제어 기능이 있는 운영자 관리 TLS 엔드포인트를 사용하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.