Wiki(으)로 돌아가기

로봇센터 SDK

RoboticsCenter Python SDK를 시작하세요: pip 로보틱센터를 설치하고 rc 연결을 실행하고, 첫 번째 텔레오프 세션이 몇 분 안에 생중계됩니다. LinkerBot O6와 VLAI L1를 지원합니다.

이 페이지에

  • [설비]
  • [하드웨어 연결]
  • [자동 탐지]
  • [장치를 지정]
  • [모크 모드]
  • [ 무슨 일이 벌어지는지 ]
  • [시션 URL]
  • [네트워크 모드]
  • [기기들을 스캔하기]
  • [파이톤 API]
  • [LinkerO6]
  • [L1Robot]
  • [환경 변수]
  • [문제 해결]

시작

  • [SDK 빠른 시작]
  • [API 참조]
  • [시션 URL & 텔레오프]

하드웨어 가이드

  • [VLAI L1 로봇]
  • [LinkerBot O6]

또한 참조

  • [← 모든 위키 기사는]
  • [로봇스 아카데미 →]
  • [플랫폼 →]
  • [문제 하나 물어봐요]

파이썬 3.10+를 빠르게 시작하세요

지원되는 하드웨어를 [platform.roboticscenter.ai]T41에 몇 분 안에 연결하십시오. 공급자 SDK가 필요하지 않습니다.

5 분 읽기 업데이트 2026년 4월

** 지원된 하드웨어:** LinkerBot O6, VLAI L1. 더 많은 장치가 곧 도착합니다.

설치

껍질 복사

$ pip 로봇 센터 설치

** 요구 사항:** 파이썬 3.10 이상. 지원 하드웨어: 링크버트 O6, VLAI L1 (더 많이 올 것). 데이터 스트리밍을 위해 [platform.roboticscenter.ai] (T43) 에서 무료 계정이 필요합니다.

하드웨어를 연결

자동 탐지 (상담)

껍질 복사

$ rc 연결

장치 지정

껍질 복사

$ rc 연결 -- 장치 링크-o6 \ # LinkerBot O6 현명한 손 $ rc 연결 -- 장치 L1 \ # VLAI L1 쌍 팔 로봇

하드웨어 없이 테스트

껍질 복사

$ rc 연결 --mock

모크 모드는 전체 시뮬레이션 장치 세션 세션 URL, 데이터 스트림 및 브라우저 패널이 실제 하드웨어와 마찬가지로 작동합니다. 로봇 또는 USB 연결이 필요하지 않습니다.

무슨 일이 벌어지는지

  1. ** 세션 생성** SDK는 platform.roboticscenter.ai에서 세션을 인증하고 생성합니다.

  2. URL 인쇄 터미널 프린트: T0

  3. ** 브라우저가 열립니다** 기본 브라우저에서 URL가 자동으로 열립니다 (또는 복사하고 붙여넣습니다).

  4. Teleop 패널 로드 브라우저는 연결된 장치에 미리 구성된 Teleop 제어 패널을 보여줍니다.

  5. ** 데이터 스트림** 센서 데이터 스트림은 자동으로 계정으로 전송됩니다.

세션 URL

T1은 고유하고 시간 제한된 세션 URL를 생성합니다:

https://platform.roboticscenter.ai/session/RC-A7B2-X9K1

이 URL를 협동자와 공유하십시오. 그들은 어떤 브라우저에서나 어디서나, 아무것도 설치하지 않고 로봇을 모니터링하거나 협동할 수 있습니다. 세션은 ** 1 시간 후에 만료됩니다. 새로운 것을 얻기 위해 다시 T2를 실행하십시오.

** 공유 팁:** 세션 URL는 링크를 가진 모든 사람에게 완전한 텔레오프 액세스를 제공합니다. 신뢰할 수있는 사람들과만 공유하십시오. 미래의 버전은 읽기 전용 게스트 토큰을 지원합니다.

네트워크 모드

플랫폼은 설정에 가장 적합한 연결 방법을 자동으로 감지합니다. 필요하다면 수동으로 오버라이드 할 수 있습니다.

Mode When to use
Auto (default) Tries local backend first, falls back to cloud. Best for most setups.
LAN Force local/intranet routing — lowest latency when robot and browser are on the same network.
Cloud Force routing through platform.roboticscenter.ai. Best when operating remotely.

브라우저에서 모드를 전환: 텔레오프 패널의 상위 바에 있는 네트워크 배지 ( / ) 를 클릭하거나 연결하기 전에 환경 변수를 설정합니다.

껍질 복사

$ RC_PLATFORM_URL=T53 rc 연결

장치에 대한 스캔

연결하기 전에 SDK가 시스템에 감지하는 모든 장치를 나열할 수 있습니다.

껍질 복사

$ rc 장치

예를 들어 출력:

포트 설명 장치 /dev/ttyUSB0 CP2102 USB-UART 다리 연결기 (ROS2 노드) VLAI L1 로봇 l1_로봇

Linux 참고: T4이 보이지 않으면 사용자 를 T5 그룹: T6에 추가 해야 합니다.

파이썬 API

프로그래밍 접근을 위해 사용자 지정 처리 파이프라인, 자동화된 데이터 수집 또는 자신의 훈련 루프와 통합을 위해 Python API를 직접 사용하십시오.

랭커봇 O6

파이썬 복사

로봇센터에서 수입 LinkerO6

장치 = LinkerO6.connect() # 자동 탐지 일련 포트 print(device.session_url) # T54

장치.스트림에 있는 프레임에 대해: print(frame.data) # 프레임에 대한 센서 가수 여기 처리

VLAI L1 로봇

파이썬 복사

로보틱스센터에서 수입 L1Robot

로봇 = L1Robot.connect(mock=True) # 테스트에 하드웨어가 필요하지 않습니다

로봇.스트림의 프레임에 대한: 관절 = 프레임.데이터['joints'] 기본 = 프레임.데이터['베이스'] print(f"왼팔: {joints['left_arm']}")

환경 변수

Variable Default Description
RC_PLATFORM_URL https://platform.roboticscenter.ai Backend URL. Override to point at a local instance or a custom Cloud Run deployment.

문제 해결

SDK를 시작했을 때 일반적인 문제점:

RC 장치들은 아무것도 보여주지 않습니다.

리눅스에서 사용자가 T9 그룹: T10에 있는지 확인하고 로그 아웃하고 다시 로그인하십시오. 윈도우에서, COM 포트를 위한 장치 관리자를 확인하세요. USB 케이블이 데이터 기능이 있는지 확인하세요.

rc 연결에 연결 시간

platform.roboticscenter.ai가 네트워크에서 접근 가능한지 확인하세요. 공기 간격 또는 제한된 LAN에 있다면, 로컬 백엔드를 가리키는 T11을 설정하세요. SDK 자체가 올바르게 설치되었는지 확인하기 위해 T12을 실행하세요.

자동 탐구는 잘못된 장치를 선택합니다

검출된 하드웨어의 목록을 나열하기 위해 T13을 사용하고, VLAI L1에 대해 T14 또는 T15을 명시적으로 연결하십시오.

브라우저 패널 로딩이 되지 않습니다

터미널에서 세션 URL를 복사하고 수동으로 열십시오. 쿠키 및 웹소켓이 브라우저 또는 프록시에서 차단되지 않도록 하십시오. 패널이 빈 상태로 남아있는 경우 인코그니토 창을 시도하십시오.

** 더 많은 도움말 필요하십니까?** 장치별 문제들을 위해 LinkerBot O6 디버깅 가이드 또는 VLAI L1 위키 참조하십시오. T16T17의 출력으로 RCSV 지원 를 연락하십시오.

** 로봇에 새로운가요?** 아직 기본을 배우고 있다면 팔, 텔레오프, ROS 2, 배포 SDK 통합에 뛰어들기 전에 [RCSV 로봇 아카데미] (T47) 를 시작하십시오.

다음 단계

VLAI L1 가이드 듀얼 팔 모바일 로봇의 완전한 설정 → LinkerBot O6 가이드 시리얼 프로토콜, 장갑 컨트롤러, 데이터 수집 → SDK API 참조 전체 파이썬 API 및 CLI 명령 참조 → 플랫폼 대시보드 세션, 녹음 및 장치를 보기 →