サポートされているシステム プロパティ

このページでは、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 実装は、プロパティ構成が仕様を遵守したものとなるように、これらを使用できます。

ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE

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

如果未检测到前车(即,没有前车;或与前车相距太远,传感器无法检测到),此属性应返回 StatusCode.NOT_AVAILABLE

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

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

ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP

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

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

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

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

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

ABS_ACTIVE

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

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

ANDROID_EPOCH_TIME

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

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

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

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

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

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

AP_POWER_BOOTUP_REASON

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

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

AP_POWER_STATE_REPORT

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

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

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

AP_POWER_STATE_REQ

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

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

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

AUTOMATIC_EMERGENCY_BRAKING_ENABLED

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

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

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

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

AUTOMATIC_EMERGENCY_BRAKING_STATE

自动紧急制动 (AEB) 状态。返回 AEB 的当前状态。此属性必须始终返回 AutomaticEmergencyBrakingState 或 ErrorState 中定义的有效状态。它不得通过 StatusCode 显示错误,而必须改用受支持的错误状态。此属性应仅适用于车速较高的应用场景。如需表示低速自动紧急制动系统的状态,应使用 LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE

如果 AEB 在启用刹车之前包含前向碰撞警告,这些警告必须通过前向碰撞警告 (FCW) 属性显示。

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

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

BLIND_SPOT_WARNING_ENABLED

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

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

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

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

BLIND_SPOT_WARNING_STATE

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

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

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

CABIN_LIGHTS_STATE

返回车厢灯的状态。

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

CABIN_LIGHTS_SWITCH

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

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

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

CLUSTER_DISPLAY_STATE

更改仪表板屏幕的状态。

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

可能的值为:

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

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

CLUSTER_NAVIGATION_STATE

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

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

CLUSTER_REPORT_STATE

报告当前显示状态和 ClusterUI 状态。 ClusterHome 在处理 CLUSTER_SWITCH_UICLUSTER_DISPLAY_STATE 时发送此消息。此外,ClusterHome 应在首次启动时发送此消息。当 ClusterOS 收到此消息时,如果内部预期与收到的消息不同,那么它应会再次发送 CLUSTER_SWITCH_UICLUSTER_DISPLAY_STATE 以匹配状态。

  • int32[0] 开启/关闭:0 - 关闭,1 - 开启
  • int32[1] 边界 - 左
  • int32[2] 边界 - 上
  • int32[3] 边界 - 右
  • int32[4] 边界 - 下
  • int32[5] 边衬区 - 左
  • int32[6] 边衬区 - 上
  • int32[7] 边衬区 - 右
  • int32[8] 边衬区 - 下
  • int32[9] 全屏或主屏幕中的 ClusterUI 类型。0 表示 ClusterHome。其他值则按照 OEM 的定义。
  • int32[10] 子屏幕中的 ClusterUI 类型,如果当前显示两个界面的话。-1 表示该区域不再使用。字节:表示 ClusterUI 可用性的数组。0 表示不可用,1 表示可用。例如,如果汽车支持 OEM 定义的三个 ClusterUI(例如 HOME、MAPS 和 CALL),并且仅在移动网络可用时支持 CALL 界面。然后,如果网络可用,它发送 [1 1 1];如果网络不可用,则发送 [1 1 0]。

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

CLUSTER_REQUEST_DISPLAY

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

  • int32 要显示的 ClusterUI 类型

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

CLUSTER_SWITCH_UI

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

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

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

CREATE_USER

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

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

  • int32[0] 42 // 请求 ID
  • int32[1] 11 // 所创建用户的 Android ID
  • int32[2] 6 // 所创建用户的 Android 标志(临时访客)
  • int32[3] 10 // 当前用户
  • int32[4] 0 // 当前用户标志(无)
  • int32[5] 3 // 用户数量
  • int32[6] 0 // 第一位用户(用户 0)
  • int32[7] 0 // 第一位用户标志(无)
  • int32[8] 10 // 第二位用户(用户 10)
  • int32[9] 0 // 第二位用户标志(无)
  • int32[10] 11 // 第三位用户(用户 11)
  • int32[11] 6 // 第三位用户标志(临时访客)字符串:"ElGuesto" // 新用户的名称

如果请求成功,HAL 会返回:

  • int32[0] 42 // 请求 ID
  • int32[1] 1 // CreateUserStatus::SUCCESS

但如果失败,则返回:

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

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

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

CRITICALLY_LOW_TIRE_PRESSURE

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

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

CRUISE_CONTROL_COMMAND

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

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

CRUISE_CONTROL_ENABLED

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

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

CRUISE_CONTROL_STATE

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

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

CRUISE_CONTROL_TARGET_SPEED

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

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

CRUISE_CONTROL_TYPE

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

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

CURRENT_GEAR

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

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

CURRENT_POWER_POLICY

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

string: "sample_policy_id" // power policy ID

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

DISABLED_OPTIONAL_FEATURES

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

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

DISPLAY_BRIGHTNESS

用于表示显示屏亮度的属性。 某些车辆只有一个用于控制所有显示屏亮度的控件。此属性用于共享对该控件的更改。如果配备了亮度受单独控制的显示屏,汽车必须使用 PER_DISPLAY_BRIGHTNESS。应仅实现 DISPLAY_BRIGHTNESSPER_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 中的 maxInt32ValueminInt32Value。必须支持 minInt32ValuemaxInt32Value 之间的所有整数。maxInt32Value 表示车门在打开时的最快移动速度。minInt32Value 表示车门在关闭时的最慢移动速度。

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

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

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

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

DOOR_POS

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

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

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

E~G

ELECTRONIC_TOLL_COLLECTION_CARD_STATUS

有料道路自動料金収受システムのカード ステータス。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: ElectronicTollCollectionCardStatus
ユニットタイプ: なし
リリース: Android 13

ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

有料道路自動料金収受システムのカードタイプ。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: ElectronicTollCollectionCardType
ユニットタイプ: なし
リリース: Android 13

EMERGENCY_LANE_KEEP_ASSIST_ENABLED

緊急車線逸脱防止支援(E-LKA)の有効化または無効化。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

EMERGENCY_LANE_KEEP_ASSIST_STATE

緊急車線逸脱防止支援(E-LKA)状態。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: EmergencyLaneKeepAssistState/ErrorState
ユニットタイプ: なし
リリース: Android 14

ENGINE_COOLANT_TEMP

エンジン冷却水の温度。

変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:CELSIUS
リリース: Android 13

ENGINE_IDLE_AUTO_STOP_ENABLED

エンジンのアイドリングの自動停止機能を示します。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

ENGINE_OIL_LEVEL

エンジンオイルのレベル。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleOilLevel
ユニットタイプ: なし
リリース: Android 13

ENGINE_OIL_TEMP

エンジンオイルの温度。

変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:CELSIUS
リリース: Android 13

ENGINE_RPM

1 分あたりのエンジン回転数(RPM)。

変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:RPM
リリース: Android 13

ENV_OUTSIDE_TEMPERATURE

外気温。

変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:CELSIUS
リリース: Android 13

EV_BATTERY_DISPLAY_UNITS

EV バッテリー ユニットの表示。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: VehicleUnit
ユニットタイプ: なし
リリース: Android 13

EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

EV 即時充電速度(ミリワット単位)。

変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:MW
リリース: Android 13

EV_BATTERY_LEVEL

EV 車またはハイブリッド車のバッテリー残量。

変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:WH
リリース: Android 13

EV_BRAKE_REGENERATION_LEVEL

電気自動車の回生ブレーキレベル。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

EV_CHARGE_CURRENT_DRAW_LIMIT

ユーザーが設定した充電の最大電流しきい値を示します。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: VehicleUnit:AMPERE
リリース: Android 13

EV_CHARGE_PERCENT_LIMIT

ユーザーが設定した最大充電率のしきい値を示します。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

EV_CHARGE_PORT_CONNECTED

接続されている EV 充電ポート。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

EV_CHARGE_PORT_OPEN

開いている EV 充電ポート。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

EV_CHARGE_STATE

車両の充電状態。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: EvChargeState
ユニットタイプ: なし
リリース: Android 13

EV_CHARGE_SWITCH

EV バッテリーの充電の開始または停止。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

EV_CHARGE_TIME_REMAINING

予想充電残り時間(秒単位)。

変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:SECS
リリース: Android 13

EV_CURRENT_BATTERY_CAPACITY

EV 車またはハイブリッド車の現在のバッテリー容量。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:WH
リリース: Android 13

EV_REGENERATIVE_BRAKING_STATE

車両の回生ブレーキまたはワンペダル ドライブの状態。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: EvRegenerativeBrakingState
ユニットタイプ: なし
リリース: Android 13

EV_STOPPING_MODE

車両の現在の停止モードのプロパティを示します。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: EvStoppingMode
ユニットタイプ: なし
リリース: Android 13

EVS_SERVICE_REQUEST

EVS サービスの有効化およびリクエスト。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

EXTERNAL_CAR_TIME

エポック時刻でエンコードした、車両の現在の日付と時刻の候補(ミリ秒単位)。 この値は 1970 年 1 月 1 日 UTC からの経過ミリ秒数を表します。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:MILLI_SECS
リリース: Android 13

FOG_LIGHTS_STATE

霧用ライトの状態。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleLightState
ユニットタイプ: なし
リリース: Android 13

FOG_LIGHTS_SWITCH

霧用ライトのスイッチ。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: VehicleLightSwitch
ユニットタイプ: なし
リリース: Android 13

FORWARD_COLLISION_WARNING_ENABLED

前方衝突警告(FCW)の有効化または無効化。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

FORWARD_COLLISION_WARNING_STATE

前方衝突警告(FCW)の状態。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: ForwardCollisionWarningState/ErrorState
ユニットタイプ: なし
リリース: Android 14

FRONT_FOG_LIGHTS_STATE

霧用フロントライトの状態。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleLightState
ユニットタイプ: なし
リリース: Android 13

FRONT_FOG_LIGHTS_SWITCH

霧用フロントライトのスイッチ。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: VehicleLightSwitch
ユニットタイプ: なし
リリース: Android 13

FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

燃費ユニットの表示。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

FUEL_DOOR_OPEN

給油口のドアの開き。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

FUEL_LEVEL

車両の燃料残量(ミリリットル単位)。

変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:MILLILITER
リリース: Android 13

FUEL_LEVEL_LOW

燃料低下の警告。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

FUEL_VOLUME_DISPLAY_UNITS

燃料ユニットの表示。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: VehicleUnit
ユニットタイプ: なし
リリース: Android 13

GEAR_SELECTION

現在選択されているギア。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleGear
ユニットタイプ: なし
リリース: Android 13

GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT

EU の一般安全規則の準拠要件。

変更モード: STATIC
アクセスモード: READ
列挙型: GsrComplianceRequirementType
ユニットタイプ: なし
リリース: Android 14

GLOVE_BOX_DOOR_POS

グローブ ボックスの扉の現在の位置を表すプロパティ。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

GLOVE_BOX_LOCKED

グローブ ボックスのロックとロック解除。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

H~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)の有効化または無効化。HOD を有効化するには true に、無効化するには false に設定します。HOD が有効になっている場合、車両内部のシステムによって、ドライバーの手がハンドル上にあることをモニタリングし、ドライバーの手がハンドルから離れた場合は警告を送信します。通常、HANDS_ON_DETECTION_ENABLED は常に true または false を返します。

なんらかの一時的な状態によりこの機能が使用できない場合、その情報は HANDS_ON_DETECTION_STATE プロパティの ErrorState 値を通して伝達される必要があります。このプロパティは、minInt32Value VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ のみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: 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_SETAreaIDs の組み合わせを含むものとします。HVAC_TEMPERATURE_SETAreaIDs[a_1, a_2, ..., a_n] にマッピングされる場合で、HVAC_DUAL_ON を a_i と a_j と連結できる場合は、HVAC_DUAL_ON プロパティが [a_i | a_j] にマッピングされている必要があります。さらに、a_k と a_l を個別に連結することもできる場合は、HVAC_DUAL_ON が [a_i | a_j, a_k | a_l] にマッピングされている必要があります。たとえば、前部に 2 席(ROW_1_LEFTROW_1_RIGHT)、後部に 3 席(ROW_2_LEFT、ROW_2_CENTER、ROW_2_RIGHT)ある車の場合、温度制御装置は 2 つ(運転席側と助手席側)あり、任意で同期できます。これは、AreaIDs で次のように表すことができます。

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

プロパティが有効になっている場合、ECU は影響を受けるエリアの温度と同期させる必要があります。DUAL_ON パラメータをオンまたはオフにした副作用として変更されたパラメータは、いずれも VHAL への onPropertyEvent() コールバックを生成します。さらに、温度設定(運転席の温度など)によって別の温度(助手席の温度など)が変わる場合は、適切な onPropertyEvent() コールバックを生成する必要があります。

ユーザーが結合を解く温度変更をした場合(助手席の温度を個別に設定するなど)、VHAL が適切な onPropertyEvent() コールバック(HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx を含む)送信する必要があります。このプロパティは、VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ として実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: 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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

  • 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 パラメータをオンまたはオフにする副作用として変更されるパラメータは、いずれも VHAL への onPropertyEvent() コールバックを生成します。このプロパティは、VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ として実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

HVAC_MAX_DEFROST_ON

MAX DEFROST のオンとオフ。MAX DEFROST をオンにすると、ECU が吹き出し口の位置、ファン速度、温度などの要素を必要に応じて調整し、窓の曇りをできるだけ早く取ります。MAX DEFROST パラメータをオンまたはオフにした副作用として変更されるパラメータは、いずれも VHAL への onPropertyEvent() コールバックを生成します。HVAC_MAX_DEFROST_ONAreaIDs は、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 の電源を入れる必要があります。VehiclePropConfig.configArrayHvacPower_DependentProperties リストを設定する必要があります。HvacPower_DependentProperties には VehicleArea:SEAT に関連付けられているプロパティのみを含めなければなりません。

HVAC_POWER_ON プロパティにマッピングする AreaID には、HvacPower_DependentProperties がマッピングされるすべての AreaIDs を含める必要があります。たとえば、自動車には以下の 2 つがあります。

  1. 前部の座席(ROW_1_LEFTROW_1_RIGHT)と後部の 3 席(ROW_2_LEFT、ROW_2_CENTER、ROW_2_RIGHT)。自動車全体の HVAC 機能(エアコン、温度など)は 1 つの HVAC 電源コントローラに依存しており、HVAC_POWER_ON は [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT] にマッピングされる必要があります。
  2. 1 列目の座席(ROW_1_LEFTROW_1_RIGHT)、2 列目の 3 席(ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT)、3 列目(ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT)。車の 1 列目に全体および車両後部の温度コント―ローラを個別に操作できる温度コントローラがある場合、HVAC_POWER_ON は、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
    

このプロパティは、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

座席の暖房と冷房。maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value 間のすべての整数がサポートされている必要があります。

maxInt32Value は、座席の暖房に設定できる最高温度を示します。minInt32Value は、車が座席の冷房にも対応している場合を除いて 0 にする必要があります。冷房に対応している場合、minInt32Value は座席の冷房に設定できる最低温度を示します。このプロパティは、特定の単位ではなく、指定した相対温度設定の範囲を使用します。このプロパティは、VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ として実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

HVAC_SEAT_VENTILATION

シート ベンチレーション。VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。minInt32Value は 0 にする必要があります。maxInt32Value は、座席に設定できるベンチレーションの最大値を示します。

このプロパティは、特定の単位ではなく、ベンチレーション設定の指定範囲を使用します。

HVAC アプリとアシスタントで使用して、シート ベンチレーションの状態を有効化、変更、読み取りできます。これは、座席の冷房とは異なります。冷房と同時にオンにすることも、またはしないこともできます。

このプロパティは >VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

HVAC_SIDE_MIRROR_HEAT

サイドミラー ヒーター。値が大きい方が、サイドミラーの暖房レベルが高いことを表します。VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。構成データには以下が含まれます。

  • maxInt32Value は、暖房レベルの最大値を表します。
  • minInt32Value は、0 でなければならず、これは暖房を使用しないことを示します。

このプロパティは、特定の単位ではなく、相対的な温度設定の指定範囲を使用します。このプロパティは、VehiclePropertyAccess.READ_WRITE として定義されますが、OEM では VehiclePropertyAccess.READ として実装する方法もあります。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

HVAC_STEERING_WHEEL_HEAT

ハンドルの暖房量と冷房量の設定。VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。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 の設定温度。

VehicleAreaConfigminFloatValuemaxFloatValue を定義する必要があります。

  • minFloatValue は、摂氏での最低温度の設定です。
  • maxFloatValue は、摂氏での最高温度の設定です。

minFloatValuemaxFloatValue の間のすべての値がサポートされていない場合は、configArray を使用して設定できる有効な温度値を列挙します。また、これによって、車両の温度を摂氏から華氏(またはその逆)に変換するルックアップ テーブルも記述されます。車で標準単位の換算がサポートされていない場合は、configArray を定義する必要があります。

configArray の設定は次のとおりです。

  • configArray[0] [摂氏でサポートされている温度の下限] * 10
  • configArray[1] [摂氏でサポートされている温度の上限] * 10
  • configArray[2] [摂氏の増加単位] * 10
  • configArray[3] [華氏でサポートされている温度の下限] * 10
  • configArray[4] [華氏でサポートされている温度の上限] * 10
  • configArray[5] [華氏の増加単位] * 10

VehicleAreaConfigminFloatValuemaxFloatValue はそれぞれ configArray[0]configArray[1] と同じである必要があります。たとえば、車が温度値を華氏で [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5] としてサポートしている場合、configArrayconfigArray = {160, 280, 5, 605, 845, 10} にする必要があります。

摂氏の増加率の華氏の増加率に対する比率は、1 度(摂氏)対 1.8 度(華氏)という実際の比率に近づけることをおすすめします。華氏のすべての値に対する摂氏のすべての値が 1 対 1 の関係でマッピングされるように configArray で定義する必要があります。configArray は、クライアントがこのプロパティの温度を摂氏から華氏に変換するために使用されます。また、これによってどの摂氏値を設定するとプロパティが希望するシステムの華氏値に達するのかをクライアントに知らせることができます。ECU に摂氏のすべての値と華氏のすべての値の 1 対 1 のマッピングがない場合、configArray は、1 対 1 のマッピングを有する摂氏の値と華氏の値のリストのみを定義する必要があります。

たとえば、ECU が摂氏の値は 16 から 28 まで、華氏の値は 60 から 85 までサポートする場合、1 増分あたり、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] に設定します。摂氏 21 度に対して OEM が提示した値が華氏 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] キーコード。KEYCODE_HOMEKEYCODE_BACK などの標準の Android キーコードを使用する必要があります。
  • int32array[2] VehicleHwKeyInputAction で定義されるアクション。例:
    VehicleHwKeyInputAction::ACTION_UPVehicleHwKeyInputAction::ACTION_UP
  • int32array[3] イベントの繰り返しカウンタ。キーダウン イベントの場合、これは最初のダウンが 0 で始まり、そこから数え上げていく繰り返しのカウントです。キーアップ イベントの場合、これは常に 0 と同等です。
  • int64array[0] 前回の起動時から経過したダウンタイム(ナノ秒単位)。直近のキーダウン イベントの時間を示します。ダウンイベントの場合、これはダウンイベントのイベントタイムのことです。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

HW_MOTION_INPUT

ハードウェア入力イベントを Android に送るプロパティ。

  • int32array[0] VehicleDisplay で定義される対象のディスプレイ。例 :
    VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTERVehicleDisplay::AUX
  • int32array[1] VehicleHwMotionInputSource で定義される入力タイプ。例:
    VehicleHwMotionInputSource::SOURCE_KEYBOARDVehicleHwMotionInputSource::SOURCE_DPAD
  • int32array[2] VehicleHwMotionInputAction で定義されるアクション コード。例:
    VehicleHwMotionInputAction::ACTION_UPVehicleHwMotionInputAction::ACTION_DOWN
  • int32array[3] VehicleHwMotionButtonStateFlag で定義されるボタン状態フラグ。例:
    VehicleHwMotionButtonStateFlag::BUTTON_PRIMARYVehicleHwMotionButtonStateFlag::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_FINGERVehicleHwMotionToolType::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 車またはハイブリッド車のバッテリー公称容量。バッテリーの公称容量(EV またはハイブリッド)を返します。これは、車両が新車の場合に使用可能なバッテリーの総容量です。EV_CURRENT_BATTERY_CAPACITY は、バッテリーの経年変化や温度依存性などの要素を考慮に入れて、リアルタイムで使用可能なバッテリー容量を返すため、この値は EV_CURRENT_BATTERY_CAPACITY と異なることがあります。

変更モード: STATIC
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:WH
リリース: Android 13

INFO_EV_CONNECTOR_TYPE

この EV が使用する可能性のあるコネクタのリスト。車に複数の充電ポートがある場合、このプロパティは、その車の充電ポートの少なくとも 1 つで使用可能なコネクタタイプをすべて返す必要があります。

変更モード: STATIC
アクセスモード: READ
列挙型: EvConnectorType
ユニットタイプ: なし
リリース: Android 13

INFO_EV_PORT_LOCATION

このプロパティでは、PortLocationType 列挙型を使用して、EV の充電ポートの場所を伝える必要があります。車両に複数のポートがある場合、このプロパティは最急速充電が可能なポートを返す必要があります。すべてのポートの場所を伝えるには、INFO_MULTI_EV_PORT_LOCATIONS を使用します。

EV ポートの場所: STATIC
アクセスモード: READ
列挙型: PortLocationType
ユニットタイプ: なし
リリース: Android 13

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 を実装してはなりません。EV の場合は、INFO_EV_BATTERY_CAPACITY を実装します。

変更モード: STATIC
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:MILLILITER
リリース: Android 13

INFO_FUEL_DOOR_LOCATION

給油口扉の位置。このプロパティでは、車両の給油口扉の位置を伝える必要があります。このプロパティは EV には適用されません。つまり、INFO_FUEL_TYPE に含まれているのが FuelType::FUEL_TYPE_ELECTRIC のみの場合、このプロパティを実装してはなりません。EV の場合は、INFO_EV_PORT_LOCATION または INFO_MULTI_LOCATIONS を実装します。

変更モード: STATIC
アクセスモード: READ
列挙型: PortLocationType
ユニットタイプ: なし
リリース: Android 13

INFO_FUEL_TYPE

車両で使用できる燃料のリスト。FuelType::FUEL_TYPE_ELECTRIC は、車両がプラグイン充電可能な場合にのみ含める必要があります。たとえば、フル ハイブリッド電気自動車(FHEV)には INFO_FUEL_TYPE の INT32_VEC 値として FuelType::FUEL_TYPE_ELECTRIC を含めてはなりません。INFO_FUEL_TYPE は、このように入力することができます。

int32Values = { FuelType::FUEL_TYPE_UNLEADED }
一方、プラグイン ハイブリッド電気自動車(PHEV)はプラグイン充電式であり、FuelType::FUEL_TYPE_ELECTRICINFO_FUEL_TYPE の INT32_VEC 値として含める必要があります。INFO_FUEL_TYPE は、int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC } のように入力することができます。

変更モード: 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

複数の EV ポートの位置。車両に複数の EV ポートがある場合は、このプロパティを実装します。ポートの位置は、PortLocationType で定義されます。たとえば、ポートが左前に 1 つ、左後ろに 1 つある場合:

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

ポートが 1 つのみの車両の場合、このプロパティの値には 1 つの要素を記述します。1 つのポートの位置を記述するには、INFO-EV-PORT-LOCATION をご覧ください。

.

変更モード: STATIC
アクセスモード: READ
列挙型: PortLocationType
ユニットタイプ: なし
リリース: Android 13

INFO_VIN

車両識別番号。

変更モード: STATIC
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

INITIAL_USER_INFO

初期化中に使用する Android ユーザーを定義します。このプロパティは、Android システムによって初期化時に呼び出され、これにより HAL は開始する Android ユーザーを定義することができます。VehiclePropValue(InitialUserInfoRequest で定義済み)を設定すると、このリクエストが行われ、HAL はプロパティ変更イベント(InitialUserInfoResponse で定義済み)を使用して応答する必要があります。Android システムが定義した時刻の後に HAL が応答しない場合、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)
HAL が、オーナーと呼ばれる管理者ユーザーを作成して応答する場合、応答は以下のようになります。
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
文字列値は、|| で区切られた複数の値を表します。最初の値は、作成するユーザー用の(任意の)システムの言語 / 地域(この場合、空欄は Android のデフォルト値の使用を意味します)で、2 つ目の値は作成するユーザーの(任意の)名前(応答のタイプが InitialUserInfoResponseAction:CREATE の場合)となります。たとえば、en-US と pt-BR の言語 / 地域で同じオーナー ユーザーを作成するには、応答の文字列値は en-US,pt-BR||Owner となります。したがって、縦棒 1 本(|)は使用できますが、言語 / 地域にも名前にもそれぞれの値に縦棒を 2 本(||)含めることはできません。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

J~R

LANE_CENTERING_ASSIST_COMMAND

車線維持支援(LCA)のコマンド。LCA を有効化および一時停止するコマンド。LaneCenteringAssistCommand からコマンド ACTIVATE が送信される場合、LANE_CENTERING_ASSIST_STATELaneCenteringAssistState#ACTIVATION_REQUESTED に設定する必要があります。ACTIVATE コマンドが成功すると、LANE_CENTERING_ASSIST_STATELaneCenteringAssistState#ACTIVATED に設定する必要があります。LaneCenteringAssistCommand からコマンド DEACTIVATE が成功すると、LANE_CENTERING_ASSIST_STATELaneCenteringAssistState#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_STATEErrorState#NOT_AVAILABLE_SPEED_LOW に設定されている場合、このプロパティは StatusCode#NOT_AVAILABLE_SPEED_LOW を返す必要があります。

変更モード: ON_CHANGE
アクセスモード: WRITE
列挙型: LaneCenteringAssistCommand
ユニットタイプ: なし
リリース: Android 14

LANE_CENTERING_ASSIST_ENABLED

車線維持支援(LCA)の有効化または無効化。LCA を有効化するには true、無効化するには false に設定します。LCA が有効な場合、車両の ADAS システムはオンになっており、ドライバーからのアクティベーション シグナルを待機しています。この機能が有効化されると、ADAS システムは車両が現在の車線の中央を維持するよう操縦します。

これは、不意にドライバーが車線区画線の方へ寄ったり、はみ出したりしないかをモニタリングする車線逸脱防止支援(LKA)とは異なります。意図しない車線の逸脱が検知されると、システムは車両を現在の車線に戻すようステアリング操作を適用します。通常、LANE_CENTERING_ASSIST_ENABLED は常に true または false を返す必要があります。なんらかの一時的な状態が原因で(車両速度が極端に遅いまたは早いなど)、この機能が利用できない場合、この情報を LANE_CENTERING_ASSIST_STATE プロパティの ErrorState 値を通じて伝達する必要があります。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: 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)の有効化または無効化。LDW を有効化するには true、無効化するには false に設定します。LDW が有効な場合、車両の ADAS システムはオンになり、車両が車線境界線に近づいたり、超えたりしないかどうかをモニタリングし、超えた場合には警告が発出されます。

通常、LANE_DEPARTURE_WARNING_ENABLED は常に true または false を返す必要があります。なんらかの一時的な状態が原因で(車両速度が極端に遅いまたは早いなど)、この機能が利用できない場合、この情報を LANE_DEPARTURE_WARNING_STATE プロパティの ErrorState 値を通じて伝達する必要があります。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: 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)の有効化または無効化。LKA を有効化するには true、無効化するには false に設定します。LKA が有効な場合、車両の ADAS システムはオンになり、不意にドライバーが車線区画線の方へ寄ったり、はみ出したりしないかをモニタリングします。意図しない車線の逸脱が検知されると、システムは車両を現在の車線に戻すようステアリング操作を適用します。これは、車線維持支援(LCA)とは異なります。有効時に、車両が現在の車線の中央を維持するよう継続的な操縦を適用します。

通常、LANE_KEEP_ASSIST_ENABLED は常に true または false を返す必要があります。なんらかの一時的な状態が原因で(車両速度が極端に遅いまたは早いなど)、この機能が利用できない場合、この情報を LANE_KEEP_ASSIST_STATE プロパティの ErrorState 値を通じて伝達する必要があります。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: 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.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

MIRROR_AUTO_TILT_ENABLED

ミラーの自動角度調節機能に対するプロパティを表します。このプロパティは、自動的に車両のサイドミラーを傾ける機能(車両をバックさせる際に、自動的にミラーが下方向に傾く場合など)が有効な場合に true となります。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

MIRROR_FOLD

ミラーの折りたたみ。true はミラーが折りたたまれることを示します。このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM では VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

MIRROR_LOCK

ミラーの固定。true は、ミラーの位置が固定されて変更できないことを示します。このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

MIRROR_Y_MOVE

ミラー Y 動作。各 VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

maxInt32Value は、ミラーが右方向へ傾く際の最大動作速度を表します。minInt32Value は、ミラーが左方向へ傾く際の最大動作速度を表します。

正か負のいずれか大きい方の絶対値がより速い動作速度を表します。ミラーが限界位置に達したら、値を 0 にリセットする必要があります。MIRROR_Y_MOVE の値が現時点で 0 の場合、現在動作が生じていないことを意味します。

このプロパティは、特定の単位ではなく、動作の相対速度の指定の範囲を使用します。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

MIRROR_Y_POS

ミラーの Y 位置。VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。minInt32Value は、ミラーが最大限左方向に傾いていることを示します。

この値は、正の値であってはなりません。maxInt32Value は、ミラーが最大限右方向に傾いていることを示します。この値は、負の値であってはなりません。0 は、ミラーがいずれの方向にも傾いていないことを示します。

minInt32ValuemaxInt32Value の間の値は、左右の最大位置の間の移行状態を示します。

このプロパティは、特定の単位ではなく、相対位置の指定の範囲を使用します。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

MIRROR_Z_MOVE

ミラーの Z 動作。各 VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

maxInt32Value は、ミラーが上方向へ傾く際の最大動作速度を表します。minInt32Valueは、ミラーが下方向へ傾く際の最大動作速度を表します。正か負のいずれか大きい方の絶対値がより速い動作速度を表します。ミラーが限界位置に達したら、値を 0 にリセットする必要があります。MIRROR_Z_MOVE' の値が現時点で 0 の場合、現在動作が生じていないことを意味します。

このプロパティは、特定の単位ではなく、動作の相対速度の指定の範囲を使用します。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

MIRROR_Z_POS

ミラーの Z 位置。VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。minInt32Value は、ミラーが完全に下方向に傾いていることを示します。この値は、正の値であってはなりません。maxInt32Value は、ミラーが完全に上方向に傾いていることを示します。この値は、負の値であってはなりません。0 は、ミラーがいずれの方向にも傾いていないことを示します。

minInt32ValuemaxInt32Value の間の値は、上下の最大位置の間の移行状態を示します。

このプロパティは、特定の単位ではなく、相対位置の指定の範囲を使用します。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: 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 + 2 要素(または、33 要素)を含むベクターでなければならないと考えます。floatValues は、Obd2FloatSensorIndex.LAST_SYSTEM_INDEX + 3 要素(または、73 要素)を含むベクターでなければなりません。

各フレームは、システムが提供するセンサーとベンダー固有のセンサーの両方で、センサー値の異なるサブセットを含むことができます。これをサポートするために、プロパティ値のバイト要素はビットマスクとして使用されます。バイトには、取り得るセンサーの合計数を表す十分なバイト数が必要です(この場合、106 個の取り得る値を表すために 14 バイト)。int32Values のサイズと同じビット数で始まり、直後に floatValues のサイズと同じビット数が続いて、各ビットがフレームからのセンサーの有無を示すような連続したビットマスクとして読み取られます。

たとえば、bytes[0] = 0x4C (0b01001100) は以下を意味します。

  • int32Values[0 and 1] は、有効なセンサー値ではありません
  • int32Values[2 and 3] は、有効なセンサー値です
  • int32Values[4 and 5] は、有効なセンサー値ではありません
  • int32Values[6] は、有効なセンサー値です
  • int32Values[7] は、有効なセンサー値ではありません
  • int32Values[0 and 1] は、有効なセンサー値ではありません
  • int32Values[2 and 3] は、有効なセンサー値です
  • int32Values[4 and 5] は、有効なセンサー値ではありません
  • int32Values[6] は、有効なセンサー値です
  • int32Values[7] は、有効なセンサー値ではありません

bytes[5] = 0x61 (0b01100001) の場合は、次のとおりです。

  • int32Values[32] は、有効なセンサー値です
  • floatValues[0 thru 3] は、無効なセンサー値です
  • floatValues[4 and 5] は、有効なセンサー値です
  • floatValues[6] は、有効なセンサー値ではありません

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

ON_CHANGE

変更モード:
アクセスモード: READ_WRITE/READ
列挙型: VehicleLightSwitch
ユニットタイプ: なし
リリース: Android 13

PARKING_BRAKE_AUTO_APPLY

自動適用のパーキング ブレーキ。true の場合、このプロパティは、車の自動パーキング ブレーキが有効であることを示します。false は、車の自動パーキング ブレーキ機能が無効であることを示します。このプロパティは、PARKING_BRAKE_ON とよく混同されます。PARKING_BRAKE_ON が実際のパーキング ブレーキがオンまたはオフであることを示す一方、PARKING_BRAKE_AUTO_APPLY は自動パーキング ブレーキ機能が有効か無効化を示し、実際のパーキング ブレーキの現在の状態を説明するわけではありません。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

PARKING_BRAKE_ON

パーキング ブレーキの状態。true の場合、このプロパティは、車のパーキング ブレーキがかかっていることを示します。false は、車のパーキング ブレーキが解除されていることを示します。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

PER_DISPLAY_BRIGHTNESS

プロパティは、個別に制御されるディスプレイの明るさを表します。一部の車は、個別に明るさを制御できるディスプレイを 1 つ以上備えており、このプロパティは、各座席のディスプレイの明るさを通知するためのものです。すべてのディスプレイの明るさをまとめて制御する車では、DISPLAY_BRIGHTNESS を使用する必要があります。

PER_DISPLAY_BRIGHTNESSPER_DISPLAY_BRIGHTNESS のうち 1 つのみを実装する必要があります。どちらも利用可能な場合は、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_SELECTIONGEAR_NEUTRAL の場合、PERF_VEHICLE_SPEED は、車両の前進時に正、後退時に負、動いていないときはゼロとなります。

変更モード: CONTINUOUS
アクセスモード: READ
ユニットタイプ: なし
ユニットタイプ: VehicleUnit:METER_PER_SEC
リリース: Android 13

PERF_VEHICLE_SPEED_DISPLAY

ディスプレイの車両速度。一部の車両では、実際の速度よりもわずかに遅い速度がスピードメーターに表示されます。

変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:METER_PER_SEC
リリース: Android 13

POWER_POLICY_GROUP_REQ

電源の状態遷移のたびに、デフォルトの電源ポリシーの決定に使用される電源ポリシー グループを設定するリクエストを定義します。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

POWER_POLICY_REQ

電源ポリシーを適用するリクエストを定義します。VHAL でこのプロパティを設定し、自動車の電源ポリシーを変更します。自動車の電源ポリシー サービスはこのプロパティに登録して、実際に電源ポリシーを変更します。/vendor/etc/automotive/power_policy.xml で定義される電源ポリシーの ID を使用して VehiclePropValue を設定することで、リクエストが行われます。特定の ID が定義されていない場合、自動車の電源ポリシー サービスはリクエストを無視して、現在の電源ポリシーを維持します。

string: "sample_policy_id" // power policy ID

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

POWER_POLICY_GROUP_REQ

電源の状態遷移のたびに、デフォルトの電源ポリシーの決定に使用される電源ポリシー グループを設定するリクエストを定義します。VHAL は、電源の状態遷移時に適用されるデフォルトの電源ポリシーを設定するために、電源ポリシー グループの ID を使用してこのプロパティを設定します。電源ポリシー グループは、/vendor/etc/power_policy.xml で定義されます。特定の ID が定義されていない場合は、自動車の電源ポリシー サービスはリクエストを無視します。自動車の電源ポリシー サービスは、このプロパティを登録し、電源ポリシー グループを設定します。電源ポリシーは、システムの電源ステータスが変わり、新しい電源ステータスに対して、マッピングされた有効な電源ポリシーがある場合に実際に適用されます。

string: "sample_policy_group_id" // power policy group ID

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

RANGE_REMAINING

残りの航続可能距離。燃料および充電の残りのメーター。残りの航続可能距離は、車両のすべてのエネルギー源を考慮に入れるものとします。たとえば、ハイブリッド車における航続可能距離は、燃料とバッテリーに基づく航続可能距離の合計となります。今後のルートに基づくより正確な推定値がある場合、ナビゲーション アプリは航続可能距離を更新することが可能なため、このプロパティは、VehiclePropertyAccess.READ_WRITE として定義されます。このプロパティは、OEM の裁量においてのみ VehiclePropertyAccess.READ として実装できます。

変更モード: CONTINUOUS
アクセスモード: READ_WRITE
列挙型: なし
ユニットタイプ: VehicleUnit:METER
リリース: Android 13

READING_LIGHTS_STATE

読書灯の現在のステータスを返します。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleLightState
ユニットタイプ: なし
リリース: Android 13

READING_LIGHTS_SWITCH

読書灯を操作するスイッチ。これは、ドアが開いている、または音声コマンドが理由でライトが点灯している場合は、READING_LIGHTS_STATE とは異なる場合があります。たとえば、スイッチがオフまたは自動の位置にある間が挙げられます。このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM では VehiclePropertyAccess.READ としてのみ実装できます。

REAR_FOG_LIGHTS_STATE

リア フォグ ライトの現在の状態を返します。FOG_LIGHTS_STATE または REAR_FOG_LIGHTS_STATE のいずれかのみを実装できます。FOG_LIGHTS_STATE をご覧ください。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleLightState
ユニットタイプ: なし
リリース: Android 13

REAR_FOG_LIGHTS_SWITCH

ユーザーが希望する設定。FOG_LIGHTS_SWITCH または REAR_FOG_LIGHTS_SWITCH のいずれかのみを実装する必要があります。詳細については、FOG_LIGHTS_SWITCH をご覧ください。このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM では VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: VehicleLightSwitch
ユニットタイプ: なし
リリース: Android 13

REMOVE_USER

Android ユーザーが削除されると Android システムによって呼び出されます。HAL は、このプロパティを同等のユーザーの削除に使用できます。これは、書き込み専用の呼び出しです。Android システムは、HAL からの返答は想定していません。したがって、このリクエストは失敗してはなりません。同等の HAL ユーザーを削除できない場合、HAL はそのユーザーに無効とマークを付けるか、別の方法で復元する必要があります。

RemoveUserRequest で定義されたコンテンツを使用して VehiclePropValue で設定するとリクエストが行われます。たとえば、システムにユーザーが 3 人(0、10、11)いる場合に、ユーザー 11 が削除された場合のリクエストは以下のようになります。

  • int32[0] 42 // リクエスト ID
  • int32[1] 11 // (削除したユーザーの Android ユーザー ID)
  • int32[2] 0 // (削除したユーザーの Android ユーザーフラグ)
  • int32[3] 10 // 現在のユーザー
  • int32[4] 0 // 現在のユーザーフラグ(なし)
  • int32[5] 2 // ユーザー数
  • int32[6] 0 // 最初のユーザー(ユーザー 0)
  • int32[7] 0 // ユーザーの最初のフラグ(なし)
  • int32[8] 10 // 2 人目のユーザー(ユーザー 10)
  • int32[9] 0 // ユーザーの 2 つ目のフラグ(なし)

変更モード: 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 回動かします。各 VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。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 は、座席の底部に最も近いアクチュエーターです。VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。minInt32Value は、座席の底部にあるアクチュエータに対する座席の背もたれのフルリクライニング位置を示します。maxInt32Value は、座席の底部にあるアクチュエータに対するシートバックレストの最も直立した位置または前方位置を示します。

minInt32ValuemaxInt32Value の間の値は、完全に倒した状態と、直立した状態と前傾した状態の間の移行状態を示します。

このプロパティは、指定された相対位置範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_BACKREST_ANGLE_2_MOVE

シートの背もたれの角度を 2 度動かします。各 VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

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 は、シートの下から 2 番目のアクチュエーターです。

VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

minInt32Value は、座席の下部にあるアクチュエータから次のアクチュエータに対応する、座席の背もたれの完全なリクライニング位置を示します(詳しくは SEAT_BACKREST_ANGLE_1_POS をご覧ください)。maxInt32Value は、シートの底部にあるアクチュエータから背もたれの次のアクチュエータまでのシート背もたれの最も直立した前方位置を示します(詳細については SEAT_BACKREST_ANGLE_1_POS をご覧ください)。

minInt32ValuemaxInt32Value の間の値は、完全に倒した状態と、直立した状態と前傾した状態の間の移行状態を示します。

このプロパティは、指定された相対位置範囲として表されます。

このプロパティは 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

シートベルトの高さ調整。各 VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の範囲の整数をすべてサポートする必要があります。

minInt32Value は、シートベルトの肩のアンカーが最も低い位置にあることを示します。maxInt32Value は、シートベルトの肩のアンカーが最も高い位置にあることを示します。

minInt32ValuemaxInt32Value の間の値は、最小位置と最大位置の間の移行状態を示します。

このプロパティは、相対位置の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_CUSHION_SIDE_SUPPORT_MOVE

シートクッションのサイドサポートの移動方向と速度のプロパティを示します。

各 VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の範囲の整数をすべてサポートする必要があります。

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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

maxInt32Value は、シート クッションのサイド サポートが最も広い位置(たとえば、最も広い位置)にあることを示します。minInt32Value は、座席クッションのサイド サポートが最も薄い位置にあることを示します(最もサポートが強い位置など)。

minInt32ValuemaxInt32Value の間の値は、最も狭い位置と最も広い位置の間の移行状態を示します。

このプロパティは、指定された相対位置範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は <covehiclepropertyaccess.read< code=""> としてのみ実装できます。</covehiclepropertyaccess.read<>

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

SEAT_DEPTH_MOVE

シートの奥行きの移動。

各 VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

maxInt32Value は、座席が深くなる際の最大動作速度を表します。minInt32Value は、座席が浅くなる際の最大動作速度を表します。

正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シートバックレストが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_DEPTH_MOVE の値が現在 0 の場合、動きはありません。

このプロパティは、相対的な移動速度の指定範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_DEPTH_POS

シートの奥行きの位置。座席の奥行き、座席のバックレストから前端までの距離を設定します。

VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

minInt32Value は、座席が最も低い位置にあることを示します(座席クッションの前端と座席の後端の距離が最も短い位置など)。

maxInt32Value は、座席が最も後ろの位置にあることを示します(座席クッションの前端と座席の後端の距離が最も長い位置など)。

minInt32Value から maxInt32Value の間の値は、最も浅い位置と最も深い位置の間の遷移状態を示します。

このプロパティは、相対位置の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は <covehiclepropertyaccess.read< code=""> としてのみ実装できます。.</covehiclepropertyaccess.read<>

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_EASY_ACCESS_ENABLED

シートの簡単なアクセス機能のプロパティを表します。true の場合、乗員が車両に乗り降りしやすくなるようにシートが自動的に調整されます。各エリア ID は、簡単アクセス機能を利用して、ユーザーが出入りしようとしている座席にマッピングする必要があります。このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は <covehiclepropertyaccess.read< code=""> としてのみ実装できます。</covehiclepropertyaccess.read<>

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

SEAT_FOOTWELL_LIGHTS_STATE

シートのフットウェル ライトの状態のプロパティを表します。SEAT_FOOTWELL_LIGHTS_STATE には、ライトの現在の状態がいつでも反映されます。これは、ライトを制御するスイッチの位置を表す SEAT_FOOTWELL_LIGHTS_SWITCH の機能とは異なります。

そのため、 SEAT_FOOTWELL_LIGHTS_STATE SEAT_FOOTWELL_LIGHTS_SWITCH の値(SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATICSEAT_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=AUTOMATICSEAT_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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の範囲の整数をすべてサポートする必要があります。

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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

minInt32Value は、座席が最も後ろの位置にあることを示します。maxInt32Value は、座席が最も前方に伸ばされていることを示します。minInt32ValuemaxInt32Value の間の値は、最も近い位置と最も遠い位置の間の移行状態を示します。

このプロパティは、指定された相対位置範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_HEADREST_ANGLE_MOVE

ヘッドレストの角度調整。各 VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

maxInt32Value は、シートのヘッドレストが直立または前方位置に移動する際の最大動作速度を表します。minInt32Value は、浅い位置に移動する際の座席のヘッドレストの最大移動速度を表します。

正か負のいずれか大きい方の絶対値がより速い動作速度を表します。座席のヘッドレストが位置制限に達したら、値を 0 にリセットする必要があります。SEAT_HEADREST_ANGLE_MOVE の値が 0 の場合、動きはありません。

このプロパティは、動作の相対速度の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されていますが、OEM は <covehiclepropertyaccess.read< code=""> としてのみ実装できます。</covehiclepropertyaccess.read<>

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_HEADREST_ANGLE_POS

ヘッドレストの角度の位置。VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

minInt32Value は、ヘッドレストが完全なリクライニング状態にあることを示します。maxInt32Value は、ヘッドレストが最も直立した前方位置にあることを示します。

minInt32Value から maxInt32Value の間の値は、完全なリクラインと最も直立した位置と前方の位置との間の移行状態を示します。

このプロパティは、指定された相対位置範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されていますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_HEADREST_FORE_AFT_MOVE

ヘッドレストの前後に動かします。各 VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

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

ヘッドレストの前後位置。VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

minInt32Value は、ヘッドレストが最も後ろの位置にあることを示します。maxInt32Value は、ヘッドレストが最前線の位置にあることを示します。

minInt32Value から maxInt32Value の間の値は、前方位置と後方位置の間の遷移状態を示します。

このプロパティは、相対位置の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_HEADREST_HEIGHT_MOVE

ヘッドレストの高さ調整。各 VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

minInt32Value は、ヘッドレストが最も低い位置にあることを示します。maxInt32Value は、ヘッドレストが最も高い位置にあることを示します。

minInt32ValuemaxInt32Value の間の値は、最小位置と最大位置の間の移行状態を示します。

このプロパティは、相対位置の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

SEAT_HEIGHT_MOVE

シートの高さの調整。各 VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value 間のすべての整数がサポートされている必要があります。

maxInt32Value は、座席が上方向に移動する際の最大動作速度を表します。

minInt32Value は、下降する際の座席の最大移動速度を表します。

正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シートが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_HEIGHT_MOVE の値が 0 であれば、動作は行われていません。

このプロパティは、動作の相対速度の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_HEIGHT_POS

シートの高さの位置。VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value 間のすべての整数がサポートされている必要があります。

minInt32Value は、座席が最も低い位置にあることを示します。maxInt32Value は、座席が最も高い位置にあることを示します。

minInt32ValuemaxInt32Value の間の値は、最小位置と最大位置の間の移行状態を示します。

このプロパティは、相対位置の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_LUMBAR_FORE_AFT_MOVE

腰椎の前後移動。各 VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value 間のすべての整数がサポートされている必要があります。

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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value 間のすべての整数がサポートされている必要があります。

minInt32Value は、ランバー サポートが最も後ろの位置にあることを示します(サポートが最も少ない位置など)。maxInt32Value は、ランバー サポートが最も前方に移動していることを示します(最もサポート力のある位置など)。

minInt32ValuemaxInt32Value の間の値は、前方と後方の位置の間の移行状態を示します。

このプロパティは、指定された相対位置範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスタイプ: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_LUMBAR_SIDE_SUPPORT_MOVE

ランバーサイド サポートの移動。各 VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。

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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。minInt32Value は、腰部サイドサポートが最も薄い位置にあることを示します(サポートが最も強い位置など)。maxInt32Value は、ランバーサイド サポートが最も広い位置にあることを示します(サポートが最も少ないなど)。

minInt32ValuemaxInt32Value の間の値は、最も狭い位置と最も広い位置の間の移行状態を示します。

このプロパティは、相対位置の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスタイプ: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

SEAT_LUMBAR_VERTICAL_MOVE

シートのランバー サポートの垂直移動の方向と速度のプロパティを表します。

各 VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の範囲の整数をすべてサポートする必要があります。maxInt32Value は、ランバー サポートの最高位置を示します。minInt32Value は、ランバーサポートの最下位の位置を示します。

minInt32ValuemaxInt32Value の間の値は、最小位置と最大位置の間の移行状態を示します。

このプロパティは、相対位置の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_MEMORY_SELECT

このパラメータは、シート位置の選択に使用するメモリ プリセットを選択します。VehicleAreaConfig の maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。minInt32Value は常に 0 で、maxInt32Value は使用可能なシート プリセット メモリ スロット数を決定します(例: numSeatPresets - 1)。たとえば、運転席に 3 つのメモリ プリセットがある場合、maxInt32Value は 2 です。ユーザーがプリセットを選択すると、目的のプリセット番号(0、1、2)が設定されます。

変更モード: ON_CHANGE
アクセスモード: WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_MEMORY_SET

この設定により、ユーザーは現在の座席位置の設定を、選択したプリセット スロットに保存できます。VehicleAreaConfigmaxInt32ValueminInt32Value を定義する必要があります。minInt32Value は 0 にする必要があります。また、各座席位置の maxInt32ValueSEAT_MEMORY_SELECTmaxInt32Value と一致する必要があります。

変更モード: ON_CHANGE
アクセスモード: WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_OCCUPANCY 色

特定の座席が占有されているかどうかを、車両が判別できる範囲で示します。有効な値は VehicleSeatOccupancyState 列挙型の値です。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleSeatOccupancyState
ユニットタイプ: なし
リリース: Android 13

SEAT_TILT_MOVE(SEAT_TILT_MOVE)

シートの傾斜移動。各 VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。maxInt32Value は、座席の前端が上方向に移動する際の最大動作速度を表します。minInt32Value は、座席の前端が下方向に移動する際の最大動作速度を表します。

正か負のいずれか大きい方の絶対値がより速い動作速度を表します。座面が限界位置に達したら、値を 0 にリセットする必要があります。SEAT_TILT_MOVE の値が現時点で 0 の場合、現在動作は行われていません。

このプロパティは、動作の相対速度の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SEAT_TILT_POS(座席傾斜位置)

シートの傾斜位置。VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の整数をすべてサポートする必要があります。minInt32Value は、座面の角度が最も低い位置にあることを示します。これは、シートの後端に対して可能な限り低い位置にあるシートの前端に対応しています。maxInt32Value は、座面が最も高い角度に傾いていることを示します。これは、シートの後端から可能な限り高い位置にあるシートの前端に対応しています。

minInt32ValuemaxInt32Value の間の値は、最小位置と最大位置の間の移行状態を示します。

このプロパティは、相対位置の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

SEAT_WALK_IN_POS

シートの現在のウォークイン位置を示すプロパティを表します。minInt32Value は通常の座席位置を示します。minInt32Value は 0 にする必要があります。maxInt32Value は、座席がフルウォークインの位置にあることを示します。

minInt32ValuemaxInt32Value の間の値は、通常の位置とウォークイン モードの位置の間の移行状態を示します。

このプロパティは、相対位置の指定の範囲として表されます。

エリア ID は、乗客が座る予定の座席ではなく、持ち込み機能が有効になったときに実際に移動する座席と一致している必要があります。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は

VehiclePropertyAccess.READ としてのみ実装します。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SHUTDOWN_REQUEST

ヘッドユニットにシャットダウンをリクエストします。

これは、ヘッドユニットの電源がオフのときにタスクを実行するために必要です(リモートタスク機能)。タスクを実行するためにヘッドユニットの電源を入れた後は、ヘッドユニットの電源を切る必要があります。タスクが完了すると、ヘッドユニットからこのメッセージが送信されます。

このプロパティは、ユーザーがヘッドユニットのシャットダウンを希望する場合には適用されません。

通常、ヘッドユニットの外部にある別のシステム(電源コントローラなど)に、ヘッドユニットのシャットダウンの準備をするよう指示します。

外部システムは、車両が使用中かどうかを確認して、このリクエストが有効であることを検証する必要があります。SHUTDOWN_REQUEST が送信された後にユーザーが車両に乗車した場合、システムはこのリクエストを無視する必要があります。VehicleInUse プロパティを電源コントローラに保存し、VEHICLE_IN_USE プロパティを介して公開することをおすすめします。VehicleInUse が true の場合、シャットダウン リクエストは無視する必要があります。

許可されている場合、外部システムはヘッドユニットにシャットダウン シグナルを送信します。これにより、VHAL は Android に SHUTDOWN_PREPARE メッセージを送信します。Android は、メッセージを処理してシャットダウン プロセスを開始します。

このプロパティはリクエストの発行のみを目的としており、書き込みのみをサポートしています。このプロパティ値が設定されるたびに、現在のプロパティ値に関係なく、シャットダウンのリクエストが発行されます。現在のプロパティ値は無意味です。

このプロパティは書き込み専用であるため、定期購入は許可されず、プロパティ変更イベントは生成されません。

設定する値はシャットダウン オプションを示します。{@code VehicleApPowerStateShutdownParam} のいずれかにする必要があります(例: VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY)。システムがこのオプションをサポートしていない場合、このシャットダウン オプションが適用されないことがあります。この場合、エラーは返されません。

構成情報については、VehiclePropConfig.configArray は、サポートされているシャットダウン オプションを示すために、{@code VehicleApPowerStateConfigFlag} の値を組み合わせるビットフラグを持つ必要があります。

シャットダウン リクエストを他のシステムに送信できなかった場合はエラーを返します。

変更モード: ON_CHANGE
アクセスモード: WRITE
列挙型: VehicleApPowerStateShutdownParam>
ユニットタイプ: なし
リリース: Android 14

STEERING_WHEEL_DEPTH_MOVE

ハンドルの奥行きの動き。VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての値がサポートされている必要があります。

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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての値がサポートされている必要があります。maxInt32Value は、ドライバーから最も遠いハンドルの位置を示します。minInt32Value は、運転席に最も近いハンドルの位置を示します。

minInt32ValuemaxInt32Value の間の値は、

このプロパティは、相対位置の指定の範囲として表されます。

このプロパティは 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 の maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間の値をすべてサポートする必要があります。

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 の maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての値がサポートされている必要があります。maxInt32Value は、ハンドルが最も高い位置にあることを示します。minInt32Value は、ハンドルが最も低い位置にあることを示します。

minInt32ValuemaxInt32Value の間の値は、最低位置と最高位置間の遷移状態を示します。

このプロパティは、相対位置の指定の範囲として表されます。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

STEERING_WHEEL_LIGHTS_STATE

ハンドルライトの状態。ステアリング ホイール ライトの現在の状態を表します。これは、ライトを制御するスイッチの位置を表す STEERING_WHEEL_LIGHTS_SWITCH とは異なります。したがって、STEERING_WHEEL_LIGHTS_STATESTEERING_WHEEL_LIGHTS_SWITCH の値と一致しない場合があります(STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATICSTEERING_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_SWITCHSTEERING_WHEEL_LIGHTS_STATE の値と一致しない場合があります。たとえば、STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATICSTEERING_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 は <covehiclepropertyaccess.read< code=""> としてのみ実装できます。/p> </covehiclepropertyaccess.read<>

変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

STEERING_WHEEL_THEFT_LOCK_ENABLED

ハンドルの盗難ロック機能を有効にしました。true の場合、特定の状況で盗難を防ぐため、ハンドルが自動的にロックされます。このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

STORAGE_ENCRYPTION_BINDING_SEED

外部暗号化バインディング シード。この値は、ローカル鍵ストレージ暗号鍵と混合されます。このプロパティは 16 バイトを保持し、IVI とは別の ECU で永続化されることが想定されます。 このプロパティは、最初に AAOS によって設定され、CSRNG を使用して生成されます。AAOS は次の起動時にこのプロパティを読み取ります。バインディング シードは確実に永続化されることが期待されます。シードが失われると、IVI は出荷時の設定にリセットされます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SUPPORT_CUSTOMIZE_VENDOR_PERMISSION

ベンダー プロパティのカスタマイズ権限をサポート。

VHAL がベンダー権限のカスタマイズ機能をサポートしている場合は、このプロパティを実装します。VehiclePropConfig.configArray は、このベンダー プロパティに選択されたベンダー プロパティと権限を示すために使用されます。権限は、VehicleVendorPermission の列挙型のいずれかである必要があります。configArray は、ベンダー プロパティの configArray[n]: propId : property ID で次のように設定されます。ここで、configArray[n+1] は VehicleVendorPermission の列挙型で、プロパティの値を読み取る権限を示します。

configArray[n+2] は VehicleVendorPermission の列挙型で、プロパティの値の書き込み権限を示します。例:

configArray: { vendor_prop_1, PERMISSION_VENDOR_SEAT_READ, PERMISSION_VENDOR_SEAT_WRITE, vendor_prop_2, PERMISSION_VENDOR_INFO, PERMISSION_NOT_ACCESSIBLE, }

ベンダー プロパティがこの配列にない場合、デフォルトのベンダー権限が付与されます。ベンダーが PERMISSION_NOT_ACCESSIBLE を選択した場合、Android はプロパティにアクセスできません。この例では、Android は vendor_prop_2 の値を書き込めません。

変更モード: STATIC
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

SUPPORTED_PROPERTY_IDS

非推奨)サポートされているすべてのプロパティ ID のリスト。

変更モード: STATIC
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14

SWITCH_USER

フォアグラウンド Android ユーザーを切り替えるリクエストを定義します。

このプロパティは主に、Android システムが現在のフォアグラウンドの Android ユーザーが切り替えていることを HAL に通知するために使用されますが、Android システムにユーザーの切り替えをリクエストするために HAL が使用することもあります。Android がリクエストを行うと、VehiclePropValue が設定され、HAL はプロパティ変更イベントで応答する必要があります。HAL がリクエストを行う場合は、プロパティ変更イベントを介して行う必要があります(主な違いは、リクエスト ID が前者の場合は正で、後者の場合は負であることです)。SwitchUserMessageType も異なります。

両方のリクエストの形式は SwitchUserRequest で定義され、レスポンスの形式(必要な場合)は SwitchUserResponse で定義されます。HAL(または Android システム)の処理方法は、以下に定義されているように、メッセージ タイプ(SwitchUserMessageType パラメータで定義)によって異なります。
  • LEGACY_ANDROID_SWITCH Android システムから呼び出され、Android ユーザーが変更されようとしていることを示します。変更リクエストが HAL と統合されていない方法(adb shell am switch-user など)で行われた場合です。HAL は、このリクエストを受信すると内部ユーザーを切り替えることができますが、Android システムに返信する必要はありません。なんらかの理由で内部ユーザーを変更できない場合は、SWITCH_USER(type=ANDROID_POST_SWITCH) 呼び出しが復旧するまで待機する必要があります(たとえば、SWITCH_USER(type=VEHICLE_REQUEST) を発行して前のユーザーに戻すことができます)。エラーを防ぐのが理想的です(元に戻すとエンドユーザーを混乱させる可能性があるため)。
    たとえば、システムにユーザー(0, 10, 11)がいて、0 から 11 に切り替える(どのユーザーにも特別なフラグがない)場合、リクエストは次のようになります。
    • int32[0] 42 // リクエスト ID
    • int32[1] 1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCH
    • int32[2] 11 // ターゲット ユーザー ID
    • int32[3] 0 // ターゲット ユーザーフラグ(なし)
    • int32[4] 10 // 現在のユーザー
    • int32[5] 0 // 現在のユーザーフラグ(なし)
    • int32[6] 3 // ユーザー数
    • int32[7] 0 // ユーザー #0(Android ユーザー ID 0)
    • int32[8] 0 // ユーザー #0 のフラグ(なし)
    • int32[9] 10 // ユーザー #1(Android ユーザー ID 10)
    • int32[10] 0 // ユーザー #1 のフラグ(なし)
    • int32[11] 11 // ユーザー 2(Android ユーザー ID 11)
    • int32[12] 0 // ユーザー 2 のフラグ(なし)
  • ANDROID_SWITCH Android システムから呼び出され、Android ユーザーが変更されようとしていることを示します。ただし、Android は HAL の応答を待ってから(最大で一定時間)続行します。HAL は、このリクエストを受信したら内部ユーザーを切り替え、内部ユーザーが切り替わったかどうかを示す SWITCH_USER(type=VEHICLE_RESPONSE)(SwitchUserStatus 列挙型を介して)を Android に返す必要があります。たとえば、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 // 2 人目のユーザー(ユーザー 10)
    • int32[10] 0 // ユーザーの 2 つ目のフラグ(なし)
    • 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 現在のフォアグラウンド Android ユーザーの切り替えをリクエストするために HAL によって呼び出されます。これは、Android が 1 人のユーザーとして起動されたが、車両がドライバーを別のユーザーとして識別した場合に便利です。たとえば、ユーザー A がユーザー B のキーフォブを使用して車のロックを解除したとします。INITIAL_USER_INFO リクエストでユーザー B が返されましたが、顔認識サブサブシステムでユーザーが A と識別されました。HAL はプロパティ変更イベント(負のリクエスト ID を渡す)によってこのリクエストを行い、Android システムは同じリクエスト ID の ANDROID_POST_SWITCH 呼び出しを発行します。たとえば、現在のフォアグラウンド Android ユーザーが 10 で、HAL が 11 への切り替えをリクエストした場合、リクエストは次のようになります。
    • int32[0] -108 // リクエスト ID
    • int32[1] 4 // messageType: SwitchUserMessageType::VEHICLE_REQUEST
    • int32[2] 11 // Android ユーザー ID

    リクエストが成功し、Android に 3 人のユーザー(0、10、11)が存在する場合、レスポンスは次のようになります。

    • int32[0] -108 // リクエスト ID
    • int32[1] 5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCH
    • int32[2] 11 // ターゲット ユーザー ID
    • int32[3] 0 // ターゲット ユーザー ID フラグ(なし)
    • int32[4] 11 // 現在のユーザー
    • int32[5] 0 // 現在のユーザーフラグ(なし)
    • int32[6] 3 // ユーザー数
    • int32[7] 0 // 最初のユーザー(ユーザー 0)
    • int32[8] 0 // ユーザーの最初のフラグ(なし)
    • int32[9] 10 // 2 番目のユーザー(ユーザー 10)
    • int32[10] 4 // ユーザーの 2 つ目のフラグ(なし)
    • int32[11] 11 // 3 人目のユーザー(ユーザー 11)
    • int32[12] 3 // 3 人目のユーザーのフラグ(なし)

    現在のユーザー ID とターゲット ユーザー ID は同じです。リクエストが失敗した場合は、異なります。たとえば、ターゲット ユーザーは 11 になり、現在のユーザーは 10 のままになります。

  • ANDROID_POST_SWITCH ユーザーの切り替えリクエストが行われた後に Android システムによって呼び出されます。このプロパティは、任意の型(例: >code>LEGACY_ANDROID_SWITCH、>code>ANDROID_SWITCH、VEHICLE_REQUEST)の switch リクエストの後に呼び出され、リクエストが成功したか失敗したかの判断に使用できます。
    • 成功すると、Android ユーザーがロック解除状態にあり、レスポンスの現在のユーザー ID とターゲット ユーザー ID の値が同じ場合に呼び出されます。これは、Android アプリで Intent.ACTION_USER_UNLOCKED を受信する場合と同じです。
    • 失敗した場合はすぐに呼び出され、レスポンスの現在のユーザー ID とターゲット ユーザー ID の値は異なります(現在のユーザーがターゲットに変更されていないため)。
    • HAL が前のリクエストに応答する前、またはユーザーがロックを解除する前に新しい切り替えリクエストが行われた場合は、ANDROID_POST_SWITCH リクエストは行われません。たとえば、ドライバーがロック認証情報を持つ間違ったユーザーに切り替えた後、認証情報を入力する前に正しいユーザーに切り替える可能性があります。

    HAL は、このリクエストを受け取った時点で内部状態を更新できますが、Android システムに返信する必要はありません。

    • リクエストします。INITIAL_USER_INFO で定義された最初の N 個の値(インデックス 1 の要求固有の値は SwitchUserMessageType::ANDROID_POST_SWITCH です)、ターゲット ユーザー ID の 2 つの値(切り替えをリクエストされた 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 は、left_front タイヤの推奨タイヤ圧力を 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、Kilopascal など)。VehiclePropConfig.configArray は、サポートされている圧力の表示単位を示すのに使用されます。圧力の単位は VehicleUnit で定義します。たとえば、configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR とします。

TIRE_PRESSURE_DISPLAY_UNITS の更新が他の *_DISPLAY_UNITS プロパティの値に影響を与える場合は、それらの値を更新し、AAOS フレームワークにも通知する必要があります。このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は <covehiclepropertyaccess.read< code=""> としてのみ実装できます。/p> </covehiclepropertyaccess.read<>

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: 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 呼び出しから新しい関連付けを開始するのではなく、すでに識別された関連付け(車のロックを解除するために使用されるキー FOB など)のみを返す必要があります。

タイプを関連付けるために、Android システムはプロパティを設定し、UserIdentificationSetRequest で定義されているように、設定される関連付けのタイプと値を含む VehiclePropValue を渡します。

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(クエリされた 2 番目のタイプ、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(2 番目の値: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)

次に、ユーザーをカスタム メカニズムに関連付けるために、set リクエストが実行されます。

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

set リクエストは関連付けを追加しますが、既存の関連付けは削除しません。上記の例では、最終状態は 2 つの関連付け(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(2 番目のタイプ: UserIdentificationAssociationType::CUSTOM_1)
  • int32[6] 1 (2 つ目の値: UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)

変更モード: ON_CHANGE
アクセスモード: READ_WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

VEHICLE_CURB_WEIGHT

車両の車両重量(kg)を返します。車両重量は、標準装備と、運転に必要な消耗品(エンジンオイル、トランスミッション オイル、ブレーキ フルード、冷却水、エアコンの冷媒など)をすべて装備した車両の総重量で、乗客や荷物を積んでいない状態の、タンクの定格容量での燃料の重量を含みます。

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 がシステム起動時に 1 回だけ設定されるという点で 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

Vehicle Maps Service(VMS)メッセージ。このプロパティは、MIXED データを使用して VMS メッセージを通信します。内容は次のように解釈されます。VmsMessageIntegerValuesInde で定義されたインデックスは、int32Values からの読み取りに使用されます。バイトは、VMS プロトコルで定義されているようにシリアル化された VMS メッセージであり、フレームワークに対して不透明です。IVehicle#get は常に StatusCode::NOT_AVAILABLE を返す必要があります。

変更モード: ON_CHANGEREAD_WRITE
アクセスモード: READ_WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

VEHICLE_SPEED_DISPLAY_UNITS

表示する速度の単位。ユーザーに速度を表示するために使用される単位のタイプを示します。例: m/s、km/h、mph。VehiclePropConfig.configArray は、サポートされている速度の表示単位を示します。圧力の単位は VehicleUnit で定義されます。例:

.configArray: { VehicleUnit::METER_PER_SEC, VehicleUnit::KILOMETERS_PER_HOUR, VehicleUnit::MILES_PER_HOUR }
  • configArray[0] METER_PER_SEC
  • configArray[1] MILES_PER_HOUR
  • configArray[2] KILOMETERS_PER_HOUR

VEHICLE_SPEED_DISPLAY_UNITS の更新が他の *_DISPLAY_UNITS properties の値に影響を与える場合は、それらの値を更新し、AAOS フレームワークに伝送する必要があります。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

VHAL_HEARTBEAT(ハートビート)

VHAL がハートビートとして 車のウォッチドッグに通知するイベントを定義します。VHAL がこのプロパティをサポートしている場合、VHAL は 3 秒ごとにシステムの稼働時間をこのプロパティに書き込む必要があります。車のウォッチドッグはこのプロパティにサブスクライブし、3 秒ごとにプロパティが更新されているかどうかを確認します。バッファ時間 3 秒の場合、カー ウォッチドッグは最後のハートビートから最大 6 秒間、ハートビートのシグナルを待機します。そうでない場合、カー ウォッチドッグは VHAL を異常と見なし、終了します。このプロパティが VHAL でサポートされていない場合、車のウォッチドッグは VHAL のヘルス ステータスをチェックしません。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

WATCHDOG_ALIVE

車のウォッチドッグが更新してアクティブであることを示すイベントを定義します。カー ウォッチドッグは、このプロパティを 3 秒ごとにミリ秒単位でシステム稼働時間に設定します。起動中は、更新に時間がかかることがあります。

変更モード: ON_CHANGE
アクセスモード: WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

WATCHDOG_TERMINATED_PROCESS

カー ウォッチドッグによって終了されたプロセスと、終了の理由を定義します。

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

変更モード: ON_CHANGE
アクセスモード: WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

WHEEL_TICK(ホイール ティック)

ホイール ティックをレポートします。ベクトルの最初の要素はリセット カウントです。リセットは、以前のティック数がこれ以降のティック数と比較できないことを示します。ティックカウントになんらかの不連続が発生しました。

次の 4 つの要素は、個々のホイールの目盛りを表します。順序は次のとおりです。

  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] 左前輪の 1 回転あたりのマイクロメートル
  • configArray[2] 右前輪の 1 回転あたりのマイクロメートル
  • 右後輪の目盛りあたり configArray[3] マイクロメートル
  • configArray[4] 左後輪の 1 回転あたりのマイクロン数。

ホイールがサポートされていない場合、その値は常に 0 に設定する必要があります。

VehiclePropValue.timestamp は入力する必要があります。

変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

WINDOW_LOCK

ウィンドウのチャイルド ロック。true は、ウィンドウがチャイルド ロックされていることを示します。このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

WINDOW_MOVE

ウィンドウの移動。各 VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。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 で maxInt32ValueminInt32Value を定義する必要があります。minInt32ValuemaxInt32Value の間のすべての整数がサポートされている必要があります。minInt32Value は、窓が閉じているか、平面から完全に開いていることを示します。ウィンドウを平面から開くことができない場合は、minInt32Value はウィンドウが完全に閉じたときの位置であり、0 にする必要があります。ウィンドウを平面の外で開くことができる場合、minInt32Value はウィンドウが平面から外れた位置で完全に開いていることを示し、負の値になります。詳細については、以下の例をご覧ください。maxInt32Value は、ウィンドウが完全に開いていることを示します。

minInt32Value から maxInt32Value の間の値は、閉じた/完全に開いた平面から外れた位置と完全に開いた位置の間の遷移状態を示します。このプロパティは特定の単位ではなく、指定された相対位置の範囲にあります。たとえば、平面から外側に移動できるウィンドウの場合、このプロパティは次のようになります。平面から外側に開くことができるウィンドウ(サンルーフの換気モード)の場合、このパラメータは負の値で動作します。

  • Max サンルーフが完全に開いている(サンルーフが閉まっている場合は 0)。
  • Min サンルーフの換気口が完全に開いている(サンルーフが閉まっている場合は 0)。
このモードでは、0 はウィンドウが閉じていることを示します。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13

WINDSHIELD_WIPERS_PERIOD

フロントガラスのワイパー時間(ミリ秒)。ワイパーの 1 回転の瞬時時間をミリ秒単位で返します。1 サイクルとは、ワイパーが停止位置から移動して、停止位置に戻ることを指します。間欠ワイパーの設定を選択した場合、間欠ワイパーの休止時間中は、このプロパティの値を 0 に設定する必要があります。VehicleAreaConfig で maxInt32ValueminInt32Value を定義する必要があります。各エリア 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: ONWINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO です。WINDSHIELD_WIPERS_STATE: ONWINDSHIELD_WIPERS_PERIOD が実装されている場合、WINDSHIELD_WIPERS_PERIOD にはワイパーの 1 サイクルの所要時間を反映する必要があります。

サポートされている各エリア ID では、WindshieldWipersState のすべての状態(非推奨の OTHER を含む)がサポートされていない限り、VehicleAreaConfig#supportedEnumValues 配列を定義する必要があります。

変更モード: ON_CHANGE
アクセスモード: READ
列挙型: WindshieldWipersState
ユニットタイプ: なし
リリース: Android 14

WINDSHIELD_WIPERS_SWITCH

ワイパーのスイッチ。フロントガラスのワイパーを制御するスイッチの位置を表します。WINDSHIELD_WIPERS_SWITCH の値は WINDSHIELD_WIPERS_STATE の値と一致しない場合があります(例: WINDSHIELD_WIPERS_SWITCH: AUTOWINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON)。サポートされている各エリア ID では、WindshieldWipersSwitch のすべての状態(非推奨の OTHER を含む)がサポートされていない限り、VehicleAreaConfig#supportedEnumValues 配列を定義する必要があります。

このプロパティは VehiclePropertyAccess.READ_WRITE として定義されていますが、OEM は VehiclePropertyAccess.READ としてのみ実装できます。このプロパティが VehiclePropertyAccess.READ_WRITE として実装され、OTHER 状態が VehicleAreaConfig#supportedEnumValues 配列にリストされている場合、OTHER は書き込みでサポートされている値ではなく、読み取りでのみサポートされている値です。

変更モード: ON_CHANGE
アクセスモード: READ_WRITE / READ
列挙型: WindshieldWipersSwitch
ユニットタイプ: なし
リリース: Android 14