支持的系统属性

使用收藏集保持井井有条 根据您的偏好保存内容并进行分类。

此页面列出了 VHAL 中支持的系统属性。VHAL 支持的属性必须是以下列表中的系统属性或供应商属性。在 Android 14 及更高版本中，属性定义在 hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl 中定义。

属性定义在 AIDL 接口 android.hardware.automotive.vehicle.property 中定义，该接口与 VHAL 接口 (android.hardware.automotive.vehicle) 分开。VHAL 实现和 VHAL 客户端必须同时依赖于这两个接口。

自动生成的访问模式和更改模式

在 Android 14 及更高版本中，为了支持 VHAL 实现，我们提供了自动生成的 C++ 头文件 和 Java 类文件，其中包含系统属性的允许更改模式或访问模式。供应商 VHAL 实现可以使用这些文件来确保属性配置符合规范。

A 到 D

ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE

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

当未检测到前车时（即，当没有前车或前车距离太远传感器无法检测到时），此属性应返回 StatusCode.NOT_AVAILABLE

当此属性不可用，因为 CC 已禁用时（例如，StatusCode#NOT_AVAILABLE_DISABLED 为 false），此属性必须返回 StatusCode#NOT_AVAILABLE_DISABLED。如果实现了 CRUISE_CONTROL_STATE 并且状态设置为 ErrorState 值，则此属性必须返回与 ErrorState 值对齐的 StatusCode。例如，如果 CRUISE_CONTROL_STATE 设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW，则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW

更改模式：CONTINUOUS
访问模式：READ
枚举类型：不适用
单位类型：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

当前日期和时间，编码为 Epoch 时间（以毫秒为单位）。此值表示自 1970 年 1 月 1 日 UTC 以来经过的毫秒数。

此值表示自 1970 年 1 月 1 日 UTC 以来经过的毫秒数。如果 VHAL 支持此属性，CarServices 会 WRITE 此值，以将 Android 系统的时间提供给 VHAL。这对于将其他车辆系统（仪表盘时钟）与 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] 如果需要唤醒的时间（以毫秒为单位）（否则为 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)，除非支持 AutomaticEmergencyBrakingState（包括不推荐使用的 OTHER）和 ErrorState 的所有状态，否则必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues 数组。

更改模式：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，除非支持 BlindSpotWarningState（包括不推荐使用的 OTHER）和 ErrorState 的所有状态，否则必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues 数组。

更改模式：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] 如果当前显示两个 UI，则子屏幕中 ClusterUI 的类型。-1 表示该区域不再使用。字节：表示 ClusterUI 可用性的数组。0 表示不可用，1 表示可用。例如，如果一辆汽车支持三个 OEM 定义的 ClusterUI，例如 HOME、MAPS 和 CALL，并且仅在蜂窝网络可用时才支持 CALL UI。那么，如果网络可用，它将发送 [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，仪表盘显示的**主屏幕**，并为仪表盘显示提供默认 UI 和一种启动器功能。其他值根据 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!” //

其含义是一个黑盒，并传递给调用方（例如，设置 UI），调用方将采取适当的操作。

更改模式：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)，除非支持 CruiseControlState 的所有状态，否则必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues 数组。通过此属性发送的任何不支持的命令都必须返回 StatusCode#INVALID_ARG。当此属性不可用，因为 CC 已禁用时（例如，CRUISE_CONTROL_ENABLED 为 false），此属性必须返回 StatusCode#NOT_AVAILABLE_DISABLED。如果实现了 CRUISE_CONTROL_STATE 并且状态设置为 ErrorState 值，则此属性必须返回与 ErrorState 值对齐的 StatusCode。例如，如果 CRUISE_CONTROL_STATE 设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW，则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：CruiseControlCommand
单位类型：不适用
发布版本：Android 14

CRUISE_CONTROL_ENABLED

启用或禁用巡航控制 (CC)。设置为 true 以启用 CC，设置为 false 以禁用 CC。此属性由所有形式的 CruiseControlType(s) 共享。启用 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)，除非支持 CruiseControlState（包括不推荐使用的 OTHER）和 ErrorState 的所有状态，否则必须定义 VehicleAreaConfig#supportedEnumValue 数组。

更改模式：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、预测式）。一般来说，此属性应返回在 CruiseControlType 或 ErrorState 中定义的有效状态。例如，如果由于某些临时状态而导致该功能不可用，则应通过 ErrorState 传达该信息。对于全局区域 ID (0)，除非支持 CruiseControlType 的所有状态（包括不建议使用的 OTHER）和 ErrorState，否则必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues 数组。尝试将 CruiseControlType#OTHER 或 ErrorState WRITE 到此属性会抛出 IllegalArgumentException。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：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 中的可选功能。此属性报告应禁用的可选功能。系统的所有允许的可选功能都在 Car 服务叠加层 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 到 G

ELECTRONIC_TOLL_COLLECTION_CARD_STATUS

电子不停车收费卡状态。此属性指示此车辆中 ETC 卡的状态。如果主机知道车辆上连接了 ETC 卡，则 ELECTRONIC_TOLL_COLLECTION_CARD_TYPE 会给出该卡的状态。否则，此属性应为 UNAVAILABLE。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：ElectronicTollCollectionCardStatus
单位类型：不适用
发布版本：Android 13

ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

电子不停车收费 (ETC) 卡类型。此属性指示此车辆中 ETC 卡的类型。如果主机知道车辆上连接了 ETC 卡，则此属性应返回连接的卡类型；否则，此属性应为 UNAVAILABLE。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：ElectronicTollCollectionCardType
单位类型：不适用
发布版本：Android 13

EMERGENCY_LANE_KEEP_ASSIST_ENABLED

启用或禁用紧急车道保持辅助 (ELKA)。设置为 true 以启用 ELKA，设置为 false 以禁用 ELKA。启用 ELKA 后，车辆中的 ADAS 系统应开启并监控驾驶员的不安全变道行为。当检测到不安全操作时，ELKA 会警告驾驶员并应用转向校正，以使车辆保持在其原始车道上。一般来说，EMERGENCY_LANE_KEEP_ASSIST_ENABLED 应始终返回 true 或 false。如果由于某些临时状态（例如车速过低）而导致该功能不可用，则必须通过 EMERGENCY_LANE_KEEP_ASSIST_STATE 属性中的 ErrorState 值传达该信息。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式： READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

EMERGENCY_LANE_KEEP_ASSIST_STATE

紧急车道保持辅助 (ELKA) 状态。返回 ELKA 的当前状态。一般来说，此属性应返回在 EmergencyLaneKeepAssistState 或 ErrorState 中定义的有效状态。例如，如果由于某些临时状态而导致该功能不可用，则应通过 ErrorState 传达该信息。对于全局区域 ID (0)，除非支持 EmergencyLaneKeepAssistState 的所有状态（包括不建议使用的 OTHER）和 ErrorState，否则必须定义 VehicleAreaConfig#supportedEnumValues 数组。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：EmergencyLaneKeepAssistState/ErrorState
单位类型：不适用
发布版本：Android 14

ENGINE_COOLANT_TEMP

发动机冷却液温度。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:CELSIUS
发布版本：Android 13

ENGINE_IDLE_AUTO_STOP_ENABLED

表示发动机怠速自动停止功能。如果为 true，则车辆可能会在不需要时自动关闭发动机，然后在需要时自动重启发动机。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

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

EV 电池显示单位。指示汽车用于向用户显示 EV 电池信息的单位。例如，瓦时 (Wh)、千瓦时 (kWh) 或安培小时 (Ah)。VehiclePropConfig.configArray 用于指示支持的电能单位。电能单位在 VehicleUnit 中定义。例如

  configArray[0] = WATT_HOUR configArray[1] = AMPERE_HOURS configArray[2] = KILOWATT_HOUR

如果更新 EV_BATTERY_DISPLAY_UNITS 影响了其他 *_DISPLAY_UNITS 属性的值，则还必须更新它们的值并将其传达给 AAOS 框架。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleUnit
单位类型：不适用
发布版本：Android 13

EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

以毫瓦为单位的 EV 瞬时充电速率。正值表示电池正在充电。负值表示电池正在放电。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:MW
发布版本：Android 13

EV_BATTERY_LEVEL

返回当前电池电量，无论是电动汽车还是混合动力汽车。此值不会超过 EV_CURRENT_BATTERY_CAPACITY。要计算电池百分比，请使用 (EV_BATTERY_LEVEL, EV_CURRENT_BATTERY_CAPACITY)*100。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:WH
发布版本：Android 13

EV_BRAKE_REGENERATION_LEVEL

电动汽车的再生制动级别。必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 和 maxInt32Value 之间的所有值。minInt32Value 必须为 0。maxInt32Value 表示从制动再生的最大能量设置。minInt32Value 表示无再生制动的设置。此属性是 EV_REGENERATIVE_BRAKING_STATE 的更精细形式。如果 EvRegenerativeBrakingState 中的状态对于 OEM 而言不够精细，则它允许用户设置更具体的再生制动级别。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式： READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

EV_CHARGE_CURRENT_DRAW_LIMIT

指示用户设置的最大充电电流阈值。EvChargeState::configArray[0] 用于指定车辆允许的最大电流（以安培为单位）。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式： READ_WRITEREAD
枚举类型：不适用
单位类型：VehicleUnit:AMPERE
发布版本：Android 13

EV_CHARGE_PERCENT_LIMIT

指示用户设置的最大充电百分比阈值。指示用户设置的最大充电百分比阈值。返回 0 到 100 之间的浮点值。configArray 用于指定有效值。例如，如果车辆支持以下充电百分比限制值：[20, 40, 60, 80, 100]，则 configArray 应为 {20, 40, 60, 80, 100}。如果 configArray 为空，则 0 到 100 之间的所有值都必须有效。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE,, READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

EV_CHARGE_PORT_CONNECTED

EV 充电端口已连接。如果车辆有多个充电端口，则当任何充电端口连接时，此属性必须返回true。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

EV_CHARGE_PORT_OPEN

EV 充电端口已打开。如果车辆有多个充电端口，则如果任何充电端口打开，此属性必须返回 true。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式： READ_WRITEREAD
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

EV_CHARGE_STATE

汽车的充电状态。返回汽车的当前充电状态。如果车辆的目标充电百分比不是 100，则当电池电量达到目标水平时，此属性必须返回 EvChargeState::STATE_FULLY_CHARGED。有关更多背景信息，请参阅 EvChargeState::EV_CHARGE_PERCENT_LIMIT。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：EvChargeState
单位类型：不适用
发布版本：Android 13

EV_CHARGE_SWITCH

启动或停止 EV 电池充电。用户想要的设置。将此属性设置为 true 会启动电池充电，设置为 false 会停止充电。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITEREAD
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

EV_CHARGE_TIME_REMAINING

估计剩余充电时间（以秒为单位）。如果车辆未充电，则返回 0。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:SECS
发布版本：Android 13

EV_CURRENT_BATTERY_CAPACITY

电动汽车或混合动力汽车的当前可用电池容量。当为电动汽车或混合动力汽车时，返回电池容量的实际值。此属性捕获实时可用电池容量，其中考虑了电池老化和温度依赖性等因素。此值可能与 INFO_EV_BATTERY_CAPACITY 不同，因为 INFO_EV_BATTERY_CAPACITY 返回车辆新购时标称电池容量。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:WH
发布版本：Android 14

EV_REGENERATIVE_BRAKING_STATE

汽车的再生制动或单踏板驱动设置。返回与汽车再生制动设置相关的当前设置。如果 OEM 需要比 EvRegenerativeBrakingState 中提供的更多设置，则可以改用 EV_BRAKE_REGENERATION_LEVEL 属性，该属性提供更精细的信息。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：EvRegenerativeBrakingState
单位类型：不适用
发布版本：Android 13

EV_STOPPING_MODE

表示车辆当前停止模式的属性。对于全局区域 ID (0)，除非支持 EvStoppingMode 的所有枚举值，否则必须定义 VehicleAreaConfig#supportedEnumValues。EvStoppingMode 枚举将来可能会扩展以包含更多状态。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以选择将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式： READ_WRITE/READ
枚举类型：EvStoppingMode
单位类型：不适用
发布版本：Android 14

EVS_SERVICE_REQUEST

启用并请求 EVS 服务。该属性提供了一种触发 EVS 服务的方法。VHAL 应使用此属性请求 Android 启动或停止 EVS 服务。

• int32Values[0] EVS 服务类型。该值必须是 EvsServiceType 中的枚举。
• int32Values[1] EVS 服务的状态。该值必须是 EvsServiceState 中的枚举之一。

例如，要启用后视 EVS 服务，Android 可以将属性值设置为

[EvsServiceType::REAR_VIEW, EvsServiceState::ON]

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

EXTERNAL_CAR_TIME

汽车的当前日期和时间建议，编码为 Epoch 时间（以毫秒为单位）。此值表示自 1970 年 1 月 1 日 UTC 以来经过的毫秒数。此属性向 Android 发出 CarTime 更改的信号。如果支持该属性，则当读取此属性时，VHAL 必须报告最准确的当前 CarTime，并在 CarTime 值更改时发布对此属性的更改。

当 CarTime 因自然时间流逝以外的任何原因而更改时，必须发布此属性的 on-change 事件（小于 500 毫秒的时间增量不应触发 on change 事件）。Android 将读取并订阅此属性以从 VHAL 获取时间。这对于将 Android 的时间与其他车辆系统（仪表盘时钟）同步可能很有用。int64Values[0] = 提供的 Epoch 时间（以毫秒为单位）。每当收到属性的新值时，AAOS 都会创建并向 TimeDetectorService 发送 ExternalTimeSuggestion。

如果其他来源没有更高的优先级，Android 将使用此值来设置系统时间。有关如何调整时间源优先级以及如何处理时间建议（包括 Android 如何处理抖动、漂移和最小分辨率）的信息，请参阅 Time Detector Service 文档。

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

我们强烈建议不要使用此属性从使用协议（例如 GNSS、NTP 和 Telephony）的 ECU 中检索时间。由于 Android 已经支持这些协议，因此我们建议您使用 Android 系统，而不是通过此属性通过 VHAL 进行连接。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:MILLI_SECS
发布版本：Android 13

FOG_LIGHTS_STATE

雾灯状态。返回雾灯的当前状态。如果

• 汽车有前雾灯和后雾灯。前后雾灯只能一起控制。FOG_LIGHTS_STATE 必须实现。FRONT_FOG_LIGHTS_STATE 和 REAR_FOG_LIGHTS_STATE 不得实现。
• 前后雾灯只能独立控制。FOG_LIGHTS_STATE 不得实现，并且必须实现 FRONT_FOG_LIGHTS_STATE 和 REAR_FOG_LIGHTS_STATE。
• 汽车只有前雾灯。 FOG_LIGHTS_STATE 或 FRONT_FOG_LIGHTS_STATE 中只能实现一个（不能两者都实现）。REAR_FOG_LIGHTS_STATE 不得实现。
• 汽车只有后雾灯。 FOG_LIGHTS_STATE 或 REAR_FOG_LIGHTS_STATE 中只能实现一个（不能两者都实现）。FRONT_FOG_LIGHTS_STATE 不得实现。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：不适用
发布版本：Android 13

FOG_LIGHTS_SWITCH

雾灯开关。用户想要的设置。如果

• 汽车既有前雾灯又有后雾灯。如果前后雾灯只能一起控制，则必须实现 FOG_LIGHTS_SWITCH。FRONT_FOG_LIGHTS_SWITCH 和 REAR_FOG_LIGHTS_SWITCH 不得实现。
• 前后雾灯只能独立控制。FOG_LIGHTS_SWITCH 不得实现。必须实现 FRONT_FOG_LIGHTS_SWITCH 和 REAR_FOG_LIGHTS_SWITCH。
• 汽车只有前雾灯。 FOG_LIGHTS_SWITCH 或 FRONT_FOG_LIGHTS_SWITCH 中只能实现一个（不能两者都实现）。REAR_FOG_LIGHTS_SWITCH 不得实现。
• 汽车只有后雾灯。 FOG_LIGHTS_SWITCH 或 REAR_FOG_LIGHTS_SWITCH 中只能实现一个（不能两者都实现）。FRONT_FOG_LIGHTS_SWITCH 不得实现。

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

更改模式：ON_CHANGE
访问模式： READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：不适用
发布版本：Android 13

FORWARD_COLLISION_WARNING_ENABLED

启用或禁用前向碰撞警告 (FCW)。设置为 true 以启用 FCW，设置为 false 以禁用 FCW。启用 FCW 后，车辆中的 ADAS 系统应开启并监控潜在的碰撞。一般来说，FORWARD_COLLISION_WARNING_ENABLED 应始终返回 true 或 false。如果由于某些临时状态（例如车速过低）而导致该功能不可用，则必须通过 FORWARD_COLLISION_WARNING_STATE 属性中的 ErrorState 值传达该信息。

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

更改模式：ON_CHANGE
访问模式： READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

FORWARD_COLLISION_WARNING_STATE

前向碰撞警告 (FCW) 状态。返回 FCW 的当前状态。此属性必须始终返回在 ForwardCollisionWarningState 或 ErrorState 中定义的有效状态。它不得通过 StatusCode 显示错误，而必须使用支持的错误状态。对于全局区域 ID (0)，除非支持 ForwardCollisionWarningState 的所有状态（包括不建议使用的 OTHER）和 ErrorState，否则必须定义 VehicleAreaConfig#supportedEnumValues 数组。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：ForwardCollisionWarningState/ErrorState
单位类型：不适用
发布版本：Android 14

FRONT_FOG_LIGHTS_STATE

前雾灯状态。返回前雾灯的当前状态。 FOG_LIGHTS_STATE 或 FRONT_FOG_LIGHTS_STATE 中只能实现一个。有关更多信息，请参阅关于 FOG_LIGHTS_STATE 的文档。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：不适用
发布版本：Android 13

FRONT_FOG_LIGHTS_SWITCH

前雾灯开关。用户想要的设置。 FOG_LIGHTS_SWITCH 或 FRONT_FOG_LIGHTS_SWITCH 中只能实现一个。有关更多信息，请参阅关于 FOG_LIGHTS_SWITCH 的文档。

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：不适用
发布版本：Android 13

FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

燃油消耗显示单位。指示汽车用于向用户显示燃油消耗信息的单位类型。True 表示单位是距离/体积，例如 MPG。False 表示单位是体积/距离，例如 L/100KM。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

FUEL_DOOR_OPEN

油箱盖打开。此属性必须传达车辆上的油箱盖是否打开。此属性不适用于电动汽车。也就是说，如果 INFO_FUEL_TYPE 仅包含 FuelType::FUEL_TYPE_ELECTRIC，则不得实现此属性。对于电动汽车，请实现 EV_CHARGE_PORT_OPEN。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式： READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

FUEL_LEVEL

车辆中剩余的燃油量，以毫升为单位。此属性必须传达车辆中剩余的当前燃油量（以毫升为单位）。此属性不适用于电动汽车。也就是说，如果 INFO_FUEL_TYPE 仅包含 FuelType::FUEL_TYPE_ELECTRIC，则不得实现此属性。对于电动汽车，请实现 EV_BATTERY_LEVEL。值不能超过 INFO_FUEL_CAPACITY。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:MILLILITER
发布版本：Android 13

FUEL_LEVEL_LOW

燃油量低警告。此属性对应于仪表板上的低燃油警告。一旦设置了 FUEL_LEVEL_LOW，则在向车辆添加更多燃油之前，不应清除它。此属性可以考虑车辆中的所有燃油来源。例如，在

• 汽油动力车辆中，此属性仅基于汽油量。
• 电池动力车辆中，此属性仅基于电池电量。
• 混合动力车辆中，此属性可能基于汽油和电池电量的组合，由 OEM 自行决定。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

FUEL_VOLUME_DISPLAY_UNITS

燃油体积显示单位。指示汽车用于向用户显示燃油体积的单位。例如，升或加仑。VehiclePropConfig.configArray 用于指示支持的燃油体积显示单位。体积单位在 VehicleUnit 中定义。例如，configArray[0] = LITER configArray[1] = GALLON。如果更新 FUEL_VOLUME_DISPLAY_UNITS 影响了其他 *_DISPLAY_UNITS 属性的值，则还必须更新它们的值并将其传达给 AAOS 框架。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式： READ_WRITE/READ
枚举类型：VehicleUnit
单位类型：不适用
发布版本：Android 13

GEAR_SELECTION

用户选择的档位。配置数据中的值必须表示此车辆支持的档位列表。例如，自动变速器的配置数据必须包含 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_DRIVE, GEAR_1, GEAR_2,...}，而手动变速器的列表必须是 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}。对于允许驾驶员按需选择特定档位（例如，手动模式）的自动变速器车辆，GEAR_SELECTION 的值必须设置为驾驶员选择的特定档位，而不是 GEAR_DRIVE。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleGear
单位类型：不适用
发布版本：Android 13

GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT

欧盟的通用安全法规合规性要求。返回一个值，指示是否需要通用安全法规合规性，如果需要，则指示要求的类型。

更改模式：STATIC
访问模式：READ
枚举类型：GsrComplianceRequirementType
单位类型：不适用
发布版本：Android 14

GLOVE_BOX_DOOR_POS

表示手套箱门当前位置的属性。必须定义 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 和 maxInt32Value 之间的所有整数。minInt32Value 表示手套箱门已关闭。minInt32Value 必须为 0。maxInt32Value 表示手套箱门处于完全打开位置。minInt32Value 和 maxInt32Value 之间的值表示关闭和完全打开位置之间的过渡状态。

此属性没有特定的单位，而是在指定的相对位置范围内。区域 ID 必须与手套箱预期使用的座椅匹配。例如，如果前排右侧仪表板中嵌入了手套箱，则区域 ID 应为 SEAT_1_RIGHT。

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

GLOVE_BOX_LOCKED

锁定或解锁手套箱。如果为 true，则手套箱已锁定。如果为 false，则手套箱已解锁。区域 ID 必须与手套箱预期使用的座椅匹配。例如，如果前排右侧仪表板中嵌入了嵌入式手套箱，则区域 ID 应为 VehicleAreaSeat#ROW_1_RIGHT。

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

更改模式：ON_CHANGE
访问模式： READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

H 到 I

HANDS_ON_DETECTION_DRIVER_STATE

驾驶员手持检测 (HOD) 驱动状态。返回驾驶员的手是否在方向盘上。通常，此属性应返回在 HandsOnDetectionDriverState 或 ErrorState 中定义的有效状态。例如，如果由于某些临时状态而导致该功能不可用，则应通过 ErrorState 传达该信息。如果车辆想要向用户发送警告，因为驾驶员的手离开方向盘的时间过长，则应通过 HANDS_ON_DETECTION_WARNING 发出警告。对于全局区域 ID (0)，除非支持 HandsOnDetectionDriverState （包括不推荐使用的 OTHER）和 ErrorState 的所有状态，否则必须定义 VehicleAreaConfig#supportedEnumValues 数组。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：HandsOnDetectionDriverState/ErrorState
单位类型：不适用
发布版本：Android 14

HANDS_ON_DETECTION_ENABLED

启用或禁用驾驶员手持检测 (HOD)。设置为 true 以启用 HOD，设置为 false 以禁用 HOD。启用 HOD 后，车辆内部的系统应监控驾驶员的手是否在方向盘上，如果检测到驾驶员的手不再在方向盘上，则发送警告。一般来说，HANDS_ON_DETECTION_ENABLED 应始终返回 true 或 false。

如果由于某些临时状态而导致该功能不可用，则必须通过 HANDS_ON_DETECTION_STATE 属性中的 ErrorState 值传达该信息。此属性定义为 minInt32Value VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

HANDS_ON_DETECTION_WARNING

驾驶员手持检测 (HOD) 警告。返回是否正在向驾驶员发送警告，因为他们的手离开方向盘的时间过长。通常，此属性应返回在 HandsOnDetectionWarning 或 ErrorState 中定义的有效状态。例如，如果由于某些临时状态而导致该功能不可用，则应通过 ErrorState 传达该信息。对于全局区域 ID (0)，除非支持 HandsOnDetectionWarning （包括不推荐使用的 OTHER）和 ErrorState 的所有状态，否则必须定义 VehicleAreaConfig#supportedEnumValues 数组。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：HandsOnDetectionWarning/ErrorState
单位类型：不适用
发布版本：Android 14

HAZARD_LIGHTS_STATE

危险警告灯状态。返回危险警告灯的当前状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：不适用
发布版本：Android 13

HAZARD_LIGHTS_SWITCH

危险警告灯开关。用户想要的设置。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：不适用
发布版本：Android 13

HEADLIGHTS_STATE

前大灯状态。返回前大灯的当前状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：不适用
发布版本：Android 13

HEADLIGHTS_SWITCH

前大灯开关。用户想要的设置。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：不适用
发布版本：Android 13

HIGH_BEAM_LIGHTS_STATE

远光灯状态。返回远光灯的当前状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleLightState
单位类型：不适用
发布版本：Android 13

HIGH_BEAM_LIGHTS_SWITCH

远光灯开关。用户想要的设置。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：不适用
发布版本：Android 13

HVAC_AC_ON

为指定的 areaId 打开和关闭空调。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为 VehiclePropertyAccess.READ

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_ACTUAL_FAN_SPEED_RPM

实际风扇转速。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_AUTO_ON

打开和关闭自动气候控制。如果为 true，则自动气候控制已打开。如果为 false，则自动气候控制已关闭。如果车辆不支持直接关闭自动气候控制，则 OEM 应在其 VHAL 实现中添加逻辑，将 HVAC_AUTO_ON 设置为 false，这将更改必要的 HVAC 设置以间接关闭 HVAC_AUTO_ON。理想情况下，这不应干扰用户。OEM 应将自动气候控制关闭时修改的任何设置恢复到之前的状态。这样，唯一的结果应该是 HVAC_AUTO_ON 关闭。如果无法将 HVAC 设置恢复到之前的设置，则 OEM 应实施干扰最小的更改。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_AUTO_RECIRC_ON

自动空气内循环开启或关闭。当自动空气内循环开启时，如果车辆检测到进气质量差，HVAC 系统可能会自动切换到空气内循环模式。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_DEFROSTER

用于指定车窗的基于风扇的除霜。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为 VehiclePropertyAccess.READ

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_DUAL_ON

启用区域之间的温度耦合。HVAC_DUAL_ON 属性的 AreaIDs 应包含 HVAC_TEMPERATURE_SET AreaIDs 的组合，这些组合可以耦合在一起。如果 HVAC_TEMPERATURE_SET 映射到 AreaIDs[a_1, a_2, ..., a_n]，并且如果可以启用 HVAC_DUAL_ON 以耦合 a_i 和 a_j，则 HVAC_DUAL_ON 属性必须映射到 [a_i | a_j]。此外，如果 a_k 和 a_l 也可以单独耦合在一起，则 HVAC_DUAL_ON 必须映射到 [a_i | a_j, a_k | a_l]。例如，一辆汽车有两个前排座椅（ROW_1_LEFT 和 ROW_1_RIGHT）和三个后排座椅（ROW_2_LEFT、ROW_2_CENTER 和 ROW_2_RIGHT）。有两个温度控制单元，驾驶员侧和乘客侧，可以有选择地同步。这可以在 AreaIDs 中这样表示

HVAC_TEMPERATURE_SET > [ROW_1_LEFT | ROW_2_LEFT, ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT]
HVAC_DUAL_ON > [ROW_1_LEFT | ROW_2_LEFT | ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT]

当属性启用时，ECU 必须同步受影响区域的温度。作为打开或关闭 DUAL_ON 参数的副作用而修改的任何参数都应生成 onPropertyEvent() 回调到 VHAL。此外，如果设置温度（例如，驾驶员温度）更改了另一个温度（例如，前排乘客温度），则必须生成相应的 onPropertyEvent() 回调。

如果用户更改了破坏耦合的温度（例如，独立设置乘客温度），则 VHAL 必须发送相应的 onPropertyEvent() 回调（包括 HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx）。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为 VehiclePropertyAccess.READ

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_ELECTRIC_DEFROSTER_ON

电动除霜器的状态。

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_FAN_DIRECTION

风扇方向设置。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleHvacFanDirection
单位类型：不适用
发布版本：Android 13

HVAC_FAN_DIRECTION_AVAILABLE

可用的风扇位置。这是区域可用的风扇位置的位掩码。每个可用的风扇方向都由向量中的单独条目表示。风扇方向可以具有来自 vehicle_hvac_fan_direction 设置的多个位。例如，典型的汽车可能具有以下风扇位置

- FAN_DIRECTION_FACE (0x1) - FAN_DIRECTION_FLOOR (0x2) - FAN_DIRECTION_FACE | FAN_DIRECTION_FLOOR (0x3) - FAN_DIRECTION_DEFROST (0x4) - FAN_DIRECTION_FLOOR | FAN_DIRECTION_DEFROST (0x6)

更改模式：STATIC
访问模式：READ
枚举类型：VehicleHvacFanDirection
单位类型：不适用
发布版本：Android 13

HVAC_FAN_SPEED

风扇转速设置。VehicleAreaConfig 中必须定义 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 和 maxInt32Value 之间的所有整数。

• minInt32Value 最低风扇转速
• maxInt32Value 最高风扇转速

此属性不使用任何特定单位，而是使用指定范围的相对速度。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以选择将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_MAX_AC_ON

MAX AC 开启或关闭。当 MAX AC 开启时，ECU 可以根据需要调整通风口位置、风扇转速和温度等项目，以尽可能快地冷却车辆。作为打开或关闭 MAX AC 参数的副作用而修改的任何参数都会生成 onPropertyEvent() 回调到 VHAL。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为 VehiclePropertyAccess.READ

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_MAX_DEFROST_ON

打开和关闭 MAX DEFROST。当 MAX DEFROST 开启时，ECU 可以根据需要调整通风口位置、风扇转速和温度等项目，以尽可能快地为车窗除霜。作为打开或关闭 MAX DEFROST 参数的副作用而修改的任何参数都会生成 onPropertyEvent() 回调到 VHAL。HVAC_MAX_DEFROST_ON 的 AreaIDs 指示可以在该区域控制 MAX DEFROST。例如，areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT} 指示 HVAC_MAX_DEFROST_ON 只能为前排控制。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为 VehiclePropertyAccess.READ

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_POWER_ON

表示 HVAC 的全局电源状态。将此属性设置为 false 可能会将某些控制各个 HVAC 功能和子系统的属性标记为 UNAVAILABLE 状态。将此属性设置为 true 可能会将某些控制各个 HVAC 功能和子系统的属性标记为 AVAILABLE 状态（除非任何或所有属性因其各自的优点而 UNAVAILABLE）。

HvacPower_DependentProperties 是指那些需要 HVAC 通电才能启用功能的属性。例如，在某些汽车中，要打开空调，必须首先打开 HVAC。HvacPower_DependentProperties 列表必须在 VehiclePropConfig.configArray 中设置。HvacPower_DependentProperties 必须仅包含与 VehicleArea:SEAT 关联的那些属性

HVAC_POWER_ON 属性的 AreaID 映射必须包含 HvacPower_DependentProperties 映射到的所有 AreaIDs。例如，一辆汽车有两

1. 前排座椅（ROW_1_LEFT、ROW_1_RIGHT）和三个后排座椅（ROW_2_LEFT、ROW_2_CENTER、ROW_2_RIGHT）。如果整车的 HVAC 功能（空调、温度等）都依赖于单个 HVAC 电源控制器，则 HVAC_POWER_ON 必须映射到 [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
2. 前排座椅（ROW_1_LEFT、ROW_1_RIGHT）和第二排（ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT）和第三排（ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT）的三个座椅。如果汽车的前排座椅中有温度控制器，可以完全独立于车辆后部的温度控制器运行，则 HVAC_POWER_ON 必须映射到两个元素数组

   - ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
   

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_RECIRC_ON

空气内循环开启和关闭。控制向车舱供应外部空气。空气内循环开启意味着进入车舱的大部分气流源于车舱内部。空气内循环关闭意味着进入车舱的大部分气流来自车外。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为 VehiclePropertyAccess.READ

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_SEAT_TEMPERATURE

座椅加热和制冷。VehicleAreaConfig 中必须定义 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 和 maxInt32Value 之间的所有整数。maxInt32Value 表示最大座椅温度加热设置。minInt32Value 必须为 0，除非车辆支持座椅制冷。在这种情况下，minInt32Value 表示最大座椅温度制冷设置。此属性不使用任何特定单位，而是使用指定范围的相对温度设置。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_SEAT_VENTILATION

座椅通风。VehicleAreaConfig 中必须定义 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 和 maxInt32Value 之间的所有整数。minInt32Value 必须为 0。maxInt32Value 表示座椅可用的最大通风设置。

此属性不使用任何特定单位，而是使用指定范围的通风设置。

供 HVAC 应用和助手用于启用、更改或读取座椅通风状态。这与座椅制冷不同。它可以与制冷同时开启，也可以不同时开启。

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_SIDE_MIRROR_HEAT

后视镜加热。值越大表示后视镜的加热级别越高。您必须在 VehicleAreaConfig 中定义 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 和 maxInt32Value 之间的所有整数。在配置数据中

• maxInt32Value 表示最大加热级别。
• minInt32Value 必须为 0，表示不加热。

此属性不使用任何特定单位，而是使用指定范围的相对加热设置。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以选择将其实现为 VehiclePropertyAccess.READ

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_STEERING_WHEEL_HEAT

设置方向盘的加热和制冷量。VehicleAreaConfig 中必须定义 maxInt32Value 和 minInt32Value。必须支持 minInt32Value 和 maxInt32Value 之间的所有整数。maxInt32Value 表示最大方向盘加热设置。minInt32Value 应为 0，除非车辆也支持方向盘制冷。在这种情况下，minInt32Value 表示最大方向盘制冷设置。此属性不使用任何特定单位，而是使用指定范围的加热设置。此属性定义为 VehiclePropertyAccess.READ，但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HVAC_TEMPERATURE_CURRENT

HVAC 当前温度。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:CELSIUS
发布版本：Android 13

HVAC_TEMPERATURE_DISPLAY_UNITS

用于显示的温度单位。指示温度是以摄氏度还是华氏度显示。VehiclePropConfig.configArray 指示支持的温度显示单位。例如，configArray[0] = CELSIUS configArray[1] = FAHRENHEIT 此参数可用于显示系统中的任何 HVAC 温度。值必须是 VehicleUnit.CELSIUS 或 VehicleUnit.FAHRENHEIT 之一

如果更新 HVAC_TEMPERATURE_DISPLAY_UNITS 影响了其他 *_DISPLAY_UNITS 属性的值，则必须更新其值并将其传达给 AAOS 框架。

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleUnit
单位类型：不适用
发布版本：Android 13

HVAC_TEMPERATURE_SET

以摄氏度为单位设置的 HVAC 目标温度。

VehicleAreaConfig 中必须定义 minFloatValue 和 maxFloatValue

• minFloatValue 摄氏度最低温度设置。
• maxFloatValue 摄氏度最高温度设置。

如果不支持 minFloatValue 和 maxFloatValue 之间的所有值，请使用 configArray 列出可以设置的有效温度值。这也描述了一个查找表，用于将温度从摄氏度转换为华氏度（反之亦然）。如果车辆不支持标准单位转换，则必须定义 configArray。

configArray 设置如下

• configArray[0] [支持的摄氏度温度下限] * 10
• configArray[1] [支持的摄氏度温度上限] * 10
• configArray[2] [摄氏度增量] * 10
• configArray[3] [支持的华氏度温度下限] * 10
• configArray[4] [支持的华氏度温度上限] * 10
• configArray[5] [华氏度增量] * 10

VehicleAreaConfig 中的 minFloatValue 和 maxFloatValue 必须分别等于 configArray[0] 和 configArray[1]。例如，如果车辆支持的温度值为摄氏度 [16.0, 16.5, 17.0 ,..., 28.0]，华氏度 [60.5, 61.5, 62.5 ,..., 84.5]，则 configArray 应为 configArray = {160, 280, 5, 605, 845, 10}

理想情况下，摄氏度增量与华氏度增量之比应尽可能接近 1 摄氏度与 1.8 华氏度的实际比率。必须存在 configArray 定义的所有摄氏度值到华氏度值的一对一映射。configArray 供客户端使用，以将此属性的温度从摄氏度转换为华氏度。此外，它还让客户端知道要将属性设置为哪个摄氏度值才能达到他们想要的系统华氏度值。如果 ECU 没有所有摄氏度值到华氏度值的一对一映射，则 configArray 应仅定义具有一对一映射的摄氏度和华氏度值的列表。

例如，如果 ECU 支持的摄氏度值范围为 16 到 28，华氏度值范围为 60 到 85，每个值的增量为 1，则一个可能的 configArray 是 code>{160, 280, 10, 600, 840, 20} 在这种情况下，85 不是支持的温度。

设置介于有效值之间的任何值都应四舍五入到最接近的有效值。我们强烈建议 OEM 也实现 HVAC_TEMPERATURE_VALUE_SUGGESTION 车辆属性，因为它为应用程序提供了一种简单的方法来确定可以为车辆设置的温度值，以及在摄氏度和华氏度之间转换值。

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：VehicleUnit:CELSIUS
发布版本：Android 13

HVAC_TEMPERATURE_VALUE_SUGGESTION

用于设置 HVAC 温度的建议值。

实现该属性以帮助应用程序了解最接近的支持的摄氏度或华氏度温度值。

• floatValues[0] 应用程序想要将温度设置为的请求值。
• floatValues[1] floatValues[0] 的单位，应为 {VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT} 之一
• floatValues[2] OEM 建议的摄氏度值（此值不包含在请求中）。
• floatValues[3] OEM 建议的华氏度值（此值不包含在请求中）。

应用程序使用请求的值和值的单位调用 set(VehiclePropValue propValue)。OEM 需要通过 onPropertyEvent() 回调在 floatValues[2] 和 floatValues[3] 中返回建议的值。建议的值必须符合可以从 HVAC_TEMPERATURE_SET configArray 派生的值。换句话说，建议的值和来自 configArray 的值表应相同。

我们建议 OEM 在其 VHAL 实现中添加自定义逻辑，以避免向 HVAC ECU 发出请求。逻辑可以如下。要将温度从摄氏度转换为华氏度

// Given tempC and the configArray float minTempC = configArray[0] / 10.0; float temperatureIncrementCelsius = configArray[2] / 10.0; float minTempF = configArray[3] / 10.0; float temperatureIncrementFahrenheit = configArray[5] / 10.0; // Round to the closest increment int numIncrements = round((tempC - minTempC) / temperatureIncrementCelsius); tempF = temperatureIncrementFahrenheit * numIncrements + minTempF;

例如，当驾驶员使用语音助手将 HVAC 温度设置为华氏度 66.2 度时。首先，应用程序使用值 [66.2, (float)VehicleUnit.FAHRENHEIT,0,0] 设置此属性。如果 OEM 建议在用户请求时设置摄氏度 19.0 度或华氏度 66.5 度，则 VHAL 必须生成一个回调，其中属性值为 [66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5]。在语音助手收到回调后，它会通知用户并将 HVAC 温度设置为建议的值。

另一个示例，应用程序通过查询 HVC_TEMPERATURE_SET 接收到摄氏度 21 度作为当前温度值，但应用程序需要知道汽车的 UI 上以华氏度显示的值是多少。为此，应用程序将属性设置为 [21, (float)VehicleUnit.CELSIUS, 0, 0]。如果 OEM 建议的摄氏度 21 度的值为华氏度 70 度，则 VHAL 必须生成一个回调，其中属性值为 [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]。在这种情况下，应用程序可以知道汽车 UI 中的值为华氏度 70.0 度。

更改模式：ON_CHANGE
访问模式：READ_WRITE
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HW_CUSTOM_INPUT

定义自定义 OEM 合作伙伴输入事件。此输入事件必须由想要传播 Android 不支持的事件的 OEM 合作伙伴使用。它仅由 int32 值数组组成。Android 属性为

• int32Values[0] 输入代码，用于标识表示此事件的功能。有效事件类型由 CustomInputType.CUSTOM_EVENT_F1 到 CustomInputType.CUSTOM_EVENT_F10 定义。它们表示要由 OEM 合作伙伴定义的自定义事件。
• int32Values[1] 在 VehicleDisplay 中定义的目标显示类型。未绑定到特定显示的事件必须发送到 VehicleDisplay#MAIN
• int32Values[2] 重复计数器，如果为 0，则事件不重复。值 1 或更高表示此事件已重复多少次。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：CustomInputType
单位类型：不适用
发布版本：Android 13

HW_KEY_INPUT

用于向 Android 馈送硬件输入事件的属性。

• int32Values[0] 由 VehicleHwKeyInputAction 定义的动作
• int32Values[1] 键代码，必须使用标准 Android 键代码
• int32Values[2] 在 VehicleDisplay 中定义的目标显示。未绑定到特定显示的事件必须发送到 VehicleDisplay#MAIN
• int32Values[3]（可选）刻度数。该值必须等于或大于 1。省略时，Android 默认为 1。

更改模式：.ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

HW_KEY_INPUT_V2

用于向 Android 馈送硬件输入事件的属性。

• int32array[0] 由 VehicleDisplay 定义的目标显示，例如
  VehicleDisplay::MAIN、VehicleDisplay::INSTRUMENT_CLUSTER、VehicleDisplay::AUX
• int32array[1] 键代码，必须使用标准 Android 键代码，例如 KEYCODE_HOME 和 KEYCODE_BACK
• int32array[2] 在 VehicleHwKeyInputAction 中定义的动作，例如
  VehicleHwKeyInputAction::ACTION_UP、VehicleHwKeyInputAction::ACTION_UP
• int32array[3] 事件的重复计数。对于按键按下事件，这是重复计数，第一次按下从 0 开始计数。对于按键释放事件，这始终等于 0。
• int64array[0] 自上次启动以来经过的纳秒级的按下时间。表示最近一次按键按下事件的时间。对于按下事件，这是按下事件的事件时间。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

HW_MOTION_INPUT

用于向 Android 馈送硬件输入事件的属性。

• int32array[0] 由 VehicleDisplay 定义的目标显示，例如
  VehicleDisplay::MAIN、VehicleDisplay::INSTRUMENT_CLUSTER、VehicleDisplay::AUX
• int32array[1] 在 VehicleHwMotionInputSource 中定义的输入类型，例如
  VehicleHwMotionInputSource::SOURCE_KEYBOARD、VehicleHwMotionInputSource::SOURCE_DPAD
• int32array[2] 在 VehicleHwMotionInputAction 中定义的动作代码，例如
  VehicleHwMotionInputAction::ACTION_UP、VehicleHwMotionInputAction::ACTION_DOWN
• int32array[3] 在 VehicleHwMotionButtonStateFlag 中定义的按钮状态标志，例如
  VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY、VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
• int32array[4] 指针事件计数，N。N 必须为正整数。
• int32array[5:5+N-1] 指针 ID，长度 N
• int32array[5+N:5+2*N-1] 工具类型，长度 N。如 VehicleHwMotionToolType 中定义，例如
  VehicleHwMotionToolType::TOOL_TYPE_FINGER、VehicleHwMotionToolType::TOOL_TYPE_STYLUS
• floatArray[0:N-1] x 数据，长度 N
• floatArray[N:2*N-1] y 数据，长度 N
• floatArray[2*N:3*N-1] 压力数据，长度 N
• floatArray[3*N:4*N-1] 大小数据，长度 N
• int64array[0] 按下时间，自启动以来经过的纳秒数。表示用户最初按下以开始位置事件流的时间。对于按下事件，它是按下事件的事件时间。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

HW_ROTARY_INPUT

用于向 Android 馈送硬件旋转事件的属性。

• int32Values[0] RotaryInputType，用于标识旋转的是哪个旋转旋钮。
• int32Values[1] 定位点（咔哒声）的数量，正数表示顺时针，负数表示逆时针。
• int32Values[2] 在 VehicleDisplay 中定义的目标显示。未绑定到特定显示的事件必须发送到 VehicleDisplay#MAIN
• int32values[3 .. 3 + abs(number of detents) - 2] 当定位点数量大于 1 或小于 -1 时，成对连续定位点之间的纳秒级增量。
• VehiclePropValue.timestamp 旋转发生的时间。如果定位点数量大于 1 或小于 -1，则为旋转的第一个定位点发生的时间。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：RotaryInputType
单位类型：不适用
发布版本：Android 13

IGNITION_STATE

表示点火状态。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：VehicleIgnitionState
单位类型：不适用
发布版本：Android 13

INFO_DRIVER_SEAT

驾驶员座椅位置。VHAL 实现必须忽略 areaId。使用 VehicleArea:GLOBAL

更改模式：STATIC
访问模式：READ
枚举类型：VehicleAreaSeat
单位类型：不适用
发布版本：Android 13

INFO_EV_BATTERY_CAPACITY

电动汽车或混合动力汽车的标称电池容量。返回电动汽车或混合动力汽车的标称电池容量。这是车辆全新时的可用电池总容量。此值可能与 EV_CURRENT_BATTERY_CAPACITY 不同，因为 EV_CURRENT_BATTERY_CAPACITY 返回的是实时可用电池容量，其中考虑了电池老化和温度依赖性等因素。

更改模式：STATIC
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:WH
发布版本：Android 13

INFO_EV_CONNECTOR_TYPE

此电动汽车可能使用的连接器列表。如果车辆有多个充电端口，则此属性必须返回车辆上至少一个充电端口可以使用的所有可能的连接器类型。

更改模式：STATIC
访问模式：READ
枚举类型：EvConnectorType
单位类型：不适用
发布版本：Android 13

INFO_EV_PORT_LOCATION

此属性必须使用 PortLocationType 枚举传达电动汽车上充电端口的位置。如果车辆有多个端口，则此属性必须返回允许最快充电的端口。要传达所有端口位置，请使用 INFO_MULTI_EV_PORT_LOCATIONS

INFO_EXTERIOR_DIMENSIONS

车辆的外部尺寸

• 高度：int32Values[0]
• 长度：int32Values[1]
• 宽度：int32Values[2]
• 宽度，包括后视镜：int32Values[3]
• 轴距，包括后视镜：int32Values[4]
• 前轮轮距：int32Values[5]
• 后轮轮距：int32Values[6]
• 路沿到路沿转弯直径：int32Values[7]

更改模式：STATIC
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:MILLIMETER
发布版本：Android 13

INFO_FUEL_CAPACITY

车辆的燃油容量，单位为毫升。此属性必须传达车辆可以存储的最大燃油量，单位为毫升。此属性不适用于电动汽车 (EV)。也就是说，如果 INFO_FUEL_TYPE 仅包含 FuelType::FUEL_TYPE_ELECTRIC，则不得实现 INFO_FUEL_CAPACITY。对于电动汽车，请实现 INFO_EV_BATTERY_CAPACITY。

更改模式：STATIC
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:MILLILITER
发布版本：Android 13

INFO_FUEL_DOOR_LOCATION

燃油箱盖位置。此属性必须传达车辆上燃油箱盖的位置。此属性不适用于电动汽车。也就是说，如果 INFO_FUEL_TYPE 仅包含 FuelType::FUEL_TYPE_ELECTRIC，则不得实现此属性。对于电动汽车，请实现 INFO_EV_PORT_LOCATION 或 INFO_MULTI_LOCATIONS

更改模式：STATIC
访问模式：READ
枚举类型：PortLocationType
单位类型：不适用
发布版本：Android 13

INFO_FUEL_TYPE

车辆可能使用的燃料列表。FuelType::FUEL_TYPE_ELECTRIC 仅当车辆可以插电充电时才必须包含。例如，完全混合动力电动汽车 (FHEV) 不得包含 FuelType::FUEL_TYPE_ELECTRIC 作为 INFO_FUEL_TYPE 的 INT32_VEC 值。INFO_FUEL_TYPE 可以按如下方式填充。

int32Values = { FuelType::FUEL_TYPE_UNLEADED }

更改模式：STATIC
访问模式：READ
枚举类型：FuelType
单位类型：不适用
发布版本：Android 13

INFO_MAKE

车辆制造商。此属性必须传达车辆的公开品牌名称。

更改模式：STATIC
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

INFO_MODEL

车辆型号。此属性必须传达车辆的公开型号名称。

更改模式：STATIC
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

INFO_MODEL_YEAR

基于公历的 `YYYY` 格式的车辆型号年份。

更改模式：STATIC
访问模式：READ
枚举类型：不适用
单位类型：VehicleUnit:YEAR
发布版本：Android 13

INFO_MULTI_EV_PORT_LOCATIONS

多个电动汽车端口位置。如果车辆有多个电动汽车端口，请实现此属性。端口位置在 PortLocationType 中定义。例如，一辆汽车有一个左前端口和一个左后端口

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

如果车辆只有一个端口，则此属性的值应列出一个元素。要描述一个端口位置，请参阅 INFO-EV-PORT-LOCATION

更改模式：STATIC
访问模式：READ
枚举类型：PortLocationType
单位类型：不适用
发布版本：Android 13

INFO_VIN

车辆的 VIN。

更改模式：STATIC
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

INITIAL_USER_INFO

定义初始化期间要使用的 Android 用户。此属性在 Android 系统初始化时被调用，并允许 HAL 定义应启动哪个 Android 用户。此请求通过设置一个 VehiclePropValue（由 InitialUserInfoRequest 定义）发出，并且 HAL 必须使用属性更改事件（由 InitialUserInfoResponse 定义）进行响应。如果 HAL 在 Android 系统定义的时间后未响应，则 Android 系统将继续执行，就像 HAL 返回了操作 InitialUserInfoResponseAction:DEFAULT 的响应一样。例如，在首次启动时，请求可能是：

int32[0] 42  // request id (arbitrary number set by Android system)
int32[1] 1   // InitialUserInfoRequestType::FIRST_BOOT
int32[2] 0   // id of current user (usersInfo.currentUser.userId)
int32[3] 1   // flag of current user (usersInfo.currentUser.flags = SYSTEM)
int32[4] 1   // number of existing users (usersInfo.numberUsers);
int32[5] 0   // user #0  (usersInfo.existingUsers[0].userId)
int32[6] 1   // flags of user #0  (usersInfo.existingUsers[0].flags)

int32[0] 42  // must match the request id from the request
int32[1] 2   // action = InitialUserInfoResponseAction::CREATE
int32[2] -10000  // userToSwitchOrCreate.userId (not used as user will be created)
int32[3] 8   // userToSwitchOrCreate.flags = ADMIN string: "||Owner" // userLocales + separator + userNameToCreate

更改模式：ON_CHANGE
访问模式：READ_WRITE
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

J 到 R

LANE_CENTERING_ASSIST_COMMAND

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

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

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：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.READonly。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

LANE_CENTERING_ASSIST_STATE

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

如果 LCA 包括车道偏离警告，则这些警告必须通过车道偏离警告 (LDW) 属性表面化。

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

更改模式：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)，除非支持 LaneDepartureWarningState（包括不推荐使用的 OTHER）和 ErrorState 的所有状态，否则必须定义 VehicleAreaConfig#supportedEnumValues 数组。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：LaneDepartureWarningState/ErrorState
单位类型：不适用
发布版本：Android 14

LANE_KEEP_ASSIST_ENABLED

启用或禁用车道保持辅助 (LKA)。设置为 true 以启用 LKA，设置为 false 以禁用 LKA。当 LKA 启用时，车辆中的 ADAS 系统应开启并监控驾驶员是否无意中向车道标记漂移或越过车道标记。如果检测到意外的车道偏离，系统将应用转向控制以将车辆返回到当前车道。这与车道居中辅助 (LCA) 不同，后者在激活时会应用持续的转向控制，以使车辆保持在当前车道的中心。

通常，LANE_KEEP_ASSIST_ENABLED 应始终返回 true 或 false。如果该功能由于某些临时状态（例如，车速过低或过高）而不可用，则必须通过 LANE_KEEP_ASSIST_STATE 属性中的 ErrorState 值来传达该信息。

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

LANE_KEEP_ASSIST_STATE

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

如果 LKA 包括在应用转向校正之前的车道偏离警告，则这些警告必须通过车道偏离警告 (LDW) 属性表面化。

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

更改模式：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.READonly。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

MIRROR_AUTO_TILT_ENABLED

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

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

MIRROR_FOLD

后视镜折叠。True 表示后视镜已折叠。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为 VehiclePropertyAccess.READonly。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

MIRROR_LOCK

后视镜锁定。True 表示后视镜位置已锁定且不可更改。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为 VehiclePropertyAccess.READonly。

更改模式：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.READonly。

更改模式：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.READonly。

更改模式：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.READonly。

更改模式：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.READonly。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

NIGHT_MODE

True 表示夜间模式传感器已检测到汽车座舱环境光线不足。平台可以使用此功能，例如，启用合适的 UI 以便在黑暗或光线不足的环境中更好地观看。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

OBD2_FREEZE_FRAME

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

此属性的值的解释方式应与 OBD2_LIVE_FRAME 的值类似，但 stringValue 字段可能包含非空的诊断故障代码 (DTC) 除外。

对此属性的 IVehicle#get 请求必须为 int64Values[0] 提供一个值。这将被解释为要检索的冻结帧的时间戳。可以通过 OBD2_FREEZE_FRAME_INFO 的 IVehicle#get 获取时间戳列表。

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

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

OBD2_FREEZE_FRAME_CLEAR

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

此属性的值的解释方式应与 OBD2_LIVE_FRAME 的值类似，但 stringValue 字段可能包含非空的诊断故障代码 (DTC) 除外。

对此属性的 IVehicle#get 请求必须为 int64Values[0] 提供一个值。这将解释为要检索的冻结帧的时间戳。可以通过 OBD2_FREEZE_FRAME_INFO 的 IVehicle#get 获取时间戳列表。

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

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：不适用
单位类型：不适用
发布版本：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 个元素）。

每个帧可能包含不同的传感器值子集，包括系统提供的传感器和供应商特定的传感器。为了支持这一点，属性值的 bytes 元素用作位掩码。Bytes 必须有足够的字节数来表示可能的传感器总数（在本例中，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
单位类型：N/A
发布版本：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 设置此属性以更改汽车电源策略。汽车电源策略服务订阅此属性并实际更改电源策略。该请求通过设置 VehiclePropValue 和电源策略的 ID 发出，该 ID 在 /vendor/etc/automotive/power_policy.xml 中定义。如果给定的 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 only。

更改模式：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.READonly。

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.READonly。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：不适用
发布版本：Android 13

REMOVE_USER

在 Android 用户被移除后由 Android 系统调用。HAL 可以使用此属性来移除等效用户。这是只写调用。Android 系统不期望 HAL 的回复。因此，此请求不应失败。如果无法移除等效的 HAL 用户，则 HAL 应将其标记为非活动状态或以其他方式恢复。

该请求通过设置 VehiclePropValue 和 RemoveUserRequest 定义的内容发出。例如，如果系统有 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 到 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 可以将其实现为仅读取。

更改模式：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 可以将其实现为仅读取。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

SEAT_EASY_ACCESS_ENABLED

表示座椅便捷进入功能属性。如果为 true，则自动调整座椅，以方便乘员进出车辆。每个区域 ID 必须映射到用户尝试使用便捷进入功能进/出的座椅。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅读取。

更改模式：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，除非支持 VehicleLightState 的所有枚举值，否则必须定义 VehicleAreaConfig#supportedEnumValues。

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

此属性定义为 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 可以将其实现为仅读取。

更改模式：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 可以

更改模式：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)，除非支持 VehicleLightState 的所有枚举值，否则必须定义 VehicleAreaConfig#supportedEnumValues。

更改模式：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)，除非支持 VehicleLightSwitch 的所有枚举值，否则必须定义 VehicleAreaConfig#supportedEnumValues。

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：VehicleLightSwitch
单位类型：不适用
发布版本：Android 14

STEERING_WHEEL_LOCKED

方向盘已锁定。如果为 true，则方向盘的位置已锁定且不可更改。此属性定义为 VehiclePropertyAccess.READ_WRITE，但 OEM 可以将其实现为仅读取。

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

STEERING_WHEEL_THEFT_LOCK_ENABLED

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 14

STORAGE_ENCRYPTION_BINDING_SEED

外部加密绑定种子。此值与本地密钥存储加密密钥混合使用。此属性包含 16 个字节，预计会持久保存在与 IVI 分开的 ECU 上。此属性最初由 AAOS 设置，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 为正数，而后一种情况下的请求 ID 为负数）。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 // 第 3 个用户（用户 11）
  • int32[12] 0 // 第 3 个用户标志（无）

  如果请求成功，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 系统响应是发出 ANDROID_POST_SWITCH 调用，该调用具有相同的请求 ID。例如，如果当前前台 Android 用户为 10，并且 HAL 请求切换到 11，则请求将是
  • int32[0] -108 // 请求 ID
  • int32[1] 4 // messageType: SwitchUserMessageType::VEHICLE_REQUEST
  • int32[2] 11 // Android 用户 ID

  如果请求成功并且 Android 有三个用户（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 系统。

  • 请求。前 N 个值由 INITIAL_USER_INFO 定义（其中索引 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 可以将其实现为仅读取。

更改模式：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。

请注意，用户身份验证发生在系统启动期间。takehe 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 中读取。bytes 是 VMS 协议中定义的序列化 VMS 消息，对于框架是不透明的。IVehicle#get 必须始终返回 StatusCode::NOT_AVAILABLE。

更改模式：ON_CHANGEREAD_WRITE
访问模式：READ_WRITE
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

VEHICLE_SPEED_DISPLAY_UNITS

用于显示的速度单位。指示用于向用户显示速度的单位类型。例如，米/秒、公里/小时或英里/小时。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 向 Car Watchdog 发出的作为心跳的事件。如果 VHAL 支持此属性，则 VHAL 应每三秒将系统正常运行时间写入此属性。Car Watchdog 订阅此属性并检查该属性是否每三秒更新一次。在三秒的缓冲时间下，Car Watchdog 最多等待六秒以发出心跳信号（从上次心跳开始算起）。如果未发出，Car Watchdog 会认为 VHAL 不健康并终止它。如果 VHAL 不支持此属性，则 Car Watchdog 不会检查 VHAL 健康状况。

更改模式：ON_CHANGE
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

WATCHDOG_ALIVE

定义 Car Watchdog 更新以指示其处于活动状态的事件。Car Watchdog 每三秒将此属性设置为系统正常运行时间（以毫秒为单位）。在启动期间，更新可能需要更长时间。

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

WATCHDOG_TERMINATED_PROCESS

定义由 Car Watchdog 终止的进程以及终止的原因。

int32Values[0] 1  // ProcessTerminationReason showing why a process is terminated. string: "/system/bin/log" // Process execution command

更改模式：ON_CHANGE
访问模式：WRITE
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

WHEEL_TICK

报告车轮刻度。向量中的第一个元素是重置计数。重置表示之前的刻度计数与此计数和将来的计数不具有可比性。刻度计数中发生某种不连续性。

接下来的四个元素表示单个车轮的刻度，顺序如下

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

所有刻度计数均为累积值。当车辆向前移动时，刻度计数会递增；当车辆向后移动时，刻度计数会递减。当车辆启动时，刻度应重置为 0。

• int64Values[0] 重置计数
• int64Values[1] 前左刻度
• int64Values[2] 前右刻度
• int64Values[3] 后右刻度
• int64Values[4] 后左刻度

configArray 用于指示每车轮刻度的微米值以及支持哪些车轮 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] 每前左车轮刻度的微米数
• configArray[2] 每前右车轮刻度的微米数
• configArray[3] 每后右车轮刻度的微米数
• configArray[4] 每后左车轮刻度的微米数。

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

必须填写 VehiclePropValue.timestamp。

更改模式：CONTINUOUS
访问模式：READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

WINDOW_LOCK

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

更改模式：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）。

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：不适用
单位类型：不适用
发布版本：Android 13

WINDSHIELD_WIPERS_PERIOD

挡风玻璃刮水器周期（毫秒）。返回挡风玻璃刮水器一个完整周期的瞬时时间周期（以毫秒为单位）。一个完整周期定义为刮水器从静止位置移动并返回静止位置。当选择间歇式刮水器设置时，此属性值必须在间歇式刮水的暂停期间设置为 0。必须在 VehicleAreaConfig 中定义 maxInt32Value 和 minInt32Value。每个区域 ID 的 maxInt32Value 必须指定最长的刮水器周期。minInt32Value 必须为每个区域 ID 设置为 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，除非支持 WindshieldWipersState 中的所有状态（包括不建议使用的 OTHER），否则必须定义 VehicleAreaConfig#supportedEnumValues 数组。

更改模式：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，除非支持 WindshieldWipersSwitch 中的所有状态（包括不建议使用的 OTHER），否则必须定义 VehicleAreaConfig#supportedEnumValues 数组。

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

更改模式：ON_CHANGE
访问模式：READ_WRITE/READ
枚举类型：WindshieldWipersSwitch
单位类型：不适用
发布版本：Android 14