이 페이지에는 VHAL에서 지원되는 시스템 속성이 나열되어 있습니다. VHAL에서 지원하는 속성
은 아래 목록의 시스템 속성 또는 공급업체 속성이어야 합니다. Android 14 및
더 높은 경우 속성 정의는
hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl
속성 정의는 AIDL 인터페이스에 정의되어 있습니다.
android.hardware.automotive.vehicle.property
: VHAL과 별개입니다.
인터페이스 (android.hardware.automotive.vehicle
)를 호출합니다. VHAL 구현 및 VHAL
클라이언트는 두 인터페이스에 모두 종속되어야 합니다.
자동 생성된 액세스 모드 및 모드 변경
Android 14 이상에서는 VHAL 구현을 지원하기 위해 자동 생성된 API를 제공합니다. C++ 헤더 파일 및 Java 클래스 파일 시스템 속성의 변경 허용 모드 또는 액세스 모드로 설정할 수 있습니다 공급업체 VHAL 구현 이를 사용하여 속성 구성이 사양을 충족하는지 확인할 수 있습니다.
가나다순
ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE
어댑티브 크루즈 컨트롤 (ACC) 또는 예측 기능을 사용할 때 앞차와의 측정 거리
크루즈 컨트롤 (PCC) 가장 뒤에 있는 점 사이의 측정된 거리를 밀리미터 단위로 반환합니다.
선행 차량의 최전방 지점과 ACC 차량의 가장 앞쪽 지점에 해당합니다. maxInt32Value
VehicleAreaConfig
의 minInt32Value
가 정의되어야 합니다. 이
minInt32Value
는 0이어야 합니다. maxInt32Value
는
거리 센서가 지원할 수 있는 최대 범위. 이 값은 음수가 아니어야 합니다.
리드 차량이 감지되지 않는 경우 (즉, 선행 차량이 없거나 선행 차량이 없는 경우)
센서가 감지하기에 너무 멀리 있는 경우 이 속성은
StatusCode.NOT_AVAILABLE
참조가 사용 중지되어 이 속성을 사용할 수 없는 경우 (예:
StatusCode#NOT_AVAILABLE_DISABLED
가 false인 경우) 이 속성은
StatusCode#NOT_AVAILABLE_DISABLED
CRUISE_CONTROL_STATE
인 경우
구현되고 상태가 ErrorState
값으로 설정되면 이 속성이
ErrorState
값에 맞는 StatusCode
를 반환해야 합니다. 대상
예를 들어 CRUISE_CONTROL_STATE
가 다음과 같이 설정된 경우
ErrorState#NOT_AVAILABLE_SPEED_LOW
이면 이 속성이
<ph type="x-smartling-placeholder">StatusCode#NOT_AVAILABLE_SPEED_LOW
</ph>
변경 모드: 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
값인 경우 이 속성은 StatusCode
ErrorState
값과 일치합니다. 예를 들어
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 시스템의 실시간 상태를 기반으로 작동합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
ANDROID_EPOCH_TIME
에포크 시간(밀리초)으로 인코딩된 현재 날짜 및 시간입니다. 이 값은 1970년 1월 1일(UTC) 이후 경과된 밀리초 수를 나타냅니다.
이 값은 1970년 1월 1일(UTC) 이후 경과된 밀리초 수를 나타냅니다.
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 열거형 값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로, AEB를 사용 중지하려면 false로 설정합니다. AEB가 사용 설정되면
잠재적 충돌을 방지하기 위해 차량의 시동을 켜고 모니터링해야 합니다. 이 속성은
보다 빠른 속도의 애플리케이션에만 적용됩니다. 저속 자동 비상 제동을 사용 설정하려면
LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED
를 사용해야 합니다.
일반적으로 AUTOMATIC_EMERGENCY_BRAKING_ENABLED
는 항상 true 또는 false를 반환해야 합니다.
차량 속도가 너무 느려지는 등 일시적인 상태로 인해 기능을 사용할 수 없는 경우
낮음이면 해당 정보는 ErrorState
값을 통해 전달되어야 합니다.
AUTOMATIC_EMERGENCY_BRAKING_STATE
속성
이 속성은 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)의 경우 StatusCode#VehicleAreaConfig#supportedEnumValues
두 AutomaticEmergencyBrakingState
의 모든 상태가 아니면 배열을 정의해야 합니다.
(권장되지 않는 OTHER
포함) 및 ErrorState
는 다음과 같습니다.
지원됩니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: ForwardCollisionWarningState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
BLIND_SPOT_WARNING_ENABLED
사각지대 경고(BSW)를 사용 설정 또는 사용 중지합니다. BSW를 사용 설정하려면 true로, BSW를 사용 중지하려면 false로 설정합니다. BSW가 사용 설정되면 차량의 ADAS 시스템이 켜지고 다음 차량에 대한 모니터링이 이루어져야 합니다. 차량의 사각지대에 물체를 방지합니다.
일반적으로 BLIND_SPOT_WARNING_ENABLED
는 항상 true 또는 false를 반환해야 합니다. 만약
차량 속도가 너무 느림,
ErrorState
값을 통해 전달되어야 한다는 것을
BLIND_SPOT_WARNING_STATE
속성
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의됩니다.
OEM은 이를 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
BLIND_SPOT_WARNING_STATE
사각지대 경고(BSW) 상태입니다. BSW의 현재 상태를 반환합니다. 이 속성은 항상
BlindSpotWarningState
또는 ErrorState
에 정의된 유효한 상태를 반환합니다.
StatusCode
를 통해 오류가 표시되면 안 되며 지원되는 오류 상태를 사용해야 합니다.
하세요.
지원되는 각 영역 ID의 경우 StatusCode#VehicleAreaConfig#supportedEnumValues
두 BlindSpotWarningState
의 모든 상태(
OTHER
(권장되지 않음) 및 ErrorState
가 지원됩니다.
변경 모드: 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
계기판 디스플레이 상태를 변경합니다.
- 경계: 클러스터 활동을 렌더링하는 영역입니다.
- 삽입: Activity가 중요한 정보를 배치해서는 안 되는 영역입니다.
가능한 값:
int32[0]
사용, 사용 중지: 0 - 사용 중지, 1 - 사용, -1 - 상관없음int32[1]
경계 - 왼쪽: 양수 - 왼쪽 위치(픽셀) -1 - 상관없음(모든 경계 필드를 설정해야 함)int32[2]
경계 - 상단: '왼쪽'과 동일한 형식int32[3]
경계 - 오른쪽: '왼쪽'과 동일한 형식int32[4]
경계 - 하단: '왼쪽'과 동일한 형식int32[5]
인셋 - 왼쪽: 양수 - 실제 왼쪽 인셋 값(픽셀) -1 - 상관없음(모든 인셋 필드를 '상관없음'으로 설정해야 함)int32[6]
인셋 - 상단: '왼쪽'과 동일한 형식int32[7]
인셋 - 오른쪽: 'left'와 동일한 형식int32[8]
인셋 - 하단: '왼쪽'과 동일한 형식
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
CLUSTER_NAVIGATION_STATE
현재 내비게이션 상태를 알립니다. 바이트: 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은 영역이 더 이상 사용되지 않음을 나타냅니다. 바이트: 바이트의 가용성을 나타내는 배열입니다. 합니다. 0은 사용 불가를 나타내고 1은 사용 가능을 나타냅니다. 예를 들어 자동차가 는 세 가지 OEM 정의 ClusterUI(예: HOME, MAPS, CALL)를 지원하고 이동통신망을 사용할 수 있는 경우에만 UI를 호출합니다. 그런 다음 Nework를 사용할 수 있는 경우 [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
0으로 표시되는 ClusterUI 유형은ClusterHome
을 나타냅니다. 홈 화면에 표시되며 기본 UI와 계기판 디스플레이용 런처 기능입니다. 다른 값은 OEM의 정의에 따른 것입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
CREATE_USER
Android 사용자가 생성된 후 Android 시스템에서 호출됩니다. HAL은 이 속성을 사용할 수 있음 동일한 사용자를 만듭니다. 이는 비동기 요청입니다. Android는 VehiclePropValue, HAL은 요청이 추가되었는지 여부를 나타내는 속성 변경으로 응답해야 함 확인할 수 있습니다 실패하면 Android 시스템에서 사용자를 삭제합니다.
요청의 형식은 CreateUserRequest로 정의되고 응답 형식은 CreateUserResponse. 예를 들어 시스템에 두 명의 사용자 (0과 10)와 세 번째 사용자( 임시 게스트)가 생성되면 요청은 다음과 같습니다.
int32[0]
42 // 요청 IDint32[1]
11 // 생성된 사용자의 Android ID입니다.int32[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 string: "D'OH!" //
의미는 블랙박스이며 호출자 (예: 설정 UI)에게 전달되며 적절한 조치를 취할 수 있습니다
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
CRITICALLY_LOW_TIRE_PRESSURE
이 속성은 각 타이어의 최저 압력 임계값을 나타냅니다. 이는 타이어를 교체하거나 수리합니다. 값은 minFloatValue 이하여야 합니다. TIRE_PRESSURE에 있습니다. 최소 및 최대 속성 값 (minFloatValue 및 maxFloatValue)은 적용되지 않습니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:KILOPASCAL
출시: Android 13
CRUISE_CONTROL_COMMAND
WRITE
크루즈 컨트롤 (CC) 명령어
지원되는 각 명령어에 관한 자세한 내용은 CruiseControlCommand를 참고하세요. 전역 영역 ID (0)의 경우
StatusCode#VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
CruiseControlState
의 상태가 지원됩니다. 다음을 통해 전송된 지원되지 않는 명령어는
이 속성을 사용할 수 없는 경우 이 속성은 StatusCode#INVALID_ARG
를 반환해야 합니다.
CC가 사용 중지되었기 때문에 (예: CRUISE_CONTROL_ENABLED
가 false인 경우) 이 속성은
CRUISE_CONTROL_STATE
인 경우 StatusCode#NOT_AVAILABLE_DISABLED
을 반환해야 합니다.
구현되고 상태가 ErrorState
값으로 설정되면
속성은 ErrorState
값에 맞는 StatusCode
를 반환해야 합니다.
예를 들어 CRUISE_CONTROL_STATE
이 다음과 같이 설정된 경우
ErrorState#NOT_AVAILABLE_SPEED_LOW
이면 이 속성이
<ph type="x-smartling-placeholder">StatusCode#NOT_AVAILABLE_SPEED_LOW
</ph>
모드 변경: ON_CHANGE
액세스 모드: WRITE
enum 유형: CruiseControlCommand
단위 유형: 해당 사항 없음
출시: Android 14
CRUISE_CONTROL_ENABLED
크루즈 컨트롤(CC)을 사용 설정하거나 사용 중지합니다. CC를 사용 설정하려면 true로 설정하고 CC를 사용 중지하려면 false로 설정합니다. 이
속성은 모든 형식의 CruiseControlType에서 공유됩니다. CC가 사용 설정되면 ADAS 시스템은
차량의 시동을 켜고 명령에 응답해야 합니다. 일반적으로
CRUISE_CONTROL_ENABLED
항상 true 또는 false를 반환해야 합니다. 일시적인 상태로 인해 기능을 사용할 수 없는 경우
예를 들어 차량 속도가 너무 낮은 경우 해당 정보는
ErrorState
값을 CRUISE_CONTROL_STATE
속성에 저장합니다. 이 속성은 다음과 같이 정의됩니다.
VehiclePropertyAccess.READ_WRITE
이지만 OEM은 이를 구현할 수 있습니다.
VehiclePropertyAccess.READ
만 해당됩니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
CRUISE_CONTROL_STATE
크루즈 컨트롤(CC)의 현재 상태입니다. 이 속성은 CC의 현재 상태를 반환합니다. 일반적으로
이 속성은 CruiseControlState에 정의된 유효한 상태를 반환해야 합니다.
ErrorState
예를 들어 일시적인 상태로 인해 기능을 사용할 수 없는 경우
ErrorState
를 통해 전달되어야 합니다. 전역 영역 ID (0)의 경우
VehicleAreaConfig#supportedEnumValue
배열을 정의해야 합니다.
CruiseControlState (OTHER는 권장되지 않음) 및 ErrorState
는 지원됩니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: CruiseControlState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
CRUISE_CONTROL_TARGET_SPEED
크루즈 컨트롤(CC)의 현재 목표 속도입니다. OEM은 minFloatValue 및
이 속성의 maxFloatValue 값을 사용하여 최소 및 최대 목표 속도 값을 정의합니다. 이러한
값은 음수가 아니어야 합니다. maxFloatValue는 목표 속도의 상한값을 나타냅니다.
minFloatValue는 목표 속도의 하한을 나타냅니다.
참조가 사용 중지되어 이 속성을 사용할 수 없는 경우 (예:
CRUISE_CONTROL_ENABLED
false인 경우) 이 속성은 StatusCode#NOT_AVAILABLE_DISABLED
을 반환해야 합니다.
CRUISE_CONTROL_STATE
:
상태가 ErrorState 값으로 설정되면 이 속성은
ErrorState 값에 맞는 StatusCode
입니다. 예를 들어
CRUISE_CONTROL_STATE
설정됨
ErrorState#NOT_AVAILABLE_SPEED_LOW
로 지정하면 이 속성은
<ph type="x-smartling-placeholder">StatusCode#NOT_AVAILABLE_SPEED_LOW
</ph>
변경 모드: 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)의 경우 StatusCode#VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
CruiseControlType
의 모든 상태 (OTHER
는
권장) 및
ErrorState
만 지원됩니다. WRITE
시도 중
CruiseControlType#OTHER
또는 ErrorState
속성에서 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,...}
이어야 합니다.
이 목록은 에 보고된 지원되는 톱니바퀴의 목록과 동일할 필요는 없습니다.
<ph type="x-smartling-placeholder">GEAR_SELECTION
</ph>
변경 모드: 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
중 하나만
있습니다. 둘 다
PER_DISPLAY_BRIGHTNESS
는 AAOS에서 사용합니다. 쓰기 가능한 경우 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
업데이트가 다른
<ph type="x-smartling-placeholder">*_DISPLAY_UNITS
</ph>
속성이 있는 경우, 그 값도 업데이트되어 AAOS 프레임워크에 전달되어야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은
VehiclePropertyAccess.READ
로만 구현합니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: VehicleUnit
단위 유형: 해당 사항 없음
출시: Android 13
DOOR_CHILD_LOCK_ENABLED
아동 보호 잠금 기능이 사용 설정되었습니다. 자녀 보호 잠금 기능이 활성화되어 있고
사용 중지되면 false입니다. 사용 설정하면 문이 내부에서 열 수 없습니다. 이 속성은
VehiclePropertyAccess.READ_WRITE
로 구현 가능하지만 OEM은 이를 다음과 같이 구현할 수 있습니다.
VehiclePropertyAccess.READ
만 해당됩니다.
모드 변경: ON_CHANGE
액세스 모드: READ_WRITE
/READ
enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
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
도어 위치입니다. maxInt32Value
및 minInt32Value
VehicleAreaConfig
을(를) 정의해야 합니다.
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
전자 통행료 징수 카드 상태입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: ElectronicTollCollectionCardStatus
단위 유형: 해당 사항 없음
출시: Android 13
ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
전자 통행료 징수 카드 유형입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: ElectronicTollCollectionCardType
단위 유형: 해당 사항 없음
출시: Android 13
EMERGENCY_LANE_KEEP_ASSIST_ENABLED
비상 차선 유지 보조(ELKA)를 사용 설정하거나 사용 중지합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
EMERGENCY_LANE_KEEP_ASSIST_STATE
비상 차선 유지 보조(ELKA) 상태입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: EmergencyLaneKeepAssistState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
ENGINE_COOLANT_TEMP
엔진 냉각수 온도입니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:CELSIUS
출시: Android 13
ENGINE_IDLE_AUTO_STOP_ENABLED
엔진 공회전 자동 중지 기능을 나타냅니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
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 배터리 단위입니다.
변경 모드: 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 또는 하이브리드 차량의 배터리 수준입니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:WH
출시: Android 13
EV_BRAKE_REGENERATION_LEVEL
전기자동차의 회생제동 수준입니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_CURRENT_DRAW_LIMIT
사용자가 설정한 충전을 위한 최대 전류 견인량 임계값을 나타냅니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:AMPERE
출시: Android 13
EV_CHARGE_PERCENT_LIMIT
사용자가 설정한 최대 충전 비율 임계값을 나타냅니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_PORT_CONNECTED
EV 충전 포트가 연결되었습니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_PORT_OPEN
EV 충전 포트가 열려 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_STATE
자동차의 충전 상태입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: EvChargeState
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_SWITCH
EV 배터리 충전을 시작하거나 중지합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EV_CHARGE_TIME_REMAINING
남은 예상 충전 시간(초)입니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:SECS
출시: Android 13
EV_CURRENT_BATTERY_CAPACITY
EV 또는 하이브리드 차량의 현재 배터리 용량입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:WH
출시: Android 13
EV_REGENERATIVE_BRAKING_STATE
자동차의 회생제동 또는 원 페달 드라이브 상태입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: EvRegenerativeBrakingState
단위 유형: 해당 사항 없음
출시: Android 13
EV_STOPPING_MODE
차량의 현재 중지 모드의 속성을 나타냅니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: EvStoppingMode
단위 유형: 해당 사항 없음
출시: Android 13
EVS_SERVICE_REQUEST
EVS 서비스를 사용 설정하고 요청합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
EXTERNAL_CAR_TIME
에포크 시간(밀리초)으로 인코딩된 자동차의 현재 날짜 및 시간 제안입니다. 이 값은 1970년 1월 1일(UTC) 이후 경과된 밀리초 수를 나타냅니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLI_SECS
출시: Android 13
FOG_LIGHTS_STATE
안개등 상태입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13
FOG_LIGHTS_SWITCH
안개등 스위치입니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
FORWARD_COLLISION_WARNING_ENABLED
전방 충돌 경고(FCW)를 사용 설정하거나 중지합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
FORWARD_COLLISION_WARNING_STATE
전방 충돌 경고(FCW) 상태입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: ForwardCollisionWarningState/ErrorState
단위 유형: 해당 사항 없음
출시: Android 14
FRONT_FOG_LIGHTS_STATE
전면 안개등 상태입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleLightState
단위 유형: 해당 사항 없음
출시: Android 13
FRONT_FOG_LIGHTS_SWITCH
전면 안개등 스위치입니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleLightSwitch
단위 유형: 해당 사항 없음
출시: Android 13
FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME
디스플레이용 연료 소비 단위입니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
FUEL_DOOR_OPEN
연료 주입구 도어가 열려 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
FUEL_LEVEL
차량에 남아 있는 연료(밀리리터)입니다.
변경 모드: CONTINUOUS
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: VehicleUnit:MILLILITER
출시: Android 13
FUEL_LEVEL_LOW
연료 부족 경고입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
FUEL_VOLUME_DISPLAY_UNITS
디스플레이용 연료량 단위입니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: VehicleUnit
단위 유형: 해당 사항 없음
출시: Android 13
GEAR_SELECTION
현재 선택된 기어입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleGear
단위 유형: 해당 사항 없음
출시: Android 13
GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT
EU의 일반 보안 규정 준수 요구사항입니다.
변경 모드: STATIC
액세스 모드: READ
Enum 유형: GsrComplianceRequirementType
단위 유형: 해당 사항 없음
출시: Android 14
GLOVE_BOX_DOOR_POS
글러브 박스 도어의 현재 위치를 나타내는 속성입니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
GLOVE_BOX_LOCKED
글러브 박스를 잠그거나 잠금 해제합니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
H-I
HANDS_ON_DETECTION_DRIVER_STATE
Hands On Detection (HOD) driver state. Returns whether the driver's hands are on the steering
wheel. Generally, this property should return a valid state defined in the
HandsOnDetectionDriverState
or ErrorState
For example, if the feature
is not available due to
some temporary state, that information should be conveyed through ErrorState
If the vehicle wants to send a warning to the user because the driver's hands have been off the
steering wheel for too long, the warning should be surfaced through
HANDS_ON_DETECTION_WARNING
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must
be defined
unless all states of both HandsOnDetectionDriverState
(including OTHER, which is
not recommended)
and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: HandsOnDetectionDriverState/ErrorState
Unit type: N/A
Release: Android 14
HANDS_ON_DETECTION_ENABLED
Enable or disable Hands On Detection (HOD). Set true to enable HOD and false to disable HOD.
When HOD is enabled, a system inside the vehicle should be monitoring the presence of the driver's
hands on the steering wheel and send a warning if it detects that the driver's hands are no longer
on the steering wheel. In general, HANDS_ON_DETECTION_ENABLED
should always return
true or false.
If the feature is not available due to some temporary state, that information must be conveyed
through the ErrorState
values in the HANDS_ON_DETECTION_STATE
property.
This property is defined as minInt32Value
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it is
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HANDS_ON_DETECTION_WARNING
Hands On Detection (HOD) warning. Returns whether a warning is being sent to the driver for
having their hands off the wheel for too long a duration. Generally, this property should return
a valid state defined in HandsOnDetectionWarning
or ErrorState
For
example, if the feature is not available due to some temporary state, that information should
be conveyed through an ErrorState
For the global area ID (0), the
VehicleAreaConfig#supportedEnumValues
array must be defined unless all states
of both HandsOnDetectionWarning
(including OTHER, which is not recommended) and
ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: HandsOnDetectionWarning/ErrorState
Unit type: N/A
Release: Android 14
HAZARD_LIGHTS_STATE
Hazard light status. Return the current status of hazard lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HAZARD_LIGHTS_SWITCH
Hazard light switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HEADLIGHTS_STATE
Headlights state. Returns the current state of headlights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HEADLIGHTS_SWITCH
Headlight switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HIGH_BEAM_LIGHTS_STATE
High beam lights state. Returns the current state of high beam lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HIGH_BEAM_LIGHTS_SWITCH
High beam light switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HVAC_AC_ON
Turn AC on and off AC for the designated areaId. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_ACTUAL_FAN_SPEED_RPM
Actual fan speed.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_AUTO_ON
Turn automatic climate control on and off.
If true, automatic climate control is on. If false, automatic climate control is off.
If the vehicle does not support directly turning off automatic climate control, then OEMs should
add logic in their VHAL implementation to set HVAC_AUTO_ON
to false, which changes
the necessary HVAC settings to indirectly turn off HVAC_AUTO_ON
Ideally, this
should not disrupt the user. OEMs should revert to the previous state any settings that were
modified when automatic climate control is off. This way, the only outcome should be that
HVAC_AUTO_ON
is off. If restoring HVAC settings to previous settings is not possible,
then the OEM should implement the least disruptive change.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_AUTO_RECIRC_ON
Automatic recirculation on or off. When automatic recirculation is on, the HVAC system may
automatically switch to recirculation mode if the vehicle detects poor incoming air quality.
This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_DEFROSTER
Fan-based defrost for designated window. This property is defined as
VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_DUAL_ON
Enable temperature coupling between areas. The AreaIDs
for the
HVAC_DUAL_ON
property
shall contain a combination of HVAC_TEMPERATURE_SET
AreaIDs
that can be
coupled
together. If HVAC_TEMPERATURE_SET
is mapped to AreaIDs
[a_1, a_2, ..., a_n]
and if HVAC_DUAL_ON
can be enabled to couple a_i and a_j, then
HVAC_DUAL_ON
property must be mapped to [a_i | a_j]. Further, if
a_k and a_l can also be coupled together separately, then
HVAC_DUAL_ON
must be mapped to [a_i | a_j, a_k | a_l].
For example, a car has two front seats (ROW_1_LEFT
and ROW_1_RIGHT
) and
three back seats (ROW_2_LEFT, ROW_2_CENTER, and ROW_2_RIGHT).
There are two temperature control units, driver side and passenger side, which can be optionally
synchronized. This can be expressed this way in the 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]
When the property is enabled, the ECU must synchronize the temperature for the affected areas.
Any parameters modified as a side effect of turning on or off the DUAL_ON parameter shall generate
onPropertyEvent()
callbacks to the VHAL. In addition, if setting a temperature
(for example, driver temperature) changes another temperature (such as front passenger
temperature), then the appropriate onPropertyEvent()
callbacks must be generated.
If a user changes a temperature that breaks the coupling (for example, sets passenger temperature
independently), then the VHAL must send the appropriate onPropertyEvent()
callbacks
(including HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx
).
This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement
it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_ELECTRIC_DEFROSTER_ON
Electric defrosters' status.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can implement
it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_FAN_DIRECTION
Fan direction setting. This property is defined as VehiclePropertyAccess.READ_WRITE
,
but OEMs can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleHvacFanDirection
Unit type: N/A
Release: Android 13
HVAC_FAN_DIRECTION_AVAILABLE
Fan positions available. This is a bit mask of fan positions available for the zone. Each
available fan direction is denoted by a separate entry in the vector. A fan direction can have
multiple bits from vehicle_hvac_fan_direction
set. For instance, a typical car may have these
fan positions:
- 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)
Change mode: STATIC
Access mode: READ
Enum type: VehicleHvacFanDirection
Unit type: N/A
Release: Android 13
HVAC_FAN_SPEED
Fan speed setting. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig must be defined. All integers between minInt32Value
and
maxInt32Value
must be supported.
minInt32Value
lowest fan speedmaxInt32Value
highest fan speed
This property is not in any specific unit but in a specified range of relative speeds. This
property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can elect to
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_MAX_AC_ON
MAX AC on or off. When MAX AC is on, the ECU can adjust items such as vent position, fan speed,
and temperature as needed to cool the vehicle as quickly as possible. Any parameters modified as
a side effect of turning on or off the MAX AC parameter generates onPropertyEvent()
callbacks to the VHAL. This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_MAX_DEFROST_ON
Turn MAX DEFROST on and off. When MAX DEFROST is on, the ECU can adjust items such as vent
position, fan speed, and temperature as needed to defrost the windows as quickly as possible.
Any parameters modified as a side effect of turning on or off MAX DEFROST parameter generates
onPropertyEvent()
callbacks to the VHAL. The AreaIDs
for
HVAC_MAX_DEFROST_ON
indicate MAX DEFROST can be controlled in the area. For example,
areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT}
indicates that
HVAC_MAX_DEFROST_ON
can only be controlled for the front rows. This property is
defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it
as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_POWER_ON
Represents the global power state for HVAC. Setting this property to false MAY mark some properties that control individual HVAC features and subsystems in the UNAVAILABLE state. Setting this property to true MAY mark some properties that control individual HVAC features and subsystems to the AVAILABLE state (unless any or all of the properties are UNAVAILABLE on their own individual merits).
HvacPower_DependentProperties
are those properties that require HVAC to be powered
on to enable functionality. In some cars, for example, to turn on the AC, HVAC must first be
powered on. The HvacPower_DependentProperties
list must be set in the
VehiclePropConfig.configArray
HvacPower_DependentProperties
must only
contain those properties associated with VehicleArea:SEAT
AreaID mapping for HVAC_POWER_ON
property must contain all AreaIDs
that
HvacPower_DependentProperties
are mapped to. For example, a car has two:
- Front seats (
ROW_1_LEFT
,ROW_1_RIGHT
) and three back seats (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). If the HVAC features (AC, Temperature etc.) throughout the car are dependent on a single HVAC power controller, thenHVAC_POWER_ON
must be mapped to [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
- Seats in the front row (
ROW_1_LEFT
,ROW_1_RIGHT
) and three seat in the second (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT
) and third rows (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT
). If the car has temperature controllers in the front row that can operate entirely independently of temperature controllers in the back of the vehicle, thenHVAC_POWER_ON
must be mapped to a two element array:- ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs have the
option to implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_RECIRC_ON
Recirculation on and off. Controls the supply of exterior air to the cabin. Recirc
on means most of the airflow into the cabin originates in the cabin. Recirc
off means most of the airflow into the cabin comes from outside the car. This
property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SEAT_TEMPERATURE
Seat heating and cooling. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined. All integers between minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
indicates the maximum seat temperature heating setting.
The minInt32Value
must be 0, unless the vehicle supports seat cooling. In this case,
minInt32Value
indicates the maximum seat temperature cooling setting.
This property is not in any specific unit, but in a specified range of relative temperature
settings. This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs
can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SEAT_VENTILATION
Seat ventilation. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined. All integers between minInt32Value
and maxInt32Value
must be supported. The minInt32Value
must be 0. The
maxInt32Value
indicates the maximum ventilation setting available for the seat.
This property is not in any particular unit but in the specified range of ventilation settings.
Used by HVAC apps and Assistant to enable, change, or read state of seat ventilation. This is different than seating cooling. It can be on at the same time as cooling, or not.
This property is defined as >VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SIDE_MIRROR_HEAT
Side mirror heat. Increasing values denote higher heating levels for side mirrors.
You must define maxInt32Value
and minInt32Value
in
VehicleAreaConfig
All integers between minInt32Value
and
maxInt32Value
must be supported. In config data:
maxInt32Value
represents maximum heating level.minInt32Value
MUST be 0 and indicates no heating.
This property is not in any particular unit but in a specified range of relative heating settings.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs have the
option to implement it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_STEERING_WHEEL_HEAT
Sets the amount of heating and cooling for the steering wheel. The maxInt32Value
and
minInt32Value
in VehicleAreaConfig
must be defined. All integers between
minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
indicates the maximum steering wheel heating setting. The
minInt32Value
should be 0, unless the vehicle supports steering wheel
cooling, too. In this case, the minInt32Value
indicates the maximum steering wheel
cooling setting. This property is not in any particular unit but in a specified range of heating
settings. This property is defined as VehiclePropertyAccess.READ
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_TEMPERATURE_CURRENT
HVAC current temperature.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
HVAC_TEMPERATURE_DISPLAY_UNITS
Temperature units for display. Indicates if temperature is displayed in Celsius or Fahrenheit.
VehiclePropConfig.configArray
indicates the supported temperature display units. For
example,
configArray[0] = CELSIUS configArray[1] = FAHRENHEIT
This parameter MAY be used to
display any HVAC temperature in the system. Values must be one of
VehicleUnit.CELSIUS
or VehicleUnit.FAHRENHEIT
If updating HVAC_TEMPERATURE_DISPLAY_UNITS affects the values of other
*_DISPLAY_UNITS
properties, then their values must be updated and communicated to
the AAOS framework.
This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement
it is VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13
HVAC_TEMPERATURE_SET
HVAC target temperature set in Celsius.
The minFloatValue
and maxFloatValue
in VehicleAreaConfig
must be defined:
minFloatValue
minimum temperature setting in Celsius.maxFloatValue
maximum temperature setting in Celsius.
If all the values between minFloatValue
and maxFloatValue
are not
supported, use the configArray
to list the valid temperature values that can be set.
This also describes a lookup table to convert the temperature from Celsius to Fahrenheit (and
vice versa) for the vehicle. The configArray
must be defined if standard unit
conversion is not supported on the vehicle.
The configArray
is set as follows:
configArray[0]
[lower bound of supported temperature in Celsius] * 10configArray[1]
[upper bound of supported temperature in Celsius] * 10configArray[2]
[increment in Celsius] * 10configArray[3]
[lower bound of the supported temperature in Fahrenheit] * 10configArray[4]
[upper bound of the supported temperature in Fahrenheit] * 10configArray[5]
[increment in Fahrenheit] * 10
The minFloatValue
and maxFloatValue
in VehicleAreaConfig
must be equal to configArray[0]
and
configArray[1]
respectively. For example, if the vehicle supports temperature values
as [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5]
in
Fahrenheit, the configArray
should be
configArray = {160, 280, 5, 605, 845, 10}
Ideally, the ratio of the Celsius increment to the Fahrenheit increment should be as close to
the actual ratio of 1 degree Celsius to 1.8 degrees Fahrenheit. There must be a one-to-one mapping
of all Celsius values to Fahrenheit values defined by the configArray
The
configArray
is used by
clients to convert this property's temperature from Celsius to Fahrenheit. Also, it lets clients
know what Celsius value to set the property to achieve their desired Fahreneheit value for the
system. If the ECU does not have a one-to-one mapping of all Celsius values to Fahrenheit values,
then the configArray
should only define the list of Celsius and Fahrenheit values
that have a one-to-one mapping.
For example, if the ECU supports Celsius values from 16 to 28 and Fahrenheit values from 60 to
85, each with an increment of 1, then one possible configArray
is
code>{160, 280, 10, 600, 840, 20}In this case, 85 is not a supported temperature.
Any value set in between a valid value should be rounded to the closest valid value. We highly
recommended that the OEM also implement the HVAC_TEMPERATURE_VALUE_SUGGESTION
vehicle property because it provides applications with a simple method for determining temperature
values that can be set for a vehicle and for converting values between Celsius and Fahrenheit.
This property is defined as VehiclePropertyAccess.READ
, but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
HVAC_TEMPERATURE_VALUE_SUGGESTION
Suggested values for setting HVAC temperature.
Implement the property to help applications understand the closest supported temperature value in Celsius or Fahrenheit.
floatValues[0]
Requested value that an app wants to set a temperature to.floatValues[1]
Unit forfloatValues[0]
and should be one of{VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
floatValues[2]
Value OEMs suggested in CELSIUS (this value is not included in the request).floatValues[3]
Value OEMs suggested in FAHRENHEIT (this value is not included in the request).
An application calls set(VehiclePropValue propValue)
with the requested value
and unit for the value. OEMs need to return the suggested values in
floatValues[2]
and floatValues[3]
by onPropertyEvent()
callbacks.
The suggested values must conform to the values that can be derived from the
HVAC_TEMPERATURE_SET
configArray
In other words, the suggested values
and the table of values
from the configArray
should be the same.
We recommended that the OEM add custom logic in their VHAL implementation to avoid making requests to the HVAC ECU. The logic can be as follows. To convert temperature from Celsius to Fahrenheit:
// 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;
For example, when a driver uses the voice assistant to set HVAC temperature to 66.2 in Fahrenheit.
First, an application sets this property with the value
[66.2, (float)VehicleUnit.FAHRENHEIT,0,0]
If an OEM suggests to set 19.0 in Celsius or 66.5 in Fahrenheit at the user's request, then VHAL
must generate a callback with a property value
[66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5]
After the voice assistant gets the callback, it informs the user and sets the HVAC temperature to
the suggested value.
Another example, an app receives 21 Celsius as the current temperature value by querying
HVC_TEMPERATURE_SET
but the app needs to know what value is displayed on the car's
UI in Fahrenheit. For this, the app sets the property to
[21, (float)VehicleUnit.CELSIUS, 0, 0]
If the suggested value by the OEM for 21 Celsius is 70 Fahrenheit, then VHAL must generate a
callback with property value [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]
In this
case, the app can know that the value is 70.0 Fahrenheit in the car's UI.
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
HW_CUSTOM_INPUT
Defines a custom OEM partner input event. This input event must be used by OEM partners who want to propagate events not supported by Android. It is composed by an array of int32 values only. The Android properties are:
int32Values[0]
Input code identifying the function representing this event. Valid event types are defined byCustomInputType.CUSTOM_EVENT_F1
up toCustomInputType.CUSTOM_EVENT_F10
They represent the custom event to be defined by OEM partners.int32Values[1]
Target display type defined inVehicleDisplay
Events not tied to a specific display must be sent toVehicleDisplay#MAIN
int32Values[2]
Repeat counter, if 0 then event is not repeated. Values 1 or higher indicate how many times this event has been repeated.
Change mode: ON_CHANGE
Access mode: READ
Enum type: CustomInputType
Unit type: N/A
Release: Android 13
HW_KEY_INPUT
Property to feed hardware input events to Android.
int32Values[0]
Action defined by VehicleHwKeyInputActionint32Values[1]
Key code, must use standard android key codeint32Values[2]
Target display defined inVehicleDisplay
Events not tied to specific display must be sent toVehicleDisplay#MAIN
int32Values[3]
(Optional) Number of ticks. The value must be equal o greater than 1. When omitted, Android defaults to 1.
Change mode: .ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HW_KEY_INPUT_V2
Property to feed hardware input events to Android.
int32array[0]
Target display defined byVehicleDisplay
such as:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
int32array[1]
Key code, must use the standard Android key code, such asKEYCODE_HOME
andKEYCODE_BACK
int32array[2]
action defined in VehicleHwKeyInputAction, such as:
VehicleHwKeyInputAction::ACTION_UP
,VehicleHwKeyInputAction::ACTION_UP
int32array[3]
Repeat count of the event. For key down events, this is the repeat count with the first down starting at 0 and counting up from there. For key up events, this is always equal to 0.int64array[0]
Down time in elapsed nanoseconds since the last boot. Denotes the time of the most recent key down event. For the down event, this is the event time of the down event.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HW_MOTION_INPUT
Property to feed hardware input events to Android.
int32array[0]
Target display defined byVehicleDisplay
, such as:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER
,VehicleDisplay::AUX
int32array[1]
Input type defined in VehicleHwMotionInputSource, such as:
VehicleHwMotionInputSource::SOURCE_KEYBOARD
,VehicleHwMotionInputSource::SOURCE_DPAD
int32array[2]
Action code defined in VehicleHwMotionInputAction, such as:
VehicleHwMotionInputAction::ACTION_UP
,VehicleHwMotionInputAction::ACTION_DOWN
int32array[3]
Button state flag defined in VehicleHwMotionButtonStateFlag, such as:
VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY
,VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
int32array[4]
Pointer events count, N. N must be a positive integer.int32array[5:5+N-1]
Pointer id, length Nint32array[5+N:5+2*N-1]
Tool type, length N. As defined inVehicleHwMotionToolType
, such as:
VehicleHwMotionToolType::TOOL_TYPE_FINGER
,VehicleHwMotionToolType::TOOL_TYPE_STYLUS
floatArray[0:N-1]
x data, length NfloatArray[N:2*N-1]
y data, length NfloatArray[2*N:3*N-1]
pressure data, length NfloatArray[3*N:4*N-1]
size data, length Nint64array[0]
Down time, elapsed nanoseconds since boot. Denotes the time when the user originally pressed down to start a stream of position events. For the down event, it is the event time of the down event.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HW_ROTARY_INPUT
Property to feed hardware rotary events to Android.
int32Values[0]
RotaryInputType to identify which rotary knob is rotated.int32Values[1]
Number of detents (clicks), positive for clockwise, negative for counterclockwise.int32Values[2]
Target display defined inVehicleDisplay
Events not tied to a specific display must be sent toVehicleDisplay#MAIN
int32values[3 .. 3 + abs(number of detents) - 2]
Nanosecond deltas between pairs of consecutive detents when the number of detents is more than 1 or less than -1.VehiclePropValue.timestamp
When the rotation took place. If the number of detents is more than 1 or less than -1, when the first detent of rotation took place.
Change mode: ON_CHANGE
Access mode: READ
Enum type: RotaryInputType
Unit type: N/A
Release: Android 13
IGNITION_STATE
Represents ignition state.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleIgnitionState
Unit type: N/A
Release: Android 13
INFO_DRIVER_SEAT
Driver's seat location VHAL implementations must ignore the areaId. Use
VehicleArea:GLOBAL
Change mode: STATIC
Access mode: READ
Enum type: VehicleAreaSeat
Unit type: N/A
Release: Android 13
INFO_EV_BATTERY_CAPACITY
Nominal battery capacity for EV or hybrid vehicle. Returns the nominal battery capacity, EV
or hybrid. This is the total usable battery capacity when the vehicle is new. This value may
differ from EV_CURRENT_BATTERY_CAPACITY
because
EV_CURRENT_BATTERY_CAPACITY
returns the real-time usable battery capacity taking
into account factors such as battery aging and temperature dependency.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:WH
Release: Android 13
INFO_EV_CONNECTOR_TYPE
List of connectors this EV may use. If the vehicle has multiple charging ports, this property must return all possible connector types that can be used by at least one charging port on the vehicle.
Change mode: STATIC
Access mode: READ
Enum type: EvConnectorType
Unit type: N/A
Release: Android 13
INFO_EV_PORT_LOCATION
This property must communicate the location of the charging port on the EV using the
PortLocationType enum. If a vehicle has multiple ports, this property must return
the port that allows the fastest charging. To communicate all port locations, use
INFO_MULTI_EV_PORT_LOCATIONS
Access mode: READ
Enum type:
PortLocationType
Unit type: N/A
Release: Android 13
INFO_EXTERIOR_DIMENSIONS
Exterior dimensions of vehicle:
- Height:
int32Values[0]
- Length:
int32Values[1]
- Width:
int32Values[2]
- Width, including mirrors:
int32Values[3]
- Wheel base, including mirrors:
int32Values[4]
- Track width front:
int32Values[5]
- Track width rear:
int32Values[6]
- Curb-to-curb turning diameter:
int32Values[7]
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLIMETER
Release: Android 13
INFO_FUEL_CAPACITY
Fuel capacity of the vehicle in milliliters. This property must communicate the maximum amount
of fuel that can be stored in the vehicle in milliliters. This property does not apply to electric
vehicles (EV). That is, if INFO_FUEL_TYPE
only contains
FuelType::FUEL_TYPE_ELECTRIC
, INFO_FUEL_CAPACITY must not be implemented.
For EVs, implement INFO_EV_BATTERY_CAPACITY.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLILITER
Release: Android 13
INFO_FUEL_DOOR_LOCATION
Fuel door location. This property must communicate the location of the fuel door on the vehicle.
This property does not apply to EVs. That is, if INFO_FUEL_TYPE
only contains
FuelType::FUEL_TYPE_ELECTRIC
, this property must not be implemented. For EVs,
implement INFO_EV_PORT_LOCATION
or INFO_MULTI_LOCATIONS
Change mode: STATIC
Access mode: READ
Enum type: PortLocationType
Unit type: N/A
Release: Android 13
INFO_FUEL_TYPE
List of fuels the vehicle may use. FuelType::FUEL_TYPE_ELECTRIC
must only be
included if the vehicle can plug-in rechargeable. For example, a Fully Hybrid Electric Vehicle
(FHEV) must not include FuelType::FUEL_TYPE_ELECTRIC
as the INT32_VEC
value for INFO_FUEL_TYPE
INFO_FUEL_TYPE
can be populated as such.
int32Values = { FuelType::FUEL_TYPE_UNLEADED }
FuelType::FUEL_TYPE_ELECTRIC
as the INT32_VEC value for
INFO_FUEL_TYPE
INFO_FUEL_TYPE
can be populated as such,
int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }
Change mode: STATIC
Access mode: READ
Enum type: FuelType
Unit type: N/A
Release: Android 13
INFO_MAKE
Manufacturer of vehicle. This property must communicate the vehicle's public brand name.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INFO_MODEL
Model of vehicle. This property must communicate the vehicle's public model name.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INFO_MODEL_YEAR
Model year of vehicle in `YYYY` format based on the Gregorian calendar.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:YEAR
Release: Android 13
INFO_MULTI_EV_PORT_LOCATIONS
Multiple EV port locations. Implement this property if the vehicle has multiple EV ports. Port locations are defined in PortLocationType. For example, a car has one port front left and one port rear left:
int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT
If a vehicle has only one port, this property's value should list one element. To describe one port location, see INFO-EV-PORT-LOCATION
.
Change mode: STATIC
Access mode: READ
Enum type: PortLocationType
Unit type: N/A
Release: Android 13
INFO_VIN
VIN of vehicle.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INITIAL_USER_INFO
Defines the Android user to be used during initialization. This property is called by
the Android system when it initializes and lets the HAL define which Android user should be
started. This request is made by setting a VehiclePropValue (defined by
InitialUserInfoRequest
), and the HAL must respond with a property change event (defined
by InitialUserInfoResponse).
If the HAL doesn't respond after a time defined by the Android system, the Android system proceeds
as if HAL returned a response of action InitialUserInfoResponseAction:DEFAULT.
For example, on first boot, the request could be:
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
). For example, to create the
same Owner user with en-US and pt-BR locales, the string value of the response is
en-US,pt-BR||Owner. As such, neither the locale nor the name can contain two vertical bars
(||
) in their values, although you can use a single vertical bar (|
).
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
J~R
LANE_CENTERING_ASSIST_COMMAND
Lane Centering Assist (LCA) commands. Commands to activate and suspend LCA.
When the command ACTIVATE
from LaneCenteringAssistCommand
is sent,
LANE_CENTERING_ASSIST_STATE
must be set to LaneCenteringAssistState#ACTIVATION_REQUESTED
When the
ACTIVATE
command succeeds,
LANE_CENTERING_ASSIST_STATE
must be set to LaneCenteringAssistState#ACTIVATED
When the command
DEACTIVATE
from LaneCenteringAssistCommand
succeeds,
LANE_CENTERING_ASSIST_STATE
must be set to
LaneCenteringAssistState#ENABLED
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
must be defined unless all
enum values of LaneCenteringAssistCommand
are supported. When this property is not available
because LCA is disabled (for example, LANE_CENTERING_ASSIST_ENABLED
is false), this
property must
return StatusCode#NOT_AVAILABLE_DISABLED
If LANE_CENTERING_ASSIST_STATE
is
implemented and the
state is set to an ErrorState
value, then this property must return a StatusCode
that aligns with
the ErrorState
value. For example, if LANE_CENTERING_ASSIST_STATE
is set to
ErrorState#NOT_AVAILABLE_SPEED_LOW
then this property must return
StatusCode#NOT_AVAILABLE_SPEED_LOW
Change mode: ON_CHANGE
Access mode: WRITE
Enum type: LaneCenteringAssistCommand
Unit type: N/A
Release: Android 14
LANE_CENTERING_ASSIST_ENABLED
Enable or disable Lane Centering Assist (LCA). Set true to enable LCA and false to disable LCA. When LCA is enabled, the ADAS system in the vehicle should be turned on and waiting for an activation signal from the driver. Once the feature is activated, the ADAS system should be steering the vehicle to keep it centered in its current lane.
This is different from Lane Keep Assist (LKA) which monitors if the driver unintentionally
drifts toward or over the lane marking. If an unintentional lane departure is detected, the
system applies steering control to return the vehicle into the current lane.
In general, LANE_CENTERING_ASSIST_ENABLED
should always return true or false. If the
feature is not available due to some temporary state, such as the vehicle speed being too low or
too high, that information must be conveyed through the ErrorState
values in the
LANE_CENTERING_ASSIST_STATE
property.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
LANE_CENTERING_ASSIST_STATE
Lane Centering Assist (LCA) state. Returns the current state of LCA. This property must always
return a valid state defined in LaneCenteringAssistState
or ErrorState
It must not surface errors through StatusCode
and must use the supported error
states instead.
If LCA includes lane departure warnings, those warnings must be surfaced through the Lane Departure Warning (LDW) properties.
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must be
defined unless all states of both LaneCenteringAssistState
(including OTHER, which
is not recommended) and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneCenteringAssistState/ErrorState
Unit type: N/A
Release: Android 14
LANE_DEPARTURE_WARNING_ENABLED
Enable or disable Lane Departure Warning (LDW). Set true to enable LDW and false to disable LDW. When LDW is enabled, the ADAS system in the vehicle should be turned on and monitoring if the vehicle is approaching or crossing lane lines, in which case a warning will be given.
In general, LANE_DEPARTURE_WARNING_ENABLED
should always return true or false. If
the feature is not available due to some temporary state, such as the vehicle speed being too low
or too high, that information must be conveyed through the ErrorState
values in the
LANE_DEPARTURE_WARNING_STATE
property.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
LANE_DEPARTURE_WARNING_STATE
Lane Departure Warning (LDW) state. Returns the current state of LDW. This property must always
return a valid state defined in LaneDepartureWarningState
or ErrorState
It must not surface errors through StatusCode
and must use the supported error states
instead.
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must be
defined unless all states of both LaneDepartureWarningState
(including OTHER, which
is not recommended) and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneDepartureWarningState/ErrorState
Unit type: N/A
Release: Android 14
LANE_KEEP_ASSIST_ENABLED
Enable or disable Lane Keep Assist (LKA). Set true to enable LKA and false to disable LKA. When LKA is enabled, the ADAS system in the vehicle should be turned on and monitoring if the driver unintentionally drifts toward or over the lane marking. If an unintentional lane departure is detected, the system applies steering control to return the vehicle into the current lane. This is different from Lane Centering Assist (LCA) which, when activated, applies continuous steering control to keep the vehicle centered in the current lane.
In general, LANE_KEEP_ASSIST_ENABLED
should always return true or false. If the
feature is not available due to some temporary state, such as the vehicle speed being too low or
too high, that information must be conveyed through the ErrorState
values in the
LANE_KEEP_ASSIST_STATE
property.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
LANE_KEEP_ASSIST_STATE
Lane Keep Assist (LKA) state. Returns the current state of LKA. This property must always return
a valid state defined in LaneKeepAssistState
or ErrorState
It must not
surface errors through StatusCode
and must use the supported error states instead
If LKA includes lane departure warnings before applying steering corrections, those warnings must be surfaced through the Lane Departure Warning (LDW) properties.
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must be defined
unless all states of both LaneKeepAssistState
(including OTHER, which is not recommended) and
ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneKeepAssistState/ErrorState
Unit type: N/A
Release: Android 14
LOCATION_CHARACTERIZATION
Characterization of inputs used for computing location. This property must indicate what (if any) data and sensor inputs are considered by the system when computing the vehicle's location that is shared with Android through the GNSS HAL.
The value must return a collection of bit flags. The bit flags are defined in
LocationCharacterization. The value must also include exactly one of DEAD_RECKONED
or
RAW_GNSS_ONLY
among its collection of bit flags.
When this property is not supported, it is assumed that no additional sensor inputs are fused into the GNSS updates provided through the GNSS HAL. That is unless otherwise specified through the GNSS HAL interfaces.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14
MIRROR_AUTO_FOLD_ENABLED
Represents property for Mirror Auto Fold feature. This property is true when the feature for automatically folding the vehicle's side mirrors (for example, when the mirrors fold inward automatically when one exits and locks the vehicle) is enabled.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
MIRROR_AUTO_TILT_ENABLED
Represents property for Mirror Auto Tilt feature. This property is true when the feature for automatically tilting the vehicle's side mirrors (for example, when the mirrors tilt downward automatically when one reverses the vehicle) is enabled.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
MIRROR_FOLD
Mirror fold. True indicates mirrors are folded. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
MIRROR_LOCK
Mirror lock. True indicates mirror positions are locked and not changeable.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
MIRROR_Y_MOVE
Mirror Y move. The maxInt32Value
and minInt32Value
in each
VehicleAreaConfig
must be defined.
All integers between minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
represents the maximum movement speed of the mirror while tilting
right. The minInt32Value
represents the maximum movement speed of the mirror while
tilting left.
Larger absolute values, either positive or negative, indicate a faster movement speed. Once the mirror reaches the positional limit, the value must reset to 0. If MIRROR_Y_MOVE's value is currently 0, then that means there is no movement currently occurring.
This property is not in any particular unit but in a specified range of relative movement speeds.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
MIRROR_Y_POS
Mirror Y position. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined.
All integers between minInt32Value
and maxInt32Value
must be supported.
The minInt32Value
indicates the mirror is tilted completely to the left.
This must be a non-positive value. The maxInt32Value
indicates the mirror is tilted
completely
to the right. This must be a non-negative value. 0 indicates the mirror is not tilted in either
direction.
Values in between minInt32Value
and maxInt32Value
indicate a transition
state between the left
extreme and right extreme positions.
This property is not in any particular unit but in a specified range of relative positions.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
MIRROR_Z_MOVE
Mirror Z move. The maxInt32Value
and minInt32Value
in each
VehicleAreaConfig
must be defined.
All integers between minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
represents the maximum movement speed of the mirror while tilting upwards.
The minInt32Value
represents the maximum movement speed of the mirror while tilting downwards.
Larger absolute values, either positive or negative, indicate a faster movement speed. Once the
mirror reaches the positional limit, the value must reset to 0. If MIRROR_Z_MOVE's value is
currently 0, then that means there is no movement currently occurring.
This property is not in any particular unit but in a specified range of relative movement speeds.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
MIRROR_Z_POS
Mirror Z position. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined. All integers between minInt32Value
and maxInt32Value
must be supported. The minInt32Value
indicates the
mirror is tilted completely downwards. This must be a non-positive value. The
maxInt32Value
indicates the mirror is tilted completely upwards. This must be a
non-negative value. 0 indicates the mirror is not tilted in either direction.
Values in between minInt32Value
and maxInt32Value
indicate a
transition state between the fully downward and fully upwards positions.
This property is not in any particular unit but in a specified range of relative positions.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
NIGHT_MODE
True indicates that the night mode sensor has detected the car cabin environment to have low light. The platform can use this to, for example, enable an appropriate UI for better viewing in dark or low light environments.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
OBD2_FREEZE_FRAME
Reports a snapshot of the value of the OBD2 sensors available at the time that a fault occurred
and was detected. A configArray must be provided with the same meaning as defined for
OBD2_LIVE_FRAME
The values of this property are to be interpreted in a similar fashion as those for
OBD2_LIVE_FRAME
, with the exception that the stringValue field may contain a
non-empty diagnostic troubleshooting code (DTC).
An IVehicle#get request of this property must provide a value for int64Values[0]. This is interpreted
as the timestamp of the freeze frame to retrieve. A list of timestamps can be obtained by an
IVehicle#get of OBD2_FREEZE_FRAME_INFO
Should no freeze frame be available at the given timestamp, a response of
NOT_AVAILABLE
must be returned by the implementation. Because vehicles may have
limited storage for freeze frames, it is possible for a frame request to respond with
NOT_AVAILABLE
even if the associated timestamp has been recently obtained through
OBD2_FREEZE_FRAME_INFO
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
OBD2_FREEZE_FRAME_CLEAR
Freeze frame clear. Reports a snapshot of the value of the OBD2 sensors available at the time
that a fault occurred and was detected. A configArray must be provided with the same meaning as
defined for OBD2_LIVE_FRAME
The values of this property are to be interpreted in a similar fashion as those for
OBD2_LIVE_FRAME
, with the exception that the stringValue field may contain a non-empty diagnostic
troubleshooting code (DTC).
A IVehicle#get request of this property must provide a value for int64Values[0]. This will be
interpreted as the timestamp of the freeze frame to retrieve. A list of timestamps can be
obtained by a IVehicle#get of OBD2_FREEZE_FRAME_INFO
Should no freeze frame be available at the given timestamp, a response of NOT_AVAILABLE
must be
returned by the implementation. Because vehicles may have limited storage for freeze frames,
it is possible for a frame request to respond with NOT_AVAILABLE
even if the associated
timestamp has been recently obtained via OBD2_FREEZE_FRAME_INFO
Change mode: ON_CHANGE
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
OBD2_FREEZE_FRAME_INFO
This property describes the current freeze frames stored in vehicle memory and available for
retrieval through OBD2_FREEZE_FRAME
The values are to be interpreted as follows. Each element of
int64Values must be the timestamp at which a a fault code has been detected and the corresponding
freeze frame stored, and each such element can be used as the key to OBD2_FREEZE_FRAME
to
retrieve the corresponding freeze frame.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
OBD2_LIVE_FRAME
Reports a snapshot of the current (live) values of the OBD2 sensors available. The configArray is set as follows:
configArray[0]
Number of vendor-specific integer-valued sensorsconfigArray[1]
Number of vendor-specific float-valued sensors
The values of this property are to be interpreted as in the following example. Considering a
configArray = {2,3} int32Values
must be a vector containing
Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX
plus two elements (or, 33 elements).
floatValues
must be a vector containing
Obd2FloatSensorIndex.LAST_SYSTEM_INDEX
plus three elements (or, 73 elements).
It is possible for each frame to contain a different subset of sensor values, both system
provided sensors, and vendor-specific ones. In order to support this, the bytes element of the
property value is used as a bitmask. Bytes must have a sufficient number of bytes to represent
the total number of possible sensors (in this case, 14 bytes to represent 106 possible values).
It'is to be read as a contiguous bitmask such that each bit indicates the presence or absence of
a sensor from the frame, starting with as many bits as the size of int32Values
,
immediately followed by as many bits as the size of floatValues.
For example, should bytes[0] = 0x4C (0b01001100)
it means that:
int32Values[0 and 1]
are not valid sensor valuesint32Values[2 and 3]
are valid sensor valuesint32Values[4 and 5]
are not valid sensor valuesint32Values[6]
is a valid sensor valueint32Values[7]
is not a valid sensor valueint32Values[0 and 1]
are not valid sensor valuesint32Values[2 and 3]
are valid sensor valuesint32Values[4 and 5]
are not valid sensor valuesint32Values[6]
is a valid sensor valueint32Values[7]
is not a valid sensor value
If bytes[5] = 0x61 (0b01100001)
, then:
int32Values[32]
is a valid sensor valuefloatValues[0 thru 3]
are invalid sensor valuesfloatValues[4 and 5]
are valid sensor valuesfloatValues[6]
is not a valid sensor value.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
ON_CHANGE
Change mode:
Access mode: READ_WRITE/READ
Enum type:
Unit type:N/A
Release: Android 13
VehicleLightSwitch
PARKING_BRAKE_AUTO_APPLY
Auto-apply parking brake. When true, this property indicates that the car's
automatic parking brake is enabled. False indicates that the car's automatic parking
brake feature is disabled. This property is often confused with PARKING_BRAKE_ON
The
difference being that PARKING_BRAKE_ON
indicates if the actual parking brake is
on or off whereas PARKING_BRAKE_AUTO_APPLY
indicates if the automatic parking brake
feature is enabled or disabled and does not describe the current state of the actual parking
brake.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
PARKING_BRAKE_ON
Parking brake state. When true, this property true indicates that the car's parking brake is engaged. False indicates the car's parking brake is disengaged.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
PER_DISPLAY_BRIGHTNESS
Property to represent brightness of the displays which are controlled separately.
Some cars have one or more displays whose brightness is controlled separately and this property
is to inform the brightness of each passenger display. In cars where all displays' brightness
is controlled together, they must use DISPLAY_BRIGHTNESS
Only one of PER_DISPLAY_BRIGHTNESS
andPER_DISPLAY_BRIGHTNESS
should be implemented. If both are
available, PER_DISPLAY_BRIGHTNESS
is used by AAOS.
The display port uniquely identifies a physical connector on the device for display output, ranging from 0 to 255.
int32Values[0]
Display portint32Values[1]
Brightness
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 14
PERF_ODOMETER
Current odometer value of the vehicle.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:KILOMETER
Release: Android 13
PERF_REAR_STEERING_ANGLE
Rear bicycle model steering angle for vehicle. Angle is measured in degrees. Left is negative. This property is independent of the angle of the steering wheel. This property must communicate the angle of the rear wheels with respect to the vehicle, not the angle of the steering wheel.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:DEGREES
Release: Android 13
PERF_STEERING_ANGLE
Front bicycle model steering angle for vehicle. Angle is measured in degrees. Left is negative. This property is independent of the angle of the steering wheel. This property must communicate the angle of the front wheels with respect to the vehicle, not the angle of the steering wheel.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:DEGREES
Release: Android 13
PERF_VEHICLE_SPEED
Speed of the vehicle, The value must be positive when the vehicle is moving forward and
negative when the vehicle is reversing. This value is independent of gear value
(CURRENT_GEAR
or GEAR_SELECTION
). For example, if
GEAR_SELECTION
is GEAR_NEUTRAL
, PERF_VEHICLE_SPEED
is
positive when the vehicle is moving forward, negative when reversing, and zero when not moving.
Change mode: CONTINUOUS
Access mode: READ
Unit type: N/A
Unit type: VehicleUnit:METER_PER_SEC
Release: Android 13
PERF_VEHICLE_SPEED_DISPLAY
Speed of the vehicle for displays, Some cars display a slightly slower speed on the speedometer than actual speed.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:METER_PER_SEC
Release: Android 13
POWER_POLICY_GROUP_REQ
Defines a request to set the power policy group used to decide a default power policy per power status transition.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
POWER_POLICY_REQ
Defines a request to apply power policy. VHAL sets this property to change car power policy.
Car power policy service subscribes to this property and actually changes the power policy. The
request is made by setting the VehiclePropValue with the ID of a power policy which is defined at
/vendor/etc/automotive/power_policy.xml
If the given ID is not defined, car power policy service
ignores the request and the current power policy is maintained.
string: "sample_policy_id" // power policy ID
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
POWER_POLICY_GROUP_REQ
Defines a request to set the power policy group used to decide a default power policy per power status transition. VHAL sets this property with the ID of a power policy group to set the default power policy applied at power status transition. Power policy groups are defined at /vendor/etc/power_policy.xml. If the given ID is not defined, car power policy service ignores the request. Car power policy service subscribes to this property and sets the power policy group. The actual application of power policy takes place when the system power status changes and there is a valid mapped power policy for the new power status.
string: "sample_policy_group_id" // power policy group ID
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
RANGE_REMAINING
Range remaining. Meters remaining of fuel and charge. Range remaining shall account for all
energy sources in a vehicle. For example, a hybrid car's range is the sum of the ranges based
on fuel and battery. This property is defined as VehiclePropertyAccess.READ_WRITE
because a navigation app could update the range if it has a more accurate estimate based on the
upcoming route. This property can be implemented as VehiclePropertyAccess.READ
only at the OEM's discretion.
Change mode: CONTINUOUS
Access mode: READ_WRITE
Enum type: N/A
Unit type: VehicleUnit:METER
Release: Android 13
READING_LIGHTS_STATE
Return the current status of reading lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
READING_LIGHTS_SWITCH
Switch t control the reading lights. This may differ from READING_LIGHTS_STATE
if
the lights are on because a door is open or due to a voice command. For example, while the switch
is in the off or automatic position. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
REAR_FOG_LIGHTS_STATE
Return the current state of the rear fog lights. Only one of FOG_LIGHTS_STATE
or
REAR_FOG_LIGHTS_STATE
can be implemented. See FOG_LIGHTS_STATE
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
REAR_FOG_LIGHTS_SWITCH
The setting that the user wants. Only one of FOG_LIGHTS_SWITCH
or
REAR_FOG_LIGHTS_SWITCH
must
be implemented. See FOG_LIGHTS_SWITCH
to learn more. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
REMOVE_USER
Called by the Android System after an Android user was removed. The HAL can use this property to remove the equivalent user. This is write-only cal. The Android System is not expecting a reply from the HAL. Hence, this request should not fail. If the equivalent HAL user cannot be removed, then HAL should mark it as inactive or recover in another way.
The request is made by setting the VehiclePropValue with the contents defined by
RemoveUserRequest
For example, if system had 3 users (0, 10, and 11) and user 11
was removed, the request would be:
int32[0]
42 // request idint32[1]
11 // (Android user id of the removed user)int32[2]
0 // (Android user flags of the removed user)int32[3]
10 // current userint32[4]
0 // current user flags (none)int32[5]
2 // number of usersint32[6]
0 // first user (user 0)int32[7]
0 // first user flags (none)int32[8]
10 // second user (user 10)int32[9
] 0 // second user flags (none)
Change mode: STATIC
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
내림차순
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번 이동 각 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. 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은 좌석의 바닥에 가장 가까운 액추에이터입니다. VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. 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_BELT_BUCKLED
안전벨트를 매었습니다. 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_BELT_HEIGHT_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< code=""> only..</covehiclepropertyaccess.read<>로 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_EASY_ACCESS_ENABLED
좌석 접근성 기능의 속성을 나타냅니다. true인 경우 탑승자가 더 쉽게 차량에 승차하고 하차할 수 있도록 좌석이 자동으로 조정됩니다. 각 영역 ID는 사용자가 쉬운 액세스 기능을 사용하여 승하차하려는 좌석에 매핑되어야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM에서는 <covehiclepropertyaccess.read< code=""> 전용</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의 값과 다를 수 있는 경우에만 구현해야 합니다.
VehicleLightState의 모든 enum 값이 지원되지 않는 한 지원되는 각 지역 ID에 대해 VehicleAreaConfig#supportedEnumValues를 정의해야 합니다.
변경 모드: 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의 값과 다를 수 있는 경우에만 구현해야 합니다.
지원되는 각 지역 ID의 경우 VehicleLightSwitch의 모든 열거형 값이 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues를 정의해야 합니다.
이 속성은 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
헤드레스트 각도 이동 각 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
는 정의되어야 합니다. 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
헤드레스트 각도 위치 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_FORE_AFT_MOVE
헤드레스트 앞뒤 이동 각 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
는 정의되어야 합니다. 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(SEAT_HEADREST_HEIGHT_MOVE)
머리 받침대 높이 움직이기. 각 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
는 정의되어야 합니다. 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(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
좌석 높이 위치입니다. 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_FORE_AFT_MOVE
요추 앞뒤 움직임 각 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. 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
허리 측면 지지대 이동 각 VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. 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
허리 측부 지지 위치입니다. VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
~maxInt32Value
사이의 모든 정수를 지원해야 합니다. minInt32Value
는 허리 측면 지지대가 가장 얇은 위치 (예: 대부분의 지지대)에 있음을 나타냅니다. maxInt32Value
는 요추 측면 지지대가 가장 넓은 위치에 있음을 나타냅니다 (예: 가장 약한 지지).
minInt32Value
과 maxInt32Value
사이의 값은 가장 좁은 위치와 가장 넓은 위치 간의 전환 상태를 나타냅니다.
이 속성은 지정된 상대적 위치 범위로 표시됩니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다.
변경 모드: ON_CHANGE
액세스 유형: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
SEAT_LUMBAR_VERTICAL_MOVE
좌석 요추 지지대의 수직 이동 방향 및 속도의 속성을 나타냅니다.
각 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_VERTICAL_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
이 설정을 사용하면 사용자가 현재 좌석 위치 설정을 선택한 사전 설정 슬롯에 저장할 수 있습니다. VehicleAreaConfig
의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. minInt32Value
는 0이어야 하며 각 좌석 위치의 maxInt32Value
는 SEAT_MEMORY_SELECT
의 maxInt32Value
와 일치해야 합니다.
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
SEAT_OCCUPANCY
자동차가 판단할 수 있는 범위 내에서 특정 좌석이 탑승 중인지 여부를 나타냅니다. 유효한 값은 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
STEERING_WHEEL_DEPTH_MOVE
스티어링 휠 깊이 움직임 VehicleAreaConfig의 maxInt32Value
및 minInt32Value
를 정의해야 합니다. 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의 모든 열거형 값이 지원되지 않는 한 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)의 경우 VehicleLightSwitch의 모든 enum 값이 지원되지 않는 한 VehicleAreaConfig#supportedEnumValues
를 정의해야 합니다.
이 속성은 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< code="">로만 구현할 수 있습니다./p>
</covehiclepropertyaccess.read<>
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 14
STEERING_WHEEL_THEFT_LOCK_ENABLED
스티어링 휠 도난 방지 잠금 기능이 사용 설정되었습니다. 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
변경 요청이 HAL과 통합되지 않은 방식으로 이루어진 경우 (예: adb 셸 am switch-user를 통해) Android 사용자가 변경하려고 함을 나타내기 위해 Android 시스템에서 호출합니다. HAL은 이 요청을 수신한 후 내부 사용자를 전환할 수 있지만 Android 시스템에 다시 응답할 필요는 없습니다. 어떤 이유로든 내부 사용자를 변경할 수 없는 경우SWITCH_USER(type=ANDROID_POST_SWITCH)
호출이 복구될 때까지 기다려야 합니다 (예: 이전 사용자로 다시 전환하기 위해SWITCH_USER(type=VEHICLE_REQUEST)
를 실행할 수 있음). 되돌아 전환하면 최종 사용자가 혼란스러워질 수 있으므로 실패하지 않는 것이 이상적입니다.
예를 들어 시스템에 사용자 (0, 10, 11)가 있고 0에서 11로 전환하는 경우(사용자 중 특수 플래그가 없는 경우) 요청은 다음과 같습니다.
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에 응답해야 합니다. 예를 들어 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 // 상태: SwitchUserStatus::SUCCESS
요청이 실패하면 응답은 다음과 같습니다.
int32[0]
42 // 요청 IDint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
2 // status: SwitchUserStatus::FAILURE string: "108-D'OH!"- OEM별 오류 메시지
VEHICLE_RESPONSE
HAL에서 호출하여 ANDROID_SWITCH 유형의 요청을 계속할지 중단할지 나타냅니다. 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 값 (인덱스 1의 요청별 값은SwitchUserMessageType::ANDROID_POST_SWITCH
임), 대상 사용자 ID의 두 개의 값 (예: 전환하도록 요청된 Android 사용자 ID) 및 플래그 (UserFlags에 의해 정의됨) - 응답: 없음 예를 들어
VEHICLE_REQUEST
을 참고하세요.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
TIRE_PRESSURE
타이어 공기압 각 타이어는 areaConfig.areaId 구성으로 식별됩니다. 각각의 minFloatValue 및 maxFloatValue는 OEM 권장 압력 범위를 저장하는 데 사용됩니다. VehicleAreaConfig의 minFloatValue 및 maxFloatValue 값을 정의해야 합니다.
areaConfig 데이터의 minFloatValue는 권장 타이어 공기압의 하한선을 나타냅니다. areaConfig 데이터의 maxFloatValue는 권장 타이어 공기압의 상한을 나타냅니다. 예를 들어 이 areaConfig는 left_front 타이어의 권장 타이어 공기압을 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, Kilopascal 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
TRAILER_PRESENT
자동차의 트레일러 상태를 반환합니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: TrailerState
단위 유형: 해당 사항 없음
출시: Android 13
TURN_SIGNAL_STATE
차량의 방향 지시등입니다.
변경 모드: ON_CHANGE
액세스 모드: READ
Enum 유형: VehicleTurnSignal
단위 유형: 해당 사항 없음
출시: Android 13
USER_IDENTIFICATION_ASSOCIATION
현재 사용자를 차량별 식별 메커니즘(예: 전자 키)과 연결하거나 연결을 쿼리하는 데 사용되는 속성입니다.
이 속성은 선택사항의 사용자 관리 속성입니다. OEM은 사용자 관리를 정의하지 않고도 계속 지원할 수 있습니다. 실제로 이 속성은 INITIAL_USER_INFO에서 설명하는 핵심 사용자 관련 기능을 지원하지 않고도 사용할 수 있습니다.
연결을 쿼리하기 위해 Android 시스템은 UserIdentificationGetRequest에 정의된 대로 쿼리되는 연결 유형이 포함된 VehiclePropValue를 전달하여 속성을 가져옵니다. HAL은 즉시 반환되어야 하며 UserIdentificationResponse와 함께 VehiclePropValue를 반환합니다.
시스템 부팅 중에 사용자 식별이 이루어졌습니다. VHAL 구현은 get 호출에서 새 연결을 시작하는 대신 이미 식별된 연결(예: 자동차 도어락을 여는 데 사용되는 키 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)
그런 다음 사용자를 맞춤 메커니즘과 연결하기 위해 세트 요청이 실행됩니다.
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)
설정 요청은 연결을 추가하지만 기존 연결은 삭제하지 않습니다. 이전 예에서 최종 상태는 두 개의 연결 (FOB 및 CUSTOM_1)입니다. 사용자를 FOB가 아닌 CUSTOM_1하고만 연결하려면 요청은 다음과 같습니다.
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
차량이 사용 중인지 여부를 나타냅니다. 사용 중이란 사람이 차량을 사용할 준비가 되어 있음을 의미합니다. 그렇다고 해서 반드시 사람이 차량에 있는 것은 아닙니다. 예를 들어 사람이 원격으로 차량을 잠금 해제하면 차량이 사용 중인 것으로 간주됩니다. 이 속성이 지원되는 경우:
- 사용자가 차량의 전원을 켜거나 시스템이 사용자가 있음을 감지할 때마다
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
는 false입니다. 원격 작업이 실행되는 동안 사용자가 차량에 들어가 차량의 전원을 켭니다.
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
자동차 워치독이 활성 상태임을 나타내기 위해 업데이트하는 이벤트를 정의합니다. Car Watchdog은 3초마다 이 속성을 시스템 가동 시간(밀리초)으로 설정합니다. 부팅하는 동안 업데이트가 더 오래 걸릴 수 있습니다.
변경 모드: ON_CHANGE
액세스 모드: WRITE
Enum 유형: 해당 사항 없음
단위 유형: 해당 사항 없음
출시: Android 13
WATCHDOG_TERMINATED_PROCESS
자동차 워치독이 종료한 프로세스와 종료 이유를 정의합니다.
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
는 휠 틱당 마이크로미터 값과 지원되는 휠을 나타내는 데 사용되며 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
창문 아동 보호 잠금 장치 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이면 이동이 진행되지 않습니다. 이 속성은 상대 이동 속도의 지정된 범위로 표현됩니다.
평면 밖으로 열 수 있는 창 (선루프의 환기 모드)의 경우 이 매개변수는 다음과 같이 작동합니다. 다음과 같은 경우:
- 선루프가 열려 있습니다.
Max
선루프를 더 열고 완전히 열리면 자동으로 중지합니다.Min
선루프 닫기, 선루프가 닫히면 자동으로 중지
- 통풍구가 열려 있음:
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
는 와이퍼의 한 전체 주기 기간을 반영해야 합니다.
WindshieldWipersState
의 모든 상태가 지원되지 않는 한 (권장되지 않는 OTHER 포함) 지원되는 각 영역 ID의 경우 VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
변경 모드: 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의 경우 WindshieldWipersSwitch
의 모든 상태가 지원되지 않는 한(권장하지 않는 OTHER 포함) VehicleAreaConfig#supportedEnumValues
배열을 정의해야 합니다.
이 속성은 VehiclePropertyAccess.READ_WRITE
로 정의되지만 OEM은 VehiclePropertyAccess.READ
로만 구현할 수 있습니다. 이 속성이 VehiclePropertyAccess.READ_WRITE
로 구현되고 OTHER 상태가 VehicleAreaConfig#supportedEnumValues
배열에 나열된 경우 OTHER는 쓰기에 지원되는 값이 아닙니다. 이는 읽기용으로만 지원되는 값입니다.
변경 모드: ON_CHANGE
액세스 모드: READ_WRITE
/READ
Enum 유형: WindshieldWipersSwitch
단위 유형: 해당 사항 없음
출시: Android 14