このページでは、VHAL でサポートされているシステム プロパティの一覧を示します。VHAL でサポートされているプロパティは、以下のリストのシステム プロパティかベンダー プロパティのいずれかです。Android 14 以降では、プロパティ定義は hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl
で定義されます。
プロパティ定義は AIDL インターフェース(android.hardware.automotive.vehicle.property
)で定義されています。これは、VHAL インターフェース(android.hardware.automotive.vehicle
)とは別のものです。VHAL 実装と VHAL クライアントは両方のインターフェースを使用する必要があります。
自動生成アクセスモードと変更モード
Android 14 以降では、VHAL 実装をサポートするために、自動生成の C++ ヘッダー ファイルと、システム プロパティの許可済み変更モードまたはアクセスモードを使用した Java クラスファイルを提供しています。ベンダー VHAL 実装は、プロパティ構成が仕様を遵守したものとなるように、これらを使用できます。
A~D
ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE
使用自适应巡航控制 (ACC) 或预测性巡航控制 (PCC) 时测量的与前车的距离。返回前车最后端点与 ACC 车辆最前端点之间的测量距离,单位为毫米。必须定义 VehicleAreaConfig
中的 maxInt32Value
和 minInt32Value
。minInt32Value
应为 0。maxInt32Value
应填充距离传感器支持的最大范围。此值应为非负值。
如果未检测到前车(即,没有前车;或与前车相距太远,传感器无法检测到),此属性应返回 StatusCode.NOT_AVAILABLE
如果此属性因 CC 处于停用状态(例如 StatusCode#NOT_AVAILABLE_DISABLED
为 false)而不可用,则必须返回 StatusCode#NOT_AVAILABLE_DISABLED
。如果实现了 CRUISE_CONTROL_STATE
且状态设置为 ErrorState
值,则此属性必须返回与 ErrorState
值一致的 StatusCode
。例如,如果 CRUISE_CONTROL_STATE
设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW
,则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW
更改模式:CONTINUOUS
访问模式:READ
枚举类型:无
单位类型:VehicleUnit:MILLIMETER
版本:Android 14
ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP
ACC 或 PCC 的当前目标时间间隔(以毫秒为单位)。 此属性应指定与前车的目标时间间隔。此时间间隔定义为,从前车的最后端点行驶到 ACC 车辆的最前端点所需的时间。与前车的实际时间间隔可能会高于或低于此值。
应在 configArray 中按升序指定可为目标时间间隔设置的值。所有值都必须为正数。如果该属性可写入,则所有值都必须可写入。如果此属性因 CC 处于停用状态(例如 CRUISE_CONTROL_ENABLED
为 false)而不可用,则必须返回 StatusCode#NOT_AVAILABLE_DISABLED
如果实现了 CRUISE_CONTROL_STATE
且状态设置为 ErrorState
值,则此属性必须返回与 ErrorState
值一致的 StatusCode
。例如,如果 CRUISE_CONTROL_STATE
设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW
,则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW
此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但原始设备制造商 (OEM) 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:VehicleUnit:MILLI_SECS
版本:Android 14
ABS_ACTIVE
自动制动系统 (ABS) 处于启用状态。当 ABS 处于启用状态时设置为 true,当 ABS 处于关闭状态时重置为 false。此属性可根据 ABS 系统的实时状态间歇性设置(脉冲式)。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
ANDROID_EPOCH_TIME
采用纪元时间编码的当前日期和时间(以毫秒为单位)。此值表示自世界协调时间 (UTC) 1970 年 1 月 1 日以来经过的毫秒数。
此值表示自世界协调时间 (UTC) 1970 年 1 月 1 日以来经过的毫秒数。
如果 VHAL 支持此属性,CarServices 会向此值执行 WRITE
,以向 VHAL 提供 Android 系统的时间。这对于使其他车载系统(仪表盘时钟)与 Android 时间保持同步非常有用。
AAOS 会在启动期间对此属性执行一次 WRITE
,之后仅会在时间源变化被传播时才会执行 WRITE
。AAOS 会正确填充 VehiclePropValue.timestamp。AAOS 不会因时间自然流逝而发送更新。int64Values[0] 表示提供的 Unix 时间(以毫秒为单位)。
该属性可能需要超过 0 毫秒的时间才能通过堆栈传播,而拥有带着时间戳的属性有助于减少时移。因此,对于向该属性执行的所有 WRITE
,时间戳都可用于消除这种时移:
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:无
单位类型:VehicleUnit:MILLI_SECS
版本:Android 13
AP_POWER_BOOTUP_REASON
用于报告当前开机原因的属性。这是一个 STATIC
属性,在设备关机前的整个时间段内都不会改变。例如,在系统因车门解锁而自动开机后,即使用户再次按下电源按钮,开机原因仍会保持为 VehicleApPowerBootupReason#USER_UNLOCK
,int32Values[0]
必须为 VehicleApPowerBootupReason
更改模式:STATIC
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
AP_POWER_STATE_REPORT
用于报告应用处理器电源状态的属性。 假设 AP 的电源状态由单独的电源控制器控制。
int32Values[0]
VehicleApPowerStateReport 枚举值int32Values[1]
唤醒所需的时间,以毫秒 (ms) 为单位,如有必要的话(否则为 0)
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
AP_POWER_STATE_REQ
用于控制应用处理器电源状态的属性。 假设 AP 的电源状态由单独的电源控制器控制。对于配置信息,VehiclePropConfig.configArray
必须在 VehicleApPowerStateConfigFlag
中具有位标志组合值
int32Values[0]
VehicleApPowerStateReq 枚举值int32Values[1]
与每个状态相关的额外参数;如果未使用,则为 0。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
AUTOMATIC_EMERGENCY_BRAKING_ENABLED
启用或停用自动紧急制动 (AEB)。
设置为 true 可启用 AEB,设置为 false 可停用 AEB。当 AEB 处于启用状态时,车辆中的 ADAS 系统应保持开启并进行监控,以避免可能发生的碰撞。此属性应仅适用于车速较高的应用场景。如需启用低速自动紧急制动功能,应使用 LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED
。
一般来说,AUTOMATIC_EMERGENCY_BRAKING_ENABLED
应始终返回 true 或 false。如果该功能因某种临时状态(例如车速过低)而不可用,则必须通过 AUTOMATIC_EMERGENCY_BRAKING_STATE
属性中的 ErrorState
值传达此信息。
此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 14
AUTOMATIC_EMERGENCY_BRAKING_STATE
自动紧急制动 (AEB) 状态。返回 AEB 的当前状态。此属性必须始终返回 AutomaticEmergencyBrakingState 或 ErrorState
中定义的有效状态。它不得通过 StatusCode
显示错误,而必须改用受支持的错误状态。此属性应仅适用于车速较高的应用场景。如需表示低速自动紧急制动系统的状态,应使用 LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE
。
如果 AEB 在启用刹车之前包含前向碰撞警告,这些警告必须通过前向碰撞警告 (FCW) 属性显示。
对于全局区域 ID (0),必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues
数组,除非同时支持 AutomaticEmergencyBrakingState
(包括不推荐的 OTHER
)和 ErrorState
的所有状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:ForwardCollisionWarningState/ErrorState
单位类型:无
版本:Android 14
BLIND_SPOT_WARNING_ENABLED
启用和停用盲点警告 (BSW)。 设置为 true 可启用 BSW,设置为 false 可停用 BSW。当 BSW 处于启用状态时,车辆中的 ADAS 系统应保持开启,并监控车辆的盲点区域是否有物体。
一般来说,BLIND_SPOT_WARNING_ENABLED
应始终返回 true 或 false。 如果该功能因某种临时状态(例如车速过低)而不可用,则必须通过 BLIND_SPOT_WARNING_STATE
属性中的 ErrorState
值传达此信息。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 14
BLIND_SPOT_WARNING_STATE
盲点警告 (BSW) 状态。 返回 BSW 的当前状态。此属性必须始终返回 BlindSpotWarningState
或 ErrorState
中定义的有效状态。它不得通过 StatusCode
显示错误,而必须改用受支持的错误状态。
对于每个受支持的区域 ID,必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues
数组,除非同时支持 BlindSpotWarningState
(包括不推荐的 OTHER
)和 ErrorState
的所有状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:BlindSpotWarningState/ErrorState
单位类型:无
版本:Android 14
CABIN_LIGHTS_STATE
返回车厢灯的状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:VehicleLightState
单位类型:无
版本:Android 13
CABIN_LIGHTS_SWITCH
车厢灯开关。 控制车厢灯的实体开关的位置。如果灯开着是因为门打开了或因为语音指令,则可能与 CABIN_LIGHTS_STATE
不同。例如,当开关处于关闭或自动位置时。
此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:VehicleLightSwitch
单位类型:无
版本:Android 13
CLUSTER_DISPLAY_STATE
更改仪表板屏幕的状态。
- 边界:用于渲染仪表集群 activity 的区域。
- 边衬区:activity 不应在该区域放置重要信息。
可能的值为:
int32[0]
开启、关闭:0 - 关闭,1 - 开启,-1 - 随意int32[1]
边界 - 左:正数 - 左侧位置(以像素为单位)-1 - 随意(应设置所有边界字段)int32[2]
边界 - 上:与“左”格式相同int32[3]
边界 - 右:与“左”格式相同int32[4]
边界 - 下:与“左”格式相同int32[5]
边衬区 - 左:正数 - 实际左边衬区值(以像素为单位)-1 - 随意(应将所有边衬区字段设置为“随意”)int32[6]
边衬区 - 上:与“左”格式相同int32[7]
边衬区 - 右:与“左”格式相同int32[8]
边衬区 - 下:与“左”格式相同
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
CLUSTER_NAVIGATION_STATE
通知当前导航状态。字节:NavigationStateProto 的序列化消息。
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:
单位类型:无
版本:Android 13
CLUSTER_REPORT_STATE
报告当前显示状态和 ClusterUI 状态。
ClusterHome
在处理 CLUSTER_SWITCH_UI
、CLUSTER_DISPLAY_STATE
时发送此消息。此外,ClusterHome
应在首次启动时发送此消息。当 ClusterOS 收到此消息时,如果内部预期与收到的消息不同,那么它应会再次发送 CLUSTER_SWITCH_UI
、CLUSTER_DISPLAY_STATE
以匹配状态。
int32[0]
开启/关闭:0 - 关闭,1 - 开启int32[1]
边界 - 左int32[2]
边界 - 上int32[3]
边界 - 右int32[4]
边界 - 下int32[5]
边衬区 - 左int32[6]
边衬区 - 上int32[7]
边衬区 - 右int32[8]
边衬区 - 下int32[9]
全屏或主屏幕中的 ClusterUI 类型。0 表示ClusterHome
。其他值则按照 OEM 的定义。int32[10]
子屏幕中的 ClusterUI 类型,如果当前显示两个界面的话。-1 表示该区域不再使用。字节:表示 ClusterUI 可用性的数组。0 表示不可用,1 表示可用。例如,如果汽车支持 OEM 定义的三个 ClusterUI(例如 HOME、MAPS 和 CALL),并且仅在移动网络可用时支持 CALL 界面。然后,如果网络可用,它发送 [1 1 1];如果网络不可用,则发送 [1 1 0]。
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:VehicleLightSwitch
单位类型:无
版本:Android 13
CLUSTER_REQUEST_DISPLAY
用于更改仪表板显示屏状态以显示某些 ClusterUI 的请求。 当前显示状态为关闭时,ClusterHome
会将此消息发送到 ClusterOS,请求开启显示屏以显示特定的 ClusterUI。ClusterOS 应使用 CLUSTER_DISPLAY_STATE
响应此请求
int32
要显示的 ClusterUI 类型
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:无
单位类型:无
版本:Android 13
CLUSTER_SWITCH_UI
在仪表板显示屏中启动 ClusterUI。
int32
要显示的 ClusterUI 类型,0 表示ClusterHome
,即仪表集群显示屏的主屏幕,并为仪表集群显示屏提供默认界面和一种启动器功能。其他值则按照 OEM 的定义。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
CREATE_USER
创建 Android 用户后由 Android 系统调用。 HAL 可以使用此属性来创建其相应的用户。这是一个异步请求:Android 通过设置 VehiclePropValue 发出请求,HAL 必须通过属性更改进行响应,指明请求是成功还是失败。如果失败,Android 系统会移除该用户。
请求的格式由 CreateUserRequest 定义,响应的格式由 CreateUserResponse 定义。例如,如果系统有两位用户(0 和 10),并且创建了第三位用户(即临时访客),请求将如下所示:
int32[0]
42 // 请求 IDint32[1]
11 // 所创建用户的 Android IDint32[2]
6 // 所创建用户的 Android 标志(临时访客)int32[3]
10 // 当前用户int32[4]
0 // 当前用户标志(无)int32[5]
3 // 用户数量int32[6]
0 // 第一位用户(用户 0)int32[7]
0 // 第一位用户标志(无)int32[8]
10 // 第二位用户(用户 10)int32[9]
0 // 第二位用户标志(无)int32[10]
11 // 第三位用户(用户 11)int32[11]
6 // 第三位用户标志(临时访客)字符串:"ElGuesto" // 新用户的名称
如果请求成功,HAL 会返回:
int32[0]
42 // 请求 IDint32[1]
1 // CreateUserStatus::SUCCESS
但如果失败,则返回:
int32[0]
42 // 请求 IDint32[1]
2 // CreateUserStatus::FAILURE 字符串:"D'OH!" //
含义是黑箱,并传递给调用方(例如设置界面),后者会执行适当的操作。
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
CRITICALLY_LOW_TIRE_PRESSURE
此属性表示每个轮胎的极低胎压阈值。它表示何时更换或修理轮胎。此值必须小于或等于 TIRE_PRESSURE 中的 minFloatValue。最小和最大属性值(minFloatValue 和 maxFloatValue)不适用于此属性。
更改模式:STATIC
访问模式:READ
枚举类型:无
单位类型:VehicleUnit:KILOPASCAL
版本:Android 13
CRUISE_CONTROL_COMMAND
WRITE
巡航控制 (CC) 指令。如需详细了解每个受支持的指令,请参阅 CruiseControlCommand。对于全局区域 ID (0),必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues
数组,除非同时支持 CruiseControlState
的所有状态。通过此属性发送的任何不受支持的指令都必须返回 StatusCode#INVALID_ARG
。如果此属性因 CC 处于停用状态(例如 CRUISE_CONTROL_ENABLED
为 false)而不可用,则必须返回 StatusCode#NOT_AVAILABLE_DISABLED
。如果实现了 CRUISE_CONTROL_STATE
且状态设置为 ErrorState
值,则此属性必须返回与 ErrorState
值一致的 StatusCode
。例如,如果 CRUISE_CONTROL_STATE
设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW
,则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW
更改模式:ON_CHANGE
访问模式:WRITE
枚举类型:CruiseControlCommand
单位类型:无
版本:Android 14
CRUISE_CONTROL_ENABLED
启用或停用巡航控制 (CC)。 设置为 true 表示启用 CC,设置为 false 表示停用 CC。此属性由所有形式的 CruiseControlType 共享。当 CC 处于启用状态时,车辆中的 ADAS 系统应处于开启状态并响应指令。一般来说,CRUISE_CONTROL_ENABLED
应始终返回 true 或 false。如果该功能因某种临时状态(例如车速过低)而不可用,则必须通过 CRUISE_CONTROL_STATE
属性中的 ErrorState
值传达此信息。此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 14
CRUISE_CONTROL_STATE
巡航控制 (CC) 的当前状态。 此属性会返回 CC 当前的状态。通常,此属性应返回 CruiseControlState 或 ErrorState
中定义的有效状态。例如,如果该功能因某种临时状态而不可用,则应通过 ErrorState
传达此信息。对于全局区域 ID (0),必须定义 VehicleAreaConfig#supportedEnumValue
数组,除非同时支持 CruiseControlState(包括不推荐的 OTHER)和 ErrorState
的所有状态。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:CruiseControlState/ErrorState
单位类型:无
版本:Android 14
CRUISE_CONTROL_TARGET_SPEED
巡航控制 (CC) 的当前目标速度。 OEM 应为此属性设置 minFloatValue 和 maxFloatValue 值,以定义最小和最大目标速度值。这些值必须是非负值。maxFloatValue 表示目标速度的上限。minFloatValue 表示目标速度的下限。如果此属性因 CC 处于停用状态(例如 CRUISE_CONTROL_ENABLED
为 false)而不可用,则必须返回 StatusCode#NOT_AVAILABLE_DISABLED
。如果实现了 CRUISE_CONTROL_STATE
且状态设置为 ErrorState 值,则此属性必须返回与 ErrorState 值一致的 StatusCode
。例如,如果 CRUISE_CONTROL_STATE
设置为 ErrorState#NOT_AVAILABLE_SPEED_LOW
,则此属性必须返回 StatusCode#NOT_AVAILABLE_SPEED_LOW
更改模式:ON_CHANGE
访问模式:READ
枚举类型:无
单位类型:VehicleUnit:METER_PER_SEC
版本:Android 14
CRUISE_CONTROL_TYPE
巡航控制 (CC) 的当前类型。 当 CRUISE_CONTROL_ENABLED
为 true 时,此属性会返回当前启用的 CC 类型(例如标准 CC 和自适应 CC、预测性 CC)。通常,此属性应返回 CruiseControlType
或 ErrorState
中定义的有效状态。例如,如果该功能因某种临时状态而不可用,则应通过 ErrorState
传达此信息。对于全局区域 ID (0),必须定义 StatusCode#VehicleAreaConfig#supportedEnumValues
数组,除非支持 CruiseControlType
(包括不推荐的 OTHER
)和 ErrorState
的所有状态。尝试将 CruiseControlType#OTHER
或 ErrorState
WRITE
到此属性会抛出 IllegalArgumentException
。此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:CruiseControlType
ErrorState
单位类型:无
版本:Android 14
CURRENT_GEAR
当前档位。在非手动情况下,所选档位可能与当前档位不符。例如,所选档位是 GEAR_DRIVE
,而当前档位是 GEAR_1
、GEAR_2
等档位中的一个,这反映了变速器当前运行的实际档位。配置数据中的值必须表示此车辆的受支持档位列表。例如,自动变速器的配置数据必须包含 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_1, GEAR_2,...}
,而手动变速器的列表必须为 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
。此列表不必与 GEAR_SELECTION
中报告的受支持档位列表相同。
更改模式:ON_CHANGE
访问模式:READ
枚举类型:VehicleGear
单位类型:无
版本:Android 13
CURRENT_POWER_POLICY
向 VHAL 层通知当前电源政策。 当前电源政策发生变化时,汽车电源政策服务会设置此属性
string: "sample_policy_id" // power policy ID
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
DISABLED_OPTIONAL_FEATURES
允许在 VHAL 中停用可选功能。此属性会报告应停用的可选功能。系统的所有允许可选功能均在汽车服务叠加层中声明,即 config_allowed_optional_car_features
。此属性允许停用叠加层中定义的功能。如果没有此属性,叠加层中声明的所有功能都将被启用。值 READ
应包含所有已停用的功能,并以英文逗号 (,
) 分隔。例如:com.android.car.user.CarUserNoticeService,storage_monitoring
更改模式:STATIC
访问模式:READ
枚举类型:无
单位类型:无
版本:Android 13
DISPLAY_BRIGHTNESS
用于表示显示屏亮度的属性。 某些车辆只有一个用于控制所有显示屏亮度的控件。此属性用于共享对该控件的更改。如果配备了亮度受单独控制的显示屏,汽车必须使用 PER_DISPLAY_BRIGHTNESS
。应仅实现 DISPLAY_BRIGHTNESS
和 PER_DISPLAY_BRIGHTNESS
中的一个。如果这两者都可用,AAOS 会使用 PER_DISPLAY_BRIGHTNESS
。如果此属性可写入,Android 可以在用户通过“设置”更改显示屏亮度时设置此值。如果仅为 READ
,用户仍可通过“设置”更改显示屏亮度,但更改不得反映在其他显示屏上。
更改模式:ON_CHANGE
访问模式:READ_WRITE
枚举类型:无
单位类型:无
版本:Android 13
DISTANCE_DISPLAY_UNITS
显示距离单位。 表示汽车使用哪些单位向用户显示距离。例如,英里、米或公里。距离单位在 VehicleUnit 中定义。VehiclePropConfig.configArray 用于表示支持的距离显示单位。例如,configArray[0] = METER configArray[1] = KILOMETER configArray[2] = MILE
。如果更新 DISTANCE_DISPLAY_UNITS
会影响其他 *_DISPLAY_UNITS
属性的值,则必须更新它们的值,并也将其传达给 AAOS 框架。此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:VehicleUnit
单位类型:无
版本:Android 13
DOOR_CHILD_LOCK_ENABLED
已启用车门童锁功能。 如果已启用车门童锁功能,则返回 true;如果已停用,则返回 false。如果已启用,门就无法从内部打开。此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 14
DOOR_LOCK
门锁为 true 表示门已上锁。此属性被定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
DOOR_MOVE
必须定义每个 VehicleAreaConfig 中的 maxInt32Value
和 minInt32Value
。必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。maxInt32Value
表示车门在打开时的最快移动速度。minInt32Value
表示车门在关闭时的最慢移动速度。
绝对值越大(无论是正值还是负值),表示移动速度就越快。门达到位置极限后,该值必须重置为 0。如果 DOOR_MOVE
的值为 0,则表示目前没有发生任何移动。
此属性不采用任何特定单位,而是采用相对移动速度的指定范围。
此属性定义为 VehiclePropertyAccess.READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
DOOR_POS
车门位置。 必须定义 VehicleAreaConfig
中的 maxInt32Value
和 minInt32Value
。
必须支持 minInt32Value
到 maxInt32Value
之间的所有整数。minInt32Value
表示车门已关闭。minInt32Value
必须是 0。maxInt32Value
表示车门已完全打开。介于 minInt32Value
和 maxInt32Value
之间的值表示门处于关闭位置和完全打开位置之间的过渡状态。
此属性不采用任何特定单位,而是采用相对位置的指定范围。某些车辆(小型货车)可以通过电动方式打开车门。因此,具备 WRITE
此属性的能力。此属性定义为 VehiclePropertyAccess
READ_WRITE
,但 OEM 可以将其实现为仅 VehiclePropertyAccess.READ
。
更改模式:ON_CHANGE
访问模式:READ_WRITE
/READ
枚举类型:无
单位类型:无
版本:Android 13
E~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_SET
と AreaIDs
の組み合わせを含むものとします。HVAC_TEMPERATURE_SET
が AreaIDs
[a_1, a_2, ..., a_n] にマッピングされる場合で、HVAC_DUAL_ON
を a_i と a_j と連結できる場合は、HVAC_DUAL_ON
プロパティが [a_i | a_j] にマッピングされている必要があります。さらに、a_k と a_l を個別に連結することもできる場合は、HVAC_DUAL_ON
が [a_i | a_j, a_k | a_l] にマッピングされている必要があります。たとえば、前部に 2 席(ROW_1_LEFT
と ROW_1_RIGHT
)、後部に 3 席(ROW_2_LEFT、ROW_2_CENTER、ROW_2_RIGHT)ある車の場合、温度制御装置は 2 つ(運転席側と助手席側)あり、任意で同期できます。これは、AreaIDs
で次のように表すことができます。
HVAC_TEMPERATURE_SET > [ROW_1_LEFT | ROW_2_LEFT, ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT] HVAC_DUAL_ON > [ROW_1_LEFT | ROW_2_LEFT | ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT]
プロパティが有効になっている場合、ECU は影響を受けるエリアの温度と同期させる必要があります。DUAL_ON パラメータをオンまたはオフにした副作用として変更されたパラメータは、いずれも VHAL への onPropertyEvent()
コールバックを生成します。さらに、温度設定(運転席の温度など)によって別の温度(助手席の温度など)が変わる場合は、適切な onPropertyEvent()
コールバックを生成する必要があります。
ユーザーが結合を解く温度変更をした場合(助手席の温度を個別に設定するなど)、VHAL が適切な onPropertyEvent()
コールバック(HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx
を含む)送信する必要があります。このプロパティは、VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
として実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
HVAC_ELECTRIC_DEFROSTER_ON
電気デフロスターの状態。
このプロパティは、VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
として実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
HVAC_FAN_DIRECTION
ファンの方向設定。このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: VehicleHvacFanDirection
ユニットタイプ: なし
リリース: Android 13
HVAC_FAN_DIRECTION_AVAILABLE
利用可能なファンの位置。これは、ゾーンで利用可能なファンの位置のビットマスクです。利用可能なファンの各方向がベクトルの個別のエントリで表されます。ファンの方向には、vehicle_hvac_fan_direction
セットからの複数ビットがあることがあります。たとえば、一般的な車のファンの位置にはこのようなものがあります。
- FAN_DIRECTION_FACE (0x1) - FAN_DIRECTION_FLOOR (0x2) - FAN_DIRECTION_FACE | FAN_DIRECTION_FLOOR (0x3) - FAN_DIRECTION_DEFROST (0x4) - FAN_DIRECTION_FLOOR | FAN_DIRECTION_DEFROST (0x6)
変更モード: STATIC
アクセスモード: READ
列挙型: VehicleHvacFanDirection
ユニットタイプ: なし
リリース: Android 13
HVAC_FAN_SPEED
ファンの速度設定。VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
minInt32Value
ファンの最低速度maxInt32Value
ファンの最高速度
このプロパティは、特定の単位ではなく、相対速度の特定の範囲を使用します。このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
HVAC_MAX_AC_ON
MAX AC のオンまたはオフ。MAX AC をオンにすると、ECU が吹き出し口の位置、ファン速度、温度などの要素を必要に応じて調整し、車内をできるだけ早く冷やします。MAX AC パラメータをオンまたはオフにする副作用として変更されるパラメータは、いずれも 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_ON
の AreaIDs
は、MAX DEFROST がそのエリアで制御可能であることを示します。たとえば、areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT}
は HVAC_MAX_DEFROST_ON
が前部のみを制御できることを示します。このプロパティは、VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
として実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
HVAC_POWER_ON
HVAC のグローバルな電源状態を表します。このプロパティを false に設定すると、個別の HVAC 機能を制御している一部のプロパティとサブシステムが UNAVAILABLE 状態としてマークされる場合があります。このプロパティを true に設定すると、個別の HVAC 機能を制御している一部のプロパティとサブシステムが AVAILABLE 状態としてマークされる場合があります(いずれかまたはすべてのプロパティがそれぞれの独自指標で UNAVAILABLE でない限り)。
HvacPower_DependentProperties
は機能の有効化のために HVAC の電源を入れる必要があるプロパティです。一部の車では、たとえばエアコンを付けるために、まず HVAC の電源を入れる必要があります。VehiclePropConfig.configArray
に HvacPower_DependentProperties
リストを設定する必要があります。HvacPower_DependentProperties
には VehicleArea:SEAT
に関連付けられているプロパティのみを含めなければなりません。
HVAC_POWER_ON
プロパティにマッピングする AreaID には、HvacPower_DependentProperties
がマッピングされるすべての AreaIDs
を含める必要があります。たとえば、自動車には以下の 2 つがあります。
- 前部の座席(
ROW_1_LEFT
、ROW_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]
にマッピングされる必要があります。 - 1 列目の座席(
ROW_1_LEFT
、ROW_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
座席の暖房と冷房。maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
間のすべての整数がサポートされている必要があります。
maxInt32Value
は、座席の暖房に設定できる最高温度を示します。minInt32Value
は、車が座席の冷房にも対応している場合を除いて 0 にする必要があります。冷房に対応している場合、minInt32Value
は座席の冷房に設定できる最低温度を示します。このプロパティは、特定の単位ではなく、指定した相対温度設定の範囲を使用します。このプロパティは、VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
として実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
HVAC_SEAT_VENTILATION
シート ベンチレーション。VehicleAreaConfig
の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。minInt32Value
は 0 にする必要があります。maxInt32Value
は、座席に設定できるベンチレーションの最大値を示します。
このプロパティは、特定の単位ではなく、ベンチレーション設定の指定範囲を使用します。
HVAC アプリとアシスタントで使用して、シート ベンチレーションの状態を有効化、変更、読み取りできます。これは、座席の冷房とは異なります。冷房と同時にオンにすることも、またはしないこともできます。
このプロパティは >VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
HVAC_SIDE_MIRROR_HEAT
サイドミラー ヒーター。値が大きい方が、サイドミラーの暖房レベルが高いことを表します。VehicleAreaConfig
で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。構成データには以下が含まれます。
maxInt32Value
は、暖房レベルの最大値を表します。minInt32Value
は、0 でなければならず、これは暖房を使用しないことを示します。
このプロパティは、特定の単位ではなく、相対的な温度設定の指定範囲を使用します。このプロパティは、VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM では VehiclePropertyAccess.READ
として実装する方法もあります。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
HVAC_STEERING_WHEEL_HEAT
ハンドルの暖房量と冷房量の設定。VehicleAreaConfig
で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。maxInt32Value
は、ハンドルの暖房設定の最大値を示します。minInt32Value
は、車がハンドルの冷房にも対応している場合を除き、0 にする必要があります。冷房に対応している場合は、minInt32Value
はハンドルの冷房設定の最大値を示します。このプロパティは、特定の単位ではなく、暖房設定の指定範囲を使用します。このプロパティは VehiclePropertyAccess.READ
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
HVAC_TEMPERATURE_CURRENT
HVAC の現在の温度。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:CELSIUS
リリース: Android 13
HVAC_TEMPERATURE_DISPLAY_UNITS
表示用の温度の単位。温度を摂氏と華氏のどちらで表示するのかを示します。VehiclePropConfig.configArray
は、サポートされる温度表示の単位を示します。例: configArray[0] = CELSIUS configArray[1] = FAHRENHEIT
。このパラメータは、システムにおける HVAC の温度表示に使用されることがあります。値は、VehicleUnit.CELSIUS
または VehicleUnit.FAHRENHEIT
のいずれかである必要があります。
HVAC_TEMPERATURE_DISPLAY_UNITS の更新が他の *_DISPLAY_UNITS
プロパティの値に影響を与える場合は、それらの値を更新し、AAOS フレームワークに伝送する必要があります。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: VehicleUnit
ユニットタイプ: なし
リリース: Android 13
HVAC_TEMPERATURE_SET
摂氏で設定される HVAC の設定温度。
VehicleAreaConfig
の minFloatValue
と maxFloatValue
を定義する必要があります。
minFloatValue
は、摂氏での最低温度の設定です。maxFloatValue
は、摂氏での最高温度の設定です。
minFloatValue
と maxFloatValue
の間のすべての値がサポートされていない場合は、configArray
を使用して設定できる有効な温度値を列挙します。また、これによって、車両の温度を摂氏から華氏(またはその逆)に変換するルックアップ テーブルも記述されます。車で標準単位の換算がサポートされていない場合は、configArray
を定義する必要があります。
configArray
の設定は次のとおりです。
configArray[0]
[摂氏でサポートされている温度の下限] * 10configArray[1]
[摂氏でサポートされている温度の上限] * 10configArray[2]
[摂氏の増加単位] * 10configArray[3]
[華氏でサポートされている温度の下限] * 10configArray[4]
[華氏でサポートされている温度の上限] * 10configArray[5]
[華氏の増加単位] * 10
VehicleAreaConfig
の minFloatValue
と maxFloatValue
はそれぞれ configArray[0]
と configArray[1]
と同じである必要があります。たとえば、車が温度値を華氏で [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5]
としてサポートしている場合、configArray
は configArray = {160, 280, 5, 605, 845, 10}
にする必要があります。
摂氏の増加率の華氏の増加率に対する比率は、1 度(摂氏)対 1.8 度(華氏)という実際の比率に近づけることをおすすめします。華氏のすべての値に対する摂氏のすべての値が 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_HOME
やKEYCODE_BACK
などの標準の Android キーコードを使用する必要があります。int32array[2]
VehicleHwKeyInputAction で定義されるアクション。例:
VehicleHwKeyInputAction::ACTION_UP
、VehicleHwKeyInputAction::ACTION_UP
int32array[3]
イベントの繰り返しカウンタ。キーダウン イベントの場合、これは最初のダウンが 0 で始まり、そこから数え上げていく繰り返しのカウントです。キーアップ イベントの場合、これは常に 0 と同等です。int64array[0]
前回の起動時から経過したダウンタイム(ナノ秒単位)。直近のキーダウン イベントの時間を示します。ダウンイベントの場合、これはダウンイベントのイベントタイムのことです。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
HW_MOTION_INPUT
ハードウェア入力イベントを Android に送るプロパティ。
int32array[0]
VehicleDisplay
で定義される対象のディスプレイ。例 :
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER
、VehicleDisplay::AUX
int32array[1]
VehicleHwMotionInputSource で定義される入力タイプ。例:
VehicleHwMotionInputSource::SOURCE_KEYBOARD
、VehicleHwMotionInputSource::SOURCE_DPAD
int32array[2]
VehicleHwMotionInputAction で定義されるアクション コード。例:
VehicleHwMotionInputAction::ACTION_UP
、VehicleHwMotionInputAction::ACTION_DOWN
int32array[3]
VehicleHwMotionButtonStateFlag で定義されるボタン状態フラグ。例:
VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY
、VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
int32array[4]
ポインタ イベント カウント、N。N は正の整数にする必要があります。int32array[5:5+N-1]
ポインタ ID、長さ Nint32array[5+N:5+2*N-1]
ツールタイプ、長さ N。VehicleHwMotionToolType
で定義。例:
VehicleHwMotionToolType::TOOL_TYPE_FINGER
、VehicleHwMotionToolType::TOOL_TYPE_STYLUS
floatArray[0:N-1]
x データ、長さ NfloatArray[N:2*N-1]
y データ、長さ NfloatArray[2*N:3*N-1]
圧力データ、長さ NfloatArray[3*N:4*N-1]
サイズデータ、長さ Nint64array[0]
ダウンタイム、起動時からの経過ナノ秒数。ユーザーが位置イベントのストリームを開始するために最初に押したときの時間を示します。ダウンイベントの場合、ダウンイベントのイベントタイムのことです。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: 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
を使用します。
アクセスモード: 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_ELECTRIC
を INFO_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_STATE
は LaneCenteringAssistState#ACTIVATION_REQUESTED
に設定する必要があります。ACTIVATE
コマンドが成功すると、LANE_CENTERING_ASSIST_STATE
は LaneCenteringAssistState#ACTIVATED
に設定する必要があります。LaneCenteringAssistCommand
からコマンド DEACTIVATE
が成功すると、LANE_CENTERING_ASSIST_STATE
は LaneCenteringAssistState#ENABLED
に設定する必要があります。
グローバル エリア ID(0)の場合、LaneCenteringAssistCommand
のすべての列挙値がサポートされていない限り、VehicleAreaConfig#supportedEnumValues
を定義する必要があります。LCA が無効になっているために(たとえば、LANE_CENTERING_ASSIST_ENABLED
が false)、このプロパティが利用できない場合、このプロパティは StatusCode#NOT_AVAILABLE_DISABLED
を返す必要があります。LANE_CENTERING_ASSIST_STATE
が実装されており、状態が ErrorState
値に設定されている場合、このプロパティは ErrorState
値に一致する StatusCode
を返す必要があります。たとえば、LANE_CENTERING_ASSIST_STATE
が ErrorState#NOT_AVAILABLE_SPEED_LOW
に設定されている場合、このプロパティは StatusCode#NOT_AVAILABLE_SPEED_LOW
を返す必要があります。
変更モード: ON_CHANGE
アクセスモード: WRITE
列挙型: LaneCenteringAssistCommand
ユニットタイプ: なし
リリース: Android 14
LANE_CENTERING_ASSIST_ENABLED
車線維持支援(LCA)の有効化または無効化。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 動作。各 VehicleAreaConfig
で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
maxInt32Value
は、ミラーが右方向へ傾く際の最大動作速度を表します。minInt32Value
は、ミラーが左方向へ傾く際の最大動作速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。ミラーが限界位置に達したら、値を 0 にリセットする必要があります。MIRROR_Y_MOVE の値が現時点で 0 の場合、現在動作が生じていないことを意味します。
このプロパティは、特定の単位ではなく、動作の相対速度の指定の範囲を使用します。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
MIRROR_Y_POS
ミラーの Y 位置。VehicleAreaConfig
の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。minInt32Value
は、ミラーが最大限左方向に傾いていることを示します。
この値は、正の値であってはなりません。maxInt32Value
は、ミラーが最大限右方向に傾いていることを示します。この値は、負の値であってはなりません。0 は、ミラーがいずれの方向にも傾いていないことを示します。
minInt32Value
と maxInt32Value
の間の値は、左右の最大位置の間の移行状態を示します。
このプロパティは、特定の単位ではなく、相対位置の指定の範囲を使用します。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
MIRROR_Z_MOVE
ミラーの Z 動作。各 VehicleAreaConfig
で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
maxInt32Value
は、ミラーが上方向へ傾く際の最大動作速度を表します。minInt32Value
は、ミラーが下方向へ傾く際の最大動作速度を表します。正か負のいずれか大きい方の絶対値がより速い動作速度を表します。ミラーが限界位置に達したら、値を 0 にリセットする必要があります。MIRROR_Z_MOVE' の値が現時点で 0 の場合、現在動作が生じていないことを意味します。
このプロパティは、特定の単位ではなく、動作の相対速度の指定の範囲を使用します。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
MIRROR_Z_POS
ミラーの Z 位置。VehicleAreaConfig
の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。minInt32Value
は、ミラーが完全に下方向に傾いていることを示します。この値は、正の値であってはなりません。maxInt32Value
は、ミラーが完全に上方向に傾いていることを示します。この値は、負の値であってはなりません。0 は、ミラーがいずれの方向にも傾いていないことを示します。
minInt32Value
と maxInt32Value
の間の値は、上下の最大位置の間の移行状態を示します。
このプロパティは、特定の単位ではなく、相対位置の指定の範囲を使用します。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
NIGHT_MODE
true は、夜間モードセンサーが車室内の環境が薄暗いことを検知したことを示します。プラットフォームではこの機能を、暗いまたは薄暗い環境での視認性を高める適切な 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_BRIGHTNESS
と PER_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_SELECTION
が GEAR_NEUTRAL
の場合、PERF_VEHICLE_SPEED
は、車両の前進時に正、後退時に負、動いていないときはゼロとなります。
変更モード: CONTINUOUS
アクセスモード: READ
ユニットタイプ: なし
ユニットタイプ: VehicleUnit:METER_PER_SEC
リリース: Android 13
PERF_VEHICLE_SPEED_DISPLAY
ディスプレイの車両速度。一部の車両では、実際の速度よりもわずかに遅い速度がスピードメーターに表示されます。
変更モード: CONTINUOUS
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:METER_PER_SEC
リリース: Android 13
POWER_POLICY_GROUP_REQ
電源の状態遷移のたびに、デフォルトの電源ポリシーの決定に使用される電源ポリシー グループを設定するリクエストを定義します。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
POWER_POLICY_REQ
電源ポリシーを適用するリクエストを定義します。VHAL でこのプロパティを設定し、自動車の電源ポリシーを変更します。自動車の電源ポリシー サービスはこのプロパティに登録して、実際に電源ポリシーを変更します。/vendor/etc/automotive/power_policy.xml
で定義される電源ポリシーの ID を使用して VehiclePropValue を設定することで、リクエストが行われます。特定の ID が定義されていない場合、自動車の電源ポリシー サービスはリクエストを無視して、現在の電源ポリシーを維持します。
string: "sample_policy_id" // power policy ID
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
POWER_POLICY_GROUP_REQ
電源の状態遷移のたびに、デフォルトの電源ポリシーの決定に使用される電源ポリシー グループを設定するリクエストを定義します。VHAL は、電源の状態遷移時に適用されるデフォルトの電源ポリシーを設定するために、電源ポリシー グループの ID を使用してこのプロパティを設定します。電源ポリシー グループは、/vendor/etc/power_policy.xml で定義されます。特定の ID が定義されていない場合は、自動車の電源ポリシー サービスはリクエストを無視します。自動車の電源ポリシー サービスは、このプロパティを登録し、電源ポリシー グループを設定します。電源ポリシーは、システムの電源ステータスが変わり、新しい電源ステータスに対して、マッピングされた有効な電源ポリシーがある場合に実際に適用されます。
string: "sample_policy_group_id" // power policy group ID
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
RANGE_REMAINING
残りの航続可能距離。燃料および充電の残りのメーター。残りの航続可能距離は、車両のすべてのエネルギー源を考慮に入れるものとします。たとえば、ハイブリッド車における航続可能距離は、燃料とバッテリーに基づく航続可能距離の合計となります。今後のルートに基づくより正確な推定値がある場合、ナビゲーション アプリは航続可能距離を更新することが可能なため、このプロパティは、VehiclePropertyAccess.READ_WRITE
として定義されます。このプロパティは、OEM の裁量においてのみ VehiclePropertyAccess.READ
として実装できます。
変更モード: CONTINUOUS
アクセスモード: READ_WRITE
列挙型: なし
ユニットタイプ: VehicleUnit:METER
リリース: Android 13
READING_LIGHTS_STATE
読書灯の現在のステータスを返します。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleLightState
ユニットタイプ: なし
リリース: Android 13
READING_LIGHTS_SWITCH
読書灯を操作するスイッチ。これは、ドアが開いている、または音声コマンドが理由でライトが点灯している場合は、READING_LIGHTS_STATE
とは異なる場合があります。たとえば、スイッチがオフまたは自動の位置にある間が挙げられます。このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM では VehiclePropertyAccess.READ
としてのみ実装できます。
REAR_FOG_LIGHTS_STATE
リア フォグ ライトの現在の状態を返します。FOG_LIGHTS_STATE
または REAR_FOG_LIGHTS_STATE
のいずれかのみを実装できます。FOG_LIGHTS_STATE
をご覧ください。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleLightState
ユニットタイプ: なし
リリース: Android 13
REAR_FOG_LIGHTS_SWITCH
ユーザーが希望する設定。FOG_LIGHTS_SWITCH
または REAR_FOG_LIGHTS_SWITCH
のいずれかのみを実装する必要があります。詳細については、FOG_LIGHTS_SWITCH
をご覧ください。このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM では VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE/READ
列挙型: VehicleLightSwitch
ユニットタイプ: なし
リリース: Android 13
REMOVE_USER
Android ユーザーが削除されると Android システムによって呼び出されます。HAL は、このプロパティを同等のユーザーの削除に使用できます。これは、書き込み専用の呼び出しです。Android システムは、HAL からの返答は想定していません。したがって、このリクエストは失敗してはなりません。同等の HAL ユーザーを削除できない場合、HAL はそのユーザーに無効とマークを付けるか、別の方法で復元する必要があります。
RemoveUserRequest
で定義されたコンテンツを使用して VehiclePropValue で設定するとリクエストが行われます。たとえば、システムにユーザーが 3 人(0、10、11)いる場合に、ユーザー 11 が削除された場合のリクエストは以下のようになります。
int32[0]
42 // リクエスト IDint32[1]
11 // (削除したユーザーの Android ユーザー ID)int32[2]
0 // (削除したユーザーの Android ユーザーフラグ)int32[3]
10 // 現在のユーザーint32[4]
0 // 現在のユーザーフラグ(なし)int32[5]
2 // ユーザー数int32[6]
0 // 最初のユーザー(ユーザー 0)int32[7]
0 // ユーザーの最初のフラグ(なし)int32[8]
10 // 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 回動かします。各 VehicleAreaConfig
の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。maxInt32Value
は、座席の背もたれが前方に傾く際の最大動作速度を表します。minInt32Value
は、リクライニング時の座席の背もたれの最大移動速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シートバックレストが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_BACKREST_ANGLE_1_MOVE
の値が 0 の場合、動作は行われていません。
このプロパティは、動作の相対速度の指定の範囲で表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_BACKREST_ANGLE_1_POS
シートの背もたれの角度は 1 ポジションです。背もたれの角度 1 は、座席の底部に最も近いアクチュエーターです。VehicleAreaConfig
の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。minInt32Value
は、座席の底部にあるアクチュエータに対する座席の背もたれのフルリクライニング位置を示します。maxInt32Value
は、座席の底部にあるアクチュエータに対するシートバックレストの最も直立した位置または前方位置を示します。
minInt32Value
と maxInt32Value
の間の値は、完全に倒した状態と、直立した状態と前傾した状態の間の移行状態を示します。
このプロパティは、指定された相対位置範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_BACKREST_ANGLE_2_MOVE
シートの背もたれの角度を 2 度動かします。各 VehicleAreaConfig
で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
maxInt32Value
は、座席の背もたれが前方に傾く際の最大動作速度を表します。minInt32Value
は、座席の背もたれが座っているときの最大移動速度を表します。
絶対値(正または負)が大きいほど、移動速度が速いことを示します。シートバックレストが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_BACKREST_ANGLE_2_MOVE
の値が現在 0 の場合、移動は行われていません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_BACKREST_ANGLE_2_POS
シートの背もたれの角度は 2 番目の位置です。背もたれの角度 2 は、シートの下から 2 番目のアクチュエーターです。
VehicleAreaConfig
の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
minInt32Value
は、座席の下部にあるアクチュエータから次のアクチュエータに対応する、座席の背もたれの完全なリクライニング位置を示します(詳しくは SEAT_BACKREST_ANGLE_1_POS
をご覧ください)。maxInt32Value
は、シートの底部にあるアクチュエータから背もたれの次のアクチュエータまでのシート背もたれの最も直立した前方位置を示します(詳細については SEAT_BACKREST_ANGLE_1_POS
をご覧ください)。
minInt32Value
と maxInt32Value
の間の値は、完全に倒した状態と、直立した状態と前傾した状態の間の移行状態を示します。
このプロパティは、指定された相対位置範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_BELT_BUCKLED
シートベルトを締める。true は、シートベルトが締まっていることを示します。書き込みアクセス権は、シートの自動バックル機能があることを示します。このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_BELT_HEIGHT_MOVE
シートベルトの高さ調整。各 VehicleAreaConfig
で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
maxInt32Value
は、シートベルトの肩のアンカーが上方向に動く際の最大動作速度を表します。minInt32Value
は、シートベルトの肩アンカーが下方向に移動する際の最大動作速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シートベルトが位置制限に達したら、値を 0 にリセットする必要があります。SEAT_BELT_HEIGHT_MOVE
の値が 0 であれば、動作は行われていません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_BELT_HEIGHT_POS
シートベルトの高さの位置。ショルダー ベルトのアンカー ポイントを調整します。
VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
~maxInt32Value
の範囲の整数をすべてサポートする必要があります。
minInt32Value
は、シートベルトの肩のアンカーが最も低い位置にあることを示します。maxInt32Value
は、シートベルトの肩のアンカーが最も高い位置にあることを示します。
minInt32Value
と maxInt32Value
の間の値は、最小位置と最大位置の間の移行状態を示します。
このプロパティは、相対位置の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_CUSHION_SIDE_SUPPORT_MOVE
シートクッションのサイドサポートの移動方向と速度のプロパティを示します。
各 VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
~maxInt32Value
の範囲の整数をすべてサポートする必要があります。
maxInt32Value
は、シートクッションのサイド サポートの幅を広げるとき(サポートが減るときなど)の最大移動速度を表します。minInt32Value
は、座席クッションのサイドサポートが狭くなる際の最大動作速度を表します(サポートが増加している場合など)。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シートクッションのサイドサポートが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_CUSHION_SIDE_SUPPORT_MOVE
の値が 0 であれば、動作は行われていません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
SEAT_CUSHION_SIDE_SUPPORT_POS
シートの腰側(底クッションの側面)のサポート位置のプロパティを表します。
各 VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
maxInt32Value
は、シート クッションのサイド サポートが最も広い位置(たとえば、最も広い位置)にあることを示します。minInt32Value
は、座席クッションのサイド サポートが最も薄い位置にあることを示します(最もサポートが強い位置など)。
minInt32Value
と maxInt32Value
の間の値は、最も狭い位置と最も広い位置の間の移行状態を示します。
このプロパティは、指定された相対位置範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は <covehiclepropertyaccess.read< code=""> としてのみ実装できます。</covehiclepropertyaccess.read<>
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
SEAT_DEPTH_MOVE
シートの奥行きの移動。
各 VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
maxInt32Value
は、座席が深くなる際の最大動作速度を表します。minInt32Value
は、座席が浅くなる際の最大動作速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シートバックレストが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_DEPTH_MOVE
の値が現在 0 の場合、動きはありません。
このプロパティは、相対的な移動速度の指定範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_DEPTH_POS
シートの奥行きの位置。座席の奥行き、座席のバックレストから前端までの距離を設定します。
VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
minInt32Value
は、座席が最も低い位置にあることを示します(座席クッションの前端と座席の後端の距離が最も短い位置など)。
maxInt32Value
は、座席が最も後ろの位置にあることを示します(座席クッションの前端と座席の後端の距離が最も長い位置など)。
minInt32Value
から maxInt32Value
の間の値は、最も浅い位置と最も深い位置の間の遷移状態を示します。
このプロパティは、相対位置の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は <covehiclepropertyaccess.read< code=""> としてのみ実装できます。.</covehiclepropertyaccess.read<>
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_EASY_ACCESS_ENABLED
シートの簡単なアクセス機能のプロパティを表します。true の場合、乗員が車両に乗り降りしやすくなるようにシートが自動的に調整されます。各エリア ID は、簡単アクセス機能を利用して、ユーザーが出入りしようとしている座席にマッピングする必要があります。このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は <covehiclepropertyaccess.read< code=""> としてのみ実装できます。</covehiclepropertyaccess.read<>
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
SEAT_FOOTWELL_LIGHTS_STATE
シートのフットウェル ライトの状態のプロパティを表します。SEAT_FOOTWELL_LIGHTS_STATE
には、ライトの現在の状態がいつでも反映されます。これは、ライトを制御するスイッチの位置を表す SEAT_FOOTWELL_LIGHTS_SWITCH
の機能とは異なります。
そのため、 SEAT_FOOTWELL_LIGHTS_STATE
が SEAT_FOOTWELL_LIGHTS_SWITCH
の値(SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
、SEAT_FOOTWELL_LIGHTS_SWITCH=ON
など)と一致しない場合があります。
このプロパティは、SEAT_FOOTWELL_LIGHTS_STATE
の値が CABIN_LIGHTS_STATE の値と異なる可能性がある場合にのみ実装する必要があります。
サポートされている各エリア ID で、VehicleLightState のすべての列挙値がサポートされていない限り、VehicleAreaConfig#supportedEnumValues を定義する必要があります。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleLightState
ユニットタイプ: なし
リリース: Android 14
SEAT_FOOTWELL_LIGHTS_SWITCH
シートのフットウェル ライトのスイッチのプロパティを表します。SEAT_FOOTWELL_LIGHTS_SWITCH
は、ライトを制御するスイッチの位置を表します。これは、任意の時点でのライト現在の状態を反映する SEAT_FOOTWELL_LIGHTS_STATE の機能とは異なります。そのため、SEAT_FOOTWELL_LIGHTS_SWITCH
が SEAT_FOOTWELL_LIGHTS_STATE の値と一致しない場合があります(SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
と SEAT_FOOTWELL_LIGHTS_SWITCH=ON
など)。
このプロパティは、SEAT_FOOTWELL_LIGHTS_SWITCH の値が CABIN_LIGHTS_SWITCH の値と異なる可能性がある場合にのみ実装する必要があります。
サポートされている各エリア ID で、VehicleLightSwitch のすべての列挙値がサポートされていない限り、VehicleAreaConfig#supportedEnumValues を定義する必要があります。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: VehicleLightSwitch
ユニットタイプ: なし
リリース: Android 13
SEAT_FORE_AFT_MOVE
シートの前後移動。このプロパティは、シート全体を向いている方向に前後に動かします。
各 VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
~maxInt32Value
の範囲の整数をすべてサポートする必要があります。
maxInt32Value
は、座席が前進する際の最大動作速度を表します。minInt32Value
は、後方に移動する際の座席の最大移動速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シートが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_FORE_AFT_MOVE
の値が 0 の場合、移動は行われません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_FORE_AFT_POS
シートの前後の位置。座席の位置を前後に設定します。
VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
minInt32Value
は、座席が最も後ろの位置にあることを示します。maxInt32Value
は、座席が最も前方に伸ばされていることを示します。minInt32Value
と maxInt32Value
の間の値は、最も近い位置と最も遠い位置の間の移行状態を示します。
このプロパティは、指定された相対位置範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_HEADREST_ANGLE_MOVE
ヘッドレストの角度調整。各 VehicleAreaConfig
の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
maxInt32Value
は、シートのヘッドレストが直立または前方位置に移動する際の最大動作速度を表します。minInt32Value
は、浅い位置に移動する際の座席のヘッドレストの最大移動速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。座席のヘッドレストが位置制限に達したら、値を 0 にリセットする必要があります。SEAT_HEADREST_ANGLE_MOVE
の値が 0 の場合、動きはありません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されていますが、OEM は <covehiclepropertyaccess.read< code=""> としてのみ実装できます。</covehiclepropertyaccess.read<>
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_HEADREST_ANGLE_POS
ヘッドレストの角度の位置。VehicleAreaConfig
の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
minInt32Value
は、ヘッドレストが完全なリクライニング状態にあることを示します。maxInt32Value
は、ヘッドレストが最も直立した前方位置にあることを示します。
minInt32Value
から maxInt32Value
の間の値は、完全なリクラインと最も直立した位置と前方の位置との間の移行状態を示します。
このプロパティは、指定された相対位置範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されていますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_HEADREST_FORE_AFT_MOVE
ヘッドレストの前後に動かします。各 VehicleAreaConfig
で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
maxInt32Value
は、前進時の座席のヘッドレストの最大移動速度を表します。minInt32Value
は、後方に移動する際の座席のヘッドレストの最大移動速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。座席のヘッドレストが位置制限に達したら、値を 0 にリセットする必要があります。SEAT_HEADREST_FORE_AFT_MOVE
の値が 0 であれば、動作は行われていません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_HEADREST_FORE_AFT_POS
ヘッドレストの前後位置。VehicleAreaConfig
の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
minInt32Value
は、ヘッドレストが最も後ろの位置にあることを示します。maxInt32Value
は、ヘッドレストが最前線の位置にあることを示します。
minInt32Value
から maxInt32Value
の間の値は、前方位置と後方位置の間の遷移状態を示します。
このプロパティは、相対位置の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_HEADREST_HEIGHT_MOVE
ヘッドレストの高さ調整。各 VehicleAreaConfig
で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
maxInt32Value
は、シートのヘッドレストが上がる際の最大動作速度を表します。minInt32Value
は、座席のヘッドレストが下がる際の最大動作速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シートのヘッドレストが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_HEADREST_HEIGHT_MOVE
の値が 0 の場合、動きはありません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_HEADREST_HEIGHT_POS
(非推奨)ヘッドレストの高さの位置。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_HEADREST_HEIGHT_POS_V2
ヘッドレストの高さの位置。サポートされている座席のヘッドレストの高さを設定します。VehiclePropConfig.areaConfigs には、サポートされているシートを指定します。
VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
minInt32Value
は、ヘッドレストが最も低い位置にあることを示します。maxInt32Value
は、ヘッドレストが最も高い位置にあることを示します。
minInt32Value
と maxInt32Value
の間の値は、最小位置と最大位置の間の移行状態を示します。
このプロパティは、相対位置の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
SEAT_HEIGHT_MOVE
シートの高さの調整。各 VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
間のすべての整数がサポートされている必要があります。
maxInt32Value
は、座席が上方向に移動する際の最大動作速度を表します。
minInt32Value
は、下降する際の座席の最大移動速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シートが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_HEIGHT_MOVE
の値が 0 であれば、動作は行われていません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_HEIGHT_POS
シートの高さの位置。VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
間のすべての整数がサポートされている必要があります。
minInt32Value
は、座席が最も低い位置にあることを示します。maxInt32Value
は、座席が最も高い位置にあることを示します。
minInt32Value
と maxInt32Value
の間の値は、最小位置と最大位置の間の移行状態を示します。
このプロパティは、相対位置の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_LUMBAR_FORE_AFT_MOVE
腰椎の前後移動。各 VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
間のすべての整数がサポートされている必要があります。
maxInt32Value
は、座席のランバーサポートが前方に移動する際の最大動作速度を表します。minInt32Value
は、座席のランバーサポートが後方に移動する際の最大動作速度を表します。
正であれ負であれ、絶対値が大きいほど動作速度が速いことを表します。シートのランバーサポートが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_LUMBAR_FORE_AFT_MOVE
の値が 0 の場合、動きはありません。
このプロパティは、相対的な移動速度の指定範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_LUMBAR_FORE_AFT_POS
木材の前後位置。VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
間のすべての整数がサポートされている必要があります。
minInt32Value
は、ランバー サポートが最も後ろの位置にあることを示します(サポートが最も少ない位置など)。maxInt32Value
は、ランバー サポートが最も前方に移動していることを示します(最もサポート力のある位置など)。
minInt32Value
と maxInt32Value
の間の値は、前方と後方の位置の間の移行状態を示します。
このプロパティは、指定された相対位置範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスタイプ: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_LUMBAR_SIDE_SUPPORT_MOVE
ランバーサイド サポートの移動。各 VehicleAreaConfig
で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。
maxInt32Value
は、座席の腰部サイド サポートが広がる際の最大動作速度を表します。minInt32Value
は、座席の腰部サイドサポートが薄くなる際の最大動作速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シートのランバーサイド サポートが限界位置に達したら、値を 0 にリセットする必要があります。SEAT_LUMBAR_SIDE_SUPPORT_MOVE
の値が 0 の場合、動きはありません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスタイプ: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_LUMBAR_SIDE_SUPPORT_POS
ランバーサイド サポートの位置。VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。minInt32Value
は、腰部サイドサポートが最も薄い位置にあることを示します(サポートが最も強い位置など)。maxInt32Value
は、ランバーサイド サポートが最も広い位置にあることを示します(サポートが最も少ないなど)。
minInt32Value
と maxInt32Value
の間の値は、最も狭い位置と最も広い位置の間の移行状態を示します。
このプロパティは、相対位置の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスタイプ: READ_WRITE
/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
SEAT_LUMBAR_VERTICAL_MOVE
シートのランバー サポートの垂直移動の方向と速度のプロパティを表します。
各 VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。maxInt32Value
は、ランバー サポートが上方向に最速で動いていることを示します。minInt32Value
は、ランバー サポートが最速の下り速度で動いていることを示します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。シート クッションのサイド サポートが位置制限に達したら、値を 0 にリセットする必要があります。SEAT_LUMBAR_VERTICAL_MOVE の値が 0 の場合、動作は発生していません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
SEAT_LUMBAR_VERTICAL_POS
シートのランバーサポートの垂直位置のプロパティを表します。各 VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
~maxInt32Value
の範囲の整数をすべてサポートする必要があります。maxInt32Value
は、ランバー サポートの最高位置を示します。minInt32Value
は、ランバーサポートの最下位の位置を示します。
minInt32Value
と maxInt32Value
の間の値は、最小位置と最大位置の間の移行状態を示します。
このプロパティは、相対位置の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_MEMORY_SELECT
このパラメータは、シート位置の選択に使用するメモリ プリセットを選択します。VehicleAreaConfig の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。minInt32Value
は常に 0 で、maxInt32Value
は使用可能なシート プリセット メモリ スロット数を決定します(例: numSeatPresets - 1)。たとえば、運転席に 3 つのメモリ プリセットがある場合、maxInt32Value
は 2 です。ユーザーがプリセットを選択すると、目的のプリセット番号(0、1、2)が設定されます。
変更モード: ON_CHANGE
アクセスモード: WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_MEMORY_SET
この設定により、ユーザーは現在の座席位置の設定を、選択したプリセット スロットに保存できます。VehicleAreaConfig
の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
は 0 にする必要があります。また、各座席位置の maxInt32Value
は SEAT_MEMORY_SELECT
の maxInt32Value
と一致する必要があります。
変更モード: ON_CHANGE
アクセスモード: WRITE
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_OCCUPANCY 色
特定の座席が占有されているかどうかを、車両が判別できる範囲で示します。有効な値は VehicleSeatOccupancyState
列挙型の値です。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleSeatOccupancyState
ユニットタイプ: なし
リリース: Android 13
SEAT_TILT_MOVE(SEAT_TILT_MOVE)
シートの傾斜移動。各 VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。maxInt32Value
は、座席の前端が上方向に移動する際の最大動作速度を表します。minInt32Value
は、座席の前端が下方向に移動する際の最大動作速度を表します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。座面が限界位置に達したら、値を 0 にリセットする必要があります。SEAT_TILT_MOVE の値が現時点で 0 の場合、現在動作は行われていません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SEAT_TILT_POS(座席傾斜位置)
シートの傾斜位置。VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
~maxInt32Value
の整数をすべてサポートする必要があります。minInt32Value
は、座面の角度が最も低い位置にあることを示します。これは、シートの後端に対して可能な限り低い位置にあるシートの前端に対応しています。maxInt32Value
は、座面が最も高い角度に傾いていることを示します。これは、シートの後端から可能な限り高い位置にあるシートの前端に対応しています。
minInt32Value
と maxInt32Value
の間の値は、最小位置と最大位置の間の移行状態を示します。
このプロパティは、相対位置の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
SEAT_WALK_IN_POS
シートの現在のウォークイン位置を示すプロパティを表します。minInt32Value
は通常の座席位置を示します。minInt32Value
は 0 にする必要があります。maxInt32Value
は、座席がフルウォークインの位置にあることを示します。
minInt32Value
と maxInt32Value
の間の値は、通常の位置とウォークイン モードの位置の間の移行状態を示します。
このプロパティは、相対位置の指定の範囲として表されます。
エリア ID は、乗客が座る予定の座席ではなく、持ち込み機能が有効になったときに実際に移動する座席と一致している必要があります。
このプロパティは VehiclePropertyAccess.READ_WRITE として定義されますが、OEM は
VehiclePropertyAccess.READ としてのみ実装します。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
SHUTDOWN_REQUEST
ヘッドユニットにシャットダウンをリクエストします。
これは、ヘッドユニットの電源がオフのときにタスクを実行するために必要です(リモートタスク機能)。タスクを実行するためにヘッドユニットの電源を入れた後は、ヘッドユニットの電源を切る必要があります。タスクが完了すると、ヘッドユニットからこのメッセージが送信されます。
このプロパティは、ユーザーがヘッドユニットのシャットダウンを希望する場合には適用されません。
通常、ヘッドユニットの外部にある別のシステム(電源コントローラなど)に、ヘッドユニットのシャットダウンの準備をするよう指示します。
外部システムは、車両が使用中かどうかを確認して、このリクエストが有効であることを検証する必要があります。SHUTDOWN_REQUEST が送信された後にユーザーが車両に乗車した場合、システムはこのリクエストを無視する必要があります。VehicleInUse プロパティを電源コントローラに保存し、VEHICLE_IN_USE プロパティを介して公開することをおすすめします。VehicleInUse が true の場合、シャットダウン リクエストは無視する必要があります。
許可されている場合、外部システムはヘッドユニットにシャットダウン シグナルを送信します。これにより、VHAL は Android に SHUTDOWN_PREPARE メッセージを送信します。Android は、メッセージを処理してシャットダウン プロセスを開始します。
このプロパティはリクエストの発行のみを目的としており、書き込みのみをサポートしています。このプロパティ値が設定されるたびに、現在のプロパティ値に関係なく、シャットダウンのリクエストが発行されます。現在のプロパティ値は無意味です。
このプロパティは書き込み専用であるため、定期購入は許可されず、プロパティ変更イベントは生成されません。
設定する値はシャットダウン オプションを示します。{@code VehicleApPowerStateShutdownParam}
のいずれかにする必要があります(例: VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY
)。システムがこのオプションをサポートしていない場合、このシャットダウン オプションが適用されないことがあります。この場合、エラーは返されません。
構成情報については、VehiclePropConfig.configArray
は、サポートされているシャットダウン オプションを示すために、{@code VehicleApPowerStateConfigFlag}
の値を組み合わせるビットフラグを持つ必要があります。
シャットダウン リクエストを他のシステムに送信できなかった場合はエラーを返します。
変更モード: ON_CHANGE
アクセスモード: WRITE
列挙型: VehicleApPowerStateShutdownParam
>
ユニットタイプ: なし
リリース: Android 14
STEERING_WHEEL_DEPTH_MOVE
ハンドルの奥行きの動き。VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての値がサポートされている必要があります。
maxInt32Value
は、ハンドルが運転手から離れていることを示します。minInt32Value
は、ハンドルが運転手側に動いていることを示します。
正であれ負であれ、整数が大きいほど動作速度が速いことを表します。ステアリング ホイールが限界位置に達したら、値を 0 にリセットする必要があります。STEERING_WHEEL_DEPTH_MOVE
の値が現在 0 の場合、動作は行われていません。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
STEERING_WHEEL_DEPTH_POS
ハンドルの奥行きの位置。すべてのハンドル プロパティの一意の ID は、0x0BE0 から始まります。
VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての値がサポートされている必要があります。maxInt32Value
は、ドライバーから最も遠いハンドルの位置を示します。minInt32Value
は、運転席に最も近いハンドルの位置を示します。
minInt32Value
と maxInt32Value
の間の値は、
このプロパティは、相対位置の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
STEERING_WHEEL_EASY_ACCESS_ENABLED
ステアリングホイールの簡単アクセス機能が有効になっている。true の場合、ドライバーが車両に乗り降りしやすくなるように運転手のハンドルが自動調整されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
STEERING_WHEEL_HEIGHT_MOVE
ステアリング ホイールの高さの調整。VehicleAreaConfig の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
~maxInt32Value
の間の値をすべてサポートする必要があります。
maxInt32Value
は、ハンドルが上方向に動いていることを示します。minInt32Value
は、ハンドルが下方向に動いていることを示します。
整数(正または負)が大きいほど、移動速度が速くなります。ステアリング ホイールが限界位置に達したら、値を 0 にリセットする必要があります。STEERING_WHEEL_HEIGHT_MOVE
の値が現時点で 0 の場合、現在動作が生じていないことを意味します。
このプロパティは、動作の相対速度の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
STEERING_WHEEL_HEIGHT_POS
ステアリング ホイールの高さの位置。
VehicleAreaConfig の maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての値がサポートされている必要があります。maxInt32Value
は、ハンドルが最も高い位置にあることを示します。minInt32Value
は、ハンドルが最も低い位置にあることを示します。
minInt32Value
~maxInt32Value
の間の値は、最低位置と最高位置間の遷移状態を示します。
このプロパティは、相対位置の指定の範囲として表されます。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 14
STEERING_WHEEL_LIGHTS_STATE
ハンドルライトの状態。ステアリング ホイール ライトの現在の状態を表します。これは、ライトを制御するスイッチの位置を表す STEERING_WHEEL_LIGHTS_SWITCH
とは異なります。したがって、STEERING_WHEEL_LIGHTS_STATE
は STEERING_WHEEL_LIGHTS_SWITCH
の値と一致しない場合があります(
と STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
STEERING_WHEEL_LIGHTS_STATE=ON
など)。
このプロパティは、STEERING_WHEEL_LIGHTS_STATE
の値が CABIN_LIGHTS_STATE の値と異なる可能性がある場合にのみ実装する必要があります。
グローバル エリア ID(0)の場合、VehicleLightState のすべての列挙値がサポートされていない限り、VehicleAreaConfig#supportedEnumValues を定義する必要があります。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: VehicleLightState
ユニットタイプ: なし
リリース: Android 14
STEERING_WHEEL_LIGHTS_SWITCH
ハンドルライトのスイッチ。ステアリング ホイールライトを制御するスイッチの位置を表します。これは、ステアリング ホイール ライトの現在の状態を表す とは異なります。したがって、STEERING_WHEEL_LIGHTS_SWITCH
は STEERING_WHEEL_LIGHTS_STATE
の値と一致しない場合があります。たとえば、STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
や STEERING_WHEEL_LIGHTS_STATE=ON
です。
このプロパティを実装するのは、STEERING_WHEEL_LIGHTS_SWITCH
の値が CABIN_LIGHTS_SWITCH
の値と異なる可能性がある場合に限られます。
グローバル エリア ID(0)の場合、VehicleLightSwitch のすべての列挙値がサポートされていない限り、VehicleAreaConfig#supportedEnumValues
を定義する必要があります。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: VehicleLightSwitch
ユニットタイプ: なし
リリース: Android 14
STEERING_WHEEL_LOCKED
ハンドルがロックされています。true の場合、ステアリングホイールの位置はロックされ、変更できません。このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は <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 // リクエスト IDint32[1]
1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCHint32[2]
11 // ターゲット ユーザー IDint32[3]
0 // ターゲット ユーザーフラグ(なし)int32[4]
10 // 現在のユーザーint32[5]
0 // 現在のユーザーフラグ(なし)int32[6]
3 // ユーザー数int32[7]
0 // ユーザー #0(Android ユーザー ID 0)int32[8]
0 // ユーザー #0 のフラグ(なし)int32[9]
10 // ユーザー #1(Android ユーザー ID 10)int32[10]
0 // ユーザー #1 のフラグ(なし)int32[11]
11 // ユーザー 2(Android ユーザー ID 11)int32[12]
0 // ユーザー 2 のフラグ(なし)
ANDROID_SWITCH
Android システムから呼び出され、Android ユーザーが変更されようとしていることを示します。ただし、Android は HAL の応答を待ってから(最大で一定時間)続行します。HAL は、このリクエストを受信したら内部ユーザーを切り替え、内部ユーザーが切り替わったかどうかを示すSWITCH_USER(type=VEHICLE_RESPONSE)
(SwitchUserStatus 列挙型を介して)を Android に返す必要があります。たとえば、Android にユーザー(0、10、11)がいて、10 から 11 に切り替える(どのユーザーにも特別なフラグがない)場合、リクエストは次のようになります。int32[0]
42 // リクエスト IDint32[1]
2 // SwitchUserMessageType::ANDROID_SWITCHint32[2]
11 // ターゲット ユーザー IDint32[3]
0 // ターゲット ユーザーフラグ(なし)int32[4]
10 // 現在のユーザーint32[5]
0 // 現在のユーザーフラグ(なし)int32[6]
3 // ユーザー数int32[7]
0 // 最初のユーザー(ユーザー 0)int32[8]
1 // ユーザーの最初のフラグ(SYSTEM)int32[9]
10 // 2 人目のユーザー(ユーザー 10)int32[10]
0 // ユーザーの 2 つ目のフラグ(なし)int32[11]
11 // 3 人目のユーザー(ユーザー 11)int32[12]
0 // 3 つ目のユーザーフラグ(なし)
リクエストが成功すると、HAL は次のようにプロパティを更新する必要があります。
int32[0]
42 // リクエスト IDint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
1 // status: SwitchUserStatus::SUCCESS
リクエストが失敗した場合、レスポンスは次のようになります。
int32[0]
42 // リクエスト IDint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
2 // status: SwitchUserStatus::FAILURE string: "108-D'OH!"- OEM 固有のエラー メッセージ
VEHICLE_RESPONSE
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 // リクエスト IDint32[1]
4 // messageType: SwitchUserMessageType::VEHICLE_REQUESTint32[2]
11 // Android ユーザー ID
リクエストが成功し、Android に 3 人のユーザー(0、10、11)が存在する場合、レスポンスは次のようになります。
int32[0]
-108 // リクエスト IDint32[1]
5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCHint32[2]
11 // ターゲット ユーザー IDint32[3]
0 // ターゲット ユーザー ID フラグ(なし)int32[4]
11 // 現在のユーザーint32[5]
0 // 現在のユーザーフラグ(なし)int32[6]
3 // ユーザー数int32[7]
0 // 最初のユーザー(ユーザー 0)int32[8]
0 // ユーザーの最初のフラグ(なし)int32[9]
10 // 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 // リクエスト IDint32[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 // リクエスト IDint32[1]
2 (レスポンスのアソシエーション数)int32[2]
1 (最初のタイプ: UserIdentificationAssociationType::KEY_FOB)int32[3]
2 (最初の値: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)int32[4]
101(最初のタイプ: UserIdentificationAssociationType::CUSTOM_1)int32[5]
4(2 番目の値: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)
次に、ユーザーをカスタム メカニズムに関連付けるために、set リクエストが実行されます。
int32[0]
43 // リクエスト IDint32[1]
10(Android ユーザー ID)int32[2]
0 (Android ユーザーフラグ)int32[3]
1 (設定される関連付けの数)int32[4]
101(最初のタイプ: UserIdentificationAssociationType::CUSTOM_1)
リクエストが成功すると、レスポンスは次のようになります。
int32[0]
43 // リクエスト IDint32[1]
1(レスポンス内の関連付けの数)int32[2]
101(最初のタイプ: UserIdentificationAssociationType::CUSTOM_1)int32[3]
1 (最初の値: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
set リクエストは関連付けを追加しますが、既存の関連付けは削除しません。上記の例では、最終状態は 2 つの関連付け(FOB と CUSTOM_1)になります。ユーザーを CUSTOM_1 のみに関連付け、FOB には関連付けない場合、リクエストは次のようになります。
int32[0]
43 // リクエスト IDint32[1]
10(Android ユーザー ID)int32[2]
2 (設定するタイプの数)int32[3]
1(最初のタイプ: UserIdentificationAssociationType::KEY_FOB)int32[4]
2 (最初の値: UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)int32[5]
101(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 つの要素は、個々のホイールの目盛りを表します。順序は次のとおりです。
- 左前
- 右前
- 右後
- 左後
すべてのティック数は累積値です。ティックカウントは車両が前進すると増加し、車両が後退すると減少します。車両の始動時に、ティックは 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_REARconfigArray[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 で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。maxInt32Value
は、窓が最速速度で平面内で開いているか、平面外方向で閉じていることを示します。minInt32Value
は、窓が最速の速度で平面内で閉じているか、平面外方向で開いていることを示します。
正か負のいずれか大きい方の絶対値がより速い動作速度を表します。ウィンドウが限界位置に達したら、値を 0 にリセットする必要があります。WINDOW_MOVE
の値が 0 の場合、動きはありません。このプロパティは、動作の相対速度の指定の範囲で表されます。
平面から開く可能性のある窓(サンルーフの換気モード)の場合、このパラメータは次のようになります。次の場合:
- サンルーフが開いている場合:
Max
サンルーフをさらに開き、完全に開くと自動的に停止します。Min
サンルーフを閉じて、サンルーフを閉じると自動的に停止する。
- 通気口が開いている:
Max
通気口を閉じると、通気口が閉じたときに自動的に停止します。Min
通気口をさらに開き、通気口が完全に開くと自動的に停止します。
- サンルーフが閉まっている場合:
Max
サンルーフを開き、サンルーフが完全に開くと自動的に停止します。Min
通気口を開き、通気口が完全に開くと自動的に停止します。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
WINDOW_POS
ウィンドウの位置。各 VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。minInt32Value
と maxInt32Value
の間のすべての整数がサポートされている必要があります。minInt32Value
は、窓が閉じているか、平面から完全に開いていることを示します。ウィンドウを平面から開くことができない場合は、minInt32Value
はウィンドウが完全に閉じたときの位置であり、0 にする必要があります。ウィンドウを平面の外で開くことができる場合、minInt32Value
はウィンドウが平面から外れた位置で完全に開いていることを示し、負の値になります。詳細については、以下の例をご覧ください。maxInt32Value
は、ウィンドウが完全に開いていることを示します。
minInt32Value
から maxInt32Value
の間の値は、閉じた/完全に開いた平面から外れた位置と完全に開いた位置の間の遷移状態を示します。このプロパティは特定の単位ではなく、指定された相対位置の範囲にあります。たとえば、平面から外側に移動できるウィンドウの場合、このプロパティは次のようになります。平面から外側に開くことができるウィンドウ(サンルーフの換気モード)の場合、このパラメータは負の値で動作します。
Max
サンルーフが完全に開いている(サンルーフが閉まっている場合は 0)。Min
サンルーフの換気口が完全に開いている(サンルーフが閉まっている場合は 0)。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: なし
ユニットタイプ: なし
リリース: Android 13
WINDSHIELD_WIPERS_PERIOD
フロントガラスのワイパー時間(ミリ秒)。ワイパーの 1 回転の瞬時時間をミリ秒単位で返します。1 サイクルとは、ワイパーが停止位置から移動して、停止位置に戻ることを指します。間欠ワイパーの設定を選択した場合、間欠ワイパーの休止時間中は、このプロパティの値を 0 に設定する必要があります。VehicleAreaConfig で maxInt32Value
と minInt32Value
を定義する必要があります。各エリア ID の maxInt32Value
には、最長のワイパー期間を指定する必要があります。minInt32Value
は、エリア ID ごとに 0 に設定する必要があります。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: なし
ユニットタイプ: VehicleUnit:MILLI_SECS
リリース: Android 14
WINDSHIELD_WIPERS_STATE
ワイパーの状態。フロントガラスのワイパーの現在の状態を返します。WINDSHIELD_WIPERS_STATE
の値は WINDSHIELD_WIPERS_SWITCH
の値と一致しない場合があります。たとえば、WINDSHIELD_WIPERS_STATE: ON
と WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO
です。WINDSHIELD_WIPERS_STATE: ON
と WINDSHIELD_WIPERS_PERIOD
が実装されている場合、WINDSHIELD_WIPERS_PERIOD
にはワイパーの 1 サイクルの所要時間を反映する必要があります。
サポートされている各エリア ID では、WindshieldWipersState
のすべての状態(非推奨の OTHER を含む)がサポートされていない限り、VehicleAreaConfig#supportedEnumValues
配列を定義する必要があります。
変更モード: ON_CHANGE
アクセスモード: READ
列挙型: WindshieldWipersState
ユニットタイプ: なし
リリース: Android 14
WINDSHIELD_WIPERS_SWITCH
ワイパーのスイッチ。フロントガラスのワイパーを制御するスイッチの位置を表します。WINDSHIELD_WIPERS_SWITCH
の値は WINDSHIELD_WIPERS_STATE
の値と一致しない場合があります(例: WINDSHIELD_WIPERS_SWITCH: AUTO
と WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON
)。サポートされている各エリア ID では、WindshieldWipersSwitch
のすべての状態(非推奨の OTHER を含む)がサポートされていない限り、VehicleAreaConfig#supportedEnumValues
配列を定義する必要があります。
このプロパティは VehiclePropertyAccess.READ_WRITE
として定義されていますが、OEM は VehiclePropertyAccess.READ
としてのみ実装できます。このプロパティが VehiclePropertyAccess.READ_WRITE
として実装され、OTHER 状態が VehicleAreaConfig#supportedEnumValues
配列にリストされている場合、OTHER は書き込みでサポートされている値ではなく、読み取りでのみサポートされている値です。
変更モード: ON_CHANGE
アクセスモード: READ_WRITE
/ READ
列挙型: WindshieldWipersSwitch
ユニットタイプ: なし
リリース: Android 14