본문으로 건너뛰기

클러스터 정보

클러스터 속도 조회 방법

Connect 클러스터에 보이는 속도와 앱에 표시하는 속도는 데이터 출처가 다르면 달라질 수 있습니다. 예를 들어 앱이 GPS로 속도를 계산하면, 클러스터가 쓰는 차량 신호 기반 속도와 어긋날 수 있습니다.

Connect 클러스터는 구글 PERF_VEHICLE_SPEED 프로퍼티로 차량 속도를 표시하므로, 클러스터와 동일한 속도를 쓰려면 CarPropertyManager로 PERF_VEHICLE_SPEED를 읽습니다.

AndroidManifest.xml에 Car.PERMISSION_SPEED 퍼미션 선언
Car 인스턴스를 준비합니다.
CarPropertyManager를 획득합니다.
getProperty로 현재 값을 조회합니다.
- registerCallback으로 변경 이벤트 구독 가능

// 런타임 권한: Car.PERMISSION_SPEED
// Car 준비 후
val carPropertyManager = car.getCarManager(Car.PROPERTY_SERVICE) as CarPropertyManager
// 예: 조회 (API 시그니처는 AAOS 버전에 맞게)
val prop = carPropertyManager.getProperty(
    Float::class.java,
    VehiclePropertyIds.PERF_VEHICLE_SPEED,
    VehicleAreaType.VEHICLE_AREA_TYPE_GLOBAL
)
val speedMps = prop?.value // Float, m/s

프로퍼티에 대한 자세한 설명은 구글의 공식 문서를 참조합니다.

배터리 정보 확인 방법

Vehicle SDK의 getEvBatteryStateOfCharge API를 호출하여 EV 배터리 충전 상태(SOC, %)를 확인할 수 있습니다.

getEvBatteryStateOfCharge API는 전기차 EV 배터리의 충전량을 퍼센트 단위로 반환합니다.

@RequiresPermission(value = "pleos.car.permission.CAR_ENERGY")
abstract fun getEvBatteryStateOfCharge(
    onComplete: (Int?) -> Unit,
    onFailed: (Exception) -> Unit
)

권한

Protection level: Normal
Permission: pleos.car.permission.CAR_ENERGY

콜백 파라미터

onComplete (Int?): 배터리 충전 상태를 성공적으로 가져왔을 때 호출됩니다. 값은 배터리 잔량(%)입니다.
onFailed (Exception): 배터리 충전 상태 조회에 실패했을 때 호출됩니다.

정보

이 API는 Vehicle SDK 2.1.5 버전부터 사용 가능합니다.
AndroidManifest.xml에 pleos.car.permission.CAR_ENERGY 권한을 추가해야 합니다.

클러스터 속도 조회 방법
배터리 정보 확인 방법