Properti sistem yang didukung

Halaman ini mencantumkan properti sistem yang didukung di VHAL. Properti yang didukung oleh VHAL harus berupa properti sistem dari daftar di bawah atau properti vendor. Di Android 14 dan lebih tinggi, definisi properti didefinisikan di hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl.

Definisi properti didefinisikan dalam antarmuka AIDL, android.hardware.automotive.vehicle.property, yang terpisah dari VHAL antarmuka (android.hardware.automotive.vehicle). Implementasi VHAL dan VHAL klien harus bergantung pada kedua antarmuka.

Mode akses yang dibuat otomatis dan mode perubahan

Di Android 14 dan yang lebih tinggi, untuk mendukung implementasi VHAL, kami menyediakan parameter Header C++ file dan File class Java dengan mode ubah atau mode akses yang diizinkan untuk properti sistem. Implementasi VHAL Vendor menggunakannya untuk memastikan bahwa konfigurasi properti memenuhi spesifikasi.

ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE

使用自适应巡航控制 (ACC) 或预测性巡航控制 (PCC) 时测量的与前车的距离。返回前车最后端点与 ACC 车辆最前端点之间的测量距离，单位为毫米。必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。minInt32Value 应为 0。maxInt32Value 应填充距离传感器支持的最大范围。此值应为非负值。

如果未检测到前车（即，没有前车；或与前车相距太远，传感器无法检测到），此属性应返回 StatusCode.NOT_AVAILABLE

如果此属性因 CC 处于停用状态（例如 StatusCode#NOT_AVAILABLE_DISABLED 为 false）而不可用，则必须返回 StatusCode#NOT_AVAILABLE_DISABLED。如果实现了 CRUISE_CONTROL_STATE 且状态设置为 ErrorState 值，则此属性必须返回与 ErrorState 值一致的 StatusCode。例如，如果 CRUISE_CONTROL_STATE 设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW，则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:MILLIMETER
版本：Android 14

ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP

ACC 或 PCC 的当前目标时间间隔（以毫秒为单位）。 此属性应指定与前车的目标时间间隔。此时间间隔定义为，从前车的最后端点行驶到 ACC 车辆的最前端点所需的时间。与前车的实际时间间隔可能会高于或低于此值。

应在 configArray 中按升序指定可为目标时间间隔设置的值。所有值都必须为正数。如果该属性可写入，则所有值都必须可写入。如果此属性因 CC 处于停用状态（例如 CRUISE_CONTROL_ENABLED 为 false）而不可用，则必须返回 StatusCode#NOT_AVAILABLE_DISABLED

如果实现了 CRUISE_CONTROL_STATE 且状态设置为 ErrorState 值，则此属性必须返回与 ErrorState 值一致的 StatusCode。例如，如果 CRUISE_CONTROL_STATE 设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW，则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW

此属性被定义为 VehiclePropertyAccess.READ_WRITE，但原始设备制造商 (OEM) 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：VehicleUnit:MILLI_SECS
版本：Android 14

ABS_ACTIVE

自动制动系统 (ABS) 处于启用状态。当 ABS 处于启用状态时设置为 true，当 ABS 处于关闭状态时重置为 false。此属性可根据 ABS 系统的实时状态间歇性设置（脉冲式）。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

ANDROID_EPOCH_TIME

采用纪元时间编码的当前日期和时间（以毫秒为单位）。此值表示自世界协调时间 (UTC) 1970 年 1 月 1 日以来经过的毫秒数。

此值表示自世界协调时间 (UTC) 1970 年 1 月 1 日以来经过的毫秒数。 如果 VHAL 支持此属性，CarServices 会向此值执行 WRITE，以向 VHAL 提供 Android 系统的时间。这对于使其他车载系统（仪表盘时钟）与 Android 时间保持同步非常有用。

AAOS 会在启动期间对此属性执行一次 WRITE，之后仅会在时间源变化被传播时才会执行 WRITE。AAOS 会正确填充 VehiclePropValue.timestamp。AAOS 不会因时间自然流逝而发送更新。int64Values[0] 表示提供的 Unix 时间（以毫秒为单位）。

该属性可能需要超过 0 毫秒的时间才能通过堆栈传播，而拥有带着时间戳的属性有助于减少时移。因此，对于向该属性执行的所有 WRITE，时间戳都可用于消除这种时移： 

drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：无
单位类型：VehicleUnit:MILLI_SECS
版本：Android 13

AP_POWER_BOOTUP_REASON

用于报告当前开机原因的属性。这是一个 STATIC 属性，在设备关机前的整个时间段内都不会改变。例如，在系统因车门解锁而自动开机后，即使用户再次按下电源按钮，开机原因仍会保持为 VehicleApPowerBootupReason#USER_UNLOCK，int32Values[0] 必须为 VehicleApPowerBootupReason

更改模式：STATIC
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

AP_POWER_STATE_REPORT

用于报告应用处理器电源状态的属性。 假设 AP 的电源状态由单独的电源控制器控制。

  • int32Values[0] VehicleApPowerStateReport 枚举值
  • int32Values[1] 唤醒所需的时间，以毫秒 (ms) 为单位，如有必要的话（否则为 0）

更改模式：ON_CHANGE
访问模式：READ_WRITE
枚举类型：无
单位类型：无
版本：Android 13

AP_POWER_STATE_REQ

用于控制应用处理器电源状态的属性。 假设 AP 的电源状态由单独的电源控制器控制。对于配置信息，VehiclePropConfig.configArray 必须在 VehicleApPowerStateConfigFlag 中具有位标志组合值

  • int32Values[0] VehicleApPowerStateReq 枚举值
  • int32Values[1] 与每个状态相关的额外参数；如果未使用，则为 0。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

AUTOMATIC_EMERGENCY_BRAKING_ENABLED

启用或停用自动紧急制动 (AEB)。 设置为 true 可启用 AEB，设置为 false 可停用 AEB。当 AEB 处于启用状态时，车辆中的 ADAS 系统应保持开启并进行监控，以避免可能发生的碰撞。此属性应仅适用于车速较高的应用场景。如需启用低速自动紧急制动功能，应使用 LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED。

一般来说，AUTOMATIC_EMERGENCY_BRAKING_ENABLED 应始终返回 true 或 false。如果该功能因某种临时状态（例如车速过低）而不可用，则必须通过 AUTOMATIC_EMERGENCY_BRAKING_STATE 属性中的 ErrorState 值传达此信息。

此属性被定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：ForwardCollisionWarningState/ErrorState
单位类型：无
版本：Android 14

BLIND_SPOT_WARNING_ENABLED

启用和停用盲点警告 (BSW)。 设置为 true 可启用 BSW，设置为 false 可停用 BSW。当 BSW 处于启用状态时，车辆中的 ADAS 系统应保持开启，并监控车辆的盲点区域是否有物体。

一般来说，BLIND_SPOT_WARNING_ENABLED 应始终返回 true 或 false。 如果该功能因某种临时状态（例如车速过低）而不可用，则必须通过 BLIND_SPOT_WARNING_STATE 属性中的 ErrorState 值传达此信息。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

BLIND_SPOT_WARNING_STATE

盲点警告 (BSW) 状态。 返回 BSW 的当前状态。此属性必须始终返回 BlindSpotWarningState 或 ErrorState 中定义的有效状态。它不得通过 StatusCode 显示错误，而必须改用受支持的错误状态。

对于每个受支持的区域 ID，必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues 数组，除非同时支持 BlindSpotWarningState（包括不推荐的 OTHER）和 ErrorState 的所有状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：BlindSpotWarningState/ErrorState
单位类型：无
版本：Android 14

CABIN_LIGHTS_STATE

返回车厢灯的状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：无
版本：Android 13

CABIN_LIGHTS_SWITCH

车厢灯开关。 控制车厢灯的实体开关的位置。如果灯开着是因为门打开了或因为语音指令，则可能与 CABIN_LIGHTS_STATE 不同。例如，当开关处于关闭或自动位置时。

此属性被定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：无
版本：Android 13

CLUSTER_DISPLAY_STATE

更改仪表板屏幕的状态。

  • 边界：用于渲染仪表集群 activity 的区域。
  • 边衬区：activity 不应在该区域放置重要信息。

可能的值为：

  • int32[0] 开启、关闭：0 - 关闭，1 - 开启，-1 - 随意
  • int32[1] 边界 - 左：正数 - 左侧位置（以像素为单位）-1 - 随意（应设置所有边界字段）
  • int32[2] 边界 - 上：与“左”格式相同
  • int32[3] 边界 - 右：与“左”格式相同
  • int32[4] 边界 - 下：与“左”格式相同
  • int32[5] 边衬区 - 左：正数 - 实际左边衬区值（以像素为单位）-1 - 随意（应将所有边衬区字段设置为“随意”）
  • int32[6] 边衬区 - 上：与“左”格式相同
  • int32[7] 边衬区 - 右：与“左”格式相同
  • int32[8] 边衬区 - 下：与“左”格式相同

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

CLUSTER_NAVIGATION_STATE

通知当前导航状态。字节：NavigationStateProto 的序列化消息。

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：
单位类型：无
版本：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] 子屏幕中的 ClusterUI 类型，如果当前显示两个界面的话。-1 表示该区域不再使用。字节：表示 ClusterUI 可用性的数组。0 表示不可用，1 表示可用。例如，如果汽车支持 OEM 定义的三个 ClusterUI（例如 HOME、MAPS 和 CALL），并且仅在移动网络可用时支持 CALL 界面。然后，如果网络可用，它发送 [1 1 1]；如果网络不可用，则发送 [1 1 0]。

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：VehicleLightSwitch
单位类型：无
版本：Android 13

CLUSTER_REQUEST_DISPLAY

用于更改仪表板显示屏状态以显示某些 ClusterUI 的请求。 当前显示状态为关闭时，ClusterHome 会将此消息发送到 ClusterOS，请求开启显示屏以显示特定的 ClusterUI。ClusterOS 应使用 CLUSTER_DISPLAY_STATE 响应此请求

  • int32 要显示的 ClusterUI 类型

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：无
单位类型：无
版本：Android 13

CLUSTER_SWITCH_UI

在仪表板显示屏中启动 ClusterUI。

  • int32 要显示的 ClusterUI 类型，0 表示 ClusterHome，即仪表集群显示屏的主屏幕，并为仪表集群显示屏提供默认界面和一种启动器功能。其他值则按照 OEM 的定义。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

CREATE_USER

创建 Android 用户后由 Android 系统调用。 HAL 可以使用此属性来创建其相应的用户。这是一个异步请求：Android 通过设置 VehiclePropValue 发出请求，HAL 必须通过属性更改进行响应，指明请求是成功还是失败。如果失败，Android 系统会移除该用户。

请求的格式由 CreateUserRequest 定义，响应的格式由 CreateUserResponse 定义。例如，如果系统有两位用户（0 和 10），并且创建了第三位用户（即临时访客），请求将如下所示：

  • int32[0] 42 // 请求 ID
  • int32[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 // 请求 ID
  • int32[1] 1 // CreateUserStatus::SUCCESS

但如果失败，则返回：

  • int32[0] 42 // 请求 ID
  • int32[1] 2 // CreateUserStatus::FAILURE 字符串："D'OH!" //

含义是黑箱，并传递给调用方（例如设置界面），后者会执行适当的操作。

更改模式：ON_CHANGE
访问模式：READ_WRITE
枚举类型：无
单位类型：无
版本：Android 13

CRITICALLY_LOW_TIRE_PRESSURE

此属性表示每个轮胎的极低胎压阈值。它表示何时更换或修理轮胎。此值必须小于或等于 TIRE_PRESSURE 中的 minFloatValue。最小和最大属性值（minFloatValue 和 maxFloatValue）不适用于此属性。

更改模式：STATIC
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:KILOPASCAL
版本：Android 13

CRUISE_CONTROL_COMMAND

WRITE 巡航控制 (CC) 指令。如需详细了解每个受支持的指令，请参阅 CruiseControlCommand。对于全局区域 ID (0)，必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues 数组，除非同时支持 CruiseControlState 的所有状态。通过此属性发送的任何不受支持的指令都必须返回 StatusCode#INVALID_ARG。如果此属性因 CC 处于停用状态（例如 CRUISE_CONTROL_ENABLED 为 false）而不可用，则必须返回 StatusCode#NOT_AVAILABLE_DISABLED。如果实现了 CRUISE_CONTROL_STATE 且状态设置为 ErrorState 值，则此属性必须返回与 ErrorState 值一致的 StatusCode。例如，如果 CRUISE_CONTROL_STATE 设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW，则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：CruiseControlCommand
单位类型：无
版本：Android 14

CRUISE_CONTROL_ENABLED

启用或停用巡航控制 (CC)。 设置为 true 表示启用 CC，设置为 false 表示停用 CC。此属性由所有形式的 CruiseControlType 共享。当 CC 处于启用状态时，车辆中的 ADAS 系统应处于开启状态并响应指令。一般来说，CRUISE_CONTROL_ENABLED 应始终返回 true 或 false。如果该功能因某种临时状态（例如车速过低）而不可用，则必须通过 CRUISE_CONTROL_STATE 属性中的 ErrorState 值传达此信息。此属性被定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

CRUISE_CONTROL_STATE

巡航控制 (CC) 的当前状态。 此属性会返回 CC 当前的状态。通常，此属性应返回 CruiseControlState 或 ErrorState 中定义的有效状态。例如，如果该功能因某种临时状态而不可用，则应通过 ErrorState 传达此信息。对于全局区域 ID (0)，必须定义 VehicleAreaConfig#supportedEnumValue 数组，除非同时支持 CruiseControlState（包括不推荐的 OTHER）和 ErrorState 的所有状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：CruiseControlState/ErrorState
单位类型：无
版本：Android 14

CRUISE_CONTROL_TARGET_SPEED

巡航控制 (CC) 的当前目标速度。 OEM 应为此属性设置 minFloatValue 和 maxFloatValue 值，以定义最小和最大目标速度值。这些值必须是非负值。maxFloatValue 表示目标速度的上限。minFloatValue 表示目标速度的下限。如果此属性因 CC 处于停用状态（例如 CRUISE_CONTROL_ENABLED 为 false）而不可用，则必须返回 StatusCode#NOT_AVAILABLE_DISABLED。如果实现了 CRUISE_CONTROL_STATE 且状态设置为 ErrorState 值，则此属性必须返回与 ErrorState 值一致的 StatusCode。例如，如果 CRUISE_CONTROL_STATE 设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW，则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:METER_PER_SEC
版本：Android 14

CRUISE_CONTROL_TYPE

巡航控制 (CC) 的当前类型。 当 CRUISE_CONTROL_ENABLED 为 true 时，此属性会返回当前启用的 CC 类型（例如标准 CC 和自适应 CC、预测性 CC）。通常，此属性应返回 CruiseControlType 或 ErrorState 中定义的有效状态。例如，如果该功能因某种临时状态而不可用，则应通过 ErrorState 传达此信息。对于全局区域 ID (0)，必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues 数组，除非支持 CruiseControlType（包括不推荐的 OTHER）和 ErrorState 的所有状态。尝试将 CruiseControlType#OTHER 或 ErrorState WRITE 到此属性会抛出 IllegalArgumentException。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：CruiseControlType ErrorState
单位类型：无
版本：Android 14

CURRENT_GEAR

当前档位。在非手动情况下，所选档位可能与当前档位不符。例如，所选档位是 GEAR_DRIVE，而当前档位是 GEAR_1、GEAR_2 等档位中的一个，这反映了变速器当前运行的实际档位。配置数据中的值必须表示此车辆的受支持档位列表。例如，自动变速器的配置数据必须包含 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_1, GEAR_2,...}，而手动变速器的列表必须为 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}。此列表不必与 GEAR_SELECTION 中报告的受支持档位列表相同。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleGear
单位类型：无
版本：Android 13

CURRENT_POWER_POLICY

向 VHAL 层通知当前电源政策。 当前电源政策发生变化时，汽车电源政策服务会设置此属性 

string: "sample_policy_id" // power policy ID

更改模式：ON_CHANGE
访问模式：READ_WRITE
枚举类型：无
单位类型：无
版本：Android 13

DISABLED_OPTIONAL_FEATURES

允许在 VHAL 中停用可选功能。此属性会报告应停用的可选功能。系统的所有允许可选功能均在汽车服务叠加层中声明，即 config_allowed_optional_car_features。此属性允许停用叠加层中定义的功能。如果没有此属性，叠加层中声明的所有功能都将被启用。值 READ 应包含所有已停用的功能，并以英文逗号 (,) 分隔。例如：com.android.car.user.CarUserNoticeService,storage_monitoring

更改模式：STATIC
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

DISPLAY_BRIGHTNESS

用于表示显示屏亮度的属性。 某些车辆只有一个用于控制所有显示屏亮度的控件。此属性用于共享对该控件的更改。如果配备了亮度受单独控制的显示屏，汽车必须使用 PER_DISPLAY_BRIGHTNESS。应仅实现 DISPLAY_BRIGHTNESS 和 PER_DISPLAY_BRIGHTNESS 中的一个。如果这两者都可用，AAOS 会使用 PER_DISPLAY_BRIGHTNESS。如果此属性可写入，Android 可以在用户通过“设置”更改显示屏亮度时设置此值。如果仅为 READ，用户仍可通过“设置”更改显示屏亮度，但更改不得反映在其他显示屏上。

更改模式：ON_CHANGE
访问模式：READ_WRITE
枚举类型：无
单位类型：无
版本：Android 13

DISTANCE_DISPLAY_UNITS

显示距离单位。 表示汽车使用哪些单位向用户显示距离。例如，英里、米或公里。距离单位在 VehicleUnit 中定义。VehiclePropConfig.configArray 用于表示支持的距离显示单位。例如，configArray[0] = METER configArray[1] = KILOMETER configArray[2] = MILE。如果更新 DISTANCE_DISPLAY_UNITS 会影响其他 *_DISPLAY_UNITS 属性的值，则必须更新它们的值，并也将其传达给 AAOS 框架。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleUnit
单位类型：无
版本：Android 13

DOOR_CHILD_LOCK_ENABLED

已启用车门童锁功能。 如果已启用车门童锁功能，则返回 true；如果已停用，则返回 false。如果已启用，门就无法从内部打开。此属性被定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

DOOR_LOCK

门锁为 true 表示门已上锁。此属性被定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 13

DOOR_POS

车门位置。 必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。 必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。minInt32Value 表示车门已关闭。minInt32Value 必须是 0。maxInt32Value 表示车门已完全打开。介于 minInt32Value 和 maxInt32Value 之间的值表示门处于关闭位置和完全打开位置之间的过渡状态。

此属性不采用任何特定单位，而是采用相对位置的指定范围。某些车辆（小型货车）可以通过电动方式打开车门。因此，具备 WRITE 此属性的能力。此属性定义为 VehiclePropertyAccess READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

E ke G

ELECTRONIC_TOLL_COLLECTION_CARD_STATUS

电子收费卡状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：ElectronicTollCollectionCardStatus
单位类型：无
版本：Android 13

ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

电子收费卡类型。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：ElectronicTollCollectionCardType
单位类型：无
版本：Android 13

EMERGENCY_LANE_KEEP_ASSIST_ENABLED

启用或停用 Emergency Lane Keep Assist (ELKA)。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

EMERGENCY_LANE_KEEP_ASSIST_STATE

Emergency Lane Keep Assist (ELKA) 状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：EmergencyLaneKeepAssistState/ErrorState
单位类型：无
版本：Android 14

ENGINE_COOLANT_TEMP

引擎冷却剂的温度。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:CELSIUS
版本：Android 13

ENGINE_IDLE_AUTO_STOP_ENABLED

表示引擎闲置自动停止的功能。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

ENGINE_OIL_LEVEL

引擎机油量。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleOilLevel
单位类型：无
版本：Android 13

ENGINE_OIL_TEMP

引擎机油的温度。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:CELSIUS
版本：Android 13

ENGINE_RPM

引擎每分钟转数 (RPM)。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:RPM
版本：Android 13

ENV_OUTSIDE_TEMPERATURE

车外温度。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:CELSIUS
版本：Android 13

EV_BATTERY_DISPLAY_UNITS

要显示的电动汽车电池单位。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleUnit
单位类型：无
版本：Android 13

EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

电动汽车瞬时充电速率（以毫瓦为单位）。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:MW
版本：Android 13

EV_BATTERY_LEVEL

电动汽车或混合动力汽车的电池电量。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:WH
版本：Android 13

EV_BRAKE_REGENERATION_LEVEL

电动汽车的再生制动等级。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

EV_CHARGE_CURRENT_DRAW_LIMIT

表示用户设置的最大当前充电量阈值。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：VehicleUnit:AMPERE
版本：Android 13

EV_CHARGE_PERCENT_LIMIT

表示用户设置的最大充电百分比阈值。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

EV_CHARGE_PORT_CONNECTED

电动汽车充电接口已连接。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

EV_CHARGE_PORT_OPEN

电动汽车充电接口已开启。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

EV_CHARGE_STATE

汽车的充电状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：EvChargeState
单位类型：无
版本：Android 13

EV_CHARGE_SWITCH

开始或停止为电动汽车电池充电。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

EV_CHARGE_TIME_REMAINING

预计剩余充电时间（以秒为单位）。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:SECS
版本：Android 13

EV_CURRENT_BATTERY_CAPACITY

电动汽车或混合动力汽车的当前电池容量。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:WH
版本：Android 13

EV_REGENERATIVE_BRAKING_STATE

汽车的再生制动或单踏板驾驶状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：EvRegenerativeBrakingState
单位类型：无
版本：Android 13

EV_STOPPING_MODE

表示车辆当前停止模式的属性。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：EvStoppingMode
单位类型：无
版本：Android 13

EVS_SERVICE_REQUEST

启用并请求 EVS 服务。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

EXTERNAL_CAR_TIME

汽车的当前日期和时间建议，编码为新纪元时间（以毫秒为单位）。 此值表示自世界协调时间 (UTC) 1970 年 1 月 1 日以来经过的毫秒数。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:MILLI_SECS
版本：Android 13

FOG_LIGHTS_STATE

雾灯状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：无
版本：Android 13

FOG_LIGHTS_SWITCH

雾灯开关。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：无
版本：Android 13

FORWARD_COLLISION_WARNING_ENABLED

启用或停用前向碰撞警示 (FCW)。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

FORWARD_COLLISION_WARNING_STATE

前向碰撞警示 (FCW) 状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：ForwardCollisionWarningState/ErrorState
单位类型：无
版本：Android 14

FRONT_FOG_LIGHTS_STATE

前雾灯状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：无
版本：Android 13

FRONT_FOG_LIGHTS_SWITCH

前雾灯开关。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：无
版本：Android 13

FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

要显示的油耗单位。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

FUEL_DOOR_OPEN

油门已打开。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

FUEL_LEVEL

车辆剩余燃料（以毫升为单位）。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:MILLILITER
版本：Android 13

FUEL_LEVEL_LOW

油位过低警告。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

FUEL_VOLUME_DISPLAY_UNITS

要显示的燃油体积单位。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleUnit
单位类型：无
版本：Android 13

GEAR_SELECTION

当前选择的档位。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleGear
单位类型：无
版本：Android 13

GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT

欧盟的一般安全法规合规性要求。

更改模式：STATIC
访问模式：READ
枚举类型：GsrComplianceRequirementType
单位类型：无
版本：Android 14

GLOVE_BOX_DOOR_POS

表示手套箱门当前位置的属性。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

GLOVE_BOX_LOCKED

锁上或解锁手套箱。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

H ke I

HANDS_ON_DETECTION_DRIVER_STATE

Status driver Hands On Detection (HOD). Menampilkan apakah tangan pengemudi berada di atas setir. Umumnya, properti ini akan menampilkan status yang valid yang ditentukan dalam HandsOnDetectionDriverState atau ErrorState. Misalnya, jika fitur tidak tersedia karena beberapa status sementara, informasi tersebut harus disampaikan melalui ErrorState Jika kendaraan ingin mengirim peringatan kepada pengguna karena tangan pengemudi telah berada di luar kemudi terlalu lama, peringatan harus ditampilkan melalui HANDS_ON_DETECTION_WARNING Untuk ID area global (0), array VehicleAreaConfig#supportedEnumValues harus ditentukan kecuali jika semua status HandsOnDetectionDriverState (termasuk OTHER, yang tidak direkomendasikan) dan ErrorState didukung.

Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: HandsOnDetectionDriverState/ErrorState
Jenis unit: T/A
Rilis: Android 14

HANDS_ON_DETECTION_DIAKTIFKAN

Mengaktifkan atau menonaktifkan Hands On Detection (HOD). Tetapkan ke true untuk mengaktifkan HOD dan false untuk menonaktifkan HOD. Saat HOD diaktifkan, sistem di dalam kendaraan harus memantau keberadaan tangan pengemudi di setir dan mengirimkan peringatan jika mendeteksi bahwa tangan pengemudi tidak lagi berada di setir. Secara umum, HANDS_ON_DETECTION_ENABLED harus selalu menampilkan benar atau salah.

Jika fitur ini tidak tersedia karena adanya status sementara, informasi tersebut harus disampaikan melalui nilai ErrorState di properti HANDS_ON_DETECTION_STATE. Properti ini ditentukan sebagai minInt32Value VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya hanya sebagai VehiclePropertyAccess.READ.

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14

PERINGATAN_Tangan_DI_DETECSI

Peringatan Hands On Detection (HOD). Menampilkan apakah peringatan dikirim kepada pengemudi karena tangannya melepaskan kemudi dalam durasi yang terlalu lama. Umumnya, properti ini akan menampilkan status yang valid yang ditentukan dalam HandsOnDetectionWarning atau ErrorState Misalnya, jika fitur tidak tersedia karena beberapa status sementara, informasi tersebut harus disampaikan melalui ErrorState Untuk ID area global (0), array VehicleAreaConfig#supportedEnumValues harus ditentukan kecuali jika semua status HandsOnDetectionWarning (termasuk OTHER, yang tidak direkomendasikan) dan ErrorState didukung.

Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: HandsOnDetectionWarning/ErrorState
Jenis unit: T/A
Rilis: Android 14

HAZARD_LIGHTS_state

Status lampu hazard. Kembalikan status lampu bahaya saat ini.

Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13

HAZARD_LIGHTS_SWITCH

Tombol lampu hazard. Setelan yang diinginkan pengguna. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ saja.

Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 13

HEADLIGHTS_STATE

Status lampu depan. Menampilkan status lampu depan saat ini.

Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13

HURUF_BESAR_SWITCH

Tombol lampu depan. Setelan yang diinginkan pengguna. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ saja.

Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 13

HIGH_BEAM_LIGHTS_state

Status lampu utama. Menampilkan status lampu beam tinggi saat ini.

Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13

BALIK_PANJANG_TINGGI_SWITCH

Sakelar lampu sinar tinggi. Setelan yang diinginkan pengguna. Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM hanya dapat menerapkannya sebagai VehiclePropertyAccess.READ.

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 13

HVAC_AC_ON

Mengaktifkan dan menonaktifkan AC untuk areaId yang ditentukan. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_ACTUAL_FAN_SPEED_RPM

Kecepatan kipas aktual.

Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_AUTO_ON

Aktifkan dan nonaktifkan kontrol iklim otomatis. Jika benar, kontrol iklim otomatis akan aktif. Jika salah (false), kontrol iklim otomatis nonaktif. Jika kendaraan tidak mendukung penonaktifan kontrol iklim otomatis secara langsung, OEM harus menambahkan logika dalam penerapan VHAL mereka untuk menetapkan HVAC_AUTO_ON ke salah (false), yang mengubah setelan HVAC yang diperlukan untuk menonaktifkan HVAC_AUTO_ON secara tidak langsung. Idealnya, hal ini tidak akan mengganggu pengguna. OEM harus mengembalikan setelan apa pun yang diubah saat kontrol iklim otomatis nonaktif ke status sebelumnya. Dengan cara ini, satu-satunya hasil yang akan terjadi adalah HVAC_AUTO_ON nonaktif. Jika tidak dapat memulihkan setelan HVAC ke setelan sebelumnya, OEM harus menerapkan perubahan yang paling tidak mengganggu.

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_AUTO_RECIRC_ON

Resirkulasi otomatis aktif atau nonaktif. Jika resirkulasi otomatis aktif, sistem HVAC dapat beralih secara otomatis ke mode resirkulasi jika kendaraan mendeteksi kualitas udara masuk yang buruk. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ saja.

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_DEFROSTER

Defrost berbasis kipas untuk jendela yang ditentukan. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ

Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_DUAL_ON

Mengaktifkan pengaitan suhu antar-area. AreaIDs untuk properti HVAC_DUAL_ON harus berisi kombinasi HVAC_TEMPERATURE_SET AreaIDs yang dapat digabungkan bersama. Jika HVAC_TEMPERATURE_SET dipetakan ke AreaIDs[a_1, a_2, ..., a_n] dan jika HVAC_DUAL_ON dapat diaktifkan untuk menggabungkan a_i dan a_j, maka properti HVAC_DUAL_ON harus dipetakan ke [a_i | a_j]. Selain itu, jika a_k dan a_l juga dapat digabungkan secara terpisah, maka HVAC_DUAL_ON harus dipetakan ke [a_i | a_j, a_k | a_l]. Misalnya, sebuah mobil memiliki dua kursi depan (ROW_1_LEFT dan ROW_1_RIGHT) dan tiga kursi belakang (ROW_2_LEFT, ROW_2_CENTER, dan ROW_2_RIGHT). Ada dua unit kontrol suhu, sisi pengemudi dan sisi penumpang, yang secara opsional dapat disinkronkan. Hal ini dapat dinyatakan dengan cara ini di 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]

Jika properti diaktifkan, ECU harus menyinkronkan suhu untuk area yang terpengaruh. Setiap parameter yang dimodifikasi sebagai efek samping pengaktifan atau penonaktifan parameter DUAL_ON akan menghasilkan callback onPropertyEvent() ke VHAL. Selain itu, jika menyetel suhu (misalnya, suhu pengemudi) mengubah suhu lain (seperti suhu penumpang bagian depan), callback onPropertyEvent() yang sesuai harus dibuat.

Jika pengguna mengubah suhu yang merusak pengaitan (misalnya, menyetel suhu penumpang secara independen), VHAL harus mengirimkan callback onPropertyEvent() yang sesuai (termasuk HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx). Properti ini didefinisikan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ

Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_ELECTRIC_DEFROSTER_ON

Status pencairan es listrik.

Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ

Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_FAN_DIRECTION

Setelan arah kipas. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ saja.

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleHvacFanDirection
Jenis unit: T/A
Rilis: Android 13

HVAC_FAN_DIRECTION_AVAILABLE

Posisi penggemar tersedia. Ini adalah bit mask dari posisi kipas yang tersedia untuk zona tersebut. Setiap arah kipas yang tersedia dilambangkan dengan entri terpisah dalam vektor tersebut. Arah kipas dapat memiliki beberapa bit dari vehicle_hvac_fan_direction yang ditetapkan. Misalnya, mobil biasa mungkin memiliki posisi kipas berikut:

- 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)

Ubah mode: STATIC
Mode akses: READ
Jenis enum: VehicleHvacFanDirection
Jenis unit: T/A
Rilis: Android 13

HVAC_KECEPATAN_PENGGEMAR

Setelan kecepatan kipas. maxInt32Value dan minInt32Value di KendaraanAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value dan maxInt32Value harus didukung.

  • Kecepatan kipas paling rendah minInt32Value
  • Kecepatan kipas tertinggi maxInt32Value

Properti ini tidak berada dalam unit tertentu, tetapi dalam rentang kecepatan relatif yang ditentukan. Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat memilih untuk menerapkannya hanya sebagai VehiclePropertyAccess.READ.

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_MAX_AC_ON

MAX AC aktif atau nonaktif. Saat MAX AC aktif, ECU dapat menyesuaikan item seperti posisi ventilasi, kecepatan kipas, dan suhu yang diperlukan untuk mendinginkan kendaraan secepat mungkin. Setiap parameter yang diubah sebagai efek samping pengaktifan atau penonaktifan parameter MAX AC akan menghasilkan callback onPropertyEvent() ke VHAL. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_MAX_DEFROST_ON

Aktifkan dan nonaktifkan MAX DEFROST. Jika MAX DEFROST aktif, ECU dapat menyesuaikan item seperti posisi ventilasi, kecepatan kipas, dan suhu sesuai kebutuhan untuk mencairkan es di kaca secepat mungkin. Setiap parameter yang diubah sebagai efek samping dari mengaktifkan atau menonaktifkan parameter MAX DEFROST akan menghasilkan callback onPropertyEvent() ke VHAL. AreaIDs untuk HVAC_MAX_DEFROST_ON menunjukkan DEFROST MAKSIMUM dapat dikontrol di area tersebut. Misalnya, areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT} menunjukkan bahwa HVAC_MAX_DEFROST_ON hanya dapat dikontrol untuk baris depan. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ

Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_POWER_ON

Merepresentasikan status daya global untuk HVAC. Jika properti ini disetel ke false MAY, beberapa properti yang mengontrol setiap fitur dan subsistem HVAC dalam status UNAVAILABLE. Menetapkan properti ini ke benar DAPAT menandai beberapa properti yang mengontrol setiap fitur dan subsistem HVAC ke status TERSEDIA (kecuali jika salah satu atau semua properti TIDAK TERSEDIA berdasarkan nilai masing-masing).

HvacPower_DependentProperties adalah properti yang memerlukan HVAC untuk diaktifkan guna mengaktifkan fungsi. Di beberapa mobil, misalnya, untuk mengaktifkan AC, HVAC harus diaktifkan terlebih dahulu. Daftar HvacPower_DependentProperties harus ditetapkan di VehiclePropConfig.configArray HvacPower_DependentProperties hanya boleh berisi properti yang terkait dengan VehicleArea:SEAT

Pemetaan AreaID untuk properti HVAC_POWER_ON harus berisi semua AreaIDs yang menjadi tujuan pemetaan HvacPower_DependentProperties. Misalnya, mobil memiliki dua:

  1. Kursi depan (ROW_1_LEFT, ROW_1_RIGHT) dan tiga kursi belakang (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). Jika fitur HVAC (AC, Suhu, dll.) di seluruh mobil bergantung pada satu pengontrol daya HVAC, HVAC_POWER_ON harus dipetakan ke [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
  2. Kursi di baris depan (ROW_1_LEFT, ROW_1_RIGHT) dan tiga kursi di baris kedua (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) dan ketiga (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT). Jika mobil memiliki pengontrol suhu di baris depan yang dapat beroperasi sepenuhnya secara independen dari pengontrol suhu di bagian belakang kendaraan, maka HVAC_POWER_ON harus dipetakan ke array dua elemen: 
    - ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT

Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM memiliki opsi untuk menerapkannya hanya sebagai VehiclePropertyAccess.READ.

Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_RECIRC_ON

Resirkulasi aktif dan nonaktif. Mengontrol pasokan udara eksterior ke kabin. Recirc on berarti sebagian besar aliran udara ke kabin berasal dari kabin. Sirkulasi ulang nonaktif berarti sebagian besar aliran udara ke kabin berasal dari luar mobil. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_SEAT_TEMPERATURE

Pemanas dan pendingin kursi. maxInt32Value dan minInt32Value di VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value dan maxInt32Value harus didukung. maxInt32Value menunjukkan setelan pemanas suhu kursi maksimum. minInt32Value harus 0, kecuali jika kendaraan mendukung pendingin kursi. Dalam hal ini, minInt32Value menunjukkan setelan pendingin suhu kursi maksimum. Properti ini tidak berada dalam unit tertentu, tetapi berada dalam rentang setelan suhu relatif yang ditentukan. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ saja.

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_SEAT_VENTILATION

Ventilasi kursi. maxInt32Value dan minInt32Value di VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value dan maxInt32Value harus didukung. minInt32Value harus 0. maxInt32Value menunjukkan setelan ventilasi maksimum yang tersedia untuk kursi.

Properti ini tidak berada dalam unit tertentu, tetapi dalam rentang setelan ventilasi yang ditentukan.

Digunakan oleh aplikasi HVAC dan Asisten untuk mengaktifkan, mengubah, atau membaca status ventilasi kursi. Hal ini berbeda dengan pendingin kursi. Sensor dapat menyala bersamaan dengan pendingin, atau tidak.

Properti ini ditetapkan sebagai >VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ saja.

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_SIDE_MIRROR_HEAT

Pemanas kaca samping. Nilai yang lebih tinggi menunjukkan tingkat penghangat yang lebih tinggi untuk cermin samping. Anda harus menentukan maxInt32Value dan minInt32Value di VehicleAreaConfig Semua bilangan bulat antara minInt32Value dan maxInt32Value harus didukung. Dalam data konfigurasi:

  • maxInt32Value menunjukkan tingkat penghangat maksimum.
  • minInt32Value HARUS 0 dan menunjukkan tidak ada penghangat.

Properti ini tidak berada dalam unit tertentu, tetapi berada dalam rentang setelan penghangat relatif yang telah ditentukan. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM memiliki opsi untuk menerapkannya sebagai VehiclePropertyAccess.READ

Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_STEERING_WHEEL_HEAT

Menyetel jumlah penghangat dan pendingin untuk setir. maxInt32Value dan minInt32Value di VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value dan maxInt32Value harus didukung. maxInt32Value menunjukkan setelan penghangat setir maksimum. minInt32Value harus 0, kecuali jika kendaraan juga mendukung pendingin setir. Dalam hal ini, minInt32Value menunjukkan setelan pendingin setir maksimum. Properti ini tidak berada dalam unit tertentu, tetapi dalam rentang setelan pemanas yang ditentukan. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ saja.

Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HVAC_SUHU_CURRENT

Suhu HVAC saat ini.

Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:CELSIUS
Rilis: Android 13

HVAC_SUHU_DISPLAY_UNITS

Satuan suhu untuk tampilan. Menunjukkan apakah suhu ditampilkan dalam Celcius atau Fahrenheit. VehiclePropConfig.configArray menunjukkan satuan tampilan suhu yang didukung. Misalnya, configArray[0] = CELSIUS configArray[1] = FAHRENHEIT Parameter ini MUNGKIN digunakan untuk menampilkan suhu HVAC apa pun dalam sistem. Nilai harus salah satu dari VehicleUnit.CELSIUS atau VehicleUnit.FAHRENHEIT

Jika memperbarui HVAC_SUHU_DISPLAY_UNITS memengaruhi nilai properti *_DISPLAY_UNITSlainnya, nilainya harus diperbarui dan disampaikan ke framework AAOS.

Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya hanya VehiclePropertyAccess.READ.

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleUnit
Jenis unit: T/A
Rilis: Android 13

HVAC_TEMPERATURE_SET

Suhu target HVAC disetel dalam Celcius.

minFloatValue dan maxFloatValue di VehicleAreaConfig harus ditentukan:

  • minFloatValue setelan suhu minimum dalam Celcius.
  • Setelan suhu maksimum maxFloatValue dalam Celsius.

Jika semua nilai antara minFloatValue dan maxFloatValue tidak didukung, gunakan configArray untuk mencantumkan nilai suhu valid yang dapat disetel. Ini juga menjelaskan tabel pencarian untuk mengonversi suhu dari Celsius ke Fahrenheit (dan sebaliknya) untuk kendaraan. configArray harus ditentukan jika konversi satuan standar tidak didukung di kendaraan.

configArray ditetapkan sebagai berikut:

  • configArray[0] [batas bawah suhu yang didukung dalam Celsius] * 10
  • configArray[1] [batas atas suhu yang didukung dalam Celcius] * 10
  • configArray[2] [kenaikan dalam Celsius] * 10
  • configArray[3] [batas bawah suhu yang didukung dalam Fahrenheit] * 10
  • configArray[4] [batas atas suhu yang didukung dalam Fahrenheit] * 10
  • configArray[5] [kenaikan dalam Fahrenheit] * 10

minFloatValue dan maxFloatValue di VehicleAreaConfig masing-masing harus sama dengan configArray[0] dan configArray[1]. Misalnya, jika kendaraan mendukung nilai suhu sebagai [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5] dalam Fahrenheit, configArray harus configArray = {160, 280, 5, 605, 845, 10}

Idealnya, rasio penambahan Celsius terhadap penambahan Fahrenheit harus mendekati rasio sebenarnya 1 derajat Celsius terhadap 1,8 derajat Fahrenheit. Harus ada pemetaan satu-ke-satu dari semua nilai Celsius ke nilai Fahrenheit yang ditentukan oleh configArray. configArray digunakan oleh klien untuk mengonversi suhu properti ini dari Celsius ke Fahrenheit. Selain itu, hal ini memungkinkan klien mengetahui nilai Celsius yang harus ditetapkan properti guna mencapai nilai Fahreneheit yang diinginkan untuk sistem. Jika ECU tidak memiliki pemetaan satu-ke-satu dari semua nilai Celcius ke nilai Fahrenheit, configArray hanya boleh menentukan daftar nilai Celcius dan Fahrenheit yang memiliki pemetaan satu-ke-satu.

Misalnya, jika ECU mendukung nilai Celsius dari 16 hingga 28 dan nilai Fahrenheit dari 60 hingga 85, masing-masing dengan kenaikan 1, maka satu kemungkinan configArray adalah kode >{160, 280, 10, 600, 840, 20}Dalam hal ini, 85 bukan suhu yang didukung.

Setiap nilai yang ditetapkan di antara nilai valid harus dibulatkan ke nilai valid terdekat. Sebaiknya OEM juga menerapkan properti kendaraan HVAC_TEMPERATURE_VALUE_SUGGESTION karena menyediakan metode sederhana bagi aplikasi untuk menentukan nilai suhu yang dapat ditetapkan untuk kendaraan dan untuk mengonversi nilai antara Celcius dan Fahrenheit.

Properti ini ditentukan sebagai VehiclePropertyAccess.READ, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: VehicleUnit:CELSIUS
Rilis: Android 13

HVAC_SUHU_VALUE_SUGGESTION

Nilai yang disarankan untuk menyetel suhu HVAC.

Terapkan properti ini untuk membantu aplikasi memahami nilai suhu terdekat yang didukung dalam Celsius atau Fahrenheit.

  • floatValues[0] Nilai yang diminta yang ingin ditetapkan aplikasi untuk suhu.
  • Unit floatValues[1] untuk floatValues[0] dan harus salah satu dari {VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
  • floatValues[2] Nilai OEM yang disarankan dalam CELSIUS (nilai ini tidak disertakan dalam permintaan).
  • floatValues[3] Nilai OEM yang disarankan dalam FAHRENHEIT (nilai ini tidak disertakan dalam permintaan).

Aplikasi memanggil set(VehiclePropValue propValue) dengan nilai dan unit yang diminta untuk nilai tersebut. OEM harus menampilkan nilai yang disarankan di floatValues[2] dan floatValues[3] dengan callback onPropertyEvent(). Nilai yang disarankan harus sesuai dengan nilai yang dapat berasal dari HVAC_TEMPERATURE_SET configArray Dengan kata lain, nilai yang disarankan dan tabel nilai dari configArray harus sama.

Sebaiknya OEM menambahkan logika kustom dalam penerapan VHAL mereka untuk menghindari pembuatan permintaan ke ECU HVAC. Logikanya bisa sebagai berikut. Untuk mengonversi suhu dari Celsius ke 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;

Misalnya, saat pengemudi menggunakan asisten suara untuk menyetel suhu HVAC ke 66,2 dalam Fahrenheit. Pertama, aplikasi menetapkan properti ini dengan nilai [66.2, (float)VehicleUnit.FAHRENHEIT,0,0] Jika OEM menyarankan untuk menyetel 19,0 dalam Celsius atau 66,5 dalam Fahrenheit atas permintaan pengguna, maka VHAL harus menghasilkan callback dengan nilai properti [66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5] Setelah asisten suara mendapatkan callback, OEM akan memberi tahu pengguna dan menyetel suhu HVAC ke nilai yang disarankan.

Contoh lain, aplikasi menerima 21 Celsius sebagai nilai suhu saat ini dengan membuat kueri HVC_TEMPERATURE_SET, tetapi aplikasi perlu mengetahui nilai yang ditampilkan di UI mobil dalam satuan Fahrenheit. Untuk ini, aplikasi menetapkan properti ke [21, (float)VehicleUnit.CELSIUS, 0, 0] Jika nilai yang disarankan oleh OEM untuk 21 Celcius adalah 70 Fahrenheit, VHAL harus menghasilkan callback dengan nilai properti [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0] Dalam hal ini, aplikasi dapat mengetahui bahwa nilainya adalah 70,0 Fahrenheit di UI mobil.

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HW_CUSTOM_INPUT

Menentukan peristiwa input partner OEM kustom. Peristiwa input ini harus digunakan oleh partner OEM yang ingin menyebarkan peristiwa yang tidak didukung oleh Android. Nilai ini hanya tersusun oleh array nilai int32. Properti Android adalah:

  • int32Values[0] Kode input yang mengidentifikasi fungsi yang mewakili peristiwa ini. Jenis peristiwa yang valid ditentukan oleh CustomInputType.CUSTOM_EVENT_F1 hingga CustomInputType.CUSTOM_EVENT_F10 Jenis peristiwa ini mewakili peristiwa kustom yang akan ditentukan oleh partner OEM.
  • int32Values[1] Jenis tampilan target yang ditentukan di VehicleDisplay Peristiwa yang tidak terikat dengan tampilan tertentu harus dikirim ke VehicleDisplay#MAIN
  • int32Values[2] Ulangi penghitung, jika 0 maka peristiwa tidak berulang. Nilai 1 atau yang lebih tinggi menunjukkan berapa kali peristiwa ini telah diulang.

Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: CustomInputType
Jenis unit: T/A
Rilis: Android 13

HW_KEY_INPUT

Properti untuk melakukan feed peristiwa input hardware ke Android.

  • int32Values[0] Tindakan yang ditentukan oleh VehicleHwKeyInputAction
  • Kode tombol int32Values[1], harus menggunakan kode tombol Android standar
  • int32Values[2] Tampilan target yang ditentukan di VehicleDisplay Peristiwa yang tidak terikat dengan tampilan tertentu harus dikirim ke VehicleDisplay#MAIN
  • int32Values[3] (Opsional) Jumlah jeda. Nilai harus sama dengan atau lebih besar dari 1. Jika dihilangkan, Android akan ditetapkan secara default ke 1.

Ubah mode: .ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

HW_KEY_INPUT_V2

Properti untuk melakukan feed peristiwa input hardware ke Android.

  • int32array[0] Tampilan target yang ditentukan oleh VehicleDisplay seperti:
    VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
  • Kode tombol int32array[1] harus menggunakan kode tombol Android standar, seperti KEYCODE_HOME dan KEYCODE_BACK
  • Tindakan int32array[2] yang ditentukan di VehicleHwKeyInputAction, seperti:
    VehicleHwKeyInputAction::ACTION_UP, VehicleHwKeyInputAction::ACTION_UP
  • int32array[3] Jumlah pengulangan peristiwa. Untuk peristiwa tombol turun, ini adalah jumlah berulang dengan tombol turun pertama dimulai dari 0 dan dihitung dari situ. Untuk peristiwa key-up, nilainya selalu sama dengan 0.
  • int64array[0] Periode nonaktif dalam nanodetik berlalu sejak booting terakhir. Menunjukkan waktu peristiwa tombol ditekan terbaru. Untuk peristiwa down, ini adalah waktu peristiwa dari peristiwa down.

Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14

HW_MOTION_INPUT

Properti untuk melakukan feed peristiwa input hardware ke Android.

  • int32array[0] Tampilan target yang ditentukan oleh VehicleDisplay, seperti:
    VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
  • int32array[1] Jenis input yang ditentukan di VehicleHwMotionInputSource, seperti:
    VehicleHwMotionInputSource::SOURCE_KEYBOARD, VehicleHwMotionInputSource::SOURCE_DPAD
  • int32array[2] Kode tindakan yang ditentukan di VehicleHwMotionInputAction, seperti:
    VehicleHwMotionInputAction::ACTION_UP, VehicleHwMotionInputAction::ACTION_DOWN
  • int32array[3] Flag status tombol ditentukan di VehicleHwMotionButtonStateFlag, seperti:
    VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY, VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
  • int32array[4] Jumlah peristiwa pointer, N. N harus berupa bilangan bulat positif.
  • int32array[5:5+N-1] ID pointer, panjang N
  • int32array[5+N:5+2*N-1] Jenis alat, panjang N. Seperti yang ditentukan dalam VehicleHwMotionToolType, seperti:
    VehicleHwMotionToolType::TOOL_TYPE_FINGER, VehicleHwMotionToolType::TOOL_TYPE_STYLUS
  • floatArray[0:N-1] x data, panjang N
  • Data y floatArray[N:2*N-1], panjang N
  • Data tekanan floatArray[2*N:3*N-1], panjang N
  • Data ukuran floatArray[3*N:4*N-1], panjang N
  • int64array[0] Waktu nonaktif, nanodetik yang berlalu sejak booting. Menunjukkan waktu ketika pengguna awalnya menekan untuk memulai aliran peristiwa posisi. Untuk peristiwa down, ini adalah waktu peristiwa down.

Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14

HW_ROTARY_INPUT

Properti untuk memasukkan peristiwa putar hardware ke Android.

  • int32Values[0] RotaryInputType untuk mengidentifikasi kenop putar mana yang diputar.
  • int32Values[1] Jumlah detent (klik), positif untuk searah jarum jam, negatif untuk berlawanan arah jarum jam.
  • int32Values[2] Tampilan target yang ditentukan di VehicleDisplay Peristiwa yang tidak terikat dengan tampilan tertentu harus dikirim ke VehicleDisplay#MAIN
  • int32values[3 .. 3 + abs(number of detents) - 2] Delta delta nanodetik antara pasangan detent berturut-turut jika jumlah deten lebih dari 1 atau kurang dari -1.
  • VehiclePropValue.timestamp Kapan rotasi terjadi. Jika jumlah detent lebih dari 1 atau kurang dari -1, saat penahanan rotasi pertama terjadi.

Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: RotaryInputType
Jenis unit: T/A
Rilis: Android 13

NEGARA_PENGHITUNGAN

Menyatakan status pengapian.

Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleIgnitionState
Jenis unit: T/A
Rilis: Android 13

Info_DriveR_SEAT

Implementasi VHAL lokasi kursi pengemudi harus mengabaikan areaId. Gunakan VehicleArea:GLOBAL

Mode perubahan: STATIC
Mode akses: READ
Jenis enum: VehicleAreaSeat
Jenis unit: T/A
Rilis: Android 13

INFO_EV_BATTERY_CAPACITY

Kapasitas baterai nominal untuk kendaraan EV atau kendaraan hybrid. Menampilkan kapasitas baterai nominal, EV, atau hybrid. Ini adalah total kapasitas baterai yang dapat digunakan saat kendaraan masih baru. Nilai ini mungkin berbeda dengan EV_CURRENT_BATTERY_CAPACITY karena EV_CURRENT_BATTERY_CAPACITY menampilkan kapasitas baterai yang dapat digunakan secara real-time dengan mempertimbangkan faktor-faktor seperti penuaan baterai dan dependensi suhu.

Ubah mode: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:WH
Rilis: Android 13

INFO_EV_CONNECTOR_TYPE

Daftar konektor yang dapat digunakan Kendaraan Listrik ini. Jika kendaraan memiliki beberapa port pengisian daya, properti ini harus menampilkan semua kemungkinan jenis konektor yang dapat digunakan oleh setidaknya satu port pengisian daya di kendaraan.

Ubah mode: STATIC
Mode akses: READ
Jenis enum: EvConnectorType
Jenis unit: T/A
Rilis: Android 13

INFO_EV_PORT_LOCATION

Properti ini harus menyampaikan lokasi port pengisian daya di Kendaraan Listrik menggunakan enum PortLocationType. Jika kendaraan memiliki beberapa port, properti ini harus menampilkan port yang memungkinkan pengisian daya tercepat. Untuk mengomunikasikan semua lokasi port, gunakan INFO_MULTI_EV_PORT_LOCATIONS

Lokasi port EV: STATIC
Mode akses: BACA
Jenis enum: PortLocationType
Jenis unit: T/A
Rilis: Android 13

INFO_EXTERIOR_DIMENSIONS

Dimensi eksterior kendaraan:

  • Tinggi: int32Values[0]
  • Durasi: int32Values[1]
  • Lebar: int32Values[2]
  • Lebar, termasuk cermin: int32Values[3]
  • Dudukan roda, termasuk spion: int32Values[4]
  • Lebar trek depan: int32Values[5]
  • Lebar lintasan belakang: int32Values[6]
  • Diameter belokan ke tepi jalan: int32Values[7]

Ubah mode: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLIMETER
Rilis: Android 13

INFO_FUEL_CAPAKIT

Kapasitas bahan bakar kendaraan dalam mililiter. Properti ini harus mengomunikasikan jumlah maksimum bahan bakar yang dapat disimpan di kendaraan dalam mililiter. Properti ini tidak berlaku untuk kendaraan listrik (EV). Artinya, jika INFO_FUEL_TYPE hanya berisi FuelType::FUEL_TYPE_ELECTRIC, INFO_FUEL_CAPACITY tidak boleh diterapkan. Untuk kendaraan listrik, terapkan INFO_EV_BATTERY_CAPACity.

Ubah mode: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLILITER
Rilis: Android 13

INFO_FUEL_DOOR_LOCATION

Lokasi pintu bahan bakar. Properti ini harus menyampaikan lokasi pintu bahan bakar pada kendaraan. Properti ini tidak berlaku untuk Kendaraan Listrik. Artinya, jika INFO_FUEL_TYPE hanya berisi FuelType::FUEL_TYPE_ELECTRIC, properti ini tidak boleh diterapkan. Untuk Kendaraan Listrik, implementasikan INFO_EV_PORT_LOCATION atau INFO_MULTI_LOCATIONS

Ubah mode: STATIC
Mode akses: READ
Jenis enum: PortLocationType
Jenis unit: T/A
Rilis: Android 13

INFO_FUEL_TYPE

Daftar bahan bakar yang dapat digunakan kendaraan. FuelType::FUEL_TYPE_ELECTRIC hanya boleh disertakan jika kendaraan dapat dicolokkan dan dapat diisi ulang. Misalnya, Kendaraan Listrik Hibrida Sepenuhnya (FHEV) tidak boleh menyertakan FuelType::FUEL_TYPE_ELECTRIC karena nilai INT32_VEC untuk INFO_FUEL_TYPE INFO_FUEL_TYPE dapat diisi seperti itu.

int32Values = { FuelType::FUEL_TYPE_UNLEADED }
 Di sisi lain, Kendaraan Listrik Hibrida (PHEV) Plug-in dapat diisi ulang plug-in dan harus menyertakan FuelType::FUEL_TYPE_ELECTRIC karena nilai INT32_VEC untuk INFO_FUEL_TYPE INFO_FUEL_TYPE dapat diisi sedemikian rupa, int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }

Mode perubahan: STATIC
Mode akses: READ
Jenis enum: FuelType
Jenis unit: T/A
Rilis: Android 13

INFO_BUAT

Produsen kendaraan. Properti ini harus menyampaikan nama merek publik kendaraan.

Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

INFO_MODEL

Model kendaraan. Properti ini harus menyampaikan nama model publik kendaraan.

Ubah mode: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

INFO_MODEL_YEAR

Tahun model kendaraan dalam format `YYYY` berdasarkan kalender Gregorian.

Ubah mode: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:YEAR
Rilis: Android 13

INFO_MULTI_EV_PORT_LOCATIONS

Beberapa lokasi pelabuhan EV. Terapkan properti ini jika kendaraan memiliki beberapa port Kendaraan Listrik Umum. Lokasi port ditentukan di PortLocationType. Misalnya, mobil memiliki satu port depan kiri dan satu port belakang kiri:

int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT

Jika kendaraan hanya memiliki satu port, nilai properti ini harus mencantumkan satu elemen. Untuk mendeskripsikan satu lokasi port, lihat INFO-EV-PORT-LOCATION

.

Mode perubahan: STATIC
Mode akses: READ
Jenis enum: PortLocationType
Jenis unit: T/A
Rilis: Android 13

Info_VIN

VIN kendaraan.

Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

INITIAL_USER_INFO

Menentukan pengguna Android yang akan digunakan selama inisialisasi. Properti ini dipanggil oleh sistem Android saat melakukan inisialisasi dan memungkinkan HAL menentukan pengguna Android mana yang harus dimulai. Permintaan ini dibuat dengan menetapkan VehiclePropValue (ditentukan oleh InitialUserInfoRequest), dan HAL harus merespons dengan peristiwa perubahan properti (ditentukan oleh InitialUserInfoResponse). Jika HAL tidak merespons setelah waktu yang ditentukan oleh sistem Android, sistem Android akan melanjutkan seolah HAL menampilkan respons tindakan InitialUserInfoResponseAction:DEFAULT. Misalnya, pada booting pertama, permintaannya adalah: 

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)
Jika HAL merespons dengan pembuatan pengguna admin yang disebut Pemilik, responsnya adalah: 
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
Nilai string mewakili beberapa nilai, yang dipisahkan oleh ||. Nilai pertama adalah lokalitas sistem (opsional) bagi pengguna yang akan dibuat (dalam hal ini jika kosong, artinya nilai tersebut menggunakan nilai default Android), sedangkan nilai kedua adalah nama (opsional) pengguna yang akan dibuat (jika jenis respons adalah InitialUserInfoResponseAction:CREATE). Misalnya, untuk membuat pengguna Owner yang sama dengan respons en-US dan pt-BRen,lokalitas respons string Dengan demikian, lokalitas maupun nama tidak boleh berisi dua batang vertikal (||) dalam nilainya, meskipun Anda dapat menggunakan satu batang vertikal (|).

Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13

J ke R

LANE_CENTERING_ASSIST_COMMAND

车道居中辅助 (LCA) 命令。此类命令用于启用和暂停 LCA。来自 LaneCenteringAssistCommand 的命令 ACTIVATE 发出时，LANE_CENTERING_ASSIST_STATE 必须设置为 LaneCenteringAssistState#ACTIVATION_REQUESTED。当 ACTIVATE 命令成功时，LANE_CENTERING_ASSIST_STATE 必须设置为 LaneCenteringAssistState#ACTIVATED。当来自 LaneCenteringAssistCommand 的命令 DEACTIVATE 成功时，LANE_CENTERING_ASSIST_STATE 必须设置为 LaneCenteringAssistState#ENABLED。

对于全局区域 ID (0)，必须定义 VehicleAreaConfig#supportedEnumValues，除非同时支持 LaneCenteringAssistCommand 的所有枚举值。如果此属性因 LCA 处于停用状态（例如 LANE_CENTERING_ASSIST_ENABLED 为 false）而不可用，则必须返回 StatusCode#NOT_AVAILABLE_DISABLED。如果实现了 LANE_CENTERING_ASSIST_STATE 且状态设置为 ErrorState 值，则此属性必须返回与 ErrorState 值一致的 StatusCode。例如，如果 LANE_CENTERING_ASSIST_STATE 设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW，则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：LaneCenteringAssistCommand
单位类型：无
版本：Android 14

LANE_CENTERING_ASSIST_ENABLED

启用或停用车道居中辅助 (LCA)。设置为 true 表示启用 LCA，设置为 false 表示停用 LCA。当 LCA 处于启用状态时，车辆中的 ADAS 系统应处于开启状态并等待来自驾驶员的启用信号。此功能启用后，ADAS 系统应驾驶车辆，使其保持在当前车道中间行驶。

这与车道保持辅助 (LKA) 不同，后者用于监测驾驶员是否无意中向车道标线偏移或越过车道标线。如果检测到车道意外偏离，系统会应用转向控制让车辆返回到当前车道。一般来说，LANE_CENTERING_ASSIST_ENABLED 应始终返回 true 或 false。 如果该功能因某种临时状态（例如车速过慢或过快）而不可用，则必须通过 LANE_CENTERING_ASSIST_STATE 属性中的 ErrorState 值传达此信息。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

LANE_CENTERING_ASSIST_STATE

车道居中辅助 (LCA) 状态。返回 LCA 的当前状态。此属性必须始终返回 LaneCenteringAssistState 或 ErrorState 中定义的有效状态。它不得通过 StatusCode 显示错误，而必须改用受支持的错误状态。

如果 LCA 包含车道偏离警告，这些警告必须通过车道偏离警告 (LDW) 属性显示。

对于全局区域 ID (0)，必须定义 VehicleAreaConfig#supportedEnumValues 数组，除非同时支持 LaneCenteringAssistState（包括不推荐的 OTHER）和 ErrorState 的所有状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：LaneCenteringAssistState/ErrorState
单位类型：无
版本：Android 14

LANE_DEPARTURE_WARNING_ENABLED

启用或停用车道偏离警告 (LDW)。设置为 true 表示启用 LDW，设置为 false 表示停用 LDW。当 LDW 处于启用状态时，车辆中的 ADAS 系统应保持开启，并监测车辆是否接近或越过车道线；如果是，则会发出警告。

一般来说，LANE_DEPARTURE_WARNING_ENABLED 应始终返回 true 或 false。 如果该功能因某种临时状态（例如车速过慢或过快）而不可用，则必须通过 LANE_DEPARTURE_WARNING_STATE 属性中的 ErrorState 值传达此信息。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

LANE_DEPARTURE_WARNING_STATE

车道偏离警告 (LDW) 状态。返回 LDW 的当前状态。此属性必须始终返回 LaneDepartureWarningState 或 ErrorState 中定义的有效状态。它不得通过 StatusCode 显示错误，而必须改用受支持的错误状态。

对于全局区域 ID (0)，必须定义 VehicleAreaConfig#supportedEnumValues 数组，除非同时支持 LaneDepartureWarningState（包括不推荐的 OTHER）和 ErrorState 的所有状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：LaneDepartureWarningState/ErrorState
单位类型：无
版本：Android 14

LANE_KEEP_ASSIST_ENABLED

启用或停用车道保持辅助 (LKA)。设置为 true 表示启用 LKA，设置为 false 表示停用 LKA。当 LKA 处于启用状态时，车辆中的 ADAS 系统应保持开启，并监测驾驶员是否无意中向车道标线偏移或越过车道标线。如果检测到车道意外偏离，系统会应用转向控制让车辆返回到当前车道。这与车道居中辅助 (LCA) 不同，LCA 在启用后会应用连续转向控制，让车辆保持在当前车道中间行驶。

一般来说，LANE_KEEP_ASSIST_ENABLED 应始终返回 true 或 false。 如果该功能因某种临时状态（例如车速过慢或过快）而不可用，则必须通过 LANE_KEEP_ASSIST_STATE 属性中的 ErrorState 值传达此信息。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

LANE_KEEP_ASSIST_STATE

车道保持辅助 (LKA) 状态。返回 LKA 的当前状态。此属性必须始终返回 LaneKeepAssistState 或 ErrorState 中定义的有效状态。它不得通过 StatusCode 显示错误，而必须改用受支持的错误状态。

如果 LKA 包含在应用转向修正之前发出车道偏离警告，这些警告必须通过车道偏离警告 (LDW) 属性显示。

对于全局区域 ID (0)，必须定义 VehicleAreaConfig#supportedEnumValues 数组，除非同时支持 LaneKeepAssistState（包括不推荐的 OTHER）和 ErrorState 的所有状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：LaneKeepAssistState/ErrorState
单位类型：无
版本：Android 14

LOCATION_CHARACTERIZATION

对用于计算位置的输入内容的特性描述。此属性必须指明：系统在计算通过 GNSS HAL 与 Android 共享的车辆位置信息时会考虑哪些数据和传感器输入（如果有）。

该值必须返回一组位标志。位标志在 LocationCharacterization 中定义。该值还必须在其位标志集合中确切包含 DEAD_RECKONED 或 RAW_GNSS_ONLY 之一。

如果不支持此属性，则假定没有其他传感器输入会融合到通过 GNSS HAL 提供的 GNSS 更新中。除非通过 GNSS HAL 接口另行指定。

更改模式：STATIC
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 14

MIRROR_AUTO_FOLD_ENABLED

表示车镜自动折叠功能的属性。当启用自动折叠车辆侧视镜的功能（例如当驾驶员离开并锁车后，车镜自动向内折叠）时，此属性为 true。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

MIRROR_AUTO_TILT_ENABLED

表示车镜自动倾斜功能的属性。当启用自动倾斜车辆侧视镜的功能（例如当驾驶员倒车时，车镜自动向下倾斜）时，此属性为 true。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

MIRROR_FOLD

车镜折叠。true 表示车镜已折叠。此属性被定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

MIRROR_LOCK

车镜锁定。true 表示车镜位置已锁定且不可更改。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

MIRROR_Y_MOVE

车镜在 Y 轴上的移动。必须定义每个 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。 必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。

maxInt32Value 表示车镜在向右倾斜时的最快移动速度。minInt32Value 表示车镜在向左倾斜时的最快移动速度。

绝对值越大（无论是正值还是负值），表示移动速度就越快。车镜达到位置极限后，该值必须重置为 0。如果 MIRROR_Y_MOVE 的值目前为 0，则表示目前没有发生任何移动。

此属性不采用任何特定单位，而是采用相对移动速度的指定范围。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

MIRROR_Y_POS

车镜在 Y 轴上的位置。必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。 必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。minInt32Value 表示车镜完全向左倾斜。

此值必须为非正值。maxInt32Value 表示车镜完全向右倾斜。此值必须为非负值。0 表示镜子没有向任一方向倾斜。

如果值介于 minInt32Value 和 maxInt32Value 之间，表示车镜处于左极限位置和右极限位置之间的过渡状态。

此属性不采用任何特定单位，而是采用相对位置的指定范围。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

MIRROR_Z_MOVE

车镜在 Z 轴上的移动。必须定义每个 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。 必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。

maxInt32Value 表示车镜在向上倾斜时的最快移动速度。minInt32Value 表示车镜在向下倾斜时的最快移动速度。绝对值越大（无论是正值还是负值），表示移动速度就越快。车镜达到位置极限后，该值必须重置为 0。如果 MIRROR_Z_MOVE 的值目前为 0，则表示目前没有发生任何移动。

此属性不采用任何特定单位，而是采用相对移动速度的指定范围。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

MIRROR_Z_POS

车镜在 Z 轴上的位置。必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。 必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。minInt32Value 表示车镜完全向下倾斜。此值必须为非正值。maxInt32Value 表示车镜完全向上倾斜。此值必须为非负值。0 表示车镜没有向任一方向倾斜。

如果值介于 minInt32Value 和 maxInt32Value 之间，表示车镜处于完全向下位置和完全向上位置之间的过渡状态。

此属性不采用任何特定单位，而是采用相对位置的指定范围。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

NIGHT_MODE

true 表示夜间模式传感器检测到车厢环境光线较弱。例如，平台可以利用此信息启用适当的界面，以便在黑暗或弱光环境中获得更好的视效。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

OBD2_FREEZE_FRAME

报告在故障发生并被检测到时可用的 OBD2 传感器值的快照。提供的 configArray 的含义必须与为 OBD2_LIVE_FRAME 定义的含义相同

此属性的值的解读方式与 OBD2_LIVE_FRAME 类似，只不过 stringValue 字段可能包含非空的诊断问题排查代码 (DTC)。

此属性的 IVehicle#get 请求必须为 int64Values[0] 提供值。系统会将其解读为要检索的冻结帧的时间戳。可以通过 IVehicle#get 方法获取 OBD2_FREEZE_FRAME_INFO，来获得时间戳列表。

如果在给定时间戳处没有可用的冻结帧，实现必须返回 NOT_AVAILABLE 响应。由于车辆的冻结帧存储空间可能有限，因此即使最近通过 OBD2_FREEZE_FRAME_INFO 获取了关联的时间戳，帧请求也可能会以 NOT_AVAILABLE 进行响应。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

OBD2_FREEZE_FRAME_CLEAR

清除冻结帧。报告在故障发生并被检测到时可用的 OBD2 传感器值的快照。提供的 configArray 的含义必须与为 OBD2_LIVE_FRAME 定义的含义相同

此属性的值的解读方式与 OBD2_LIVE_FRAME 类似，只不过 stringValue 字段可能包含非空的诊断问题排查代码 (DTC)。

此属性的 IVehicle#get 请求必须为 int64Values[0] 提供值。系统会将其解读为要检索的冻结帧的时间戳。可以通过 IVehicle#get 方法获取 OBD2_FREEZE_FRAME_INFO，来获得时间戳列表。

如果在给定时间戳处没有可用的冻结帧，实现必须返回 NOT_AVAILABLE 响应。由于车辆的冻结帧存储空间可能有限，因此即使最近通过 OBD2_FREEZE_FRAME_INFO 获取了关联的时间戳，帧请求也可能会以 NOT_AVAILABLE 响应

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：无
单位类型：无
版本：Android 13

OBD2_FREEZE_FRAME_INFO

此属性描述了存储在车辆内存中且可通过 OBD2_FREEZE_FRAME 检索的当前冻结帧。这些值的解读如下。int64Values 的每个元素都必须是检测到故障代码并存储相应冻结帧的时间戳，并且每个此类元素都可以用作 OBD2_FREEZE_FRAME 的键来检索相应的冻结帧。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

OBD2_LIVE_FRAME

报告可用 OBD2 传感器的当前（实时）值的快照。configArray 的设置如下所示：

  • configArray[0] 供应商特定的整数值传感器的数量
  • configArray[1] 供应商特定的浮点值传感器的数量

此属性的值应按以下示例进行解读。考虑 configArray = {2,3} int32Values 必须是一个包含 Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX 和两个元素（即 33 个元素）的向量。floatValues 必须是一个包含 Obd2FloatSensorIndex.LAST_SYSTEM_INDEX 和三个元素（即 73 个元素）的向量。

每个帧都可能包含不同的传感器值子集，既有系统提供的传感器，又有特定供应商的传感器。为了支持这一点，属性值的字节元素会用作位掩码。字节数必须足以表示可能的传感器总数（在本例中，14 个字节表示 106 个可能的值）。它应被读取为连续的位掩码，以便每个位都表示帧中是否存在传感器，从与 int32Values 大小相同数量的位开始，紧接着读取与 floatValues 大小相同数量的位。

例如，如果 bytes[0] = 0x4C (0b01001100)，则表示：

  • int32Values[0 and 1] 不是有效的传感器值
  • int32Values[2 and 3] 是有效的传感器值
  • int32Values[4 and 5] 不是有效的传感器值
  • int32Values[6] 是有效的传感器值
  • int32Values[7] 不是有效的传感器值
  • int32Values[0 and 1] 不是有效的传感器值
  • int32Values[2 and 3] 是有效的传感器值
  • int32Values[4 and 5] 不是有效的传感器值
  • int32Values[6] 是有效的传感器值
  • int32Values[7] 不是有效的传感器值

如果 bytes[5] = 0x61 (0b01100001)，则：

  • int32Values[32] 是有效的传感器值
  • floatValues[0 thru 3] 是无效的传感器值
  • floatValues[4 and 5] 是有效的传感器值
  • floatValues[6] 不是有效的传感器值。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

ON_CHANGE

更改模式：
访问模式：READ_WRITE/READ
枚举类型： VehicleLightSwitch
单位类型：无
版本：Android 13

PARKING_BRAKE_AUTO_APPLY

自动应用驻车制动。如果为 true，此属性表示汽车的自动驻车制动功能已启用。false 表示汽车的自动驻车制动功能已停用。此属性经常与 PARKING_BRAKE_ON 混淆。区别在于 PARKING_BRAKE_ON 表示实际驻车制动处于开启还是关闭状态；而 PARKING_BRAKE_AUTO_APPLY 表示自动驻车制动功能处于启用还是停用状态，并不描述实际驻车制动的当前状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

PARKING_BRAKE_ON

驻车制动状态。如果此属性为 true，表示汽车的驻车制动已启用。false 表示汽车的驻车制动处于解除状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

PER_DISPLAY_BRIGHTNESS

此属性用于表示单独受控制的显示屏的亮度。某些汽车有一个或多个亮度可单独控制的显示屏，此属性用于告知每个乘客显示屏的亮度。如果所有显示屏的亮度都一起受控，汽车必须使用 DISPLAY_BRIGHTNESS

应仅实现 PER_DISPLAY_BRIGHTNESS 和 PER_DISPLAY_BRIGHTNESS 中的一项。如果这两者都可用，AAOS 会使用 PER_DISPLAY_BRIGHTNESS。

显示屏端口唯一性地标识设备上针对显示屏输出的实体连接器，范围从 0 到 255。

  • int32Values[0] 显示屏端口
  • int32Values[1] 亮度

更改模式：ON_CHANGE
访问模式：READ_WRITE
枚举类型：无
单位类型：无
版本：Android 14

PERF_ODOMETER

车辆的当前里程表值。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:KILOMETER
版本：Android 13

PERF_REAR_STEERING_ANGLE

车辆的自行车模型后轮转向角度。角度以度为单位。左侧为负数。 此属性与方向盘的角度无关。此属性必须传达后轮相对于车辆的角度，而不是方向盘的角度。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:DEGREES
版本：Android 13

PERF_STEERING_ANGLE

车辆的自行车模型前轮转向角度。角度以度为单位。左侧为负数。此属性与方向盘的角度无关。此属性必须传达前轮相对于车辆的角度，而不是方向盘的角度。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:DEGREES
版本：Android 13

PERF_VEHICLE_SPEED

车辆的速度。当车辆前进时，该值必须为正值；当车辆倒车时，该值必须为负值。此值与档位值（CURRENT_GEAR 或 GEAR_SELECTION）无关。例如，如果 GEAR_SELECTION 为 GEAR_NEUTRAL，则 PERF_VEHICLE_SPEED 在车辆前进时为正数，在车辆倒车时为负数，在车辆不动时为零。

更改模式：CONTINUOUS
访问模式：READ
单位类型：无
单位类型：VehicleUnit:METER_PER_SEC
版本：Android 13

PERF_VEHICLE_SPEED_DISPLAY

显示屏上车辆的速度，某些汽车的速度表上显示的速度会比实际速度略慢。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:METER_PER_SEC
版本：Android 13

POWER_POLICY_GROUP_REQ

定义了一项请求，用于设置电源策略组，以便在每次电源状态转换时决定默认电源策略。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

POWER_POLICY_REQ

定义应用电源策略的请求。VHAL 会设置此属性以更改汽车电源策略。汽车电源策略服务会订阅此属性，并实际更改电源策略。该请求是通过使用在 /vendor/etc/automotive/power_policy.xml 中定义的电源策略的 ID 设置 VehiclePropValue 来发出的。如果未定义给定 ID，汽车电源策略服务会忽略该请求，并保持当前电源策略。

string: "sample_policy_id" // power policy ID

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

POWER_POLICY_GROUP_REQ

定义了一项请求，用于设置电源策略组，以便在每次电源状态转换时决定默认电源策略。VHAL 使用电源策略组的 ID 设置此属性，以设置在电源状态转换时应用的默认电源策略。电源策略组在 /vendor/etc/power_policy.xml 中定义。如果未定义给定 ID，汽车电源策略服务会忽略该请求。汽车电源策略服务会订阅此属性并设置电源策略组。当系统电源状态发生变化且有针对新电源状态的有效映射电源策略时，系统会实际应用电源策略。

string: "sample_policy_group_id" // power policy group ID

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

RANGE_REMAINING

剩余续航里程。剩余燃料和电量可行驶的里程数（以米为单位）。剩余续航里程应考虑车辆中的所有能量来源。例如，混动车的续航里程是基于燃油和电池的续航里程之和。此属性定义为 VehiclePropertyAccess.READ_WRITE，因为导航应用如果能根据后续路线得到更准确的估算值，便可能会更新续航里程。此属性可由 OEM 自行决定实现为仅 VehiclePropertyAccess.READ。

更改模式：CONTINUOUS
访问模式：READ_WRITE
枚举类型：无
单位类型：VehicleUnit:METER
版本：Android 13

READING_LIGHTS_STATE

返回阅读灯的当前状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：无
版本：Android 13

READING_LIGHTS_SWITCH

用于控制阅读灯的开关。如果灯开着是因为门打开了或因为语音指令，则可能与 READING_LIGHTS_STATE 不同。例如，当开关处于关闭或自动位置时。此属性被定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

REAR_FOG_LIGHTS_STATE

返回后雾灯的当前状态。只能实现 FOG_LIGHTS_STATE 或 REAR_FOG_LIGHTS_STATE 之一。请参见 FOG_LIGHTS_STATE

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：无
版本：Android 13

REAR_FOG_LIGHTS_SWITCH

用户所需的设置。必须实现 FOG_LIGHTS_SWITCH 或 REAR_FOG_LIGHTS_SWITCH 中的一个。如需了解详情，请参阅 FOG_LIGHTS_SWITCH。此属性被定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：无
版本：Android 13

REMOVE_USER

在某个 Android 用户被移除后由 Android 系统调用。HAL 可以使用此属性来移除相应的用户。这是只写调用。Android 系统不会预期 HAL 发来回复。因此，此请求不应失败。如果无法移除相应 HAL 用户，则 HAL 应将其标记为非活跃状态或通过另一方式恢复。

该请求是通过使用 RemoveUserRequest 定义的内容设置 VehiclePropValue 来发出的。例如，如果系统有 3 位用户（0、10 和 11），并且移除了用户 11，请求如下所示：

  • int32[0] 42 // 请求 ID
  • int32[1] 11 //（被移除用户的 Android 用户 ID）
  • int32[2] 0 //（被移除用户的 Android 用户标志）
  • int32[3] 10 // 当前用户
  • int32[4] 0 // 当前用户标志（无）
  • int32[5] 2 // 用户数量
  • int32[6] 0 // 第一位用户（用户 0）
  • int32[7] 0 // 第一位用户标志（无）
  • int32[8] 10 // 第二位用户（用户 10）
  • int32[9] 0 // 第二位用户标志（无）

更改模式：STATIC
访问模式：WRITE
枚举类型：无
单位类型：无
版本：Android 13

S ke Z

SEAT_AIRBAG_ENABLED

表示座椅在安全气囊被触发时（例如在发生碰撞时）展开安全气囊的功能是处于启用还是停用状态。如果为 true，则表示座椅的安全气囊处于启用状态，并且在被触发后会展开。如果为 true，则表示座椅的安全气囊处于停用状态，并且在任何情况下都不会展开。此属性不会指明安全气囊是否处于展开状态。

为了遵守法规或出于安全考虑，可以将此属性设置为 VehiclePropertyAccess.READ 只读。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无 单位类型：无
版本：Android 13

SEAT_BACKREST_ANGLE_2_POS

座椅靠背角度 2 位置。靠背角度 2 是指到达座椅底部向上的下一个致动器时的角度。

必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。

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
枚举类型：无
单位类型：无
版本：Android 13

SEAT_BELT_BUCKLED

安全带已系好。true 表示安全带已系好。写入访问权限表示座椅具有自动系好安全带的功能。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 14

SEAT_CUSHION_SIDE_SUPPORT_POS

表示座椅臀部侧面（底部座垫侧面）支撑位置的属性。

必须定义每个 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。

maxInt32Value 表示座垫侧面支撑处于最宽位置（例如支撑最小）。minInt32Value 表示座垫侧面支撑处于最窄位置（例如支撑最大）。

如果值介于 minInt32Value 和 maxInt32Value 之间，则表示处于最窄位置和最宽位置之间的过渡状态。

此属性以指定范围的相对位置来表示。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 <covehiclepropertyaccess.read< code="">。</covehiclepropertyaccess.read<>

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 13

SEAT_DEPTH_POS

座椅深度位置。设置座椅深度，即从座椅靠背到座椅前缘的距离。

必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。

minInt32Value 表示座椅处于最浅位置（例如座垫前缘与座椅后端之间距离最小时的位置）。

maxInt32Value 表示座椅处于最深位置（例如座垫前缘与座椅后端之间距离最大时的位置）。

如果值介于 minInt32Value 和 maxInt32Value 之间，则表示处于最浅位置和最深位置之间的过渡状态。

此属性以指定范围的相对位置来表示。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 <covehiclepropertyaccess.read< code="">。</covehiclepropertyaccess.read<>

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

SEAT_EASY_ACCESS_ENABLED

表示座椅便捷进出功能的属性。如果为 true，则表示座椅会自动调整，以方便人员更轻松地进出车辆。每个区域 ID 都必须映射到用户在尝试借助便捷进出功能坐入/离开的座椅。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 <covehiclepropertyaccess.read< code="">。</covehiclepropertyaccess.read<>

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

SEAT_FOOTWELL_LIGHTS_STATE

表示座椅脚窝灯状态的属性。SEAT_FOOTWELL_LIGHTS_STATE 反映灯在任意时间点的当前状态。这与 SEAT_FOOTWELL_LIGHTS_SWITCH 的功能不同，后者表示控制灯的开关的位置。

因此， SEAT_FOOTWELL_LIGHTS_STATE 可能与 SEAT_FOOTWELL_LIGHTS_SWITCH 的值不一致（例如 SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC 和 SEAT_FOOTWELL_LIGHTS_SWITCH=ON）。

仅当 SEAT_FOOTWELL_LIGHTS_STATE 的值可能与 CABIN_LIGHTS_STATE 的值不同时，才应实现此属性。

对于每个受支持的区域 ID，必须定义 VehicleAreaConfig#supportedEnumValues，除非支持 VehicleLightState 的所有枚举值。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：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，必须定义 VehicleAreaConfig#supportedEnumValues，除非支持 VehicleLightSwitch 的所有枚举值。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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="">。</covehiclepropertyaccess.read<>

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 13

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
枚举类型：无
单位类型：无
版本：Android 13

SEAT_HEADREST_HEIGHT_POS

（已废弃）头枕高度位置。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 14

SEAT_HEIGHT_MOVE

座椅高度移动。必须定义每个 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。

maxInt32Value 表示座椅在向上移动时的最快移动速度。

minInt32Value 表示座椅在向下移动时的最快移动速度。

绝对值越大（无论是正值还是负值），表示移动速度就越快。座椅达到位置极限后，该值必须重置为 0。如果 SEAT_HEIGHT_MOVE 的值为 0，则表示没有进行任何移动。

此属性以指定范围的相对移动速度来表示。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 13

SEAT_MEMORY_SELECT

此参数用于选择内存预设，以便在选择座椅位置时使用。必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。minInt32Value 始终为 0，maxInt32Value 用于确定可用的座椅预设内存槽位数（例如 numSeatPresets - 1）。例如，如果驾驶员座椅有三个内存预设，则 maxInt32Value 为 2。当用户选择预设时，系统会设置所需的预设数（0、1 或 2）。

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：无
单位类型：无
版本：Android 13

SEAT_MEMORY_SET

通过此设置，用户可以将当前座椅位置设置保存到所选的预设槽位。必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。minInt32Value 必须为 0，并且每个座椅位置的 maxInt32Value 必须与 SEAT_MEMORY_SELECT 的 maxInt32Value 一致

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：无
单位类型：无
版本：Android 13

SEAT_OCCUPANCY

根据汽车做出的最佳判断，指明特定座椅是否被占用。有效值来自 VehicleSeatOccupancyState 枚举。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 14

SEAT_WALK_IN_POS

此属性用于表示座椅当前的进入位置。minInt32Value 表示正常座椅位置。minInt32Value 必须是 0。maxInt32Value 表示座椅处于完全进入位置。

如果值介于 minInt32Value 和 maxInt32Value 之间，则表示处于正常位置和进入位置之间的过渡状态。

此属性以指定范围的相对位置来表示。

区域 ID 必须与启用便捷进入功能时实际移动的座椅匹配，而不是与乘客打算坐入的座椅匹配。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以

将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 14

STEERING_WHEEL_EASY_ACCESS_ENABLED

已启用方向盘方便进出功能。如果为 true，驾驶员的方向盘会自动调整，以便驾驶员更轻松地进出车辆。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：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)，必须定义 VehicleAreaConfig#supportedEnumValues，除非支持 VehicleLightState 的所有枚举值。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：无
版本：Android 14

STEERING_WHEEL_LIGHTS_SWITCH

方向盘灯开关。表示控制方向盘灯的开关的位置。这与表示方向盘灯当前状态的属性不同。因此，STEERING_WHEEL_LIGHTS_SWITCH 可能与 STEERING_WHEEL_LIGHTS_STATE 的值不一致。例如 STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC 和 STEERING_WHEEL_LIGHTS_STATE=ON。

仅当 STEERING_WHEEL_LIGHTS_SWITCH 的值可能与 CABIN_LIGHTS_SWITCH 的值不同时，才应实现此属性。

对于全局区域 ID (0)，必须定义 VehicleAreaConfig#supportedEnumValues，除非支持 VehicleLightSwitch 的所有枚举值。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：无
版本：Android 14

STEERING_WHEEL_LOCKED

方向盘已锁定。如果为 true，则方向盘位置已锁定且不可更改。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 <covehiclepropertyaccess.read< code="">。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

STEERING_WHEEL_THEFT_LOCK_ENABLED

已启用方向盘防盗锁功能。如果为 true，方向盘会在某些情况下自动锁定以防止车辆被盗。此属性被定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 14

STORAGE_ENCRYPTION_BINDING_SEED

外部加密绑定种子。此值与本地密钥存储加密密钥混合使用。此属性会保存 16 个字节，并且应保留在与 IVI 分开的 ECU 上。此属性最初是由 AAOS 设置的，后者使用 CSRNG 生成此属性。然后，AAOS 会在后续启动时读取此属性。应可靠地保存绑定种子。任何丢失种子的行为都会导致需要将 IVI 恢复出厂设置。

更改模式：ON_CHANGE
访问模式：READ_WRITE
枚举类型：无
单位类型：无
版本：Android 13

SUPPORT_CUSTOMIZE_VENDOR_PERMISSION

支持为供应商属性自定义权限。

如果 VHAL 支持自定义供应商权限功能，请实现此属性。VehiclePropConfig.configArray 用于指明供应商属性以及为此供应商属性选择的权限。权限必须是 VehicleVendorPermission 中的枚举项之一。configArray 的设置如下：configArray[n]: propId : property ID 用于供应商属性，其中 configArray[n+1] 是 VehicleVendorPermission 中的枚举项，表示属性值读取权限。

configArray[n+2] 是 VehicleVendorPermission 中的枚举项，表示属性值写入权限。例如：

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
枚举类型：无
单位类型：无
版本：Android 13

SUPPORTED_PROPERTY_IDS

（已废弃）一个列表，列出所有受支持的属性 ID。

更改模式：STATIC
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 14

SWITCH_USER

定义切换前台 Android 用户的请求。

此属性主要供 Android 系统用于通知 HAL 将切换当前的前台 Android 用户，但 HAL 也可以使用此属性请求 Android 系统切换用户。当 Android 发出请求时，系统会设置 VehiclePropValue，并且 HAL 必须通过属性更改事件进行响应。HAL 发出请求时，还必须通过属性更改事件发出请求（主要区别在于，前者的请求 ID 为正数，后者为负数）。SwitchUserMessageType 也不同。

这两种请求的格式均由 SwitchUserRequest 定义，响应的格式（如有需要）则由 SwitchUserResponse 定义。HAL（或 Android 系统）应如何继续执行取决于消息类型（由 SwitchUserMessageType 参数定义），定义如下。
  • LEGACY_ANDROID_SWITCH 由 Android 系统调用，用于指明 Android 用户即将更改，前提是更改请求的发出方式不同于集成 HAL 的方式（例如通过 adb shell am switch-user）。收到此请求后，HAL 可以切换其内部用户，但无需回复 Android 系统。如果出于某种原因无法更改其内部用户，则必须等待 SWITCH_USER(type=ANDROID_POST_SWITCH) 调用以进行恢复（例如，它可以发出 SWITCH_USER(type=VEHICLE_REQUEST) 以切换回上一个用户）。理想情况下，它永远不应失败（因为切换回来可能会让最终用户感到困惑）。
    例如，如果系统有多个用户（0、10、11），并且要从 0 切换到 11（其中没有任何特殊标志），请求将如下所示：
    • int32[0] 42 // 请求 ID
    • int32[1] 1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCH
    • int32[2] 11 // 目标用户 ID
    • int32[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) 向 Android 做出响应，指明其内部用户是否已切换（通过 SwitchUserStatus 枚举）。例如，如果 Android 有多个用户（0、10、11），并且要从 10 切换到 11（其中没有任何特殊标志），请求将如下所示：
    • int32[0] 42 // 请求 ID
    • int32[1] 2 // SwitchUserMessageType::ANDROID_SWITCH
    • int32[2] 11 // 目标用户 ID
    • int32[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 // 请求 ID
    • int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
    • int32[2] 1 // status: SwitchUserStatus::SUCCESS

    如果请求失败了，响应将如下所示：

    • int32[0] 42 // 请求 ID
    • int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
    • int32[2] 2 // status: SwitchUserStatus::FAILURE string: "108-D'OH!"
    • OEM 专属错误消息
  • VEHICLE_RESPONSE 由 HAL 调用，用于指明 ANDROID_SWITCH 类型的请求是应继续还是中止。另请参阅 ANDROID_SWITCH。
  • VEHICLE_REQUEST 由 HAL 调用，用于请求切换当前的前台 Android 用户。若 Android 以某个用户的身份启动，但车辆将驾驶员识别为其他用户，此方法非常有用。例如，用户 A 通过用户 B 的遥控钥匙解锁了汽车。INITIAL_USER_INFO 请求返回了用户 B，但随后面部识别子系统将用户识别为 A。HAL 通过属性更改事件（传递负请求 ID）发出此请求，而 Android 系统响应是发出具有相同请求 ID 的 ANDROID_POST_SWITCH 调用。例如，如果当前的前台 Android 用户是 10，并且 HAL 要求切换到 11，请求将如下所示：
    • int32[0] -108 // 请求 ID
    • int32[1] 4 // messageType: SwitchUserMessageType::VEHICLE_REQUEST
    • int32[2] 11 // Android 用户 ID

    如果请求成功，并且 Android 有 3 个用户（0、10 和 11），响应将如下所示：

    • int32[0] -108 // 请求 ID
    • int32[1] 5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCH
    • int32[2] 11 // 目标用户 ID
    • int32[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
枚举类型：无
单位类型：无
版本：Android 13

TIRE_PRESSURE

胎压。每个轮胎都通过其 areaConfig.areaId 配置进行标识。相应的 minFloatValue 和 maxFloatValue 用于存储 OEM 建议的胎压范围。必须定义 VehicleAreaConfig 中的 minFloatValue 和 maxFloatValue 的值。

areaConfig 数据中的 minFloatValue 表示建议的胎压下限。areaConfig 数据中的 maxFloatValue 表示建议的胎压上限。例如，此 areaConfig 表示左前轮胎的建议胎压为 200.0kPa 到 240.0kPa。

.areaConfigs: { VehicleAreaConfig { .areaId: VehicleAreaWheel::LEFT_FRONT, .minFloatValue: 200.0, .maxFloatValue: 240.0, } }

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:KILOPASCAL
版本：Android 13

TIRE_PRESSURE_DISPLAY_UNITS

胎压显示单位。表示汽车使用哪些单位向用户显示胎压。例如 PSI、Bar 或千帕。VehiclePropConfig.configArray 用于指明支持的胎压显示单位。胎压单位在 VehicleUnit 中定义。例如 configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR

如果更新 TIRE_PRESSURE_DISPLAY_UNITS 会影响其他 *_DISPLAY_UNITS 属性的值，则必须更新这些属性的值，并将这些值也传达给 AAOS 框架。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 <covehiclepropertyaccess.read< code="">。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleUnit
单位类型：无
版本：Android 13

TRACTION_CONTROL_ACTIVE

当牵引力控制 (TC) 处于启用状态时设置为 true，当 TC 处于停用状态时重置为 false。此属性可根据 TC 系统的实时状态间歇性设置（脉冲式）。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

TRAILER_PRESENT

返回汽车的拖车状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：TrailerState
单位类型：无
版本：Android 13

TURN_SIGNAL_STATE

车辆转向指示灯的状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleTurnSignal
单位类型：无
版本：Android 13

USER_IDENTIFICATION_ASSOCIATION

此属性用于将当前用户与车辆专用身份识别机制（例如遥控钥匙）相关联（或查询关联）。

这是一个可选的用户管理属性。OEM 仍可以在不定义此属性的情况下支持用户管理。事实上，即使不支持 INITIAL_USER_INFO 中所述的核心用户相关功能，也可以使用此属性。

为了查询关联，Android 系统会获取此属性，并传递一个 VehiclePropValue，其中包含要查询的关联的类型（由 UserIdentificationGetRequest 定义）。HAL 必须立即通过 UserIdentificationResponse 返回 VehiclePropValue。

请注意，用户身份识别是在系统启动时进行的。VHAL 实现应仅返回已识别的关联（例如用于解锁汽车的遥控钥匙），而非通过 get 调用开始建立新的关联。

为了关联类型，Android 系统会设置此属性，并传递一个 VehiclePropValue，其中包含要设置的关联的类型和值（由 UserIdentificationSetRequest 定义）。

然后，HAL 会使用属性更改事件（其 VehiclePropValue 由 UserIdentificationResponse 定义）来指明请求后的类型的当前状态。

例如，若要查询当前用户 (10) 是否与解锁汽车的 FOB 以及 OEM 提供的自定义机制相关联，请求如下所示：

  • int32[0] 42 // 请求 ID
  • int32[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 // 请求 ID
  • int32[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 // 请求 ID
  • int32[1] 10 (Android 用户 ID)
  • int32[2] 0 (Android 用户标志)
  • int32[3] 1 （要设置的关联数）
  • int32[4] 101（第一种类型：UserIdentificationAssociationType::CUSTOM_1）

如果请求成功，响应将如下所示：

  • int32[0] 43 // 请求 ID
  • int32[1] 1 （响应中的关联数）
  • int32[2] 101（第一种类型：UserIdentificationAssociationType::CUSTOM_1）
  • int32[3] 1 （第一个值：UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER）

设置请求会添加关联，但不会移除现有关联。在上面的示例中，最终状态将是两个关联（FOB 和 CUSTOM_1）。若要将用户仅与 CUSTOM_1 关联，而不与 FOB 关联，则请求应为：

  • int32[0] 43 // 请求 ID
  • int32[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
枚举类型：无
单位类型：无
版本：Android 13

VEHICLE_CURB_WEIGHT

返回车辆的整备重量（单位：千克）。整备重量是指车辆在不载客、不载货的情况下，配备标准设备和所有必要的操作消耗品（例如机油、变速箱油、制动液、冷却液、空调制冷剂、油箱中额定容量的燃油）时的总重量。

configArray[0] 用于指定车辆的总重量（单位：千克）。车辆的总重量是指制造商指定的车辆最大满载重量，包括车辆的底盘、车身、发动机、发动机液体、燃油、附件、驾驶员、乘客和货物，但不包括任何拖车。

更改模式：STATIC
访问模式：READ
枚举类型：无
单位类型：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
枚举类型：无
单位类型：无
版本：Android 14

VEHICLE_MAP_SERVICE

车载地图服务 (VMS) 消息。此属性使用 MIXED 数据来传达 VMS 消息。其内容应按如下方式进行解读。VmsMessageIntegerValuesInde 中定义的索引用于从 int32Values 读取数据。字节是 VMS 协议中定义的序列化 VMS 消息，该消息对框架来说是不可见的。IVehicle#get 必须始终返回 StatusCode::NOT_AVAILABLE。

更改模式：ON_CHANGEREAD_WRITE
访问模式：READ_WRITE
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 13

VHAL_HEARTBEAT

定义一个事件，VHAL 将其作为检测信号发送给汽车监控定时器。如果 VHAL 支持此属性，VHAL 应每 3 秒向此属性写入一次系统正常运行时间。汽车监控定时器会订阅此属性，并每隔 3 秒检查一次此属性是否已更新。在缓冲区时间为 3 秒时，汽车监控定时器会等待检测信号，最长等待时间可达到 6 秒（从上次收到检测信号算起）。如果未更新，汽车监控定时器会将 VHAL 视为运行状况不佳并终止 VHAL。如果 VHAL 不支持此属性，汽车监控定时器不会检查 VHAL 的运行状况。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

WATCHDOG_ALIVE

定义 Car Watchdog 更新的事件，以表明其处于活跃状态。汽车监控定时器会每隔 3 秒将此属性设置为系统正常运行时间（单位：毫秒）。在启动过程中，更新可能需要更长时间。

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 13

WHEEL_TICK

报告车轮 tick 计数。向量中的第一个元素是重置计数。重置表明之前的 tick 计数与当前及未来的 tick 计数不具有可比性。这表明在 tick 计数过程中出现了一些不连续的情况。

接下来的四个元素表示各个车轮的 tick 计数，顺序如下：

  1. 前左
  2. 前右
  3. 右后
  4. 左后

所有 tick 计数都是累计数据。当车辆前进时，tick 计数会递增；当车辆后退时，tick 计数会递减。车辆启动时，tick 计数应重置为 0。

  • int64Values[0] 重置计数
  • int64Values[1] 左前车轮 tick 计数
  • int64Values[2] 右前车轮 tick 计数
  • int64Values[3] 右后车轮 tick 计数
  • int64Values[4] 左后车轮 tick 计数

configArray 用于指明 micrometers-per-wheel-tick 值，以及支持的车轮，configArray 设置如下：

configArray[0], bits [0:3] Supported wheels

使用枚举 Wheel。例如，如果支持所有车轮，则：

  • configArray[0] VehicleAreaWheel::LEFT_FRONT | VehicleAreaWheel::RIGHT_FRONT | VehicleAreaWheel::LEFT_REAR | VehicleAreaWheel::RIGHT_REAR
  • configArray[1] 左前车轮每 tick 对应的微米数
  • configArray[2] 右前车轮每 tick 对应的微米数
  • configArray[3] 右后车轮每 tick 对应的微米数
  • configArray[4] 左后车轮每 tick 对应的微米数

如果某个车轮不受支持，则其值应始终设置为 0。

必须填写 VehiclePropValue.timestamp。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：无
单位类型：无
版本：Android 13

WINDOW_LOCK

车窗童锁。true 表示车窗已上童锁。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：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
枚举类型：无
单位类型：无
版本：Android 13

WINDOW_POS

车窗位置。必须定义每个 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 到 maxInt32Value 之间的所有整数。minInt32Value 表示车窗已沿非平面方向关闭或完全打开。如果车窗无法沿非平面方向打开，则 minInt32Value 是车窗完全关闭时的位置，必须为 0。如果车窗可以沿非平面方向打开，minInt32Value 表示车窗已沿非平面方向完全打开，并且是一个负值。如需更详细的说明，请参阅以下示例。maxInt32Value 表示车窗已完全打开。

如果值介于 minInt32Value 和 maxInt32Value 之间，则表示处于已沿非平面方向关闭/完全打开位置和完全打开位置之间的过渡状态。此属性不采用任何特定单位，而是采用指定范围的相对速度。例如，对于可以沿非平面方向移动的车窗，此属性应按如下方式工作：对于可以沿非平面方向移动的车窗（天窗的通风模式），此参数可使用负值，如下所示：

  • Max 天窗完全打开（天窗关闭时为 0）。
  • Min 天窗通风口完全打开（天窗关闭时为 0）。
在此模式下，0 表示车窗已关闭。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：无
单位类型：无
版本：Android 13

WINDSHIELD_WIPERS_PERIOD

挡风玻璃雨刷周期（毫秒）。返回挡风玻璃雨刷一个完整周期的瞬时时间段（单位：毫秒）。一个完整周期是指雨刷从停放位置移动并返回停放位置。选择间歇式雨刷设置后，在间歇式雨刷暂停期间，此属性的值必须设置为 0。必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。每个区域 ID 的 maxInt32Value 必须指定最长的雨刷周期。每个区域 ID 的 minInt32Value 都必须设置为 0。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：无
单位类型：VehicleUnit:MILLI_SECS
版本：Android 14

WINDSHIELD_WIPERS_STATE

挡风玻璃雨刷的状态。返回挡风玻璃雨刷的当前状态。WINDSHIELD_WIPERS_STATE 的值可能与 WINDSHIELD_WIPERS_SWITCH 的值不一致，例如 WINDSHIELD_WIPERS_STATE: ON 和 WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO。如果实现了 WINDSHIELD_WIPERS_STATE: ON 和 WINDSHIELD_WIPERS_PERIOD，则 WINDSHIELD_WIPERS_PERIOD 必须反映雨刷的一个完整周期的时间段。

对于每个受支持的区域 ID，必须定义 VehicleAreaConfig#supportedEnumValues 数组，除非支持 WindshieldWipersState 中的所有状态（包括不推荐的 OTHER）。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：WindshieldWipersState
单位类型：无
版本：Android 14

WINDSHIELD_WIPERS_SWITCH

挡风玻璃雨刷开关。表示控制挡风玻璃雨刷的开关的位置。WINDSHIELD_WIPERS_SWITCH 的值可能与 WINDSHIELD_WIPERS_STATE 的值不一致，例如 WINDSHIELD_WIPERS_SWITCH: AUTO 和 WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON。对于每个受支持的区域 ID，必须定义 VehicleAreaConfig#supportedEnumValues 数组，除非支持 WindshieldWipersSwitch 中的所有状态（包括不推荐的 OTHER）。

此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。如果此属性实现为 VehiclePropertyAccess.READ_WRITE，并且 OTHER 状态列在 VehicleAreaConfig#supportedEnumValues 数组中，则不支持写入 OTHER 不支持写入，仅支持读取该值。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：WindshieldWipersSwitch
单位类型：无
版本：Android 14