이 페이지에는 VHAL에서 지원되는 시스템 속성이 나와 있습니다. VHAL에서 지원하는 속성은 아래 목록의 시스템 속성 또는 공급업체 속성 중 하나여야 합니다. Android 14 이상에서는 속성 정의가 hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl
에 정의됩니다.
속성 정의는 VHAL 인터페이스 (android.hardware.automotive.vehicle
)와 별개인 AIDL 인터페이스 android.hardware.automotive.vehicle.property
에 정의됩니다. VHAL 구현과 VHAL 클라이언트는 두 인터페이스 모두에 종속되어야 합니다.
자동 생성된 액세스 모드 및 변경 모드
Android 14 이상에서는 VHAL 구현을 지원하기 위해 자동 생성된 C++ 헤더 파일 및 Java 클래스 파일을 시스템 속성에 허용된 변경 모드 또는 액세스 모드와 함께 제공합니다. 공급업체 VHAL 구현은 이를 사용하여 속성 구성이 사양을 충족하는지 확인할 수 있습니다.
A~D
ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE
어댑티브 크루즈 컨트롤 (ACC)이나 프리딕티브 크루즈 컨트롤 (PCC)을 사용할 때 앞차와의 측정 거리입니다. 선행 차량의 가장 뒤쪽 지점과 ACC 차량의 가장 앞쪽 지점 간의 측정된 거리(밀리미터)를 반환합니다. VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
는 0이어야 합니다. maxInt32Value
는 거리 센서가 지원할 수 있는 최대 범위로 채워야 합니다. 이 값은 음수가 아니어야 합니다.
선행 차량이 감지되지 않는 경우 (즉, 선행 차량이 없거나 선행 차량이 센서가 감지할 수 없을 만큼 너무 멀리 있는 경우) 이 속성은 StatusCode.NOT_AVAILABLE
를 반환해야 합니다.
CC가 사용 중지되어 이 속성을 사용할 수 없는 경우 (예: StatusCode#NOT_AVAILABLE_DISABLED
가 false임) 이 속성은 StatusCode#NOT_AVAILABLE_DISABLED
를 반환해야 합니다. CRUISE_CONTROL_STATE
가 구현되고 상태가 ErrorState
값으로 설정된 경우 이 속성은 ErrorState
값과 일치하는 StatusCode
를 반환해야 합니다. 예를 들어 CRUISE_CONTROL_STATE
가 ErrorState#NOT_AVAILABLE_SPEED_LOW
로 설정된 경우 이 속성은 StatusCode#NOT_AVAILABLE_SPEED_LOW
를 반환해야 합니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLIMETER
출시: Android 14
ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP
ACC 또는 PCC의 현재 목표 시간 간격(밀리초)입니다. 이 속성은 선행 차량과의 타겟 시간 간격을 지정해야 합니다. 이 간격은 선행 차량의 가장 뒤쪽 지점과 ACC 차량의 가장 앞쪽 지점 사이의 거리를 이동하는 데 걸리는 시간으로 정의됩니다. 선행 차량과의 실제 시간 간격은 이 값보다 높거나 낮을 수 있습니다.
타겟 시간 간격에 설정할 수 있는 값은 configArray에서 오름차순으로 지정해야 합니다. 모든 값은 양수여야 합니다. 속성을 쓸 수 있는 경우 모든 값을 쓸 수 있어야 합니다. 참조를 사용 중지했기 때문에 이 속성을 사용할 수 없는 경우 (예: CRUISE_CONTROL_ENABLED
가 false인 경우) 이 속성은 StatusCode#NOT_AVAILABLE_DISABLED
을 반환해야 합니다.
CRUISE_CONTROL_STATE
가 구현되고 상태가 ErrorState
값으로 설정된 경우 이 속성은 ErrorState
값과 일치하는 StatusCode
를 반환해야 합니다. 예를 들어 CRUISE_CONTROL_STATE
가 ErrorState#NOT_AVAILABLE_SPEED_LOW
로 설정된 경우 이 속성은 StatusCode#NOT_AVAILABLE_SPEED_LOW
를 반환해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLI_SECS
출시: Android 14
ABS_ACTIVE
자동 브레이크 시스템 (ABS)이 활성화되어 있습니다. ABS가 활성화된 경우 true로 설정되고 ABS가 꺼진 경우 false로 재설정됩니다. 이 속성은 ABS 시스템의 실시간 상태에 따라 간헐적으로 설정 (펄스)될 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
ANDROID_EPOCH_TIME
에포크 시간(밀리초)으로 인코딩된 현재 날짜 및 시간입니다. 이 값은 1970년 1월 1일(UTC) 이후 경과된 밀리초 수를 나타냅니다.
이 값은 1970년 1월 1일(UTC) 이후 경과된 밀리초 수를 나타냅니다.
VHAL이 이 속성을 지원하는 경우 CarServices는 이 값으로 WRITE
하여 VHAL에 Android 시스템 시간을 제공합니다. 이는 다른 차량 시스템 (대시 시계)을 Android 시간과 동기화하는 데 유용할 수 있습니다.
AAOS는 부팅 중에 이 속성에 한 번 WRITE
하고 이후에는 시간 소스 변경사항이 전파될 때만 WRITE
합니다. AAOS가 VehiclePropValue.timestamp를 올바르게 채웁니다. AAOS는 자연스러운 시간 경과에 관한 업데이트를 전송하지 않습니다. int64Values[0] = 제공된 Unix 시간 (밀리초)입니다.
속성이 스택을 통해 전파되는 데 0밀리초가 더 걸릴 수 있으며 타임스탬프가 지정된 속성을 사용하면 시간 편차를 줄이는 데 도움이 됩니다. 따라서 속성의 모든 WRITE
에 대해 타임스탬프를 사용하여 이 드리프트를 제거할 수 있습니다.
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLI_SECS
출시: Android 13
AP_POWER_BOOTUP_REASON
현재 전원이 켜져 있는 부팅 이유를 보고하는 속성입니다. 이는 전원이 꺼질 때까지 전체 지속 시간 동안 변경되지 않는 STATIC
속성입니다. 예를 들어 도어 잠금 해제로 전원이 자동으로 켜진 후 사용자가 전원 버튼을 눌러도 부팅 이유는 VehicleApPowerBootupReason#USER_UNLOCK
으로 유지되어야 하며 int32Values[0]
는 VehicleApPowerBootupReason
여야 합니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
AP_POWER_STATE_REPORT
앱 프로세서의 전원 상태를 보고하는 속성입니다. AP의 전원 상태는 별도의 전원 컨트롤러에 의해 제어된다고 가정합니다.
int32Values[0]
VehicleApPowerStateReport enum 값int32Values[1]
필요한 경우 기기의 절전 모드 해제 시간 (밀리초, 그 외의 경우 0)
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
AP_POWER_STATE_REQ
앱 프로세서의 전원 상태를 제어하는 속성입니다. AP의 전원 상태는 별도의 전원 컨트롤러에 의해 제어된다고 가정합니다. 구성 정보의 경우 VehiclePropConfig.configArray
에 VehicleApPowerStateConfigFlag
의 값을 결합하는 비트 플래그가 있어야 합니다.
int32Values[0]
VehicleApPowerStateReq enum 값int32Values[1]
각 상태와 관련된 추가 매개변수입니다. 사용하지 않으면 0입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
AUTOMATIC_EMERGENCY_BRAKING_ENABLED
자동 비상 제동(AEB)을 사용 설정 또는 사용 중지합니다.
AEB를 사용 설정하려면 true로, 사용 중지하려면 false로 설정합니다. AEB가 사용 설정된 경우 잠재적인 충돌을 방지하기 위해 차량의 ADAS 시스템을 켜고 모니터링해야 합니다. 이 속성은 속도가 더 빠른 애플리케이션에만 적용해야 합니다. 저속 자동 긴급 제동을 사용 설정하려면 LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED
를 사용해야 합니다.
일반적으로 AUTOMATIC_EMERGENCY_BRAKING_ENABLED
는 항상 true 또는 false를 반환해야 합니다.
차량 속도가 너무 느림과 같은 일시적인 상태로 인해 기능을 사용할 수 없는 경우 AUTOMATIC_EMERGENCY_BRAKING_STATE
속성의 ErrorState
값을 통해 해당 정보를 전달해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
AUTOMATIC_EMERGENCY_BRAKING_STATE
자동 비상 제동 (AEB) 상태입니다. AEB의 현재 상태를 반환합니다. 이 속성은 항상 AutomaticEmergencyBrakingState 또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. StatusCode
를 통해 오류를 표시해서는 안 되며 대신 지원되는 오류 상태를 사용해야 합니다. 이 속성은 속도가 더 빠른 애플리케이션에만 적용해야 합니다. 저속 자동 긴급 제동 시스템의 상태를 나타내려면 LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE
를 사용해야 합니다.
AEB에 브레이크를 활성화하기 전에 전방 충돌 경고가 포함된 경우 이러한 경고는 전방 충돌 경고 (FCW) 속성을 통해 표시되어야 합니다.
전 세계 지역 ID (0)의 경우 AutomaticEmergencyBrakingState
(OTHER
포함, 권장하지 않음) 및 ErrorState
의 모든 상태가 지원되지 않는 한 StatusCode#VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: ForwardCollisionWarningState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
BLIND_SPOT_WARNING_ENABLED
사각지대 경고(BSW)를 사용 설정 또는 사용 중지합니다. BSW를 사용 설정하려면 true로, 사용 중지하려면 false로 설정합니다. BSW가 사용 설정된 경우 차량의 ADAS 시스템이 켜져 있고 차량의 사각지대에 있는 물체를 모니터링해야 합니다.
일반적으로 BLIND_SPOT_WARNING_ENABLED
는 항상 true 또는 false를 반환해야 합니다. 차량 속도가 너무 낮은 등 일시적인 상태로 인해 기능을 사용할 수 없는 경우 BLIND_SPOT_WARNING_STATE
속성의 ErrorState
값을 통해 해당 정보를 전달해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
BLIND_SPOT_WARNING_STATE
사각지대 경고(BSW) 상태입니다. BSW의 현재 상태를 반환합니다. 이 속성은 항상 BlindSpotWarningState
또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. StatusCode
를 통해 오류를 표시해서는 안 되며 대신 지원되는 오류 상태를 사용해야 합니다.
지원되는 각 지역 ID의 경우 BlindSpotWarningState
(OTHER
포함, 권장하지 않음) 및 ErrorState
의 모든 상태가 지원되지 않는 한 StatusCode#VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: BlindSpotWarningState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
CABIN_LIGHTS_STATE
실내 조명의 상태를 반환합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13
CABIN_LIGHTS_SWITCH
운전석 조명 스위치입니다. 객실 조명을 제어하는 실제 스위치의 위치입니다.
문이 열려 있거나 음성 명령으로 인해 조명이 켜져 있는 경우 CABIN_LIGHTS_STATE
와 다를 수 있습니다. 예를 들어 스위치가 꺼짐 또는 자동 위치에 있는 경우
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
CLUSTER_DISPLAY_STATE
계기판 디스플레이 상태를 변경합니다.
- 경계: 클러스터 활동을 렌더링할 영역입니다.
- 인셋: 활동에서 중요한 정보를 배치해서는 안 되는 영역입니다.
가능한 값:
int32[0]
사용, 사용 안 함: 0 - 사용 안 함, 1 - 사용, -1 - 상관없음int32[1]
경계 - 왼쪽: 양수 - 왼쪽 위치(픽셀) -1 - 상관없음(모든 경계 필드를 설정해야 함)int32[2]
경계 - 상단: '왼쪽'과 동일한 형식int32[3]
경계 - 오른쪽: '왼쪽'과 동일한 형식int32[4]
경계 - 하단: '왼쪽'과 동일한 형식int32[5]
인셋 - 왼쪽: 양수 - 픽셀 단위의 실제 왼쪽 인셋 값 -1 - 상관없음 (모든 인셋 필드에 '관심 없음'을 설정해야 함)int32[6]
인셋 - 상단: '왼쪽'과 동일한 형식int32[7]
인셋 - 오른쪽: '왼쪽'과 동일한 형식int32[8]
Inset - bottom: 'left'와 동일한 형식
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
CLUSTER_NAVIGATION_STATE
현재 내비게이션 상태를 알립니다. bytes: NavigationStateProto의 직렬화된 메시지입니다.
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형:
단위 유형: 해당 사항 없음
출시: Android 13
CLUSTER_REPORT_STATE
현재 디스플레이 상태 및 ClusterUI 상태를 보고합니다.
ClusterHome
는 CLUSTER_SWITCH_UI
를 처리할 때 이 메시지를 전송합니다.
CLUSTER_DISPLAY_STATE
또한 ClusterHome
는 처음 시작할 때 이 메시지를 전송해야 합니다. ClusterOS가 이 메시지를 수신하고 내부 예상치가 수신된 메시지와 다른 경우 상태에 맞게 CLUSTER_SWITCH_UI
, CLUSTER_DISPLAY_STATE
를 다시 전송해야 합니다.
int32[0]
사용/사용 중지: 0 - 사용 중지, 1 - 사용int32[1]
경계 - 왼쪽int32[2]
경계 - 상단int32[3]
경계 - 오른쪽int32[4]
경계 - 하단int32[5]
인셋 - 왼쪽int32[6]
인셋 - 상단int32[7]
인셋 - 오른쪽int32[8]
인셋 - 하단int32[9]
전체 화면 또는 기본 화면의 ClusterUI 유형입니다. 0은ClusterHome
를 나타냅니다. 다른 값 뒤에는 OEM의 정의가 표시됩니다.int32[10]
현재 두 개의 UI가 표시되는 경우 하위 화면의 ClusterUI 유형입니다. -1은 더 이상 사용되지 않는 영역을 나타냅니다. bytes: ClusterUI의 가용성을 나타내는 배열입니다. 0은 사용할 수 없음을 나타내고 1은 사용할 수 있음을 나타냅니다. 예를 들어 자동차가 HOME, MAPS, CALL과 같은 세 가지 OEM 정의 ClusterUI를 지원하고, 셀룰러 네트워크를 사용할 수 있을 때만 CALL UI를 지원하는 경우 그런 다음 네트워크를 사용할 수 있는 경우 [1 1 1] 을 전송하고 네트워크에 연결되어 있지 않은 경우 [1 1 0]을 전송합니다.
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
CLUSTER_REQUEST_DISPLAY
일부 ClusterUI를 표시하도록 계기판 디스플레이 상태의 변경을 요청합니다. 현재 디스플레이 상태가 꺼져 있고 ClusterHome
가 이 메시지를 ClusterOS로 전송하여 디스플레이를 켜서 특정 ClusterUI를 표시하도록 요청합니다. ClusterOS는 CLUSTER_DISPLAY_STATE
로 응답해야 합니다.
int32
표시할 ClusterUI 유형
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
CLUSTER_SWITCH_UI
계기판 디스플레이에서 ClusterUI를 시작합니다.
int32
표시할 ClusterUI 유형입니다. 0은 계기판 디스플레이의 홈 화면인ClusterHome
을 나타내며 계기판 디스플레이에 기본 UI와 일종의 런처 기능을 제공합니다. 다른 값은 OEM 정의에 따라 다릅니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
CREATE_USER
Android 사용자가 생성된 후 Android 시스템에서 호출됩니다. HAL은 이 속성을 사용하여 이에 상응하는 사용자를 만들 수 있습니다. 비동기 요청입니다. Android는 VehiclePropValue를 설정하여 요청하고 HAL은 요청이 성공했는지 실패했는지 나타내는 속성 변경으로 응답해야 합니다. 실패하면 Android 시스템은 사용자를 삭제합니다.
요청 형식은 CreateUserRequest에 의해 정의되고 응답 형식은 CreateUserResponse에 의해 정의됩니다. 예를 들어 시스템에 사용자 2명 (0 및 10)이 있고 세 번째 사용자 (일시적인 게스트)가 생성된 경우 요청은 다음과 같습니다.
int32[0]
42 // 요청 IDint32[1]
11 // 생성된 사용자의 Android IDint32[2]
6 // 생성된 사용자의 Android 플래그 (임시 게스트)int32[3]
10 // 현재 사용자int32[4]
0 // 현재 사용자 플래그 (없음)int32[5]
3 // 사용자 수int32[6]
0 // 첫 번째 사용자 (사용자 0)int32[7]
0 // 첫 번째 사용자 플래그 (없음)int32[8]
10 // 두 번째 사용자 (사용자 10)int32[9]
0 // 두 번째 사용자 플래그 (없음)int32[10]
11 // 세 번째 사용자 (사용자 11)int32[11]
6 // 세 번째 사용자 플래그 (임시 게스트) 문자열: 'ElGuesto' // 새 사용자의 이름
요청이 성공하면 HAL은 다음을 반환합니다.
int32[0]
42 // 요청 IDint32[1]
1 // CreateUserStatus::SUCCESS
실패하면 다음 단계를 따르세요.
int32[0]
42 // 요청 IDint32[1]
2 // CreateUserStatus::FAILURE 문자열: 'D'OH!' //
의미는 블랙박스이며 호출자 (예: 설정 UI)에게 전달되어 적절한 조치를 취합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
CRITICALLY_LOW_TIRE_PRESSURE
이 속성은 각 타이어의 심각하게 낮은 압력 기준점을 나타냅니다. 타이어를 교체하거나 수리해야 하는 시점을 나타냅니다. 값은 TIRE_PRESSURE의 minFloatValue보다 작거나 같아야 합니다. 최솟값 및 최댓값 속성 값 (minFloatValue 및 maxFloatValue)은 이 속성에 적용되지 않습니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:KILOPASCAL
출시: Android 13
CRUISE_CONTROL_COMMAND
WRITE
크루즈 컨트롤 (CC) 명령어
지원되는 각 명령어에 관한 자세한 내용은 CruiseControlCommand를 참고하세요. 전역 영역 ID (0)의 경우 CruiseControlState
의 모든 상태가 지원되지 않는 한 StatusCode#VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다. 이 속성을 통해 전송된 지원되지 않는 명령어는 StatusCode#INVALID_ARG
를 반환해야 합니다. CC가 사용 중지되어 이 속성을 사용할 수 없는 경우 (예: CRUISE_CONTROL_ENABLED
가 false임) 이 속성은 StatusCode#NOT_AVAILABLE_DISABLED
를 반환해야 합니다. CRUISE_CONTROL_STATE
가 구현되고 상태가 ErrorState
값으로 설정된 경우 이 속성은 ErrorState
값과 일치하는 StatusCode
를 반환해야 합니다.
예를 들어 CRUISE_CONTROL_STATE
가 ErrorState#NOT_AVAILABLE_SPEED_LOW
로 설정된 경우 이 속성은 StatusCode#NOT_AVAILABLE_SPEED_LOW
를 반환해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: CruiseControlCommand
단위 유형: 해당 사항 없음
출시: Android 14
CRUISE_CONTROL_ENABLED
크루즈 컨트롤(CC)을 사용 설정하거나 사용 중지합니다. CC를 사용 설정하려면 true로, 사용 중지하려면 false로 설정합니다. 이 속성은 모든 형태의 CruiseControlType에서 공유됩니다. CC가 사용 설정되면 차량의 ADAS 시스템이 켜져 있고 명령에 응답해야 합니다. 일반적으로 CRUISE_CONTROL_ENABLED
는 항상 true 또는 false를 반환해야 합니다. 차량 속도가 너무 낮은 등 일시적인 상태로 인해 기능을 사용할 수 없는 경우 CRUISE_CONTROL_STATE
속성의 ErrorState
값을 통해 해당 정보를 전달해야 합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
CRUISE_CONTROL_STATE
크루즈 컨트롤(CC)의 현재 상태입니다. 이 속성은 현재 CC 상태를 반환합니다. 일반적으로 이 속성은 CruiseControlState 또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. 예를 들어 일시적인 상태로 인해 기능을 사용할 수 없는 경우 이 정보는 ErrorState
를 통해 전달되어야 합니다. 글로벌 지역 ID (0)의 경우 CruiseControlState의 모든 상태 (권장되지 않는 OTHER 포함)와 ErrorState
가 지원되지 않는 한 VehicleAreaConfig#supportedEnumValue
배열을 정의해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: CruiseControlState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
CRUISE_CONTROL_TARGET_SPEED
크루즈 컨트롤(CC)의 현재 목표 속도입니다. OEM은 이 속성의 minFloatValue 및 maxFloatValue 값을 설정하여 최소 및 최대 타겟 속도 값을 정의해야 합니다. 이러한 값은 음수가 아니어야 합니다. maxFloatValue는 타겟 속도의 상한을 나타냅니다.
minFloatValue는 목표 속도의 하한을 나타냅니다.
CC가 사용 중지되어 이 속성을 사용할 수 없는 경우 (예: CRUISE_CONTROL_ENABLED
가 false임) 이 속성은 StatusCode#NOT_AVAILABLE_DISABLED
을 반환해야 합니다. CRUISE_CONTROL_STATE
가 구현되고 상태가 ErrorState 값으로 설정된 경우 이 속성은 ErrorState 값과 일치하는 StatusCode
을 반환해야 합니다. 예를 들어 CRUISE_CONTROL_STATE
가 ErrorState#NOT_AVAILABLE_SPEED_LOW
로 설정된 경우 이 속성은 StatusCode#NOT_AVAILABLE_SPEED_LOW
를 반환해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:METER_PER_SEC
출시: Android 14
CRUISE_CONTROL_TYPE
현재 크루즈 컨트롤(CC) 유형입니다. CRUISE_CONTROL_ENABLED
가 true이면 이 속성은 현재 사용 설정된 CC 유형 (예: 표준 CC 및 적응형 CC, 예측)을 반환합니다.
일반적으로 이 속성은 CruiseControlType
또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. 예를 들어 일시적인 상태로 인해 기능을 사용할 수 없는 경우 이 정보는 ErrorState
를 통해 전달되어야 합니다. 글로벌 지역 ID (0)의 경우 CruiseControlType
의 모든 상태 (권장되지 않는 OTHER
포함)와 ErrorState
가 지원되지 않는 한 StatusCode#VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다. 이 속성에 CruiseControlType#OTHER
또는 ErrorState
를 WRITE
하려고 하면 IllegalArgumentException
이 발생합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: CruiseControlType
ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
CURRENT_GEAR
현재 기어입니다. 수동 기어가 아닌 경우 선택된 기어가 현재 기어와 일치하지 않을 수 있습니다. 예를 들어 선택된 기어가 GEAR_DRIVE
면 현재 기어는 GEAR_1
, GEAR_2
등의 하나이며 이는 변속기가 현재 작동되는 실제 기어를 반영합니다. 구성 데이터의 값은 이 차량에 지원되는 기어 목록을 나타내야 합니다. 예를 들어 자동 변속기의 구성 데이터에는 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_1, GEAR_2,...}
가 포함되어야 하며, 수동 변속기의 경우 목록이 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
여야 합니다. 이 목록은 GEAR_SELECTION
에 보고된 지원되는 기어의 목록과 동일하지 않아도 됩니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleGear
단위 유형: 해당 사항 없음
출시: Android 13
CURRENT_POWER_POLICY
VHAL 레이어에 현재 전원 정책을 알립니다. 자동차 전원 정책 서비스는 현재 전원 정책이 변경될 때 이 속성을 설정합니다.
string: "sample_policy_id" // power policy ID
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
DISABLED_OPTIONAL_FEATURES
VHAL에서 선택적 기능을 사용 중지하도록 허용합니다. 이 속성은 사용 중지해야 하는 선택적 기능을 보고합니다. 시스템에 허용되는 모든 선택적 기능은 자동차 서비스 오버레이 config_allowed_optional_car_features
에 선언됩니다. 이 속성을 사용하면 오버레이에 정의된 기능을 사용 중지할 수 있습니다. 이 속성이 없으면 오버레이에 선언된 모든 지형지물이 사용 설정됩니다.
값 READ
에는 쉼표 (,
)로 구분된 사용 중지된 모든 기능이 포함되어야 합니다.
예: com.android.car.user.CarUserNoticeService,storage_monitoring
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
DISPLAY_BRIGHTNESS
디스플레이의 밝기를 나타내는 속성입니다. 일부 차량에는 모든 디스플레이의 밝기를 제어하는 단일 컨트롤이 있습니다. 이 속성은 해당 컨트롤의 변경사항을 공유하기 위한 것입니다. 밝기가 별도로 제어되는 디스플레이가 있는 자동차에서는 PER_DISPLAY_BRIGHTNESS
를 사용해야 합니다. DISPLAY_BRIGHTNESS
와 PER_DISPLAY_BRIGHTNESS
중 하나만 구현해야 합니다. 둘 다 사용할 수 있는 경우 AAOS에서 PER_DISPLAY_BRIGHTNESS
를 사용합니다. 이 값을 쓸 수 있으면 사용자가 설정에서 디스플레이 밝기를 변경할 때 Android에서 이 값을 설정할 수 있습니다. READ
전용인 경우 사용자는 설정에서 디스플레이 밝기를 계속 변경할 수 있지만 변경사항이 다른 디스플레이에 반영되어서는 안 됩니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
DISTANCE_DISPLAY_UNITS
디스플레이의 길이 단위입니다. 자동차에서 사용자에게 거리를 표시하는 데 사용하는 단위를 나타냅니다. 예를 들어 마일, 미터, 킬로미터가 있습니다. 거리 단위는 VehicleUnit에 정의되어 있습니다.
VehiclePropConfig.configArray는 지원되는 거리 표시 단위를 나타내는 데 사용됩니다.
예를 들어 configArray[0] = METER configArray[1] = KILOMETER configArray[2] = MILE
DISTANCE_DISPLAY_UNITS
를 업데이트하면 다른 *_DISPLAY_UNITS
속성의 값에 영향을 미치는 경우 이러한 값도 업데이트되어 AAOS 프레임워크에 전달되어야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: VehicleUnit
단위 유형: 해당 사항 없음
출시: Android 13
DOOR_CHILD_LOCK_ENABLED
아동 보호 잠금 기능이 사용 설정되었습니다. 아동 보호 잠금 기능이 사용 설정된 경우 true를 반환하고 사용 중지된 경우 false를 반환합니다. 이 기능을 사용 설정하면 내부에서 문을 열 수 없습니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
DOOR_LOCK
Door lock true는 문이 잠겨 있음을 나타냅니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
DOOR_MOVE
각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
는 정의되어야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다. maxInt32Value
는 문이 열리는 동안의 최대 이동 속도를 나타냅니다. minInt32Value
는 닫히는 동안 문의 최대 이동 속도를 나타냅니다.
양수 또는 음수의 절댓값이 클수록 이동 속도가 빠릅니다. 문이 위치 한도에 도달하면 값을 0으로 재설정해야 합니다. DOOR_MOVE
값이 0이면 현재 움직임이 없다는 의미입니다.
이 속성은 특정 단위가 아닌 지정된 상대 이동 속도 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
DOOR_POS
도어 위치입니다. VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다.
minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
minInt32Value
는 문이 닫혀 있음을 나타냅니다. minInt32Value
는 0이어야 합니다.
maxInt32Value
는 문이 완전히 열려 있음을 나타냅니다. minInt32Value
과 maxInt32Value
사이의 값은 닫힌 상태와 완전히 열린 상태 간의 전환 상태를 나타냅니다.
이 속성은 특정 단위가 아닌 지정된 상대적 위치 범위입니다.
일부 차량 (미니밴)은 전자적으로 문을 열 수 있습니다. 따라서 이 속성을 WRITE
할 수 있습니다. 이 속성은 VehiclePropertyAccess
READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
E~G
ELECTRONIC_TOLL_COLLECTION_CARD_STATUS
전자 통행료 징수 카드 상태입니다. 이 속성은 이 차량의 ETC 카드 상태를 나타냅니다. 헤드 단위가 차량에 연결된 ETC 카드를 인식하면 ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
는 카드의 상태를 제공합니다. 그 외의 경우에는 이 속성이 UNAVAILABLE
이어야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: ElectronicTollCollectionCardStatus
단위 유형: 해당 사항 없음
출시: Android 13
ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
전자 통행료 징수 (ETC) 카드 유형입니다. 이 속성은 차량의 ETC 카드 유형을 나타냅니다. 헤드 단위가 차량에 연결된 ETC 카드를 인식하는 경우 이 속성은 연결된 카드 유형을 반환해야 합니다. 그렇지 않으면 이 속성은 UNAVAILABLE
여야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: ElectronicTollCollectionCardType
단위 유형: 해당 사항 없음
출시: Android 13
EMERGENCY_LANE_KEEP_ASSIST_ENABLED
비상 차선 유지 보조(ELKA)를 사용 설정하거나 사용 중지합니다. ELKA를 사용 설정하려면 true로, 사용 중지하려면 false로 설정합니다. ELKA가 사용 설정된 경우 차량의 ADAS 시스템이 켜져 있고 운전자의 안전하지 않은 차선 변경을 모니터링해야 합니다. 안전하지 않은 조작이 감지되면 ELKA는 운전자에게 경보를 보내고 조향 수정을 적용하여 차량을 원래 차선에 유지합니다.
일반적으로 EMERGENCY_LANE_KEEP_ASSIST_ENABLED
는 항상 true 또는 false를 반환해야 합니다.
차량 속도가 너무 느림과 같은 일시적인 상태로 인해 기능을 사용할 수 없는 경우 EMERGENCY_LANE_KEEP_ASSIST_STATE
속성의 ErrorState
값을 통해 해당 정보를 전달해야 합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
EMERGENCY_LANE_KEEP_ASSIST_STATE
비상 차선 유지 보조(ELKA) 상태입니다. ELKA의 현재 상태를 반환합니다. 일반적으로 이 속성은 EmergencyLaneKeepAssistState
또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. 예를 들어 일시적인 상태로 인해 기능을 사용할 수 없는 경우 이 정보는 ErrorState
를 통해 전달되어야 합니다. 전 세계 지역 ID (0)의 경우 EmergencyLaneKeepAssistState
의 모든 상태 (권장되지 않는 OTHER 포함)와 ErrorState
가 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: EmergencyLaneKeepAssistState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
ENGINE_COOLANT_TEMP
엔진 냉각수 온도입니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:CELSIUS
출시: Android 13
ENGINE_IDLE_AUTO_STOP_ENABLED
엔진 공회전 자동 중지 기능을 나타냅니다. 이 값이 true이면 차량이 필요하지 않을 때 자동으로 엔진을 끄고 필요할 때 자동으로 다시 시작할 수 있습니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
ENGINE_OIL_LEVEL
엔진 오일 수준입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleOilLevel
단위 유형: 해당 사항 없음
출시: Android 13
ENGINE_OIL_TEMP
엔진 오일 온도입니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:CELSIUS
출시: Android 13
ENGINE_RPM
분당 엔진 회전수(RPM)입니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:RPM
출시: Android 13
ENV_OUTSIDE_TEMPERATURE
외부 온도입니다. 이 속성은 차량 외부 환경의 온도 측정값을 전달해야 합니다. 외부 온도를 측정하는 센서가 여러 개인 경우 이 속성은 외부 환경의 온도를 가장 잘 나타내는 측정값의 평균 또는 의미 있는 가중 평균으로 채워야 합니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:CELSIUS
출시: Android 13
EV_BATTERY_DISPLAY_UNITS
디스플레이용 EV 배터리 단위입니다. 자동차에서 EV 배터리 정보를 사용자에게 표시하는 데 사용하는 단위를 나타냅니다. 예를 들어 와트-시간 (Wh), 킬로와트-시간 (kWh) 또는 암페어-시간 (Ah)이 있습니다.
VehiclePropConfig.configArray
는 지원되는 전기 에너지를 나타내는 데 사용됩니다.
단위입니다. 전기 에너지 단위는 VehicleUnit
에 정의되어 있습니다. 예를 들면 다음과 같습니다.
configArray[0] = WATT_HOUR configArray[1] = AMPERE_HOURS configArray[2] = KILOWATT_HOUR
EV_BATTERY_DISPLAY_UNITS
를 업데이트하면 다른 *_DISPLAY_UNITS
속성의 값에 영향을 미치는 경우 이러한 값도 업데이트되어 AAOS 프레임워크에 전달되어야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleUnit
단위 유형: 해당 사항 없음
출시: Android 13
EV_BATTERY_INSTANTANEOUS_CHARGE_RATE
EV 순간 충전 속도(밀리와트)입니다. 양수 값은 배터리가 충전 중임을 나타냅니다. 음수 값은 배터리가 방전되고 있음을 나타냅니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MW
출시: Android 13
EV_BATTERY_LEVEL
EV 또는 하이브리드 여부와 관계없이 현재 배터리 수준을 반환합니다. 이 값은 EV_CURRENT_BATTERY_CAPACITY
를 초과하지 않습니다. 배터리 잔량 비율을 계산하려면 (EV_BATTERY_LEVEL
, EV_CURRENT_BATTERY_CAPACITY
)*100을 사용하세요.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:WH
출시: Android 13
EV_BRAKE_REGENERATION_LEVEL
전기자동차의 회생제동 수준입니다. VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
과 maxInt32Value
사이의 모든 값을 지원해야 합니다. minInt32Value
는 0이어야 합니다. maxInt32Value
는 제동 시 재생되는 최대 에너지의 설정을 나타냅니다. minInt32Value
은 회생 제동이 적용되지 않는 설정을 나타냅니다. 이 속성은 EV_REGENERATIVE_BRAKING_STATE
의 더 세분화된 형태입니다. EvRegenerativeBrakingState
의 상태가 OEM에 충분히 세분화되지 않은 경우 사용자가 더 구체적인 수준의 회생 제동을 설정할 수 있습니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_CURRENT_DRAW_LIMIT
사용자가 설정한 충전을 위한 최대 전류 견인량 임계값을 나타냅니다.
EvChargeState::configArray[0]
는 차량에서 허용되는 최대 전류 견인량(암페어)을 지정하는 데 사용됩니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITEREAD
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:AMPERE
출시: Android 13
EV_CHARGE_PERCENT_LIMIT
사용자가 설정한 최대 충전 비율 임계값을 나타냅니다. 사용자가 설정한 최대 충전 비율 임계값을 나타냅니다. 0에서 100 사이의 부동 소수점 값을 반환합니다.
configArray는 유효한 값을 지정하는 데 사용됩니다. 예를 들어 차량이 다음과 같은 충전 비율 제한 값[20, 40, 60, 80, 100] 을 지원하는 경우 configArray는 {20, 40, 60, 80, 100}이어야 합니다. configArray가 비어 있으면 0~100 사이의 모든 값이 유효해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE,
, READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_PORT_CONNECTED
EV 충전 포트가 연결되었습니다. 차량에 충전 포트가 여러 개인 경우 이 속성은
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_PORT_OPEN
EV 충전 포트가 열려 있습니다. 차량에 충전 포트가 여러 개인 경우 충전 포트가 열려 있으면 이 속성이 true를 반환해야 합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITEREAD
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_STATE
자동차의 충전 상태
자동차의 현재 충전 상태를 반환합니다.
차량의 목표 충전 비율이 100이 아닌 경우 배터리 충전 수준이 목표 수준에 도달하면 이 속성은 EvChargeState::STATE_FULLY_CHARGED
를 반환해야 합니다. 자세한 내용은 EvChargeState::EV_CHARGE_PERCENT_LIMIT
를 참고하세요.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: EvChargeState
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_SWITCH
EV 배터리 충전을 시작하거나 중지합니다. 사용자가 원하는 설정입니다. 이 속성을 true로 설정하면 배터리 충전이 시작되고 false로 설정하면 충전이 중지됩니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITEREAD
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_TIME_REMAINING
남은 예상 충전 시간(초)입니다. 차량이 충전 중이 아니면 0을 반환합니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:SECS
출시: Android 13
EV_CURRENT_BATTERY_CAPACITY
EV 또는 하이브리드 차량의 현재 사용 가능한 배터리 용량입니다. EV 또는 하이브리드인 경우 배터리 용량의 실제 값을 반환합니다. 이 속성은 배터리 노화 및 온도 종속과 같은 요소를 고려하여 실시간으로 사용 가능한 배터리 용량을 캡처합니다. 이 값은 INFO_EV_BATTERY_CAPACITY
와 다를 수 있습니다. INFO_EV_BATTERY_CAPACITY
는 차량이 새 차일 때의 공칭 배터리 용량을 반환하기 때문입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:WH
출시: Android 14
EV_REGENERATIVE_BRAKING_STATE
자동차의 회생제동 또는 원 페달 드라이브 설정입니다. 자동차의 회생 제동 설정과 관련된 현재 설정을 반환합니다. OEM에 EvRegenerativeBrakingState
에 제공된 것보다 더 많은 설정이 필요한 경우 더 세부적인 정보를 제공하는 EV_BRAKE_REGENERATION_LEVEL
속성을 대신 사용할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: EvRegenerativeBrakingState
단위 유형: 해당 사항 없음
출시: Android 13
EV_STOPPING_MODE
차량의 현재 중지 모드의 속성을 나타냅니다. 전 세계 지역 ID (0)의 경우 EvStoppingMode
의 모든 enum 값이 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues
를 정의해야 합니다. 향후 더 많은 상태를 포함하도록 EvStoppingMode
enum이 확장될 수 있습니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: EvStoppingMode
단위 유형: 해당 사항 없음
출시: Android 14
EVS_SERVICE_REQUEST
EVS 서비스를 사용 설정하고 요청합니다. 이 속성은 EVS 서비스를 트리거하는 방법을 제공합니다. VHAL은 이 속성을 사용하여 Android에 EVS 서비스를 시작하거나 중지하도록 요청해야 합니다.
int32Values[0]
EVS 서비스 유형입니다. 값은 EvsServiceType의 enum이어야 합니다.int32Values[1]
EVS 서비스의 상태입니다. 값은 EvsServiceState의 enum 중 하나여야 합니다.
예를 들어 후방 EVS 서비스를 사용 설정하려면 Android에서 속성 값을 다음과 같이 설정할 수 있습니다.
[EvsServiceType::REAR_VIEW, EvsServiceState::ON]
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EXTERNAL_CAR_TIME
에포크 시간 (밀리초)으로 인코딩된 cr의 현재 날짜 및 시간 제안입니다. 이 값은 1970년 1월 1일(UTC) 이후 경과된 밀리초 수를 나타냅니다. 이 속성은 CarTime이 Android로 변경되었음을 나타냅니다. 속성이 지원되는 경우 VHAL은 이 속성이 읽힐 때 가장 정확한 현재 CarTime을 보고하고 CarTime 값이 변경될 때 이 속성의 변경사항을 게시해야 합니다.
이 속성의 변경 이벤트는 자연스러운 시간 경과 이외의 이유로 CarTime이 변경될 때 게시되어야 합니다 (500ms 미만의 시간 차이는 변경 이벤트를 트리거해서는 안 됨). Android는 이 속성을 읽고 구독하여 VHAL에서 시간을 가져옵니다. 이는 Android의 시간을 다른 차량 시스템 (대시 시계)과 동기화하는 데 유용할 수 있습니다. int64Values[0] = 제공된 Epoch 시간 (밀리초) 속성의 새 값이 수신될 때마다 AAOS는 ExternalTimeSuggestion을 생성하여 TimeDetectorService로 전송합니다.
다른 소스의 우선순위가 더 높지 않으면 Android는 이를 사용하여 시스템 시간을 설정합니다. 시간 소스 우선순위를 조정하는 방법과 시간 제안이 처리되는 방식(Android에서 gitter, 드리프트, 최소 해상도를 처리하는 방식 포함)에 관한 자세한 내용은 시간 감지기 서비스 문서를 참고하세요.
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
프로토콜(예: GNSS, NTP, 전화)을 사용하여 ECU에서 시간을 검색하는 데 이 속성을 사용하지 않는 것이 좋습니다. 이러한 프로토콜은 이미 Android에서 지원되므로 이 속성을 사용하여 VHAL을 통해 연결하는 대신 Android 시스템을 사용하는 것이 좋습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLI_SECS
출시: Android 13
FOG_LIGHTS_STATE
안개등 상태입니다. 안개등의 현재 상태를 반환합니다. 다음에 해당하는 경우:
- 자동차에 전면 및 후면 안개등이 있습니다. 전면 및 후면 안개등은 함께만 제어할 수 있습니다.
FOG_LIGHTS_STATE
를 구현해야 합니다.FRONT_FOG_LIGHTS_STATE
및REAR_FOG_LIGHTS_STATE
는 구현하면 안 됩니다. - 전면 및 후면 안개등은 독립적으로만 제어할 수 있습니다.
FOG_LIGHTS_STATE
는 구현되어서는 안 되며FRONT_FOG_LIGHTS_STATE
및REAR_FOG_LIGHTS_STATE
는 구현되어야 합니다. - 차량에 전면 안개등만 있습니다.
FOG_LIGHTS_STATE
또는FRONT_FOG_LIGHTS_STATE
중 하나만 구현해야 합니다 (둘 다 아님).REAR_FOG_LIGHTS_STATE
는 구현하면 안 됩니다. - 차량에 후방 안개등이만 있습니다.
FOG_LIGHTS_STATE
또는REAR_FOG_LIGHTS_STATE
중 하나만 구현해야 합니다 (둘 다 아님).FRONT_FOG_LIGHTS_STATE
는 구현하면 안 됩니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13
FOG_LIGHTS_SWITCH
안개등 스위치입니다. 사용자가 원하는 설정입니다. 다음에 해당하는 경우:
- 자동차에 전면 및 후면 안개등이 모두 있습니다. 전면 및 후면 안개등을 함께만 제어할 수 있는 경우
FOG_LIGHTS_SWITCH
를 구현해야 합니다.FRONT_FOG_LIGHTS_SWITCH
및REAR_FOG_LIGHTS_SWITCH
는 구현하면 안 됩니다. - 전면 및 후면 안개등은 독립적으로만 제어할 수 있습니다.
FOG_LIGHTS_SWITCH
는 구현하면 안 됩니다.FRONT_FOG_LIGHTS_SWITCH
및REAR_FOG_LIGHTS_SWITCH
를 구현해야 합니다. - 차량에 전면 안개등만 있습니다.
FOG_LIGHTS_SWITCH
또는FRONT_FOG_LIGHTS_SWITCH
중 하나만 구현해야 합니다 (둘 다 아님).REAR_FOG_LIGHTS_SWITCH
는 구현하면 안 됩니다. - 차량에 후방 안개등이만 있습니다.
FOG_LIGHTS_SWITCH
또는REAR_FOG_LIGHTS_SWITCH
중 하나만 구현해야 합니다 (둘 다 구현하면 안 됨).FRONT_FOG_LIGHTS_SWITCH
는 구현하면 안 됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
FORWARD_COLLISION_WARNING_ENABLED
전방 충돌 경고(FCW)를 사용 설정하거나 중지합니다. FCW를 사용 설정하려면 true로 설정하고 FCW를 사용 중지하려면 false로 설정합니다. FCW가 사용 설정된 경우 차량의 ADAS 시스템이 켜져 있고 잠재적 충돌을 모니터링해야 합니다. 일반적으로 FORWARD_COLLISION_WARNING_ENABLED
는 항상 true 또는 false를 반환해야 합니다. 차량 속도가 너무 낮은 등 일시적인 상태로 인해 기능을 사용할 수 없는 경우 FORWARD_COLLISION_WARNING_STATE
속성의 ErrorState
값을 통해 해당 정보를 전달해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
FORWARD_COLLISION_WARNING_STATE
전방 충돌 경고(FCW) 상태입니다. FCW의 현재 상태를 반환합니다. 이 속성은 항상 ForwardCollisionWarningState
또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. StatusCode를 통해 오류를 표시해서는 안 되며 대신 지원되는 오류 상태를 사용해야 합니다.
전 세계 지역 ID (0)의 경우 ForwardCollisionWarningState
(권장되지 않는 OTHER 포함) 및 ErrorState
의 모든 상태가 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: ForwardCollisionWarningState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
FRONT_FOG_LIGHTS_STATE
전면 안개등 상태입니다. 전면 안개등의 현재 상태를 반환합니다. FOG_LIGHTS_STATE
또는 FRONT_FOG_LIGHTS_STATE
중 하나만 구현하면 됩니다.
자세한 내용은 FOG_LIGHTS_STATE
관련 문서를 참고하세요.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13
FRONT_FOG_LIGHTS_SWITCH
전면 안개등 스위치입니다. 사용자가 원하는 설정입니다. FOG_LIGHTS_SWITCH
또는 FRONT_FOG_LIGHTS_SWITCH
중 하나만 구현하면 됩니다. 자세한 내용은 FOG_LIGHTS_SWITCH
관련 문서를 참고하세요.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME
디스플레이용 연료 소비 단위입니다.
자동차에서 사용자에게 연료 소비 정보를 표시하는 데 사용하는 단위 유형을 나타냅니다. 참은 단위가 MPG와 같이 거리/용량임을 나타냅니다. False는 단위가 거리에 대한 부피(예: L/100KM)임을 나타냅니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
FUEL_DOOR_OPEN
연료 주입구 도어가 열려 있습니다. 이 속성은 차량의 연료 주입구 도어가 열려 있는지 여부를 전달해야 합니다.
이 속성은 전기자동차에는 적용되지 않습니다. 즉, INFO_FUEL_TYPE
에 FuelType::FUEL_TYPE_ELECTRIC
만 포함된 경우 이 속성을 구현해서는 안 됩니다. EV의 경우 EV_CHARGE_PORT_OPEN
를 구현합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
FUEL_LEVEL
차량에 남아 있는 연료(밀리리터)입니다. 이 속성은 차량에 남아 있는 현재 연료의 양을 밀리리터 단위로 전달해야 합니다. 이 속성은 전기 자동차에 적용되지 않습니다. 즉, INFO_FUEL_TYPE
에 FuelType::FUEL_TYPE_ELECTRIC
만 포함된 경우 이 속성을 구현해서는 안 됩니다. 전기자동차의 경우 EV_BATTERY_LEVEL
값은 INFO_FUEL_CAPACITY
이하여야 합니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLILITER
출시: Android 13
FUEL_LEVEL_LOW
연료 부족 경고입니다. 이 속성은 대시보드의 연료 부족 경고에 해당합니다.
FUEL_LEVEL_LOW
가 설정되면 차량에 더 많은 연료를 추가할 때까지 지워서는 안 됩니다. 이 속성은 차량의 모든 연료 소스를 고려할 수 있습니다. 예를 들어 다음과 같은 경우
- 가솔린 차량: 이 속성은 연료 잔량만을 기반으로 합니다.
- 배터리 구동 차량: 이 속성은 배터리 잔량만을 기반으로 합니다.
- 하이브리드 차량: 이 속성은 OEM의 재량에 따라 가솔린 및 배터리 수준의 조합을 기반으로 할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
FUEL_VOLUME_DISPLAY_UNITS
디스플레이용 연료량 단위입니다. 자동차에서 사용자에게 연료량을 표시하는 데 사용하는 단위를 나타냅니다. 예를 들면 리터 또는 갤런입니다. VehiclePropConfig.configArray
는 지원되는 연료량 표시 단위를 나타내는 데 사용됩니다. 볼륨 단위는 VehicleUnit
에 정의됩니다. 예를 들어 configArray[0] = LITER configArray[1] = GALLON
입니다. FUEL_VOLUME_DISPLAY_UNITS
업데이트가 다른 *_DISPLAY_UNITS
속성의 값에 영향을 미치는 경우 해당 값도 업데이트되어 AAOS 프레임워크에 전달되어야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleUnit
단위 유형: 해당 사항 없음
출시: Android 13
GEAR_SELECTION
사용자가 선택한 기어입니다. 구성 데이터의 값은 이 차량에 지원되는 기어 목록을 나타내야 합니다. 예를 들어 자동 변속기의 구성 데이터에는 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK,
가 포함되어야 하고 수동 변속기의 경우 목록은 GEAR_DRIVE
, GEAR_1, GEAR_2,...}{GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
여야 합니다. 운전자가 필요에 따라 특정 기어를 선택할 수 있는 자동 변속기 차량(예: 수동 모드)의 경우 GEAR_SELECTION
값은 GEAR_DRIVE
대신 운전자가 선택한 특정 기어로 설정해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleGear
단위 유형: 해당 사항 없음
출시: Android 13
GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT
EU의 일반 보안 규정 준수 요구사항입니다. 일반 보안 규정 준수가 필요한지 여부와 필요한 경우 요구사항 유형을 나타내는 값을 반환합니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: GsrComplianceRequirementType
단위 유형: 해당 사항 없음
출시: Android 14
GLOVE_BOX_DOOR_POS
글러브 박스 도어의 현재 위치를 나타내는 속성입니다. VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다.
minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
minInt32Value
은 글러브 박스 도어가 닫혀 있음을 나타냅니다.
minInt32Value
는 0이어야 합니다. maxInt32Value
는 글러브 박스 도어가 완전히 열린 위치에 있음을 나타냅니다. minInt32Value
과 maxInt32Value
사이의 값은 닫힌 상태와 완전히 열린 상태 간의 전환 상태를 나타냅니다.
이 속성은 특정 단위가 아닌 지정된 상대적 위치 범위입니다.
영역 ID는 글러브 박스를 사용할 좌석과 일치해야 합니다. 예를 들어 앞 우측 대시보드에 글러브 박스가 삽입되어 있으면 영역 ID는 SEAT_1_RIGHT
여야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
GLOVE_BOX_LOCKED
글러브 박스를 잠그거나 잠금 해제합니다. true인 경우 글러브 박스가 잠겨 있습니다. false인 경우 글러브 박스가 잠금 해제되어 있습니다. 영역 ID는 글러브 박스를 사용할 좌석과 일치해야 합니다. 예를 들어 앞 우측 대시보드에 글로브 박스가 삽입되어 있으면 영역 ID는 VehicleAreaSeat#ROW_1_RIGHT
이어야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
H~I
HANDS_ON_DETECTION_DRIVER_STATE
직접식 감지 (HOD) 드라이버 상태입니다. 운전자의 손이 스티어링 휠에 있는지 여부를 반환합니다. 일반적으로 이 속성은 HandsOnDetectionDriverState
또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. 예를 들어 일시적인 상태로 인해 기능을 사용할 수 없는 경우 이 정보는 ErrorState
를 통해 전달되어야 합니다. 운전자의 손이 너무 오랫동안 스티어링 휠에서 벗어나 있어 차량에서 사용자에게 경고를 보내려는 경우 경고는 HANDS_ON_DETECTION_WARNING
를 통해 표시되어야 합니다. 전역 지역 ID (0)의 경우 HandsOnDetectionDriverState
(권장되지 않는 OTHER 포함) 및 ErrorState
의 모든 상태가 지원되는 것이 아니라면 VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: HandsOnDetectionDriverState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
HANDS_ON_DETECTION_ENABLED
직접식 감지 (HOD)를 사용 설정하거나 사용 중지합니다. HOD를 사용 설정하려면 true로, 사용 중지하려면 false로 설정합니다.
HOD가 사용 설정된 경우 차량 내부의 시스템은 운전자의 손이 핸들에 있는지 모니터링하고 운전자의 손이 더 이상 핸들에 있지 않다고 감지되면 경고를 전송해야 합니다. 일반적으로 HANDS_ON_DETECTION_ENABLED
는 항상 true 또는 false를 반환해야 합니다.
임시 상태로 인해 기능을 사용할 수 없는 경우 이 정보는 HANDS_ON_DETECTION_STATE
속성의 ErrorState
값을 통해 전달되어야 합니다.
이 속성은 minInt32Value
VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
HANDS_ON_DETECTION_WARNING
직접식 감지 (HOD) 경고 운전자가 핸들을 너무 오랫동안 놓아둔 것에 대한 경고가 전송되는지 여부를 반환합니다. 일반적으로 이 속성은 HandsOnDetectionWarning
또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. 예를 들어 일시적인 상태로 인해 기능을 사용할 수 없는 경우 이 정보는 ErrorState
를 통해 전달되어야 합니다. 전 세계 지역 ID (0)의 경우 HandsOnDetectionWarning
(권장되지 않는 OTHER 포함) 및 ErrorState
의 모든 상태가 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: HandsOnDetectionWarning/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
HAZARD_LIGHTS_STATE
경고등 상태입니다. 비상 경고등의 현재 상태를 반환합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13
HAZARD_LIGHTS_SWITCH
비상 경고등 스위치입니다. 사용자가 원하는 설정입니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
HEADLIGHTS_STATE
헤드라이트 상태입니다. 헤드라이트의 현재 상태를 반환합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13
HEADLIGHTS_SWITCH
헤드라이트 스위치입니다. 사용자가 원하는 설정입니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
HIGH_BEAM_LIGHTS_STATE
상향등 상태입니다. 현재 상향등 상태를 반환합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13
HIGH_BEAM_LIGHTS_SWITCH
상향등 스위치입니다. 사용자가 원하는 설정입니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_AC_ON
지정된 areaId의 에어컨을 켜거나 끕니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_ACTUAL_FAN_SPEED_RPM
실제 팬 속도입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_AUTO_ON
자동 실내 온도 조절기를 켜거나 끕니다.
true이면 자동 실내 온도 조절기가 켜져 있는 것입니다. false인 경우 자동 온도 조절이 꺼져 있습니다. 차량에서 자동 온도 조절을 직접 사용 중지할 수 없는 경우 OEM은 VHAL 구현에 HVAC_AUTO_ON
를 false로 설정하는 로직을 추가해야 합니다. 그러면 필요한 HVAC 설정이 변경되어 HVAC_AUTO_ON
가 간접적으로 사용 중지됩니다. 이때 사용자에게 방해가 되지 않는 것이 이상적입니다. OEM은 자동 온도 조절이 꺼져 있을 때 수정된 설정을 이전 상태로 되돌려야 합니다. 이렇게 하면 HVAC_AUTO_ON
가 꺼지는 것만으로 끝납니다. HVAC 설정을 이전 설정으로 복원할 수 없는 경우 OEM은 가장 방해가 되지 않는 변경사항을 구현해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_AUTO_RECIRC_ON
자동 내기 순환 사용 설정 또는 중지. 자동 내기 순환이 사용 설정되어 있으면 차량에서 공기질이 좋지 않은 것을 감지하면 HVAC 시스템이 자동으로 내기 순환 모드로 전환될 수 있습니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_DEFROSTER
지정된 창에 팬 기반 성에 제거 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_DUAL_ON
영역 간의 온도 결합을 사용 설정합니다. HVAC_DUAL_ON
속성의 AreaIDs
에는 함께 결합할 수 있는 HVAC_TEMPERATURE_SET
AreaIDs
조합이 포함되어야 합니다. HVAC_TEMPERATURE_SET
가 AreaIDs
[a_1, a_2, ..., a_n]에 매핑되고 HVAC_DUAL_ON
를 사용 설정하여 a_i와 a_j를 결합할 수 있는 경우 HVAC_DUAL_ON
속성을 [a_i | a_j]에 매핑해야 합니다. 또한 a_k와 a_l을 별도로 결합할 수도 있는 경우 HVAC_DUAL_ON
는 [a_i | a_j, a_k | a_l]에 매핑되어야 합니다.
예를 들어 자동차에 앞좌석 2개 (ROW_1_LEFT
및 ROW_1_RIGHT
)와 뒷좌석 3개 (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT)가 있습니다.
운전자 측과 조수석 측 온도 조절 장치 2개가 있으며 원하는 경우 동기화할 수 있습니다. AreaIDs
에서 다음과 같이 표현할 수 있습니다.
HVAC_TEMPERATURE_SET > [ROW_1_LEFT | ROW_2_LEFT, ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT] HVAC_DUAL_ON > [ROW_1_LEFT | ROW_2_LEFT | ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT]
이 속성이 사용 설정되면 ECU는 영향을 받는 영역의 온도를 동기화해야 합니다.
DUAL_ON 매개변수를 사용 설정하거나 사용 중지하는 부작용으로 수정된 모든 매개변수는 VHAL에 대한 onPropertyEvent()
콜백을 생성해야 합니다. 또한 온도 설정(예: 운전자 온도)으로 인해 다른 온도 (예: 앞좌석 승객 온도)가 변경되면 적절한 onPropertyEvent()
콜백이 생성되어야 합니다.
사용자가 결합을 중단하는 온도를 변경하는 경우 (예: 승객 온도를 독립적으로 설정) VHAL은 적절한 onPropertyEvent()
콜백(HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx
포함)을 전송해야 합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_ELECTRIC_DEFROSTER_ON
전기 해동기의 상태입니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_FAN_DIRECTION
팬 방향 설정 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleHvacFanDirection
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_FAN_DIRECTION_AVAILABLE
팬 위치를 사용할 수 있습니다. 이 필드는 영역에서 사용할 수 있는 팬 위치의 비트 마스크입니다. 사용 가능한 각 팬 방향은 벡터에 별도의 항목으로 표시됩니다. 팬 방향에는 vehicle_hvac_fan_direction
세트의 비트가 여러 개 있을 수 있습니다. 예를 들어 일반적인 자동차에는 다음과 같은 팬 위치가 있을 수 있습니다.
- FAN_DIRECTION_FACE (0x1) - FAN_DIRECTION_FLOOR (0x2) - FAN_DIRECTION_FACE | FAN_DIRECTION_FLOOR (0x3) - FAN_DIRECTION_DEFROST (0x4) - FAN_DIRECTION_FLOOR | FAN_DIRECTION_DEFROST (0x6)
변경 모드: STATIC
액세스 모드: READ
Enum 유형: VehicleHvacFanDirection
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_FAN_SPEED
팬 속도 설정 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
minInt32Value
가장 낮은 팬 속도maxInt32Value
가장 높은 팬 속도
이 속성은 특정 단위가 아닌 지정된 상대 속도 범위로 표시됩니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현하도록 선택할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_MAX_AC_ON
MAX AC 켜기 또는 끄기. MAX AC가 켜져 있으면 ECU는 차량을 최대한 빨리 냉각하기 위해 필요에 따라 통풍구 위치, 팬 속도, 온도와 같은 항목을 조정할 수 있습니다. MAX AC 매개변수를 사용 설정하거나 사용 중지하는 부작용으로 수정된 매개변수는 VHAL에 대한 onPropertyEvent()
콜백을 생성합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_MAX_DEFROST_ON
MAX DEFROST를 켜거나 끕니다. MAX DEFROST가 켜져 있으면 ECU는 창문을 최대한 빨리 제상할 수 있도록 필요에 따라 통풍구 위치, 팬 속도, 온도와 같은 항목을 조정할 수 있습니다.
MAX DEFROST 매개변수를 사용 설정하거나 사용 중지하는 부작용으로 수정된 모든 매개변수는 VHAL에 대한 onPropertyEvent()
콜백을 생성합니다. HVAC_MAX_DEFROST_ON
의 AreaIDs
는 해당 영역에서 MAX DEFROST를 제어할 수 있음을 나타냅니다. 예를 들어 areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT}
는 HVAC_MAX_DEFROST_ON
가 앞쪽 좌석에서만 제어할 수 있음을 나타냅니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_POWER_ON
HVAC의 전역 전원 상태를 나타냅니다. 이 속성을 false로 설정하면 개별 HVAC 기능 및 하위 시스템을 제어하는 일부 속성이 UNAVAILABLE 상태로 표시될 수 있습니다. 이 속성을 true로 설정하면 개별 HVAC 기능과 하위 시스템을 제어하는 일부 속성이 AVAILABLE 상태로 표시될 수 있습니다 (일부 또는 모든 속성이 자체적으로 UNAVAILABLE 상태인 경우 제외).
HvacPower_DependentProperties
는 HVAC의 전원을 켜야 기능을 사용할 수 있는 속성입니다. 예를 들어 일부 자동차에서는 에어컨을 켜려면 먼저 HVAC의 전원을 켜야 합니다. HvacPower_DependentProperties
목록은 VehiclePropConfig.configArray
에 설정되어야 하며 HvacPower_DependentProperties
에는 VehicleArea:SEAT
와 연결된 속성만 포함되어야 합니다.
HVAC_POWER_ON
속성의 AreaID 매핑에는 HvacPower_DependentProperties
가 매핑된 모든 AreaIDs
가 포함되어야 합니다. 예를 들어 자동차에는 다음 두 가지가 있습니다.
- 앞좌석 (
ROW_1_LEFT
,ROW_1_RIGHT
) 및 뒷좌석 3개(ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) 차량 전체의 HVAC 기능 (에어컨, 온도 등)이 단일 HVAC 전원 컨트롤러에 종속되는 경우HVAC_POWER_ON
는 [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
- 앞줄 좌석 (
ROW_1_LEFT
,ROW_1_RIGHT
)과 두 번째 줄 (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT
) 및 세 번째 줄(ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT
) 좌석 3개가 있습니다. 차량에 뒷좌석의 온도 조절기와 완전히 독립적으로 작동할 수 있는 앞좌석 온도 조절기가 있는 경우HVAC_POWER_ON
를 두 요소 배열에 매핑해야 합니다.- ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_RECIRC_ON
재순환 켜기/끄기. 객실로 외부 공기를 공급하는 기능을 제어합니다. Recirc
on은 객실로 유입되는 공기의 대부분이 객실에서 발생한다는 의미입니다. 리시르크 off는 객실로 들어오는 공기의 대부분이 차량 외부에서 들어오는 것을 의미합니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_SEAT_TEMPERATURE
좌석 난방 및 냉방 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
maxInt32Value
는 최대 좌석 온도 난방 설정을 나타냅니다.
차량에서 좌석 냉방을 지원하지 않는 한 minInt32Value
는 0이어야 합니다. 이 경우 minInt32Value
는 최대 좌석 온도 냉각 설정을 나타냅니다.
이 속성은 특정 단위가 아닌 지정된 상대 온도 설정 범위 내에 있습니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_SEAT_VENTILATION
좌석 환기 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다. minInt32Value
는 0이어야 합니다. maxInt32Value
는 좌석에 적용할 수 있는 최대 환기 설정을 나타냅니다.
이 속성은 특정 단위가 아닌 지정된 환기 설정 범위 내에 있습니다.
HVAC 앱과 어시스턴트에서 좌석 환기 상태를 사용 설정, 변경 또는 읽는 데 사용됩니다. 이는 좌석 냉방과는 다릅니다. 냉방과 동시에 켜져 있을 수도 있고 아닐 수도 있습니다.
이 속성은 >VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_SIDE_MIRROR_HEAT
사이드미러 난방 값이 클수록 사이드미러의 난방 수준이 높습니다.
VehicleAreaConfig
에서 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
과 maxInt32Value
사이의 모든 정수가 지원되어야 합니다. 구성 데이터에서 다음을 실행합니다.
maxInt32Value
는 최대 난방 수준을 나타냅니다.minInt32Value
는 0이어야 하며 난방이 없음을 나타냅니다.
이 속성은 특정 단위가 아닌 지정된 범위의 상대 난방 설정으로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 이를 VehiclePropertyAccess.READ
로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_STEERING_WHEEL_HEAT
스티어링 휠의 난방 및 냉방 수준을 설정합니다. VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
maxInt32Value
는 최대 스티어링 휠 난방 설정을 나타냅니다. 차량에서 스티어링 휠 냉각도 지원하는 것이 아니라면 minInt32Value
는 0이어야 합니다. 이 경우 minInt32Value
는 최대 스티어링 휠 냉방 설정을 나타냅니다. 이 속성은 특정 단위가 아닌 지정된 난방 설정 범위에 있습니다. 이 속성은 VehiclePropertyAccess.READ
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_TEMPERATURE_CURRENT
HVAC 현재 온도
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:CELSIUS
출시: Android 13
HVAC_TEMPERATURE_DISPLAY_UNITS
디스플레이용 온도 단위입니다. 온도가 섭씨로 표시되는지 또는 화씨로 표시되는지를 나타냅니다.
VehiclePropConfig.configArray
는 지원되는 온도 표시 단위를 나타냅니다. 예를 들어 configArray[0] = CELSIUS configArray[1] = FAHRENHEIT
이 매개변수는 시스템의 HVAC 온도를 표시하는 데 사용할 수 있습니다. 값은 VehicleUnit.CELSIUS
또는 VehicleUnit.FAHRENHEIT
중 하나여야 합니다.
HVAC_TEMPERATURE_DISPLAY_UNITS를 업데이트하면 다른 *_DISPLAY_UNITS
속성의 값에 영향을 미치는 경우 해당 값을 업데이트하고 AAOS 프레임워크에 전달해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleUnit
단위 유형: 해당 사항 없음
출시: Android 13
HVAC_TEMPERATURE_SET
HVAC 타겟 온도(섭씨)입니다.
VehicleAreaConfig
의 minFloatValue
및 maxFloatValue
를 정의해야 합니다.
minFloatValue
최저 온도 설정(섭씨)입니다.maxFloatValue
최대 온도 설정(섭씨)입니다.
minFloatValue
과 maxFloatValue
사이의 모든 값이 지원되지 않는 경우 configArray
를 사용하여 설정할 수 있는 유효한 온도 값을 나열합니다.
또한 차량의 온도를 섭씨에서 화씨로 변환하는 (또는 그 반대로) 조회 표도 설명합니다. 차량에서 표준 단위 변환이 지원되지 않는 경우 configArray
를 정의해야 합니다.
configArray
는 다음과 같이 설정됩니다.
configArray[0]
[지원되는 온도 하한값(섭씨)] * 10configArray[1]
[지원되는 온도 상한(섭씨)] * 10configArray[2]
[섭씨 단위의 증분] * 10configArray[3]
[지원되는 온도 하한값(화씨)] * 10configArray[4]
[지원되는 온도의 상한값(화씨)] * 10configArray[5]
[화씨 증분] * 10
VehicleAreaConfig
의 minFloatValue
및 maxFloatValue
는 각각 configArray[0]
및 configArray[1]
와 같아야 합니다. 예를 들어 차량에서 온도 값을 화씨로 [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5]
로 지원하는 경우 configArray
은 configArray = {160, 280, 5, 605, 845, 10}
여야 합니다.
섭씨 증분과 화씨 증분의 비율이 섭씨 1도와 화씨 1.8도의 실제 비율에 최대한 근접하는 것이 좋습니다. 모든 섭씨 값을 configArray
에 의해 정의된 화씨 값에 일대일로 매핑해야 합니다. configArray
는 클라이언트가 이 속성의 온도를 섭씨에서 화씨로 변환하는 데 사용됩니다. 또한 클라이언트는 시스템에 원하는 화씨 값을 얻기 위해 속성을 설정할 섭씨 값을 알 수 있습니다. ECU에 모든 섭씨 값을 화씨 값에 일대일 매핑하는 매핑이 없는 경우 configArray
는 일대일 매핑이 있는 섭씨 및 화씨 값 목록만 정의해야 합니다.
예를 들어 ECU가 16~28의 섭씨 값과 60~85의 화씨 값을 각각 1씩 증분하여 지원하는 경우 가능한 configArray
는 다음과 같습니다. code>{160, 280, 10, 600, 840, 20}이 경우 85는 지원되지 않는 온도입니다.
유효한 값 사이에 설정된 값은 가장 가까운 유효한 값으로 반올림되어야 합니다. OEM은 HVAC_TEMPERATURE_VALUE_SUGGESTION
차량 속성도 구현하는 것이 좋습니다. 이 속성은 애플리케이션에 차량에 설정할 수 있는 온도 값을 결정하고 섭씨와 화씨 값을 변환하는 간단한 메서드를 제공하기 때문입니다.
이 속성은 VehiclePropertyAccess.READ
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:CELSIUS
출시: Android 13
HVAC_TEMPERATURE_VALUE_SUGGESTION
HVAC 온도 설정에 권장되는 값입니다.
애플리케이션이 섭씨 또는 화씨로 지원되는 가장 가까운 온도 값을 이해하는 데 도움이 되도록 이 속성을 구현합니다.
floatValues[0]
앱에서 온도를 설정하려는 요청된 값입니다.floatValues[1]
floatValues[0]
의 단위이며{VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
중 하나여야 합니다.floatValues[2]
OEM이 제안한 값(섭씨로 표시됨)(이 값은 요청에 포함되지 않음)floatValues[3]
OEM이 FAHRENHEIT로 제안한 값입니다 (이 값은 요청에 포함되지 않음).
애플리케이션은 요청된 값과 값의 단위를 사용하여 set(VehiclePropValue propValue)
를 호출합니다. OEM은 onPropertyEvent()
콜백을 통해 floatValues[2]
및 floatValues[3]
에 추천 값을 반환해야 합니다.
추천 값은 HVAC_TEMPERATURE_SET
configArray
에서 파생될 수 있는 값을 준수해야 합니다. 즉, 추천 값과 configArray
의 값 표는 동일해야 합니다.
OEM은 HVAC ECU에 요청하지 않도록 VHAL 구현에 맞춤 로직을 추가하는 것이 좋습니다. 로직은 다음과 같습니다. 온도를 섭씨에서 화씨로 변환하려면 다음 단계를 따르세요.
// Given tempC and the configArray float minTempC = configArray[0] / 10.0; float temperatureIncrementCelsius = configArray[2] / 10.0; float minTempF = configArray[3] / 10.0; float temperatureIncrementFahrenheit = configArray[5] / 10.0; // Round to the closest increment int numIncrements = round((tempC - minTempC) / temperatureIncrementCelsius); tempF = temperatureIncrementFahrenheit * numIncrements + minTempF;
예를 들어 운전자가 음성 어시스턴트를 사용하여 HVAC 온도를 화씨 66.2로 설정하는 경우입니다.
먼저 애플리케이션이 이 속성을 값 [66.2, (float)VehicleUnit.FAHRENHEIT,0,0]
로 설정합니다. OEM이 사용자의 요청에 따라 섭씨 19.0 또는 화씨 66.5를 설정하도록 제안하는 경우 VHAL은 속성 값 [66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5]
로 콜백을 생성해야 합니다. 음성 어시스턴트가 콜백을 수신하면 사용자에게 알리고 HVAC 온도를 제안된 값으로 설정합니다.
또 다른 예로, 앱이 HVC_TEMPERATURE_SET
를 쿼리하여 현재 온도 값으로 21℃를 수신하지만 앱은 자동차 UI에 화씨로 표시되는 값을 알아야 합니다. 이를 위해 앱은 속성을 [21, (float)VehicleUnit.CELSIUS, 0, 0]
로 설정합니다. 섭씨 21도의 OEM 추천 값이 화씨 70도인 경우 VHAL은 속성 값 [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]
로 콜백을 생성해야 합니다. 이 경우 앱은 차량 UI에서 값이 화씨 70.0도임을 알 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HW_CUSTOM_INPUT
맞춤 OEM 파트너 입력 이벤트를 정의합니다. 이 입력 이벤트는 Android에서 지원하지 않는 이벤트를 전파하려는 OEM 파트너가 사용해야 합니다. int32 값 배열로만 구성됩니다. Android 속성은 다음과 같습니다.
int32Values[0]
이 이벤트를 나타내는 함수를 식별하는 입력 코드입니다. 유효한 이벤트 유형은CustomInputType.CUSTOM_EVENT_F1
~CustomInputType.CUSTOM_EVENT_F10
로 정의됩니다. OEM 파트너가 정의할 맞춤 이벤트를 나타냅니다.int32Values[1]
VehicleDisplay
에 정의된 타겟 디스플레이 유형입니다. 특정 디스플레이에 연결되지 않은 이벤트는VehicleDisplay#MAIN
로 전송해야 합니다.int32Values[2]
반복 카운터입니다. 0이면 이벤트가 반복되지 않습니다. 1 이상의 값은 이 이벤트가 반복된 횟수를 나타냅니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: CustomInputType
단위 유형: 해당 사항 없음
출시: Android 13
HW_KEY_INPUT
Android에 하드웨어 입력 이벤트를 제공하는 속성입니다.
int32Values[0]
VehicleHwKeyInputAction에서 정의한 작업int32Values[1]
키 코드, 표준 Android 키 코드를 사용해야 함int32Values[2]
VehicleDisplay
에 정의된 타겟 디스플레이입니다. 특정 디스플레이에 연결되지 않은 이벤트는VehicleDisplay#MAIN
로 전송해야 합니다.int32Values[3]
(선택사항) 틱 수입니다. 값은 1 이상이어야 합니다. 생략하면 Android 기본값은 1입니다.
모드 변경: .ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
HW_KEY_INPUT_V2
Android에 하드웨어 입력 이벤트를 제공하는 속성입니다.
int32array[0]
VehicleDisplay
에 의해 정의된 타겟 디스플레이(예:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
int32array[1]
키 코드.KEYCODE_HOME
및KEYCODE_BACK
와 같은 표준 Android 키 코드를 사용해야 합니다.- VehicleHwKeyInputAction에 정의된
int32array[2]
작업(예:
VehicleHwKeyInputAction::ACTION_UP
,VehicleHwKeyInputAction::ACTION_UP
) int32array[3]
이벤트의 반복 횟수입니다. 키 누르기 이벤트의 경우 첫 번째 누르기가 0에서 시작하여 거기서부터 숫자가 증가하는 반복 횟수입니다. 키 up 이벤트의 경우 항상 0입니다.int64array[0]
마지막 부팅 이후 경과한 다운타임(나노초)입니다. 가장 최근 키 다운 이벤트의 시간을 나타냅니다. 다운 이벤트의 경우 다운 이벤트의 이벤트 시간입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
HW_MOTION_INPUT
Android에 하드웨어 입력 이벤트를 제공하는 속성입니다.
int32array[0]
VehicleDisplay
로 정의된 타겟 디스플레이(예:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER
,VehicleDisplay::AUX
)int32array[1]
VehicleHwMotionInputSource에 정의된 입력 유형입니다(예:
VehicleHwMotionInputSource::SOURCE_KEYBOARD
,VehicleHwMotionInputSource::SOURCE_DPAD
).int32array[2]
VehicleHwMotionInputAction에 정의된 작업 코드입니다(예:
VehicleHwMotionInputAction::ACTION_UP
,VehicleHwMotionInputAction::ACTION_DOWN
).int32array[3]
VehicleHwMotionButtonStateFlag에 정의된 버튼 상태 플래그(예:
,VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY
,VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
)int32array[4]
포인터 이벤트 수, N입니다. N은 양의 정수여야 합니다.int32array[5:5+N-1]
포인터 ID, 길이 Nint32array[5+N:5+2*N-1]
도구 유형, 길이 N입니다.VehicleHwMotionToolType
에 정의된 대로(예:
VehicleHwMotionToolType::TOOL_TYPE_FINGER
,VehicleHwMotionToolType::TOOL_TYPE_STYLUS
)floatArray[0:N-1]
x 데이터, 길이 NfloatArray[N:2*N-1]
y 데이터, 길이 NfloatArray[2*N:3*N-1]
압력 데이터, 길이 NfloatArray[3*N:4*N-1]
크기 데이터, 길이 Nint64array[0]
다운 시간, 부팅 후 경과한 나노초입니다. 사용자가 처음에 아래로 눌러 위치 이벤트 스트림을 시작한 시간을 나타냅니다. 다운 이벤트의 경우 다운 이벤트의 이벤트 시간입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
HW_ROTARY_INPUT
Android에 하드웨어 로터리 이벤트를 제공하는 속성입니다.
int32Values[0]
RotaryInputType: 회전되는 로터리 노브를 식별합니다.int32Values[1]
멈춤 위치 수 (클릭수), 시계 방향이면 양수, 시계 반대 방향이면 음수입니다.int32Values[2]
VehicleDisplay
에 정의된 타겟 디스플레이입니다. 특정 디스플레이에 연결되지 않은 이벤트는VehicleDisplay#MAIN
로 전송해야 합니다.int32values[3 .. 3 + abs(number of detents) - 2]
디텐트 수가 1보다 크거나 -1보다 작은 경우 연속 디텐트 쌍 간의 나노초 델타입니다.VehiclePropValue.timestamp
회전이 발생한 시점입니다. 디텐트 수가 1보다 크거나 -1보다 작은 경우 첫 번째 회전 디텐트가 발생한 시점입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: RotaryInputType
단위 유형: 해당 사항 없음
출시: Android 13
IGNITION_STATE
점화 상태를 나타냅니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleIgnitionState
단위 유형: 해당 사항 없음
출시: Android 13
INFO_DRIVER_SEAT
운전자 좌석 위치 VHAL 구현은 areaId를 무시해야 합니다. VehicleArea:GLOBAL
사용
변경 모드: STATIC
액세스 모드: READ
Enum 유형: VehicleAreaSeat
단위 유형: 해당 사항 없음
출시: Android 13
INFO_EV_BATTERY_CAPACITY
EV 또는 하이브리드 차량의 공칭 배터리 용량입니다. 공칭 배터리 용량(EV 또는 하이브리드)을 반환합니다. 차량이 신차일 때의 총 사용 가능한 배터리 용량입니다. 이 값은 EV_CURRENT_BATTERY_CAPACITY
와 다를 수 있습니다. EV_CURRENT_BATTERY_CAPACITY
는 배터리 노화 및 온도 종속성 등의 요소를 고려하여 실시간으로 사용 가능한 배터리 용량을 반환하기 때문입니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:WH
출시: Android 13
INFO_EV_CONNECTOR_TYPE
이 전기자동차에서 사용할 수 있는 커넥터 목록입니다. 차량에 충전 포트가 여러 개인 경우 이 속성은 차량의 충전 포트 중 하나 이상에서 사용할 수 있는 모든 커넥터 유형을 반환해야 합니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: EvConnectorType
단위 유형: 해당 사항 없음
출시: Android 13
INFO_EV_PORT_LOCATION
이 속성은 PortLocationType 열거형을 사용하여 EV의 충전 포트 위치를 전달해야 합니다. 차량에 포트가 여러 개인 경우 이 속성은 가장 빠른 충전을 허용하는 포트를 반환해야 합니다. 모든 포트 위치를 전달하려면 INFO_MULTI_EV_PORT_LOCATIONS
를 사용하세요.
액세스 모드: 읽기
Enum 유형:
PortLocationType
단위 유형: 해당 사항 없음
출시: Android 13
INFO_EXTERIOR_DIMENSIONS
차량 외부 크기:
- 높이:
int32Values[0]
- 길이:
int32Values[1]
- 너비:
int32Values[2]
- 미러링을 포함한 너비:
int32Values[3]
- 미러를 포함한 휠베이스:
int32Values[4]
- 트랙 너비 앞면:
int32Values[5]
- 트랙 너비 후면:
int32Values[6]
- 갓길에서 갓길까지 회전 직경:
int32Values[7]
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLIMETER
출시: Android 13
INFO_FUEL_CAPACITY
차량의 연료 용량(밀리리터)입니다. 이 속성은 차량에 저장할 수 있는 최대 연료량을 밀리리터 단위로 전달해야 합니다. 이 속성은 전기자동차 (EV)에는 적용되지 않습니다. 즉, INFO_FUEL_TYPE
에 FuelType::FUEL_TYPE_ELECTRIC
만 포함된 경우 INFO_FUEL_CAPACITY를 구현하면 안 됩니다.
전기자동차의 경우 INFO_EV_BATTERY_CAPACITY를 구현합니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLILITER
출시: Android 13
INFO_FUEL_DOOR_LOCATION
연료 주입구 도어 위치 이 속성은 차량의 연료 주입구 위치를 전달해야 합니다.
이 속성은 전기자동차에는 적용되지 않습니다. 즉, INFO_FUEL_TYPE
에 FuelType::FUEL_TYPE_ELECTRIC
만 포함된 경우 이 속성을 구현해서는 안 됩니다. 전기자동차의 경우 INFO_EV_PORT_LOCATION
또는 INFO_MULTI_LOCATIONS
를 구현합니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: PortLocationType
단위 유형: 해당 사항 없음
출시: Android 13
INFO_FUEL_TYPE
차량에서 사용할 수 있는 연료 목록입니다. FuelType::FUEL_TYPE_ELECTRIC
는 차량에 충전식 전기 자동차를 연결할 수 있는 경우에만 포함해야 합니다. 예를 들어 INFO_FUEL_TYPE
의 INT32_VEC 값이 INFO_FUEL_TYPE
로 채워질 수 있으므로 FuelType::FUEL_TYPE_ELECTRIC
는 INFO_FUEL_TYPE
를 포함할 수 없습니다.
int32Values = { FuelType::FUEL_TYPE_UNLEADED }
INFO_FUEL_TYPE
의 INT32_VEC 값으로 FuelType::FUEL_TYPE_ELECTRIC
를 포함해야 합니다. INFO_FUEL_TYPE
는 이와 같이 채워질 수 있습니다.
int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }
변경 모드: STATIC
액세스 모드: READ
Enum 유형: FuelType
단위 유형: 해당 사항 없음
출시: Android 13
INFO_MAKE
차량 제조업체입니다. 이 속성은 차량의 공개 브랜드 이름을 전달해야 합니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
INFO_MODEL
차량 모델입니다. 이 속성은 차량의 공개 모델 이름을 전달해야 합니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
INFO_MODEL_YEAR
그레고리력 기준 `YYYY` 형식의 차량 모델 연도입니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:YEAR
출시: Android 13
INFO_MULTI_EV_PORT_LOCATIONS
여러 EV 포트 위치 차량에 EV 포트가 여러 개인 경우 이 속성을 구현합니다. 포트 위치는 PortLocationType에 정의되어 있습니다. 예를 들어 차량에 전면 왼쪽 포트 1개와 후면 왼쪽 포트 1개가 있는 경우
int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT
차량에 포트가 하나만 있는 경우 이 속성의 값에 요소가 하나 표시됩니다. 포트 위치 하나를 설명하려면 INFO-EV-PORT-LOCATION을 참고하세요.
.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: PortLocationType
단위 유형: 해당 사항 없음
출시: Android 13
INFO_VIN
차량의 VIN
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
INITIAL_USER_INFO
초기화 중에 사용할 Android 사용자를 정의합니다. 이 속성은 Android 시스템이 초기화될 때 호출되며 HAL이 시작할 Android 사용자를 정의할 수 있도록 합니다. 이 요청은 VehiclePropValue (InitialUserInfoRequest
로 정의됨)를 설정하여 이루어지며 HAL은 속성 변경 이벤트 (InitialUserInfoResponse로 정의됨)로 응답해야 합니다.
HAL이 Android 시스템에서 정의한 시간 후에 응답하지 않으면 Android 시스템은 HAL이 InitialUserInfoResponseAction:DEFAULT 작업의 응답을 반환한 것처럼 진행합니다.
예를 들어 첫 번째 부팅 시 요청은 다음과 같을 수 있습니다.
int32[0] 42 // request id (arbitrary number set by Android system) int32[1] 1 // InitialUserInfoRequestType::FIRST_BOOT int32[2] 0 // id of current user (usersInfo.currentUser.userId) int32[3] 1 // flag of current user (usersInfo.currentUser.flags = SYSTEM) int32[4] 1 // number of existing users (usersInfo.numberUsers); int32[5] 0 // user #0 (usersInfo.existingUsers[0].userId) int32[6] 1 // flags of user #0 (usersInfo.existingUsers[0].flags)
int32[0] 42 // must match the request id from the request int32[1] 2 // action = InitialUserInfoResponseAction::CREATE int32[2] -10000 // userToSwitchOrCreate.userId (not used as user will be created) int32[3] 8 // userToSwitchOrCreate.flags = ADMIN string: "||Owner" // userLocales + separator + userNameToCreate
InitialUserInfoResponseAction:CREATE
인 경우)입니다. 예를 들어 en-US 및 pt-BR 언어로 동일한 Owner 사용자를 만들려면 응답의 문자열 값은 en-US,pt-BR||Owner입니다. 따라서 언어 또는 이름의 값에 두 개의 수직 막대(||
)를 포함할 수 없지만 단일 수직 막대 (|
)는 사용할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
J~R
LANE_CENTERING_ASSIST_COMMAND
차선 중앙 유지 보조 (LCA) 명령어 LCA를 활성화하고 정지하는 명령어
LaneCenteringAssistCommand
의 ACTIVATE
명령어가 전송되면 LANE_CENTERING_ASSIST_STATE
는 LaneCenteringAssistState#ACTIVATION_REQUESTED
로 설정되어야 합니다. ACTIVATE
명령어가 성공하면 LANE_CENTERING_ASSIST_STATE
는 LaneCenteringAssistState#ACTIVATED
로 설정되어야 합니다. LaneCenteringAssistCommand
의 DEACTIVATE
명령어가 성공하면 LANE_CENTERING_ASSIST_STATE
는 LaneCenteringAssistState#ENABLED
로 설정되어야 합니다.
전 세계 지역 ID (0)의 경우 LaneCenteringAssistCommand
의 모든 열거형 값이 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues
를 정의해야 합니다. LCA가 사용 중지되어 이 속성을 사용할 수 없는 경우 (예: LANE_CENTERING_ASSIST_ENABLED
가 false임) 이 속성은 StatusCode#NOT_AVAILABLE_DISABLED
를 반환해야 합니다. LANE_CENTERING_ASSIST_STATE
가 구현되고 상태가 ErrorState
값으로 설정된 경우 이 속성은 ErrorState
값과 일치하는 StatusCode
를 반환해야 합니다. 예를 들어 LANE_CENTERING_ASSIST_STATE
가 ErrorState#NOT_AVAILABLE_SPEED_LOW
로 설정된 경우 이 속성은 StatusCode#NOT_AVAILABLE_SPEED_LOW
를 반환해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: LaneCenteringAssistCommand
단위 유형: 해당 사항 없음
출시: Android 14
LANE_CENTERING_ASSIST_ENABLED
차로 중앙 유지 보조 (LCA)를 사용 설정하거나 사용 중지합니다. LCA를 사용 설정하려면 true로, 사용 중지하려면 false로 설정합니다. LCA가 사용 설정되면 차량의 ADAS 시스템이 켜져 있고 운전자의 활성화 신호를 기다리고 있어야 합니다. 이 기능이 활성화되면 ADAS 시스템이 차량을 조종하여 현재 차로 중앙을 유지해야 합니다.
이는 운전자가 의도치 않게 차선 마커를 향해 또는 차선 마커를 넘어가는지 모니터링하는 차선 유지 보조 (LKA)와는 다릅니다. 의도하지 않은 차선 이탈이 감지되면 시스템은 스티어링 제어를 적용하여 차량을 현재 차선으로 되돌립니다.
일반적으로 LANE_CENTERING_ASSIST_ENABLED
는 항상 true 또는 false를 반환해야 합니다. 차량 속도가 너무 낮거나 너무 높음과 같은 일시적인 상태로 인해 기능을 사용할 수 없는 경우 LANE_CENTERING_ASSIST_STATE
속성의 ErrorState
값을 통해 해당 정보를 전달해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
LANE_CENTERING_ASSIST_STATE
차로 중앙 유지 보조 (LCA) 상태입니다. LCA의 현재 상태를 반환합니다. 이 속성은 항상 LaneCenteringAssistState
또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. StatusCode
를 통해 오류를 표시해서는 안 되며 대신 지원되는 오류 상태를 사용해야 합니다.
LCA에 차선 이탈 경고가 포함된 경우 이러한 경고는 차선 이탈 경고 (LDW) 속성을 통해 표시되어야 합니다.
전 세계 지역 ID (0)의 경우 LaneCenteringAssistState
(권장되지 않는 OTHER 포함) 및 ErrorState
의 모든 상태가 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: LaneCenteringAssistState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
LANE_DEPARTURE_WARNING_ENABLED
차선 이탈 경고 (LDW)를 사용 설정하거나 사용 중지합니다. LDW를 사용 설정하려면 true로, 사용 중지하려면 false로 설정합니다. LDW가 사용 설정된 경우 차량의 ADAS 시스템이 켜져 있고 차량이 차선에 접근하거나 차선을 넘어가는지 모니터링해야 하며, 이 경우 경고가 표시됩니다.
일반적으로 LANE_DEPARTURE_WARNING_ENABLED
는 항상 true 또는 false를 반환해야 합니다. 차량 속도가 너무 낮거나 너무 높음과 같은 일시적인 상태로 인해 기능을 사용할 수 없는 경우 이 정보를 LANE_DEPARTURE_WARNING_STATE
속성의 ErrorState
값을 통해 전달해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
LANE_DEPARTURE_WARNING_STATE
차선 이탈 경고 (LDW) 상태입니다. LDW의 현재 상태를 반환합니다. 이 속성은 항상 LaneDepartureWarningState
또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. StatusCode
를 통해 오류를 표시해서는 안 되며 대신 지원되는 오류 상태를 사용해야 합니다.
전 세계 지역 ID (0)의 경우 LaneDepartureWarningState
(권장되지 않는 OTHER 포함) 및 ErrorState
의 모든 상태가 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: LaneDepartureWarningState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
LANE_KEEP_ASSIST_ENABLED
차선 유지 보조 (LKA)를 사용 설정하거나 사용 중지합니다. LKA를 사용 설정하려면 true로, 사용 중지하려면 false로 설정합니다. LKA가 사용 설정된 경우 차량의 ADAS 시스템이 켜져 있어야 하며 운전자가 의도치 않게 차선 마커를 향해 또는 차선 마커를 넘어가는지 모니터링해야 합니다. 의도하지 않은 차선 이탈이 감지되면 시스템은 스티어링 제어를 적용하여 차량을 현재 차선으로 되돌립니다. 이는 활성화되면 연속 조향 제어를 적용하여 차량이 현재 차로 중앙을 유지하도록 하는 차선 중앙 모드 어시스트 (LCA)와는 다릅니다.
일반적으로 LANE_KEEP_ASSIST_ENABLED
는 항상 true 또는 false를 반환해야 합니다. 차량 속도가 너무 낮거나 너무 높음과 같은 일시적인 상태로 인해 기능을 사용할 수 없는 경우 LANE_KEEP_ASSIST_STATE
속성의 ErrorState
값을 통해 해당 정보를 전달해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
LANE_KEEP_ASSIST_STATE
차선 유지 보조 (LKA) 상태입니다. LKA의 현재 상태를 반환합니다. 이 속성은 항상 LaneKeepAssistState
또는 ErrorState
에 정의된 유효한 상태를 반환해야 합니다. StatusCode
를 통해 오류를 표시해서는 안 되며 대신 지원되는 오류 상태를 사용해야 합니다.
LKA에 스티어링 수정을 적용하기 전에 차선 이탈 경고가 포함된 경우 이러한 경고는 차선 이탈 경고 (LDW) 속성을 통해 표시되어야 합니다.
전 세계 지역 ID (0)의 경우 LaneKeepAssistState
(권장되지 않는 OTHER 포함) 및 ErrorState
의 모든 상태가 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: LaneKeepAssistState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
LOCATION_CHARACTERIZATION
위치 계산에 사용되는 입력의 특성입니다. 이 속성은 GNSS HAL을 통해 Android와 공유되는 차량의 위치를 계산할 때 시스템에서 고려하는 데이터 및 센서 입력 (있는 경우)을 나타내야 합니다.
값은 비트 플래그 모음을 반환해야 합니다. 비트 플래그는 LocationCharacterization에 정의되어 있습니다. 또한 값은 비트 플래그 모음 중 DEAD_RECKONED
또는 RAW_GNSS_ONLY
중 하나를 정확히 하나 포함해야 합니다.
이 속성이 지원되지 않으면 GNSS HAL을 통해 제공되는 GNSS 업데이트에 추가 센서 입력이 융합되지 않는다고 가정됩니다. GNSS HAL 인터페이스를 통해 달리 지정되지 않는 한
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
MIRROR_AUTO_FOLD_ENABLED
미러 자동 접힘 기능의 속성을 나타냅니다. 이 속성은 차량의 사이드미러를 자동으로 접는 기능 (예: 운전자가 차량에서 나와 차량을 잠그면 사이드미러가 자동으로 안쪽으로 접히는 경우)이 사용 설정된 경우 true입니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
MIRROR_AUTO_TILT_ENABLED
미러 자동 기울기 기능의 속성을 나타냅니다. 이 속성은 차량의 사이드 미러를 자동으로 기울이는 기능 (예: 차량을 후진할 때 미러가 자동으로 아래쪽으로 기울어짐)이 사용 설정된 경우 true입니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
MIRROR_FOLD
거울 접힘 true는 미러가 접혀 있음을 나타냅니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
MIRROR_LOCK
미러 잠금 true는 미러 위치가 잠겨 있고 변경할 수 없음을 나타냅니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
MIRROR_Y_MOVE
Y 이동을 미러링합니다. 각 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
는 정의되어야 합니다.
minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
maxInt32Value
는 오른쪽으로 기울이는 동안 거울의 최대 이동 속도를 나타냅니다. minInt32Value
는 왼쪽으로 기울이는 동안 거울의 최대 이동 속도를 나타냅니다.
양수 또는 음수의 절댓값이 클수록 이동 속도가 빠릅니다. 미러가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. MIRROR_Y_MOVE의 값이 현재 0이면 현재 움직임이 없다는 의미입니다.
이 속성은 특정 단위가 아닌 지정된 상대 이동 속도 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
MIRROR_Y_POS
Y 위치를 미러링합니다. VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다.
minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
minInt32Value
는 거울이 완전히 왼쪽으로 기울어져 있음을 나타냅니다.
값은 양수가 아니어야 합니다. maxInt32Value
는 거울이 완전히 오른쪽으로 기울어져 있음을 나타냅니다. 음이 아닌 값이어야 합니다. 0은 거울이 어느 방향으로도 기울어지지 않았음을 나타냅니다.
minInt32Value
과 maxInt32Value
사이의 값은 왼쪽 극단 위치와 오른쪽 극단 위치 간의 전환 상태를 나타냅니다.
이 속성은 특정 단위가 아닌 지정된 상대적 위치 범위입니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
MIRROR_Z_MOVE
Z축 이동을 미러링합니다. 각 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
는 정의되어야 합니다.
minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
maxInt32Value
는 위로 기울이는 동안 거울의 최대 이동 속도를 나타냅니다.
minInt32Value
는 아래쪽으로 기울이는 동안 미러의 최대 이동 속도를 나타냅니다.
양수 또는 음수의 절댓값이 클수록 이동 속도가 빠릅니다. 미러가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. MIRROR_Z_MOVE의 값이 현재 0이면 현재 움직임이 없다는 의미입니다.
이 속성은 특정 단위가 아닌 지정된 상대 이동 속도 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
MIRROR_Z_POS
Z 위치를 미러링합니다. VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다. minInt32Value
는 거울이 완전히 아래쪽으로 기울어져 있음을 나타냅니다. 값은 양수가 아니어야 합니다. maxInt32Value
는 거울이 완전히 위로 기울어져 있음을 나타냅니다. 음이 아닌 값이어야 합니다. 0은 거울이 어느 방향으로도 기울어지지 않았음을 나타냅니다.
minInt32Value
과 maxInt32Value
사이의 값은 완전히 아래쪽과 완전히 위쪽 위치 간의 전환 상태를 나타냅니다.
이 속성은 특정 단위가 아닌 지정된 상대적 위치 범위입니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
NIGHT_MODE
True는 야간 모드 센서가 자동차 실내 환경이 어둡다고 감지했음을 나타냅니다. 플랫폼은 이를 사용하여 어두운 환경이나 조명이 어두운 환경에서 더 나은 시청 환경을 위해 적절한 UI를 사용 설정할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
OBD2_FREEZE_FRAME
오류가 발생하고 감지된 시점에 사용 가능한 OBD2 센서의 값을 스냅샷으로 보고합니다. configArray는 OBD2_LIVE_FRAME
에 정의된 것과 동일한 의미로 제공되어야 합니다.
이 속성의 값은 OBD2_LIVE_FRAME
의 값과 비슷한 방식으로 해석됩니다. 단, stringValue 필드에 비어 있지 않은 진단 문제 해결 코드 (DTC)가 포함될 수 있습니다.
이 속성의 IVehicle#get 요청은 int64Values[0]의 값을 제공해야 합니다. 이는 검색할 정지 프레임의 타임스탬프로 해석됩니다. 타임스탬프 목록은 OBD2_FREEZE_FRAME_INFO
의 IVehicle#get을 통해 가져올 수 있습니다.
지정된 타임스탬프에 사용할 수 있는 정지 프레임이 없는 경우 구현에서 NOT_AVAILABLE
응답을 반환해야 합니다. 차량에 정지 프레임용 저장소가 제한되어 있을 수 있으므로 연결된 타임스탬프가 최근에 OBD2_FREEZE_FRAME_INFO
를 통해 가져온 경우에도 프레임 요청이 NOT_AVAILABLE
로 응답할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
OBD2_FREEZE_FRAME_CLEAR
프레임 고정 지우기 오류가 발생하고 감지된 시점에 사용 가능한 OBD2 센서의 값 스냅샷을 보고합니다. configArray는 OBD2_LIVE_FRAME
에 정의된 것과 동일한 의미로 제공되어야 합니다.
이 속성의 값은 OBD2_LIVE_FRAME
의 값과 비슷한 방식으로 해석됩니다. 단, stringValue 필드에 비어 있지 않은 진단 문제 해결 코드 (DTC)가 포함될 수 있다는 점을 제외하고
이 속성의 IVehicle#get 요청은 int64Values[0]의 값을 제공해야 합니다. 이는 검색할 정지 프레임의 타임스탬프로 해석됩니다. 타임스탬프 목록은 OBD2_FREEZE_FRAME_INFO
의 IVehicle#get을 통해 가져올 수 있습니다.
지정된 타임스탬프에 사용할 수 있는 정지 프레임이 없는 경우 구현에서 NOT_AVAILABLE
응답을 반환해야 합니다. 차량의 정지 프레임 저장소가 제한되어 있을 수 있으므로 연결된 타임스탬프가 최근에 OBD2_FREEZE_FRAME_INFO
를 통해 가져온 경우에도 프레임 요청이 NOT_AVAILABLE
로 응답할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
OBD2_FREEZE_FRAME_INFO
이 속성은 차량 메모리에 저장되고 OBD2_FREEZE_FRAME
를 통해 검색할 수 있는 현재 정지 프레임을 나타냅니다. 값은 다음과 같이 해석됩니다. int64Values의 각 요소는 오류 코드가 감지되고 해당 정지 프레임이 저장된 타임스탬프여야 하며, 이러한 각 요소는 OBD2_FREEZE_FRAME
의 키로 사용되어 해당 정지 프레임을 검색할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
OBD2_LIVE_FRAME
사용 가능한 OBD2 센서의 현재 (실시간) 값의 스냅샷을 보고합니다. configArray는 다음과 같이 설정됩니다.
configArray[0]
공급업체별 정수 값 센서 수configArray[1]
공급업체별 부동 소수점 값 센서 수
이 속성의 값은 다음 예와 같이 해석됩니다. configArray = {2,3} int32Values
는 Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX
와 두 개의 요소 (또는 33개의 요소)를 포함하는 벡터여야 합니다.
floatValues
는 Obd2FloatSensorIndex.LAST_SYSTEM_INDEX
와 3개의 요소 (또는 73개의 요소)를 포함하는 벡터여야 합니다.
각 프레임에는 시스템 제공 센서와 공급업체별 센서 모두 다른 센서 값 하위 집합이 포함될 수 있습니다. 이를 지원하기 위해 속성 값의 바이트 요소가 비트 마스크로 사용됩니다. 바이트는 가능한 총 센서 수를 나타낼 만큼 충분한 바이트 수를 보유해야 합니다 (이 경우 가능한 106개 값을 나타내는 14바이트).
각 비트가 프레임의 센서 유무를 나타내도록 연속된 비트 마스크로 읽습니다. int32Values
크기만큼의 비트로 시작하고 바로 뒤에 floatValues 크기만큼의 비트가 이어집니다.
예를 들어 bytes[0] = 0x4C (0b01001100)
이면 다음을 의미합니다.
int32Values[0 and 1]
은(는) 유효한 센서 값이 아닙니다.int32Values[2 and 3]
는 유효한 센서 값입니다.int32Values[4 and 5]
은(는) 유효한 센서 값이 아닙니다.int32Values[6]
은(는) 유효한 센서 값입니다.int32Values[7]
은(는) 유효한 센서 값이 아닙니다.int32Values[0 and 1]
은(는) 유효한 센서 값이 아닙니다.int32Values[2 and 3]
는 유효한 센서 값입니다.int32Values[4 and 5]
은(는) 유효한 센서 값이 아닙니다.int32Values[6]
은(는) 유효한 센서 값입니다.int32Values[7]
은(는) 유효한 센서 값이 아닙니다.
bytes[5] = 0x61 (0b01100001)
인 경우:
int32Values[32]
은(는) 유효한 센서 값입니다.floatValues[0 thru 3]
는 잘못된 센서 값입니다.floatValues[4 and 5]
는 유효한 센서 값입니다.floatValues[6]
은(는) 유효한 센서 값이 아닙니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
ON_CHANGE
변경 모드:
액세스 모드: READ_WRITE/READ
Enum 유형:
VehicleLightSwitch
단위 유형:해당 사항 없음
출시: Android 13
PARKING_BRAKE_AUTO_APPLY
주차 브레이크 자동 적용 이 속성이 true이면 자동차의 자동 주차 브레이크가 사용 설정되었음을 나타냅니다. false는 자동차의 자동 주차 브레이크 기능이 사용 중지되었음을 나타냅니다. 이 속성은 PARKING_BRAKE_ON
와 혼동되는 경우가 많습니다. 차이점은 PARKING_BRAKE_ON
는 실제 주차 브레이크가 켜져 있는지 꺼져 있는지 나타내는 반면 PARKING_BRAKE_AUTO_APPLY
는 자동 주차 브레이크 기능이 사용 설정되어 있는지 사용 중지되어 있는지를 나타내며 실제 주차 브레이크의 현재 상태를 설명하지 않습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
PARKING_BRAKE_ON
주차 브레이크 상태입니다. 이 속성이 true인 경우 자동차의 주차 브레이크가 설정되어 있음을 나타냅니다. False는 자동차의 주차 브레이크가 해제되었음을 나타냅니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
PER_DISPLAY_BRIGHTNESS
별도로 제어되는 디스플레이의 밝기를 나타내는 속성입니다.
일부 자동차에는 밝기가 별도로 제어되는 디스플레이가 하나 이상 있으며 이 속성은 각 뒷좌석 디스플레이의 밝기를 알리는 것입니다. 모든 디스플레이의 밝기가 함께 제어되는 자동차에서는 DISPLAY_BRIGHTNESS
PER_DISPLAY_BRIGHTNESS
및 PER_DISPLAY_BRIGHTNESS
중 하나만 구현해야 합니다. 둘 다 사용할 수 있는 경우 AAOS에서 PER_DISPLAY_BRIGHTNESS
를 사용합니다.
디스플레이 포트는 디스플레이 출력을 위한 기기의 실제 커넥터를 고유하게 식별하며 0~255 사이의 값을 갖습니다.
int32Values[0]
디스플레이 포트int32Values[1]
밝기
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
PERF_ODOMETER
차량의 현재 주행 거리계 값입니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:KILOMETER
출시: Android 13
PERF_REAR_STEERING_ANGLE
차량의 후면 자전거 모델 조향 각도입니다. 각도는 도 단위로 측정됩니다. 왼쪽은 음수입니다. 이 속성은 스티어링 휠의 각도와 무관합니다. 이 속성은 스티어링 휠의 각도가 아닌 차량을 기준으로 한 뒷바퀴의 각도를 전달해야 합니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:DEGREES
출시: Android 13
PERF_STEERING_ANGLE
차량의 앞 자전거 모델 조향 각도입니다. 각도는 도 단위로 측정됩니다. 왼쪽은 음수입니다. 이 속성은 스티어링 휠의 각도와 무관합니다. 이 속성은 스티어링 휠의 각도가 아닌 차량을 기준으로 한 앞바퀴의 각도를 전달해야 합니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:DEGREES
출시: Android 13
PERF_VEHICLE_SPEED
차량 속도입니다. 차량이 전진 중일 때는 값이 양수여야 하며 차량이 후진 중일 때는 음수여야 합니다. 이 값은 기어 값(CURRENT_GEAR
또는 GEAR_SELECTION
)과 무관합니다. 예를 들어 GEAR_SELECTION
이 GEAR_NEUTRAL
이면 PERF_VEHICLE_SPEED
는 차량이 전진할 때 양수, 후진할 때 음수, 움직이지 않을 때 0입니다.
변경 모드: CONTINUOUS
액세스 모드: READ
단위 유형: 해당 사항 없음
단위 유형: VehicleUnit:METER_PER_SEC
출시: Android 13
PERF_VEHICLE_SPEED_DISPLAY
디스플레이용 차량 속도입니다. 일부 차량의 경우 속도계에서 실제 속도보다 약간 느린 속도가 표시됩니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:METER_PER_SEC
출시: Android 13
POWER_POLICY_GROUP_REQ
전원 상태 전환당 기본 전원 정책을 결정하는 데 사용되는 전원 정책 그룹을 설정하는 요청을 정의합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
POWER_POLICY_REQ
전원 정책 적용 요청을 정의합니다. VHAL은 이 속성을 설정하여 자동차 전원 정책을 변경합니다.
자동차 전원 정책 서비스는 이 속성을 구독하고 실제로 전원 정책을 변경합니다. 요청은 VehiclePropValue를 /vendor/etc/automotive/power_policy.xml
에 정의된 전원 정책의 ID로 설정하여 이루어집니다. 지정된 ID가 정의되지 않으면 자동차 전원 정책 서비스는 요청을 무시하고 현재 전원 정책이 유지됩니다.
string: "sample_policy_id" // power policy ID
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
POWER_POLICY_GROUP_REQ
전원 상태 전환당 기본 전원 정책을 결정하는 데 사용되는 전원 정책 그룹을 설정하는 요청을 정의합니다. VHAL은 전원 정책 그룹의 ID로 이 속성을 설정하여 전원 상태 전환 시 적용되는 기본 전원 정책을 설정합니다. 전원 정책 그룹은 /vendor/etc/power_policy.xml에서 정의됩니다. 지정된 ID가 정의되지 않으면 자동차 전원 정책 서비스는 요청을 무시합니다. 자동차 전원 정책 서비스는 이 속성을 구독하고 전원 정책 그룹을 설정합니다. 전원 정책의 실제 적용은 시스템 전원 상태가 변경되고 새 전원 상태에 매핑된 유효한 전원 정책이 있는 경우에 이루어집니다.
string: "sample_policy_group_id" // power policy group ID
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
RANGE_REMAINING
남은 주행 가능 거리입니다. 남은 연료 및 충전량(미터)입니다. 잔여 주행 가능 거리는 차량의 모든 에너지 소스를 고려해야 합니다. 예를 들어 하이브리드 자동차의 주행 가능 거리는 연료와 배터리를 기반으로 한 주행 가능 거리의 합계입니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의됩니다. 내비게이션 앱이 예정된 경로를 기반으로 더 정확한 추정치를 가지고 있으면 범위를 업데이트할 수 있기 때문입니다. 이 속성은 OEM의 재량에 따라 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: CONTINUOUS
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:METER
출시: Android 13
READING_LIGHTS_STATE
독서등 현재 상태를 반환합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13
READING_LIGHTS_SWITCH
독서등을 제어하는 스위치입니다. 문이 열려 있거나 음성 명령으로 인해 조명이 켜져 있는 경우 READING_LIGHTS_STATE
과 다를 수 있습니다. 예를 들어 스위치가 꺼짐 또는 자동 위치에 있는 경우 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
REAR_FOG_LIGHTS_STATE
후방 안개등의 현재 상태를 반환합니다. FOG_LIGHTS_STATE
또는 REAR_FOG_LIGHTS_STATE
중 하나만 구현할 수 있습니다. FOG_LIGHTS_STATE
를 참고하세요.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13
REAR_FOG_LIGHTS_SWITCH
사용자가 원하는 설정입니다. FOG_LIGHTS_SWITCH
또는 REAR_FOG_LIGHTS_SWITCH
중 하나만 구현하면 됩니다. 자세한 내용은 FOG_LIGHTS_SWITCH
를 참고하세요. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
REMOVE_USER
Android 사용자가 삭제된 후 Android 시스템에서 호출됩니다. HAL은 이 속성을 사용하여 상응하는 사용자를 삭제할 수 있습니다. 쓰기 전용 호출입니다. Android 시스템은 HAL의 응답을 기대하지 않습니다. 따라서 이 요청은 실패하지 않습니다. 상응하는 HAL 사용자를 삭제할 수 없는 경우 HAL은 이를 비활성으로 표시하거나 다른 방법으로 복구해야 합니다.
VehiclePropValue를 RemoveUserRequest
로 정의된 콘텐츠로 설정하여 요청합니다. 예를 들어 시스템에 사용자 3명 (0, 10, 11)이 있고 사용자 11이 삭제된 경우 요청은 다음과 같습니다.
int32[0]
42 // 요청 IDint32[1]
11 // (삭제된 사용자의 Android 사용자 ID)int32[2]
0 // (삭제된 사용자의 Android 사용자 플래그)int32[3]
10 // 현재 사용자int32[4]
0 // 현재 사용자 플래그 (없음)int32[5]
2 // 사용자 수int32[6]
0 // 첫 번째 사용자 (사용자 0)int32[7]
0 // 첫 번째 사용자 플래그 (없음)int32[8]
10 // 두 번째 사용자 (사용자 10)int32[9
] 0 // 두 번째 사용자 플래그 (없음)
변경 모드: STATIC
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
S~Z
SEAT_AIRBAG_ENABLED
트리거될 때 좌석의 에어백 배치 기능을 활성화 및 비활성화하는 기능을 나타냅니다.
(예: 충돌) true
인 경우 좌석의 에어백이 사용 설정되어 있으며, 트리거되면 펼쳐집니다. true
인 경우 좌석의 에어백이 사용 중지되며 실행됩니다.
배포되지 않습니다 이 속성은 에어백 배포 여부를 나타내지 않습니다.
이 속성은 규제 또는 안전 문제의 목적으로 읽기 전용 VehiclePropertyAccess.READ
로 설정할 수 있습니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
SEAT_BACKREST_ANGLE_1_MOVE
좌석 등받이 각도 1회 동작입니다. maxInt32Value
및 minInt32Value
각 VehicleAreaConfig
를 정의해야 합니다. minInt32Value
과 maxInt32Value
사이의 모든 정수를 지원해야 합니다.
maxInt32Value
는 앞으로 기울이는 동안 좌석 등받이의 최대 이동 속도를 나타냅니다. minInt32Value
는 좌석의 최대 이동 속도를 나타냅니다.
등받이가 고정되지 않습니다.
양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 좌석 등받이가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. 만약
SEAT_BACKREST_ANGLE_1_MOVE
가 0이고 움직임이 발생하지 않습니다.
이 속성은 지정된 상대 이동 속도 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_BACKREST_ANGLE_1_POS
좌석 등받이 각도 1 위치 등받이 각도 1은 좌석 하단에 가장 가까운 액추에이터입니다. maxInt32Value
및 minInt32Value
VehicleAreaConfig
을(를) 정의해야 합니다. minInt32Value
과 maxInt32Value
사이의 모든 정수를 지원해야 합니다. minInt32Value
는 좌석 하단의 액추에이터와 관련하여 좌석 등받이의 완전히 젖힌 위치를 나타냅니다. 이
maxInt32Value
는 좌석 등받이의 가장 똑바로 또는 앞으로 놓여 있는 위치를 나타냅니다.
좌석 하단의 액추에이터에 연결됩니다.
minInt32Value
~maxInt32Value
사이의 값은 전환을 나타냅니다.
상태를 유지합니다.
이 속성은 상대 위치의 지정된 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_BACKREST_ANGLE_2_MOVE
좌석 등받이 각도 2 이동. 각 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
는 정의되어야 합니다. minInt32Value
과 maxInt32Value
사이의 모든 정수를 지원해야 합니다.
maxInt32Value
는 좌석 등받이의 최대 이동 속도를 나타내며
있습니다. minInt32Value
는 리클라이닝하는 동안 좌석 등받이의 최대 이동 속도를 나타냅니다.
절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석 등받이가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. 만약
SEAT_BACKREST_ANGLE_2_MOVE
은(는) 현재 0이며 진행 중인 움직임이 없습니다.
이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_BACKREST_ANGLE_2_POS
좌석 등받이 각도 2번 위치 등받이 각도 2는 있습니다.
VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
에서 maxInt32Value
사이의 모든 정수
#0지원되어야 합니다.
minInt32Value
는 각도와 관련하여 좌석 등받이의 전체 기울기 위치를 나타냅니다.
좌석 하단의 액추에이터에서 다음 액추에이터로 이동합니다 (아래 참조
SEAT_BACKREST_ANGLE_1_POS
참조). maxInt32Value
는 좌석 하단의 액추에이터에서 등받이의 다음 액추에이터에 관해 좌석 등받이의 가장 직립하고 앞으로 나온 위치를 나타냅니다(자세한 내용은 SEAT_BACKREST_ANGLE_1_POS
참고).
minInt32Value
~maxInt32Value
사이의 값은 전환을 나타냅니다.
상태를 유지합니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_벨트_버클
안전벨트가 매겼습니다. True는 벨트에 안전벨트가 매여 있음을 나타냅니다. 쓰기 액세스는 자동 좌석 벨트 잠금 기능을 나타냅니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_BELT_HEIGHT_MOVE
안전벨트 높이 이동 각 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
는 정의되어야 합니다. minInt32Value
사이의 모든 정수
및 maxInt32Value
가 지원되어야 합니다.
maxInt32Value
는 안전벨트 어깨의 최대 이동 속도를 나타냅니다.
고정합니다. minInt32Value
는 아래로 이동하는 동안 안전 벨트의 어깨 앵커의 최대 이동 속도를 나타냅니다.
양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 안전 벨트가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. SEAT_BELT_HEIGHT_MOVE
값이 0이면 이동이 진행되지 않습니다.
이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_벨트_높이_POS
안전벨트 높이 위치 어깨 벨트 앵커 포인트를 조정합니다.
VehicleAreaConfig의 maxInt32Value
및 minInt32Value
는
정의할 수 있습니다 minInt32Value
에서 maxInt32Value
사이의 모든 정수는
지원됩니다.
minInt32Value
는 안전 벨트의 어깨 앵커가 가장 낮은 위치에 있음을 나타냅니다. maxInt32Value
는 안전 벨트의 어깨 앵커가 가장 높은 위치에 있음을 나타냅니다.
minInt32Value
과 maxInt32Value
사이의 값은 가장 낮은 위치와 가장 높은 위치 간의 전환 상태를 나타냅니다.
이 속성은 상대 위치의 지정된 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_CUSHION_SIDE_SUPPORT_MOVE
좌석 쿠션 측면 지지대의 움직임 방향 및 속도 속성을 나타냅니다.
각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
는
정의할 수 있습니다 minInt32Value
에서 maxInt32Value
사이의 모든 정수는
지원됩니다.
maxInt32Value
는 좌석 쿠션 측면 지지대가 더 넓어질 때의 최대 움직임 속도를 나타냅니다(예: 지지대가 감소함). minInt32Value
는 좁아질 때(예: 지지대가 증가함) 좌석 쿠션 측면 지지대의 최대 이동 속도를 나타냅니다.
양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 좌석 쿠션 측면 지지대가 위치 한도에 도달하면 값을 0으로 재설정해야 합니다. 값이
SEAT_CUSHION_SIDE_SUPPORT_MOVE
가 0이면 움직임이 발생하지 않습니다.
이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
SEAT_CUSHION_SIDE_SUPPORT_POS
좌석의 엉덩이 (하단 쿠션 측면) 지지 위치에 대한 속성을 나타냅니다.
각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수가 지원되어야 합니다.
maxInt32Value
는 좌석 쿠션 측면 지지대가 가장 넓은 위치에 있음을 나타냅니다(예: 가장 약한 지지). minInt32Value
는 좌석 쿠션 측면 지지대가 가장 얇은 위치(예: 가장 많은 지지)에 있음을 나타냅니다.
minInt32Value
과 maxInt32Value
사이의 값은 가장 얇은 위치와 가장 넓은 위치 간의 전환 상태를 나타냅니다.
이 속성은 상대 위치의 지정된 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 <covehiclepropertyaccess.read< code=""> only.</covehiclepropertyaccess.read<>로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
SEAT_DEPTH_MOVE
좌석 깊이 이동
각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
는
정의할 수 있습니다 minInt32Value
에서 maxInt32Value
사이의 모든 정수는
지원됩니다.
maxInt32Value
는 깊어지는 동안 좌석의 최대 이동 속도를 나타내고 minInt32Value
는 얕아지는 동안 좌석의 최대 이동 속도를 나타냅니다.
절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 일단
좌석 등받이가 위치 한계에 도달하면 값을 0으로 재설정해야 합니다. SEAT_DEPTH_MOVE
값이 현재 0이면 이동이 진행되지 않습니다.
이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_DEPTH_POS
좌석 깊이 위치입니다. 등받이에서 좌석 앞쪽 가장자리까지의 거리인 좌석 깊이를 설정합니다.
VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. 모든 정수
minInt32Value
에서 maxInt32Value
사이의 값을 지원해야 합니다.
minInt32Value
는 좌석이 가장 낮은 위치에 있음을 나타냅니다(예: 좌석 쿠션의 앞쪽 가장자리와 좌석의 뒤쪽 끝 사이의 거리가 가장 짧은 위치).
maxInt32Value
는 좌석이 가장 낮은 위치에 있음을 나타냅니다(예: 좌석 쿠션의 앞쪽 가장자리와 좌석의 뒤쪽 끝 사이의 거리가 가장 긴 위치).
minInt32Value
과 maxInt32Value
사이의 값은 가장 낮은 위치와 가장 높은 위치 간의 전환 상태를 나타냅니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
<covehiclepropertyaccess.read< 코드="">
전용...</covehiclepropertyaccess.read<>
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_EASY_ACCESS_ENABLED
좌석 접근성 기능의 속성을 나타냅니다. 이 속성이 true이면 탑승자가 차량에 더 쉽게 드나들 수 있도록 좌석이 자동으로 조정됩니다. 각 영역 ID는 사용자가 쉬운 액세스 기능을 사용하여 승하차하려는 좌석에 매핑되어야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
<covehiclepropertyaccess.read< 코드="">
전용입니다.</covehiclepropertyaccess.read<>
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
SEAT_FOOTWELL_LIGHTS_STATE
좌석 발판 조명 상태의 속성을 나타냅니다. SEAT_FOOTWELL_LIGHTS_STATE
는
현재 상태를 나타냅니다. 이것은
SEAT_FOOTWELL_LIGHTS_SWITCH
: 조명을 제어하는 스위치의 위치를 나타냅니다.
따라서 SEAT_FOOTWELL_LIGHTS_STATE
가 SEAT_FOOTWELL_LIGHTS_SWITCH
값과 일치하지 않을 수 있습니다(예: SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
및 SEAT_FOOTWELL_LIGHTS_SWITCH=ON
).
이 속성은 SEAT_FOOTWELL_LIGHTS_STATE
의 값이 CABIN_LIGHTS_STATE의 값과 다를 수 있는 경우에만 구현해야 합니다.
지원되는 각 영역 ID에 대해 VehicleAreaConfig#supportedEnumValues는 다음을 정의해야 합니다. VehicleLightState의 모든 enum 값이 지원됩니다.
모드 변경: ON_CHANGE
액세스 모드: READ
enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 14
SEAT_FOOTWELL_lightS_SWITCH
좌석 발밑 조명 스위치의 속성을 나타냅니다. SEAT_FOOTWELL_LIGHTS_SWITCH
는 다음을 나타냅니다.
조명 제어 스위치의 위치입니다. 이는 특정 시점의 조명 현재 상태를 반영하는 SEAT_FOOTWELL_LIGHTS_STATE의 기능과는 다릅니다.
따라서 SEAT_FOOTWELL_LIGHTS_SWITCH
이 SEAT_FOOTWELL_LIGHTS_STATE 값과 일치하지 않을 수 있습니다(예: SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
및 SEAT_FOOTWELL_LIGHTS_SWITCH=ON
).
이 속성은 SEAT_FOOTWELL_LIGHTS_SWITCH 값이 다를 수 있는 경우에만 구현해야 합니다. CABIN_LIGHTS_SWITCH의 API입니다.
지원되는 각 영역 ID에 대해 VehicleAreaConfig#supportedEnumValues는 VehicleLightSwitch의 enum 값이 지원됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_FORE_AFT_MOVE
앞뒤로 좌석 이동 이 속성은 좌석이 향하는 방향으로 전체 좌석을 앞뒤로 이동합니다.
각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
는
정의할 수 있습니다 minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
maxInt32Value
는 전진하는 동안 좌석의 최대 이동 속도를 나타냅니다. minInt32Value
는 좌석의 최대 이동 속도를 나타내며
뒤로 이동하면서
절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 일단
사용 가능 라이선스 수가 위치 한계에 도달하면 값을 0으로 재설정해야 합니다. 값이
SEAT_FORE_AFT_MOVE
가 0이고 움직임이 발생하고 있지 않습니다.
이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_FORE_AFT_POS
좌석 앞뒤 위치 좌석 위치를 앞뒤로 설정합니다.
VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다.
minInt32Value
에서 maxInt32Value
사이의 모든 정수가 지원되어야 합니다.
minInt32Value
는 좌석이 가장 뒤쪽 선형 위치에 있음을 나타냅니다.
maxInt32Value
는 좌석이 가장 앞쪽 선형 위치에 있음을 나타냅니다. 값
minInt32Value
과 maxInt32Value
사이는 전환 상태를 나타냄
가장 가까운 위치와 가장 먼 위치 간의
차이라고 합시다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_HEADREST_ANGLE_MOVE
헤드레스트 각도 이동 각각 maxInt32Value
및 minInt32Value
VehicleAreaConfig
을(를) 정의해야 합니다. minInt32Value
사이의 모든 정수
및 maxInt32Value
가 지원되어야 합니다.
maxInt32Value
는 직립 또는 앞으로 이동하는 동안 좌석 헤드레스트의 최대 이동 속도를 나타냅니다. minInt32Value
는 얕은 위치로 이동하는 동안 좌석 헤드레스트의 최대 이동 속도를 나타냅니다.
양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 좌석의 헤드레스트가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. 값이
SEAT_HEADREST_ANGLE_MOVE
이 0이면 움직임이 발생하지 않습니다.
이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 <covehiclepropertyaccess.read< code=""> only..</covehiclepropertyaccess.read<>로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_HEADREST_ANGLE_POS
헤드레스트 각도 위치 maxInt32Value
및 minInt32Value
VehicleAreaConfig
을(를) 정의해야 합니다. minInt32Value
사이의 모든 정수
및 maxInt32Value
가 지원되어야 합니다.
minInt32Value
는 머리받침이 완전히 젖혀진 위치에 있음을 나타냅니다. maxInt32Value
: 헤드레스트가 가장 수직이고 앞으로 향한 위치에 있음을 나타냅니다.
minInt32Value
과 maxInt32Value
사이의 값은
완전한 기울기와 가장 똑바로 된 위치와 앞으로 놓인 위치 사이의 전환 상태를 뜻합니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_HEADREST_FORE_AFT_MOVE(SEAT_HEADREST_FORE_AFT_MOVE)
헤드레스트 앞뒤 이동 maxInt32Value
및 minInt32Value
각 VehicleAreaConfig
를 정의해야 합니다. 다음 사이의 모든 정수
minInt32Value
및 maxInt32Value
가 지원되어야 합니다.
maxInt32Value
는 좌석 머리 받침대의 최대 이동 속도를 나타냅니다.
살펴봤습니다 minInt32Value
는 최대 이동 속도를 나타냅니다.
좌석의 머리 받침대를 조절하는 것입니다.
양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 한 번
좌석의 머리 받침대가 위치 한계에 도달하면 값을 0으로 재설정해야 합니다. 값이
SEAT_HEADREST_FORE_AFT_MOVE
가 0이면 움직임이 발생하지 않습니다.
이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_HEADREST_FORE_AFT_POS
헤드레스트 앞뒤 위치 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
사이의 모든 정수
및 maxInt32Value
가 지원되어야 합니다.
minInt32Value
는 헤드레스트가 가장 뒤쪽 선형 위치에 있음을 나타냅니다.
maxInt32Value
는 헤드레스트가 가장 앞쪽 선형 위치에 있음을 나타냅니다.
minInt32Value
~maxInt32Value
사이의 값은 전환을 나타냅니다.
상태를 전달합니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_HEADREST_HEIGHT_MOVE
머리 받침대 높이 움직이기. 각각 maxInt32Value
및 minInt32Value
VehicleAreaConfig
을(를) 정의해야 합니다. minInt32Value
사이의 모든 정수
및 maxInt32Value
가 지원되어야 합니다.
maxInt32Value
는 위로 이동하는 동안 좌석 헤드레스트의 최대 이동 속도를 나타냅니다. minInt32Value
는 아래로 이동하는 동안 좌석 헤드레스트의 최대 이동 속도를 나타냅니다.
절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석의 헤드레스트가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. 만약
SEAT_HEADREST_HEIGHT_MOVE
가 0이면 움직임이 발생하지 않습니다.
이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_HEADREST_HEIGHT_POS
(지원 중단됨) 헤드레스트 높이 위치입니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_HEADREST_HEIGHT_POS_V2
헤드레스트 높이 위치 지원되는 좌석의 머리 받침대 높이를 설정합니다. VehiclePropConfig.areaConfigs는 지원되는 좌석을 지정합니다.
VehicleAreaConfig의 maxInt32Value
및 minInt32Value
는
정의할 수 있습니다 minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
minInt32Value
은 머리 받침대가 가장 낮은 위치에 있음을 나타냅니다. 이
maxInt32Value
는 머리 받침대가 가장 높은 위치에 있음을 나타냅니다.
minInt32Value
과 maxInt32Value
사이의 값은 전환을 나타냅니다.
표시됩니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
SEAT_HEIGHT_MOVE
좌석 높이 이동입니다. 각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
에서 사이에 있는 모든 정수
maxInt32Value
이(가) 지원되어야 합니다.
maxInt32Value
은 위로 이동할 때 좌석의 최대 이동 속도를 나타냅니다.
minInt32Value
는 아래로 이동할 때 좌석의 최대 이동 속도를 나타냅니다.
양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 자리가 위치 한도에 도달하면 값을 0으로 재설정해야 합니다. 값이
SEAT_HEIGHT_MOVE
값이 0이고 움직임이 발생하지 않습니다.
이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_HEIGHT_POS
좌석 높이 위치입니다. maxInt32Value
및 minInt32Value
VehicleAreaConfig를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
minInt32Value
는 좌석이 가장 낮은 위치에 있음을 나타냅니다. 이
maxInt32Value
는 좌석이 가장 높은 위치에 있음을 나타냅니다.
minInt32Value
과 maxInt32Value
사이의 값은 가장 낮은 위치와 가장 높은 위치 간의 전환 상태를 나타냅니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_LUMBAR_FORE_AFT_MOVE
요추 앞뒤 움직임 각각 maxInt32Value
및 minInt32Value
VehicleAreaConfig를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
maxInt32Value
는 앞으로 이동하는 동안 좌석의 요추 지지대의 최대 이동 속도를 나타냅니다. minInt32Value
는 뒤로 이동하는 동안 좌석의 요추 지지대의 최대 이동 속도를 나타냅니다.
절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다.
좌석의 요추 지지대가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다.
SEAT_LUMBAR_FORE_AFT_MOVE
값이 0이면 이동이 발생하지 않는 것입니다.
이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_LUMBAR_FORE_AFT_POS
목재 앞 및 후방 위치. VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다.
minInt32Value
는 요추 지지대가 가장 뒤쪽에 있음을 나타냅니다(예: 지지력이 가장 약한 위치). maxInt32Value
는 요추 지지대가 가장 앞쪽 위치에 있음을 나타냅니다(예: 가장 지지력이 좋은 위치).
minInt32Value
과 maxInt32Value
사이의 값은 전방 및 후방 위치 간의 전환 상태를 나타냅니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
모드 변경: ON_CHANGE
액세스 유형: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_LUMBAR_SIDE_SUPPORT_MOVE
허리 측면 지지대 이동 각각 maxInt32Value
및 minInt32Value
VehicleAreaConfig
을(를) 정의해야 합니다. minInt32Value
사이의 모든 정수
및 maxInt32Value
가 지원되어야 합니다.
maxInt32Value
는 넓어지는 동안 좌석의 요추 측면 지지대의 최대 이동 속도를 나타냅니다. minInt32Value
는 얇아지는 동안 좌석의 요추 측면 지지대의 최대 이동 속도를 나타냅니다.
양수 또는 음수의 절대값이 클수록 이동 속도가 더 빠릅니다. 좌석의 요추 측면 지지대가 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. SEAT_LUMBAR_SIDE_SUPPORT_MOVE
값이 0이면 움직임이 발생하지 않습니다.
이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 유형: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_LUMBAR_SIDE_SUPPORT_POS
허리 측면 지지대 위치 maxInt32Value
및 minInt32Value
VehicleAreaConfig를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다. minInt32Value
는 등추 측면 지지대가 가장 얇은 위치 (예: 대부분의 지지대)에 있음을 나타냅니다. 이
maxInt32Value
는 허리 측면 지지대가 가장 넓은 위치에 있음을 나타냅니다 (예:
최소 지원).
minInt32Value
과 maxInt32Value
사이의 값은 가장 좁은 위치와 가장 넓은 위치 간의 전환 상태를 나타냅니다.
이 속성은 상대 위치의 지정된 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 유형: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
SEAT_LUMBAR_가로_이동
좌석 허리 지지대의 수직 이동 방향 및 속도에 대한 속성을 나타냅니다.
각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
는 정의되어야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다. maxInt32Value
은 요추 지지대가 가장 빠른 위쪽 속도로 움직이고 있음을 나타냅니다. minInt32Value
은 요추 지지대가 가장 빠른 속도로 아래로 움직이고 있음을 나타냅니다.
절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 좌석 쿠션 측면 지지대가 위치 한도에 도달하면 값을 0으로 재설정해야 합니다. SEAT_LUMBAR_VERTICAL_MOVE의 값이 0이면 움직임이 발생하지 않는 것입니다.
이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
SEAT_LUMBAR_카테고리_POS
좌석의 요추 지지대 수직 위치의 속성을 나타냅니다. 각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. 다음 사이의 모든 정수
minInt32Value
및 maxInt32Value
가 지원되어야 합니다.
maxInt32Value
는 허리 지지대의 가장 높은 위치를 나타냅니다.
minInt32Value
은 허리 지지대의 가장 낮은 위치를 나타냅니다.
minInt32Value
과 maxInt32Value
사이의 값은 가장 낮은 위치와 가장 높은 위치 간의 전환 상태를 나타냅니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_MEMORY_SELECT
이 매개변수는 좌석 위치를 선택하는 데 사용할 메모리 사전 설정을 선택합니다. VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다.
minInt32Value
에서 maxInt32Value
사이의 모든 정수가 지원되어야 합니다.
minInt32Value
는 항상 0이고 maxInt32Value
는 사용 가능한 좌석 사전 설정 메모리 슬롯 수를 결정합니다(예: numSeatPresets - 1). 예를 들어 운전석 좌석에 메모리 사전 설정이 3개 있는 경우 maxInt32Value
는 2입니다. 이
사용자가 프리셋을 선택하면 원하는 프리셋 번호 (0, 1 또는 2)가 설정됩니다.
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_MEMORY_SET
이 설정을 사용하면 사용자가 현재 좌석 위치 설정을 선택한 사전 설정에 저장할 수 있습니다.
있습니다. maxInt32Value
및 minInt32Value
VehicleAreaConfig
을(를) 정의해야 합니다. minInt32Value
는 0이어야 하며
각 좌석 위치의 maxInt32Value
은(는) 다음의 maxInt32Value
과(와) 일치해야 합니다.
SEAT_MEMORY_SELECT
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
좌석 점유
차량이 판단할 수 있는 최선을 다해 특정 좌석의 점유 여부를 나타냅니다. 유효한 값은 VehicleSeatOccupancyState
enum에 속하는 값입니다.
모드 변경: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleSeatOccupancyState
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_TILT_MOVE
좌석 기울이기 동작입니다. 각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다. maxInt32Value
는 위로 이동하는 동안 좌석 앞쪽 가장자리의 최대 이동 속도를 나타냅니다. 이
minInt32Value
는 좌석 앞 가장자리의 최대 이동 속도를 나타냅니다.
접을 수 있습니다.
양수 또는 음수의 절댓값이 클수록 이동 속도가 빠릅니다. 좌석 하단이 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. SEAT_TILT_MOVE의 값이 현재 0이면 진행 중인 이동이 없습니다.
이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_TILT_POS
좌석 기울기 위치입니다. VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
에서 사이에 있는 모든 정수
maxInt32Value
이(가) 지원되어야 합니다. minInt32Value
는 좌석 하단이 가장 낮은 각도 위치에서 기울어 있음을 나타냅니다. 이는 좌석의
좌석의 뒤쪽 끝을 기준으로 가능한 가장 낮은 위치에 전면 가장자리를 배치합니다.
maxInt32Value
는 좌석 하단이 가장 높은 각도 위치에서 기울어져 있음을 나타냅니다.
좌석의 앞쪽 가장자리를 뒤쪽을 기준으로 가능한 가장 높은 위치에 해당합니다.
있습니다.
minInt32Value
과 maxInt32Value
사이의 값은 전환을 나타냅니다.
표시됩니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
SEAT_WALK_IN_POS
좌석의 현재 방문 위치를 나타내는 속성을 나타냅니다. minInt32Value
는 일반 좌석 위치를 나타냅니다. minInt32Value
0이어야 합니다. maxInt32Value
는 좌석이 완전히 들어간 상태임을 나타냅니다.
minInt32Value
과 maxInt32Value
사이의 값은 일반 위치와 워크인 위치 간의 전환 상태를 나타냅니다.
이 속성은 상대 위치의 지정된 범위로 표현됩니다.
구역 ID는 방문 수리 기능이 활성화될 때 실제로 이동하는 좌석과 일치해야 하며, 승객이 앉을 의도된 좌석입니다.
이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은
VehiclePropertyAccess.READ로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SHUTDOWN_REQUEST
헤드 단위를 중지하도록 요청합니다.
헤드 단위의 전원이 꺼져 있을 때 작업을 실행하는 데 필요합니다 (원격 작업 기능). 작업을 실행하기 위해 헤드 유닛의 전원이 켜지면 헤드 유닛이 종료되어야 합니다. 머리 단위가 이 메시지를 보냅니다.
이 속성은 사용자가 헤드 단위를 종료하려고 할 때는 적용되지 않습니다.
일반적으로 헤드 단위 외부의 별도 시스템(예: 전원 컨트롤러)에 헤드 단위 종료 준비를 알립니다.
외부 시스템은 차량이 사용 중인지 확인하여 이 요청이 유효한지 확인해야 합니다. SHUTDOWN_REQUEST가 전송된 후 사용자가 차량에 탑승하면 시스템은 이 요청을 무시해야 합니다. 전원 컨트롤러에 VehicleInUse 속성을 저장하고 VEHICLE_IN_USE 속성을 통해 이를 노출합니다. VehicleInUse가 종료 요청을 무시해야 함 true입니다.
허용되는 경우 외부 시스템은 헤드 유닛에 종료 신호를 전송하여 VHAL이 Android에 SHUTDOWN_PREPARE 메시지를 전송하게 합니다. 그러면 Android가 종료 프로세스를 시작합니다. 확인할 수 있습니다.
이 속성은 요청 실행 전용이며 쓰기만 지원합니다. 이 속성 값이 설정될 때마다 현재 속성 값과 관계없이 종료 요청이 실행됩니다. 현재 속성 값은 의미가 없습니다.
이 속성은 쓰기 전용이므로 구독이 허용되지 않으며 속성 변경 이벤트는 생성됩니다.
설정할 값은 종료 옵션을 나타내며 다음 중 하나여야 합니다.
{@code VehicleApPowerStateShutdownParam}
예를 들면 다음과 같습니다.
VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY
입니다. 이 종료 옵션은
시스템에서 이러한 옵션을 지원하지 않으면 적용됩니다. 이러한 경우에는 오류가 반환되지 않습니다.
구성 정보의 경우 VehiclePropConfig.configArray
에는 {@code VehicleApPowerStateConfigFlag}
의 값을 결합하는 비트 플래그가 있어야 지원되는 종료 옵션을 나타낼 수 있습니다.
종료 요청을 다른 시스템에 전송하지 못하면 오류를 반환합니다.
모드 변경: ON_CHANGE
액세스 모드: WRITE
Enum 유형: VehicleApPowerStateShutdownParam
>
단위 유형: 해당 사항 없음
출시: Android 14
이동_WHEEL_DEPTH_MOVE
핸들 깊이 움직임입니다. maxInt32Value
및 minInt32Value
VehicleAreaConfig의 정의되어야 합니다. minInt32Value
과 maxInt32Value
사이의 모든 값을 지원해야 합니다.
maxInt32Value
는 핸들이 운전자로부터 멀어지는 것을 나타냅니다. minInt32Value
은 운전자 쪽으로 움직이는 스티어링 휠을 나타냅니다.
정수 또는 음수의 정수가 클수록 이동 속도가 더 빠릅니다. 스티어링 휠이 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. STEERING_WHEEL_DEPTH_MOVE
값이 현재 0이면 이동이 진행되지 않는 것입니다.
이 속성은 지정된 상대 이동 속도 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
STEERING_WHEEL_DEPTH_POS
핸들 깊이 위치입니다. 모든 핸들 속성 고유 ID는 0x0BE0부터 시작합니다.
VehicleAreaConfig의 maxInt32Value
및 minInt32Value
는 정의되어야 합니다. minInt32Value
과 maxInt32Value
사이의 모든 값을 지원해야 합니다. maxInt32Value
는 운전자와 가장 먼 핸들 위치를 나타냅니다. minInt32Value
는
드라이버입니다.
minInt32Value
과 maxInt32Value
사이의 값은
전환 상태를
이 속성은 상대 위치의 지정된 범위로 표현됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
STEERING_WHEEL_EASY_ACCESS_ENABLED
스티어링 휠 간편 액세스 기능이 사용 설정되었습니다. 이 값이 true이면 운전자가 차량에 더 쉽게 탑승하고 내릴 수 있도록 운전자의 스티어링 휠이 자동으로 조정됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
STEERING_WHEEL_HEIGHT_MOVE
핸들 높이 움직임입니다. VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
과 maxInt32Value
사이의 모든 값을 지원해야 합니다.
maxInt32Value
는 핸들이 위로 이동하는 것을 나타냅니다. minInt32Value
은 스티어링 휠이 아래로 움직임을 나타냅니다.
양수 또는 음수 중 더 큰 정수는 더 빠른 이동 속도를 나타냅니다. 스티어링 휠이 위치 제한에 도달하면 값을 0으로 재설정해야 합니다. 만약
STEERING_WHEEL_HEIGHT_MOVE
의 값이 현재 0이면 움직임이 없음을 의미합니다.
확인할 수 있습니다
이 속성은 지정된 상대적 범위로 표현됩니다. 학습합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
STEERING_WHEEL_HEIGHT_POS
스티어링 휠 높이 위치
VehicleAreaConfig의 maxInt32Value
및 minInt32Value
는
정의할 수 있습니다 minInt32Value
과 maxInt32Value
사이의 모든 값을 지원해야 합니다. maxInt32Value
는 핸들이 가장 높은 위치에 있음을 나타냅니다.
있습니다. minInt32Value
는 핸들이 최저점에 있음을 나타냅니다.
있습니다.
minInt32Value
과 maxInt32Value
사이의 값은 가장 낮은 위치와 가장 높은 위치 간의 전환 상태를 나타냅니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
STEERING_WHEEL_LIGHTS_STATE
스티어링 휠 조명 상태입니다. 핸들 조명의 현재 상태를 나타냅니다. 이는 조명을 제어하는 스위치의 위치를 나타내는 STEERING_WHEEL_LIGHTS_SWITCH
와 다릅니다. 따라서 STEERING_WHEEL_LIGHTS_STATE
는
STEERING_WHEEL_LIGHTS_SWITCH
(예:
및
STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
STEERING_WHEEL_LIGHTS_STATE=ON
).
이 속성은 STEERING_WHEEL_LIGHTS_STATE
의 값이 CABIN_LIGHTS_STATE의 값과 다를 수 있는 경우에만 구현해야 합니다.
전역 영역 ID(0)의 경우 VehicleLightState의 모든 enum 값이 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues를 정의해야 합니다.
모드 변경: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 14
STEERING_WHEEL_LIGHTS_SWITCH
핸들 조명 스위치입니다. 조종을 제어하는 스위치의 위치를 나타냅니다.
휠 조명. 이는 스티어링 휠 조명의 현재 상태를 나타내는 와는 다릅니다. 따라서 STEERING_WHEEL_LIGHTS_SWITCH
은
STEERING_WHEEL_LIGHTS_STATE
의 값입니다. 예를 들어
STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
및
STEERING_WHEEL_LIGHTS_STATE=ON
입니다.
이 속성은 STEERING_WHEEL_LIGHTS_SWITCH
의 값이 CABIN_LIGHTS_SWITCH
의 값과 다를 수 있는 경우에만 구현해야 합니다.
전역 영역 ID (0)의 경우 VehicleAreaConfig#supportedEnumValues
는 다음과 같아야 합니다.
VehicleLightSwitch의 모든 enum 값이 지원되지 않는 한 정의됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 14
STEERING_WHEEL_LOCKED
핸들이 잠겼습니다. true인 경우 핸들 위치가 잠겨 있으며 변경할 수 없습니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
<covehiclepropertyaccess.read< 코드="">
전용./p>
</covehiclepropertyaccess.read<>
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
STEERING_WHEEL_THEFT_잠금 사용 설정됨
스티어링 휠 도난 방지 잠금 기능이 사용 설정되었습니다. 이 값이 true이면 특정 상황에서 도난을 방지하기 위해 스티어링 휠이 자동으로 잠깁니다. 이 속성은 VehiclePropertyAccess.READ_WRITE로 정의되지만 OEM은 VehiclePropertyAccess.READ로만 구현할 수 있습니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
STORAGE_ENCRYPTION_BINDING_SEED
외부 암호화 결합 시드입니다. 이 값은 로컬 키 스토리지 암호화 키와 함께 사용됩니다. 이 속성은 16바이트를 보유하며 IVI와는 별도로 ECU에 지속될 것으로 예상됩니다. 이 속성은 처음에 AAOS에 의해 설정되며 AAOS는 CSRNG를 사용하여 속성을 생성합니다. 그런 다음 AAOS는 후속 부팅 시 속성을 읽습니다. 바인딩 시드는 안정적으로 유지될 것으로 예상됩니다. 시드를 잃으면 IVI가 초기화됩니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SUPPORT_CUSTOMIZE_VENDOR_PERMISSION
공급업체 속성의 권한 맞춤설정을 지원합니다.
VHAL에서 공급업체 권한 맞춤설정 기능을 지원하는 경우 이 속성을 구현합니다.
VehiclePropConfig.configArray는 포드를 실행하는 공급업체 속성 및 권한을 나타내는 데
선택할 수 있습니다 권한은 VehicleVendorPermission의 enum 중 하나여야 합니다.
configArray는 다음과 같이 설정됩니다. 공급업체 속성의 경우 configArray[n]: propId : property ID
, 여기서 configArray[n+1]은 VehicleVendorPermission의 enum이며 속성 값을 읽는 권한을 나타냅니다.
configArray[n+2] 는 VehicleVendorPermission의 enum이며 쓰기 권한을 나타냅니다. 속성의 값입니다. 예를 들면 다음과 같습니다.
configArray: { vendor_prop_1, PERMISSION_VENDOR_SEAT_READ, PERMISSION_VENDOR_SEAT_WRITE, vendor_prop_2, PERMISSION_VENDOR_INFO, PERMISSION_NOT_ACCESSIBLE, }
공급업체 속성이 이 배열에 없는 경우 기본 공급업체 권한을 가집니다. 공급업체인 경우 PERMISSION_NOT_ACCESSIBLE을 선택하면 Android가 속성에 액세스할 수 없습니다. 이 예에서 Android는 vendor_prop_2의 값을 쓸 수 없습니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SUPPORTED_PROPERTY_IDS
(지원 중단됨) 지원되는 모든 속성 ID의 목록입니다.
모드 변경: STATIC
액세스 모드: READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
SWITCH_USER
포그라운드 Android 사용자를 전환하는 요청을 정의합니다.
이 속성은 주로 Android 시스템에서 현재 포그라운드 Android 사용자가 전환되고 있음을 HAL에 알리는 데 사용되지만 HAL에서 Android 시스템에 사용자 전환을 요청하는 데도 사용할 수 있습니다. Android에서 요청하면 VehiclePropValue가 설정되고 HAL은 속성 변경 이벤트로 응답해야 합니다. HAL이 요청할 때는 속성 변경 이벤트를 통해서도 요청해야 합니다. 주요 차이점은 요청 ID가 전자의 경우 양수이고 후자의 경우 음수라는 점입니다. SwitchUserMessageType도 다릅니다.
두 요청의 형식은 SwitchUserRequest 및 응답 형식( 필수)는 SwitchUserResponse에서 정의합니다. HAL(또는 Android 시스템)이 진행하는 방식은 아래에 정의된 대로 메시지 유형(SwitchUserMessageType 매개변수로 정의됨)에 따라 다릅니다.LEGACY_ANDROID_SWITCH
Android 시스템에서 Android 사용자를 나타내기 위해 호출합니다. 통합되지 않은 방식으로 변경 요청이 이루어졌을 때 HAL (예: adb shell am switch-user를 통해) HAL은 이 요청을 수신하면 내부 사용자를 전환할 수 있지만 Android 시스템에 다시 답변할 필요는 없습니다. 이 어떤 이유로 내부 사용자를 변경할 수 없으면 복구를 위한SWITCH_USER(type=ANDROID_POST_SWITCH)
호출 (예: 다음을 실행할 수 있음) 이전 사용자로 다시 전환하는SWITCH_USER(type=VEHICLE_REQUEST)
). 되돌리면 최종 사용자가 혼란스러워질 수 있으므로 실패하지 않는 것이 이상적입니다.
예를 들어 시스템에 사용자 (0, 10, 11)가 있고 0에서 11로 전환하는 경우 (특별한 플래그가 없는 경우) 요청은 다음과 같습니다.
<ph type="x-smartling-placeholder">- </ph>
int32[0]
42 // 요청 IDint32[1]
1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCHint32[2]
11 // 대상 사용자 IDint32[3]
0 // 타겟 사용자 플래그(없음)int32[4]
10 // 현재 사용자int32[5]
0 // 현재 사용자 플래그 (없음)int32[6]
3 // 사용자 수int32[7]
0 // 사용자 0(Android 사용자 ID 0)int32[8]
0 // 사용자 #0의 플래그 (없음)int32[9]
10 // 사용자 1 (Android 사용자 ID 10)int32[10]
0 // 사용자 1의 플래그(없음)int32[11]
11 // 사용자 2 (Android 사용자 ID 11)int32[12]
0 // 사용자 2의 플래그(없음)
ANDROID_SWITCH
Android 사용자가 곧 변경된다는 것을 나타내기 위해 Android 시스템에서 호출합니다. Android는 계속 진행하기 전에 HAL의 응답을 기다립니다. HAL은 이 요청을 받으면 내부 사용자를 전환한 다음 내부 사용자가 전환되었는지 여부를 나타내는SWITCH_USER(type=VEHICLE_RESPONSE)
(SwitchUserStatus enum을 통해) 예를 들어 Android에 사용자(0, 10, 11)가 있고 10에서 11로 전환하는 경우(특수 플래그가 없는 경우) 요청은 다음과 같습니다.int32[0]
42 // 요청 IDint32[1]
2 // SwitchUserMessageType::ANDROID_SWITCHint32[2]
11 // 대상 사용자 IDint32[3]
0 // 타겟 사용자 플래그(없음)int32[4]
10 // 현재 사용자int32[5]
0 // 현재 사용자 플래그 (없음)int32[6]
3 // 사용자 수int32[7]
0 // 첫 번째 사용자 (사용자 0)int32[8]
1 // 첫 번째 사용자 플래그 (SYSTEM)int32[9]
10 // 두 번째 사용자 (사용자 10)int32[10]
0 // 두 번째 사용자 플래그(없음)int32[11]
11 // 세 번째 사용자(사용자 11)int32[12]
0 // 세 번째 사용자 플래그 (없음)
요청이 성공하면 HAL은 다음을 사용하여 속성을 업데이트해야 합니다.
int32[0]
42 // 요청 IDint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
1 // status: SwitchUserStatus::SUCCESS
요청이 실패하면 응답은 다음과 같습니다.
int32[0]
42 // 요청 IDint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
2 // status: SwitchUserStatus::FAILURE string: "108-D'OH!"- OEM별 오류 메시지
VEHICLE_RESPONSE
ANDROID_SWITCH 유형의 요청이 있는지 나타내기 위해 HAL에서 호출합니다. 진행 또는 중단해야 합니다. ANDROID_SWITCH도 참고하세요.VEHICLE_REQUEST
현재 포그라운드 Android 사용자가 다음에 오도록 요청하기 위해 HAL에서 호출합니다. 알 수 있습니다. 이는 Android가 한 사용자로 시작했지만 차량에서 운전자를 다른 사용자로 식별한 경우에 유용합니다. 예를 들어 사용자 A가 사용자 B의 전자 키를 사용하여 자동차를 잠금 해제했습니다. INITIAL_USER_INFO 요청에서 사용자 B를 반환했지만 얼굴 인식 하위 시스템이 사용자를 A로 식별했습니다. HAL은 속성 변경 이벤트(음수 요청 ID 전달)를 통해 이 요청을 실행하고 Android 시스템은 동일한 요청 ID인 ANDROID_POST_SWITCH 호출을 실행하여 응답합니다. 예를 들어 현재 포그라운드 Android 사용자가 10이고 HAL에서 11로 전환하도록 요청한 경우 요청은 다음과 같습니다.int32[0]
-108 // 요청 IDint32[1]
4 // messageType: SwitchUserMessageType::VEHICLE_REQUESTint32[2]
11 // Android 사용자 ID
요청이 성공하고 Android에 사용자(0, 10, 11)가 3명 있는 경우 응답은 다음과 같습니다.
int32[0]
-108 // 요청 IDint32[1]
5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCHint32[2]
11 // 대상 사용자 IDint32[3]
0 // 타겟 사용자 ID 플래그(없음)int32[4]
11 // 현재 사용자int32[5]
0 // 현재 사용자 플래그(없음)int32[6]
3 // 사용자 수int32[7]
0 // 첫 번째 사용자(사용자 0)int32[8]
0 // 첫 번째 사용자 플래그 (없음)int32[9]
10 // 두 번째 사용자 (사용자 10)int32[10]
4 // 두 번째 사용자 플래그 (없음)int32[11]
11 // 세 번째 사용자 (사용자 11)int32[12]
3 // 세 번째 사용자 플래그(없음)
현재 사용자 ID와 대상 사용자 ID가 동일합니다. 요청이 실패하면 다를 수 있습니다. 예를 들어 대상 사용자는 11이 되고 현재 사용자는 10이 됩니다.
ANDROID_POST_SWITCH
사용자 전환 요청 후 Android 시스템에서 호출합니다. 이 속성은 모든 유형의 전환 요청(예: >code>LEGACY_ANDROID_SWITCH, >code>ANDROID_SWITCH 또는VEHICLE_REQUEST
) 후에 호출되며 요청이 성공했는지 여부를 확인하는 데 사용할 수 있습니다.- 성공하면 Android 사용자가 잠금 해제 상태이고 응답의 현재 사용자 ID와 대상 사용자 ID의 값이 동일할 때 호출됩니다. 이는 Android 앱에서 Intent.ACTION_USER_UNLOCKED를 수신하는 것과 같습니다.
- 실패하면 즉시 호출되며 응답의 현재 사용자 ID와 타겟 사용자 ID 값이 다릅니다(현재 사용자가 타겟으로 변경되지 않았기 때문).
- HAL이 이전 요청에 응답하기 전 또는 이전에 새로운 전환 요청이 이루어진 경우 사용자가 잠금 해제된 경우 ANDROID_POST_SWITCH 요청이 이루어지지 않습니다. 예를 들어 운전자가 실수로 잘못된 사용자로 전환할 수 있으며, 이 경우 인증 정보가 잠기고, 해당 사용자로 전환하시기 바랍니다.
HAL은 이 요청을 수신한 후 내부 상태를 업데이트할 수 있지만 업데이트할 필요는 없습니다. Android 시스템에 응답합니다.
- 요청합니다.
INITIAL_USER_INFO
로 정의된 처음 N개의 값 (여기서 요청별 값이SwitchUserMessageType::ANDROID_POST_SWITCH
)이면 대상 사용자 ID (예: 전환 요청된 Android 사용자 ID) 해당 플래그 (UserFlags에 의해 정의됨)를 포함해야 합니다. - 응답: 없음 예를 보려면
VEHICLE_REQUEST
를 참고하세요.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
타이어 압력
타이어 공기압 각 타이어는 areaConfig.areaId 구성으로 식별됩니다. 이 각 minFloatValue 및 maxFloatValue는 OEM- 권장 압력 범위. VehicleAreaConfig의 minFloatValue 및 maxFloatValue 값을 정의해야 합니다.
areaConfig 데이터의 minFloatValue는 권장 타이어 공기압의 하한선을 나타냅니다. 영역 구성 데이터의 maxFloatValue는 권장 타이어 압력. 예를 들어, 이 AreaConfig는 왼쪽 타이어의 타이어 압력을 200.0kPa~240.0kPa로 설정했습니다.
.areaConfigs: { VehicleAreaConfig { .areaId: VehicleAreaWheel::LEFT_FRONT, .minFloatValue: 200.0, .maxFloatValue: 240.0, } }
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:KILOPASCAL
출시: Android 13
TIRE_PRESSURE_DISPLAY_UNITS
디스플레이용 타이어 압력 단위입니다. 자동차에서 타이어 압력을 표시하는 데 사용하는 단위를 나타냅니다. 표시됩니다. 예: PSI, Bar 또는 킬로파스칼 VehiclePropConfig.configArray는 지원되는 압력 표시 단위를 나타냅니다. 압력 단위는 VehicleUnit에 정의되어 있습니다. 예: configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR
TIRE_PRESSURE_DISPLAY_UNITS 업데이트가 다른 *_DISPLAY_UNITS 속성 값에 영향을 미치는 경우
값이 업데이트되고 AAOS 프레임워크에도 전달되어야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 <covehiclepropertyaccess.read< code="">로만 구현할 수 있습니다./p>
</covehiclepropertyaccess.read<>
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: VehicleUnit
단위 유형: 해당 사항 없음
출시: Android 13
TRACTION_CONTROL_ACTIVE
견인 제어 (TC)가 활성화되면 true로 설정되고 TC가 꺼져 있으면 false로 재설정됩니다. 이 속성은 TC 시스템의 실시간 상태에 따라 간헐적으로 설정 (펄스)될 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
트레일러_현재
자동차의 트레일러 상태를 반환합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: TrailerState
단위 유형: 해당 사항 없음
출시: Android 13
TURN_SIGNAL_STATE
차량의 방향 지시등입니다.
모드 변경: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleTurnSignal
단위 유형: 해당 사항 없음
출시: Android 13
USER_IDENTIFICATION_ASSOCIATION
현재 사용자를 차량별과 연결 (또는 연결을 쿼리)하는 데 사용되는 속성 식별 메커니즘 (예: 키 FOB)
이 속성은 선택사항의 사용자 관리 속성입니다. OEM은 여전히 사용자 관리를 지원할 수 있습니다. 정의하는 것입니다. 실제로 이 속성은 INITIAL_USER_INFO에 설명된 핵심 사용자 관련 함수를 지원하지 않고도 사용할 수 있습니다.
연결을 쿼리하기 위해 Android 시스템은 속성을 가져와 VehiclePropValue를 전달합니다. 쿼리되고 있는 연결 유형을 포함하는 UserIdentificationGetRequest. HAL은 즉시 반환되어야 하며, 다음과 함께 VehiclePropValue를 반환합니다. UserIdentificationResponse.
사용자 식별은 시스템이 실행되는 동안 시작됩니다 Takehe VHAL 구현은 이미 식별된 연결만 반환해야 합니다. (예: 자동차를 잠금 해제하는 데 사용하는 키 FOB) 있습니다.
유형을 연결하기 위해 Android 시스템은 UserIdentificationSetRequest에 정의된 대로 설정되는 연결의 유형과 값을 포함하는 VehiclePropValue를 전달하여 속성을 설정합니다.
그런 다음 HAL은 요청 후 유형의 현재 상태를 나타내는 속성 변경 이벤트(VehiclePropValue가 UserIdentificationResponse에 의해 정의됨)를 사용합니다.
예를 들어 현재 사용자(10)가 자동차의 도어락을 열었던 FOB 및 OEM에서 제공한 맞춤 메커니즘과 연결되어 있는지 쿼리하려면 다음과 같이 요청합니다.
int32[0]
42 // 요청 IDint32[1]
10 (Android 사용자 ID)int32[2]
0 (Android 사용자 플래그)int32[3]
2 (쿼리된 유형 수)int32[4]
1 (첫 번째 쿼리된 유형, UserIdentificationAssociationType::KEY_FOB)int32[5]
101(두 번째 쿼리된 유형, UserIdentificationAssociationType::CUSTOM_1)
사용자가 FOB와 연결되어 있지만 맞춤 메커니즘과는 연결되어 있지 않은 경우 응답은 다음과 같습니다.
int32[0]
42 // 요청 IDint32[1]
2 (응답의 연결 수)int32[2]
1 (첫 번째 유형: UserIdentificationAssociationType::KEY_FOB)int32[3]
2 (첫 번째 값: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)int32[4]
101(첫 번째 유형: UserIdentificationAssociationType::CUSTOM_1)int32[5]
4 (두 번째 값: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)
그런 다음 사용자를 맞춤 메커니즘과 연결하기 위해 set 요청을 실행합니다.
int32[0]
43 // 요청 IDint32[1]
10 (Android 사용자 ID)int32[2]
0 (Android 사용자 플래그)int32[3]
1 (설정 중인 연결 수)int32[4]
101(첫 번째 유형: UserIdentificationAssociationType::CUSTOM_1)
요청이 성공하면 응답은 다음과 같습니다.
int32[0]
43 // 요청 IDint32[1]
1 (응답의 연결 수)int32[2]
101(첫 번째 유형: UserIdentificationAssociationType::CUSTOM_1)int32[3]
1 (첫 번째 값: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
설정 요청은 연결을 추가하지만 기존 연결은 삭제하지 않습니다. 이전 예를 들어 최종 상태는 2개의 연결 (FOB 및 CUSTOM_1)이 됩니다. 사용자를 CUSTOM_1만 있고 FOB는 아닌 경우 요청은 다음과 같습니다.
int32[0]
43 // 요청 IDint32[1]
10 (Android 사용자 ID)int32[2]
2 (설정된 유형 수)int32[3]
1 (첫 번째 유형: UserIdentificationAssociationType::KEY_FOB)int32[4]
2 (첫 번째 값: UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)int32[5]
101 (두 번째 유형: UserIdentificationAssociationType::CUSTOM_1)int32[6]
1 (두 번째 값: UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
VEHICLE_CURB_WEIGHT
차량의 공차중량(킬로그램)을 반환합니다. 연석 중량은 차량의 총 중량입니다. 표준 장비 및 모터 오일, 변속기 등 필요한 모든 작동 소모품 포함 오일, 브레이크액, 냉각수, 에어컨 냉매, 명목 탱크의 연료 무게 승객 또는 화물이 적재되지 않은 상태에서는 최대 운송 인원이 차지할 수 있습니다.
configArray[0] 는 차량의 총중량을 킬로그램으로 지정하는 데 사용됩니다. 차량의 총 중량은 제조업체가 지정한 차량의 최대 작동 중량입니다. 차량의 섀시, 본체, 엔진, 엔진 유체, 연료, 액세서리, 운전자, 승객, 화물, 트레일러는 제외됩니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:KILOGRAM
출시: Android 13
사용 중인 차량
차량이 사용 중인지를 나타냅니다. 사용 중은 사람이 있고 차량을 사용할 의도가 있음을 의미합니다. 그렇다고 해서 실제 사용자가 차량에 탑승했다는 의미는 아닙니다. 예를 들어 사람이 원격으로 차량을 잠금 해제하면 차량이 사용 중인 것으로 간주됩니다. 이 속성이 는 다음과 같이 지원됩니다.
- 사용자가 차량의 전원을 켜거나 시스템이 사용자가 있음을 감지할 때마다
VEHICLE_IN_USE
를 true로 설정해야 합니다. 사용자가 차량의 전원을 끄거나 시스템이 사용자가 없음을 감지할 때마다VEHICLE_IN_USE
를 false로 설정해야 합니다. - 사용자가 차량의 전원을 끄거나 시스템에서 사용자가 부재 중인 것을 감지하면
VEHICLE_IN_USE
는 false로 설정해야 합니다. - 사용자가 차량 시동을 걸거나 시스템에서 사용자가 있음을 감지하면
VEHICLE_IN_USE
는 true로 설정해야 합니다.
이 속성은 다음과 같은 점에서 AP_POWER_BOOTUP_REASON
와 다릅니다.
AP_POWER_BOOTUP_REASON
는 시스템 부팅 중에 한 번만 설정됩니다. 그러나 이 속성은 시스템 부팅 주기 중에 여러 번 변경될 수 있습니다. 예를 들어, 기기는 현재
있습니다. 원격 작업을 실행하기 위한 시스템 부팅 VEHICLE_IN_USE
가 거짓입니다. 원격 작업이 실행되는 동안 사용자가 차량에 들어가 차량의 전원을 켭니다.
VEHICLE_IN_USE
가 true로 설정되어 있습니다. 운전 세션이 끝나면 사용자가 차량의 전원을 끕니다.
VEHICLE_IN_USE
가 false로 설정됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
VEHICLE_MAP_SERVICE
차량 지도 서비스 (VMS) 메시지 이 속성은 MIXED 데이터를 사용하여 VMS 메시지를 전달합니다.
그 내용은 다음과 같이 해석되어야 합니다. VmsMessageIntegerValuesInde에 정의된 색인은 int32Values에서 읽는 데 사용됩니다. bytes는 VMS 프로토콜에 정의된 것처럼 직렬화된 VMS 메시지로 프레임워크에는 불투명합니다. IVehicle#get은 항상 StatusCode::NOT_AVAILABLE
를 반환해야 합니다.
변경 모드: ON_CHANGEREAD_WRITE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
VEHICLE_SPEED_DISPLAY_UNITS
디스플레이의 속도 단위입니다. 사용자에게 속도를 표시하는 데 사용되는 단위의 유형을 나타냅니다. 예를 들면 m/s, km/h, mph입니다. VehiclePropConfig.configArray는 지원되는 속도 표시 단위를 나타냅니다. 압력 단위는 VehicleUnit에 정의되어 있습니다. 예를 들면 다음과 같습니다.
.configArray: { VehicleUnit::METER_PER_SEC, VehicleUnit::KILOMETERS_PER_HOUR, VehicleUnit::MILES_PER_HOUR }
configArray[0]
METER_PER_SEC
configArray[1]
MILES_PER_HOUR
configArray[2]
KILOMETERS_PER_HOUR
VEHICLE_SPEED_DISPLAY_UNITS
를 업데이트하면 다른 *_DISPLAY_UNITS properties
의 값에 영향을 미치는 경우 이러한 값을 업데이트하고 AAOS 프레임워크에 전달해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
VHAL_HEARTBEAT
VHAL이 자동차 워치독에 하트비트로 신호를 보내는 이벤트를 정의합니다. VHAL이 이 속성을 지원하는 경우 VHAL은 3초마다 이 속성에 시스템 가동 시간을 써야 합니다. 자동차 워치독은 이 속성을 구독하고 3초마다 속성이 업데이트되는지 확인합니다. 버퍼 시간이 3초인 자동차 워치독은 마지막 심장 박동으로부터 최대 6초 후에 신호를 받아야 합니다. 그렇지 않은 경우 자동차 워치독은 VHAL이 비정상으로 종료되고 종료합니다. VHAL에서 이 속성을 지원하지 않으면 자동차 워치독이 VHAL 상태를 확인하지 않습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
WATCHDOG_ALIVE
자동차 워치독이 활성 상태임을 나타내기 위해 업데이트하는 이벤트를 정의합니다. 자동차 워치독에서 설정합니다. 속성을 3초마다 밀리초 단위로 시스템 업타임으로 업데이트합니다. 부팅하는 동안 업데이트가 더 오래 걸릴 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
WATCHDOG_TERMINATED_절차
자동차 워치독에 의해 종료된 프로세스와 종료 이유를 정의합니다.
int32Values[0] 1 // ProcessTerminationReason showing why a process is terminated. string: "/system/bin/log" // Process execution command
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
WHEEL_TICK
휠 틱을 보고합니다. 벡터의 첫 번째 요소는 재설정 수입니다. 재설정은 이전 틱 수가 현재 및 향후 틱 수와 비교할 수 없음을 나타냅니다. 틱 계산에 일종의 불연속성이 발생했습니다.
다음 네 개의 요소는 개별 바퀴의 틱을 다음 순서로 나타냅니다.
- 왼쪽 앞
- 오른쪽 앞
- 오른쪽 뒤
- 왼쪽 뒤
모든 틱 수는 누적됩니다. 차량이 전진하면 틱 수가 증가하고 차량이 후진하면 틱 수가 감소합니다. 차량이 운행될 때 틱은 0으로 재설정되어야 합니다. 시작됩니다
int64Values[0]
횟수 재설정int64Values[1]
앞 왼쪽 눈금int64Values[2]
오른쪽 전면 틱int64Values[3]
오른쪽 뒤 틱int64Values[4]
뒤 왼쪽 틱
configArray
는 휠당 마이크로미터 틱 값과
wheels가 지원되는 configArray는 다음과 같이 설정됩니다.
configArray[0], bits [0:3] Supported wheels
enum Wheel을 사용합니다. 예를 들어 모든 바퀴가 지원되는 경우 다음과 같습니다.
configArray[0]
VehicleAreaWheel::LEFT_FRONT | VehicleAreaWheel::RIGHT_FRONT | VehicleAreaWheel::LEFT_REAR | VehicleAreaWheel::RIGHT_REARconfigArray[1]
왼쪽 전면 휠 틱당 마이크로미터- 오른쪽 앞바퀴 틱당
configArray[2]
마이크로미터 configArray[3]
후면 우측 휠 틱당 마이크로미터configArray[4]
뒷좌석 왼쪽 바퀴 틱당 마이크로미터입니다.
바퀴가 지원되지 않는 경우 값은 항상 0으로 설정됩니다.
VehiclePropValue.timestamp
를 작성해야 합니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
WINDOW_LOCK
Window 자녀 보호 잠금 true는 창이 자녀 보호 기능으로 잠겨 있음을 나타냅니다. 이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
WINDOW_MOVE
창 이동 각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다. maxInt32Value
- 창이 가장 빠른 속도로 평면에서 열리고 평면을 벗어난 방향으로 닫히고 있음을 나타냅니다.
있습니다. minInt32Value
는 창이 평면에서 닫히고/평면 외부 방향에서 가장 빠른 속도로 열리고 있음을 나타냅니다.
절댓값이 클수록(양수 또는 음수) 이동 속도가 빠릅니다. 일단
값이 0으로 재설정되어야 합니다. 값이
WINDOW_MOVE
가 0이며 진행 중인 이동이 없습니다. 이 속성은
상대적 이동 속도 범위를 지정합니다.
평면 밖에서 열 수 있는 창(선루프의 통풍구 모드)의 경우 이 매개변수는 다음과 같이 작동합니다. 다음과 같은 경우:
- 선루프가 열려 있습니다.
<ph type="x-smartling-placeholder">
- </ph>
Max
선루프를 더 열고 완전히 열리면 자동으로 중지합니다.Min
선루프를 닫고 선루프가 닫히면 자동으로 중지합니다.
- 통풍구 열림:
<ph type="x-smartling-placeholder">
- </ph>
Max
통풍구를 닫습니다. 통풍구가 닫히면 자동으로 중지됩니다.Min
환기구를 더 엽니다. 환기구가 완전히 열리면 자동으로 멈춥니다.
- 선루프가 닫혀 있습니다.
Max
선루프를 엽니다. 선루프가 완전히 열리면 자동으로 중지합니다.Min
통풍구를 열고 통풍구가 완전히 열리면 자동으로 중지됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
WINDOW_POS
창 위치입니다. 각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
에서 사이에 있는 모든 정수
maxInt32Value
이(가) 지원되어야 합니다. minInt32Value
는 창을 나타냅니다.
닫혀 있거나 평면 밖으로 완전히 열려 있습니다. 창이 평면 밖으로 열 수 없는 경우
minInt32Value
는 완전히 닫힐 때 창의 위치이며 0이어야 합니다. 창을 평면 외부로 열 수 있는 경우 minInt32Value
는 창이 평면 외부 위치에서 완전히 열려 있음을 나타내며 음수 값입니다. 자세한 내용은 아래 예를 참고하세요. maxInt32Value
는 창이 완전히 열려 있음을 나타냅니다.
minInt32Value
과 maxInt32Value
사이의 값은 전환을 나타냅니다.
닫혀 있는/완전히 열린 위치와 완전히 열린 위치 사이의 상태를 뜻합니다. 이 속성은
지정된 상대적 위치 범위에 있는 광고를 게재할 수 있습니다. 예를 들어 평면 밖으로 이동할 수 있는 창의 경우 속성이 다음과 같이 작동합니다. 평면 밖으로 열 수 있는 창(선루프의 통풍구 모드)의 경우 이 매개변수는 다음과 같이 음수 값으로 작동합니다.
Max
선루프가 완전히 열림 (선루프가 닫힌 경우 0)Min
선루프 환기구가 완전히 열림 (선루프가 닫힌 경우 0)
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
WINDSHIELD_WIPERS_PERIOD
앞 유리 와이퍼의 시간 (밀리초)입니다. 앞유리 와이퍼의 한 번의 전체 주기에 걸리는 순간적인 시간(밀리초)을 반환합니다. 전체 주기는 와이퍼가 움직였다가 다시 정지 위치로 돌아오는 것으로 정의됩니다. 간헐적 와이퍼 설정이 선택된 경우 간헐적 와이퍼의 일시중지 기간 동안 이 속성 값을 0으로 설정해야 합니다. 이
VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다.
각 영역 ID의 maxInt32Value
는 가장 긴 와이퍼 기간을 지정해야 합니다. minInt32Value
는 각 영역 ID에 대해 0으로 설정해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLI_SECS
출시: Android 14
WINDSHIELD_WIPERS_STATE
앞 유리 와이퍼 상태입니다. 앞 유리 와이퍼의 현재 상태를 반환합니다. WINDSHIELD_WIPERS_STATE
의 값이 WINDSHIELD_WIPERS_SWITCH
의 값과 일치하지 않을 수 있습니다. 예를 들어 WINDSHIELD_WIPERS_STATE: ON
및 WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO
. WINDSHIELD_WIPERS_STATE: ON
및 WINDSHIELD_WIPERS_PERIOD
가 구현된 경우 WINDSHIELD_WIPERS_PERIOD
는 와이퍼의 한 번의 전체 주기 시간을 반영해야 합니다.
지원되는 각 영역 ID의 경우 VehicleAreaConfig#supportedEnumValues
배열은
WindshieldWipersState
의 모든 주 (OTHER,
권장되지 않습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: WindshieldWipersState
단위 유형: 해당 사항 없음
출시: Android 14
WINDSHIELD_WIPERS_SWITCH
와이퍼 스위치입니다. 앞 유리를 제어하는 스위치의 위치를 나타냅니다.
와이퍼가 있습니다. WINDSHIELD_WIPERS_SWITCH
값은 다음 값과 일치하지 않을 수 있습니다.
WINDSHIELD_WIPERS_STATE
예를 들면 WINDSHIELD_WIPERS_SWITCH: AUTO
및
WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON
지원되는 각 영역 ID의 경우
VehicleAreaConfig#supportedEnumValues
배열은
WindshieldWipersSwitch
는 지원됩니다 (권장하지 않는 OTHER 포함).
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다. 이 속성이
VehiclePropertyAccess.READ_WRITE
및 OTHER 상태는
VehicleAreaConfig#supportedEnumValues
배열, 이후 OTHER는 지원되지 않음
읽기에 지원되는 값만 지원됩니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: WindshieldWipersSwitch
단위 유형: 해당 사항 없음
출시: Android 14