Introduction
개요
Vehicle SDK는 차량 정보 조회 및 제어를 위한 Vehicle API를 제공합니다. Brake, CarInfo, Door, DrivingMode, EvBattery, HVAC, Light, Odometer, Safety, Seat, SideMirror, Steeringwheel, Tire, TurnSignal, Window, Wiper 등 기능(도메인)별로 차량 상태 조회 및 제어용 API를 제공합니다.
패키지 구조와 API 명세는 Vehicle API Reference에서 확인할 수 있고, Vehicle SDK를 사용한 구현 예시는 튜토리얼과 Sample Project에서 확인할 수 있습니다.
차량 모델별 호환성
Vehicle SDK는 차량 모델에 따라 일부만 지원될 수 있습니다. API는 Door, Window, HVAC 등 기능 영역(도메인)별로 제공되며, 각 기능 영역별 지원 여부는 해당 인터페이스의 checkXXXCapability API로 확인할 수 있습니다.
개발 환경 설정
Vehicle SDK를 사용하려면 Android Studio에 Pleos Connect Emulator를 설치한 후, AVD 설정을 진행합니다.
도메인
Vehicle SDK는 기능별로 API 그룹(인터페이스)으로 나뉘며, vehicle.getXXX()로 해당 그룹 객체를 얻어 사용합니다.
| API 그룹 | 설명 |
|---|---|
| Brake | 브레이크 페달, 주차 브레이크 상태 조회 |
| CarInfo | 차량 기본 정보(외부 크기, 제조사, 연식 등) 조회 |
| Display | 인포테인먼트 표시 데이터 단위(온도 단위 등) 조회/설정 |
| Door | 도어 열림/닫힘, 잠금/해제 제어 및 상태 조회 |
| DrivingMode | 드라이브 모드, 크루즈 컨트롤 정보 조회 |
| EvBattery | EV 배터리·충전 상태 및 전비(효율) 조회 |
| HVAC | 난방·환기·공조(온도, 풍량, 습도 등) 제어 및 조회 |
| Light | 조명 상태 조회 및 제어 |
| Odometer | 총 주행 거리, 트립 주행 거리/시간, 주행 거리 단위 조회 |
| Safety | 차량 경고(Warning) 정보 조회 |
| Seat | 좌석 위치·각도·기능 제어 및 조회 |
| SideMirror | 사이드미러 열선 상태 조회/설정 |
| Steeringwheel | 핸들(스티어링휠) 상태, 열선 조회/제어 |
| Tire | 타이어 상태 조회 |
| TurnSignal | 방향 지시등 상태 조회 |
| Window | 창문 제어 및 상태 조회 |
| Wiper | 와이퍼 제어 및 상태 조회 |