개발자 프리뷰 / 하드웨어 미검증: X3 하드웨어와 실제 로봇에 배포된 실행 환경은 아직 검증되지 않았습니다. 로컬 테스트만으로 장치 호환성, 물리적 동작 또는 안전한 운용을 보장할 수 없습니다.
연동 경로
Python 애플리케이션은 호환되는 ROS 환경에서 SDK의 ROS 클라이언트를 사용하거나, 운영자가 승인한 rosbridge를 통해 읽기 전용 WebSocket 클라이언트로 대화 이벤트를 관찰할 수 있습니다. 이 두 경로는 별개이며 WebSocket 관찰 기능은 로봇 명령 접근 권한을 제공하지 않습니다.
탐색과 검증 자료
ROS 이름은 네임스페이스나 리매핑에 따라 달라질 수 있습니다. SDK 진단은 관찰된 이름, 타입 및 일부 QoS 경로를 확인합니다. 그래프 결과는 특정 시점의 스냅샷으로, 엔드포인트 신원, 권한, 지속적인 정상 상태, 메시지 전달 또는 물리적 동작을 보장하지 않습니다. 프리뷰 인터페이스 계약은 토픽과 서비스를 참고하세요.
네트워크 경계
운영자가 관리하는 네트워크 접근 제어를 사용하세요. 클라이언트 측 토픽 허용 목록은 해당 클라이언트만 제한하며 다른 클라이언트로부터 rosbridge 서버를 보호하지 못합니다. 브리지를 공용 인터넷에 직접 노출하지 마세요. 신뢰할 수 없는 연결에는 인증서 검증과 접근 제어 기능이 있는 운영자 관리 TLS 엔드포인트를 사용하세요.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Warmcore Tech Documentation","colors":{"primary":"#395EC9","light":"#7797F0","dark":"#253D8F"},"logo":{"light":"https://mintcdn.com/warmcore-tech/jDHzVQCBbLqcIaDQ/logo/warmcore-gradient-compact.png?fit=max\u0026auto=format\u0026n=jDHzVQCBbLqcIaDQ\u0026q=85\u0026s=a3e1fb04d23a74a701eb5b1c4e7e0818","dark":"https://mintcdn.com/warmcore-tech/jDHzVQCBbLqcIaDQ/logo/warmcore-gradient-compact.png?fit=max\u0026auto=format\u0026n=jDHzVQCBbLqcIaDQ\u0026q=85\u0026s=a3e1fb04d23a74a701eb5b1c4e7e0818"},"favicon":"https://mintcdn.com/warmcore-tech/tGV32rd5dNBOXLai/favicon.svg?fit=max\u0026auto=format\u0026n=tGV32rd5dNBOXLai\u0026q=85\u0026s=522368367f80d7e117f66e6a17dcc41f","navbar":{"links":[{"href":"https://warmcore-tech.com","label":"Warmcore Tech"}]},"footer":{"socials":{"github":"https://github.com/WarmcoreTech"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":""},{"language":"zh-Hant","href":"zh-Hant"},{"language":"cn","href":"cn"},{"language":"jp","href":"jp"},{"language":"ko","href":"ko"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"warmcore-tech","hasAudioNarration":false,"actualSubdomain":"warmcore-tech","customDomains":["docs.warmcore-tech.com"],"gitSource":{"type":"github","owner":"warmcoretech","repo":"warmcore-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6af940bc0052dd6d64140d3d"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af97cad7fd385b08ebe8c0e","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"cn","tag":"Xiaoling S100 SDK","count":16},{"language":"en","tag":"Xiaoling S100 SDK","count":16},{"language":"jp","tag":"Xiaoling S100 SDK","count":16},{"language":"ko","tag":"Xiaoling S100 SDK","count":16},{"language":"zh-Hant","tag":"Xiaoling S100 SDK","count":16},{"language":"cn","tag":"Xiaoling X3 SDK","count":12},{"language":"en","tag":"Xiaoling X3 SDK","count":12},{"language":"jp","tag":"Xiaoling X3 SDK","count":12},{"language":"ko","tag":"Xiaoling X3 SDK","count":12},{"language":"zh-Hant","tag":"Xiaoling X3 SDK","count":12},{"language":"cn","tag":"欢迎","count":1},{"language":"en","tag":"Welcome","count":1},{"language":"jp","tag":"はじめに","count":1},{"language":"ko","tag":"시작하기","count":1},{"language":"zh-Hant","tag":"歡迎","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"ko/xiaoling-x3/v1/ros2-architecture","slug":"/ko/xiaoling-x3/v1/ros2-architecture","pageMetadata":{"title":"ROS 2 아키텍처","description":"X3 SDK 연동 경계 이해하기","href":"/ko/xiaoling-x3/v1/ros2-architecture"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"X3 SDK 연동 경계 이해하기\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.blockquote,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`개발자 프리뷰 / 하드웨어 미검증:`}),` X3 하드웨어와 실제 로봇에 배포된 실행 환경은 아직 검증되지 않았습니다. 로컬 테스트만으로 장치 호환성, 물리적 동작 또는 안전한 운용을 보장할 수 없습니다.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`연동-경로`,children:`연동 경로`}),`\n`,_jsx(_components.p,{children:`Python 애플리케이션은 호환되는 ROS 환경에서 SDK의 ROS 클라이언트를 사용하거나, 운영자가 승인한 rosbridge를 통해 읽기 전용 WebSocket 클라이언트로 대화 이벤트를 관찰할 수 있습니다. 이 두 경로는 별개이며 WebSocket 관찰 기능은 로봇 명령 접근 권한을 제공하지 않습니다.`}),`\n`,_jsx(Heading,{level:`2`,id:`탐색과-검증-자료`,children:`탐색과 검증 자료`}),`\n`,_jsxs(_components.p,{children:[`ROS 이름은 네임스페이스나 리매핑에 따라 달라질 수 있습니다. SDK 진단은 관찰된 이름, 타입 및 일부 QoS 경로를 확인합니다. 그래프 결과는 특정 시점의 스냅샷으로, 엔드포인트 신원, 권한, 지속적인 정상 상태, 메시지 전달 또는 물리적 동작을 보장하지 않습니다. 프리뷰 인터페이스 계약은 `,_jsx(_components.a,{href:`/ko/xiaoling-x3/v1/topics-services`,children:`토픽과 서비스`}),`를 참고하세요.`]}),`\n`,_jsx(Heading,{level:`2`,id:`네트워크-경계`,children:`네트워크 경계`}),`\n`,_jsx(_components.p,{children:`운영자가 관리하는 네트워크 접근 제어를 사용하세요. 클라이언트 측 토픽 허용 목록은 해당 클라이언트만 제한하며 다른 클라이언트로부터 rosbridge 서버를 보호하지 못합니다. 브리지를 공용 인터넷에 직접 노출하지 마세요. 신뢰할 수 없는 연결에는 인증서 검증과 접근 제어 기능이 있는 운영자 관리 TLS 엔드포인트를 사용하세요.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"ROS 2 아키텍처","description":"X3 SDK 연동 경계 이해하기","href":"/ko/xiaoling-x3/v1/ros2-architecture"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"연동 경로","slug":"연동-경로","depth":2,"children":[]},{"title":"탐색과 검증 자료","slug":"탐색과-검증-자료","depth":2,"children":[]},{"title":"네트워크 경계","slug":"네트워크-경계","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"warmcore-tech","siteName":"Warmcore Tech Documentation","title":"ROS 2 아키텍처 - Warmcore Tech Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/xiaoling-x3/v1/ros2-architecture","matchLevel":1},"zh-Hant":{"href":"/zh-Hant/xiaoling-x3/v1/ros2-architecture","matchLevel":1},"cn":{"href":"/cn/xiaoling-x3/v1/ros2-architecture","matchLevel":1},"jp":{"href":"/jp/xiaoling-x3/v1/ros2-architecture","matchLevel":1},"ko":{"href":"/ko/xiaoling-x3/v1/ros2-architecture","matchLevel":0}}},"lastModified":"2026-11-15T07:44:05.929Z","originalFileLocation":"ko/xiaoling-x3/v1/ros2-architecture.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"X3 SDK 연동 경계 이해하기\">\u003cmeta data-mint-head name=\"application-name\" content=\"Warmcore Tech Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/warmcore-tech/j8SXfPr35BxFSFLq/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/warmcore-tech/j8SXfPr35BxFSFLq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/warmcore-tech/j8SXfPr35BxFSFLq/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/warmcore-tech/j8SXfPr35BxFSFLq/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/warmcore-tech/j8SXfPr35BxFSFLq/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/warmcore-tech/j8SXfPr35BxFSFLq/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/warmcore-tech/j8SXfPr35BxFSFLq/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/warmcore-tech/j8SXfPr35BxFSFLq/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/warmcore-tech/j8SXfPr35BxFSFLq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"ROS 2 아키텍처 - Warmcore Tech Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"X3 SDK 연동 경계 이해하기\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Warmcore Tech Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://warmcore-tech.mintlify.site/_mintlify/api/og/v2?division=Xiaoling+X3+SDK\u0026amp;title=ROS+2+%EC%95%84%ED%82%A4%ED%85%8D%EC%B2%98\u0026amp;description=X3+SDK+%EC%97%B0%EB%8F%99+%EA%B2%BD%EA%B3%84+%EC%9D%B4%ED%95%B4%ED%95%98%EA%B8%B0\u0026amp;theme=42a47c11764429bbda02c590\u0026amp;signature=46798c78bd3111d720601ffd13d782c71b447a45cadd1199a7fd101d3f63828d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"ROS 2 아키텍처 - Warmcore Tech Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"X3 SDK 연동 경계 이해하기\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://warmcore-tech.mintlify.site/_mintlify/api/og/v2?division=Xiaoling+X3+SDK\u0026amp;title=ROS+2+%EC%95%84%ED%82%A4%ED%85%8D%EC%B2%98\u0026amp;description=X3+SDK+%EC%97%B0%EB%8F%99+%EA%B2%BD%EA%B3%84+%EC%9D%B4%ED%95%B4%ED%95%98%EA%B8%B0\u0026amp;theme=42a47c11764429bbda02c590\u0026amp;signature=46798c78bd3111d720601ffd13d782c71b447a45cadd1199a7fd101d3f63828d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/warmcore-tech/j8SXfPr35BxFSFLq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Warmcore Tech Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#395EC9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/xiaoling-x3/v1/ros2-architecture.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.warmcore-tech.com/en/xiaoling-x3/v1/ros2-architecture\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://docs.warmcore-tech.com/zh-Hant/xiaoling-x3/v1/ros2-architecture\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.warmcore-tech.com/cn/xiaoling-x3/v1/ros2-architecture\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.warmcore-tech.com/jp/xiaoling-x3/v1/ros2-architecture\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.warmcore-tech.com/en/xiaoling-x3/v1/ros2-architecture\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.warmcore-tech.com/#organization\",\"name\":\"Warmcore Tech Documentation\",\"url\":\"https://docs.warmcore-tech.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/warmcore-tech/jDHzVQCBbLqcIaDQ/logo/warmcore-gradient-compact.png?fit=max\u0026auto=format\u0026n=jDHzVQCBbLqcIaDQ\u0026q=85\u0026s=a3e1fb04d23a74a701eb5b1c4e7e0818\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.warmcore-tech.com#website\",\"name\":\"Warmcore Tech Documentation\",\"url\":\"https://docs.warmcore-tech.com\",\"publisher\":{\"@id\":\"https://docs.warmcore-tech.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture#webpage\",\"url\":\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture\",\"name\":\"ROS 2 아키텍처\",\"description\":\"X3 SDK 연동 경계 이해하기\",\"dateModified\":\"2026-11-15T07:44:05.929Z\",\"isPartOf\":{\"@id\":\"https://docs.warmcore-tech.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Xiaoling X3 SDK\",\"item\":\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ROS 2 아키텍처\",\"item\":\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture#article\",\"headline\":\"ROS 2 아키텍처\",\"name\":\"ROS 2 아키텍처\",\"description\":\"X3 SDK 연동 경계 이해하기\",\"url\":\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture\",\"mainEntityOfPage\":{\"@id\":\"https://docs.warmcore-tech.com/ko/xiaoling-x3/v1/ros2-architecture#webpage\"},\"dateModified\":\"2026-11-15T07:44:05.929Z\",\"publisher\":{\"@id\":\"https://docs.warmcore-tech.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.warmcore-tech.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Warmcore Tech Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Warmcore Tech Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/xiaoling-x3/v1/ros2-architecture.md","siteName":"Warmcore Tech Documentation","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/en/xiaoling-x3/v1/ros2-architecture"}]},{"language":"zh-Hant","pages":[{"title":"zh-Hant","href":"/zh-Hant/xiaoling-x3/v1/ros2-architecture"}]},{"language":"cn","pages":[{"title":"cn","href":"/cn/xiaoling-x3/v1/ros2-architecture"}]},{"language":"jp","pages":[{"title":"jp","href":"/jp/xiaoling-x3/v1/ros2-architecture"}]},{"language":"ko","groups":[{"group":"시작하기","pages":[{"title":"Warmcore Tech 개발자 문서","href":"/ko"}]},{"group":"Xiaoling X3 SDK","pages":[{"title":"Xiaoling X3 SDK 개요","href":"/ko/xiaoling-x3/v1/overview"},{"title":"빠른 시작","href":"/ko/xiaoling-x3/v1/quick-start"},{"title":"설치","description":"X3 SDK 프리뷰 확보와 환경 준비","href":"/ko/xiaoling-x3/v1/installation"},{"title":"ROS 2 아키텍처","href":"/ko/xiaoling-x3/v1/ros2-architecture"},{"title":"노드와 패키지","description":"실제 배포된 ROS 그래프 탐색","href":"/ko/xiaoling-x3/v1/nodes-packages"},{"title":"토픽과 서비스","href":"/ko/xiaoling-x3/v1/topics-services"},{"title":"Python API 참조","href":"/ko/xiaoling-x3/v1/python-api"},{"title":"오디오와 LLM 연동","href":"/ko/xiaoling-x3/v1/audio-llm"},{"title":"머리·눈·입","href":"/ko/xiaoling-x3/v1/head-eyes-mouth"},{"title":"예제","href":"/ko/xiaoling-x3/v1/examples"},{"title":"문제 해결","href":"/ko/xiaoling-x3/v1/troubleshooting"},{"title":"릴리스 노트","href":"/ko/xiaoling-x3/v1/release-notes"}]},{"group":"Xiaoling S100 SDK","pages":[{"title":"Xiaoling S100 SDK 개요","href":"/ko/xiaoling-s100/v1/overview"},{"title":"빠른 시작","href":"/ko/xiaoling-s100/v1/getting-started"},{"title":"설치","href":"/ko/xiaoling-s100/v1/installation"},{"title":"아키텍처","href":"/ko/xiaoling-s100/v1/architecture"},{"title":"ROS 2 노드와 패키지","href":"/ko/xiaoling-s100/v1/nodes-packages"},{"title":"Python API 참조","href":"/ko/xiaoling-s100/v1/python-api"},{"title":"ROS 2 토픽과 서비스","href":"/ko/xiaoling-s100/v1/topics-services"},{"title":"오디오와 LLM","href":"/ko/xiaoling-s100/v1/audio-llm"},{"title":"머리·눈·입","href":"/ko/xiaoling-s100/v1/head-eyes-mouth"},{"title":"RF433","href":"/ko/xiaoling-s100/v1/rf433"},{"title":"터치 이벤트","href":"/ko/xiaoling-s100/v1/touch-events"},{"title":"비전 및 추적","href":"/ko/xiaoling-s100/v1/vision-tracking"},{"title":"Pro와 Ultra 기능","href":"/ko/xiaoling-s100/v1/pro-ultra"},{"title":"예제","href":"/ko/xiaoling-s100/v1/examples"},{"title":"문제 해결과 릴리스 상태","href":"/ko/xiaoling-s100/v1/troubleshooting"},{"title":"릴리스 상태","href":"/ko/xiaoling-s100/v1/release-status"}]}]}]},"basePath":"","title":"ROS 2 아키텍처 - Warmcore Tech Documentation","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}