支援的系統屬性

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

本頁面列出 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
列舉類型：N/A
單位類型：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
列舉類型：N/A
單位類型：VehicleUnit:MILLI_SECS
版本：Android 14

ABS_ACTIVE

自動煞車系統 (ABS) 已啟用。在 ABS 啟用時設為 true，在 ABS 關閉時重設為 false。這項屬性可根據 ABS 系統的即時狀態間歇性設定 (脈衝)。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

ANDROID_EPOCH_TIME

當前日期和時間，以 Epoch 紀元時間 (以毫秒為單位) 編碼。這個值代表自 1970 年 1 月 1 日世界標準時間起經過的毫秒數。

這個值代表自 1970 年 1 月 1 日世界標準時間起經過的毫秒數。如果 VHAL 支援此屬性，CarServices 會將此值設為 WRITE，以便將 Android 系統的時間提供給 VHAL。這項功能可用於將其他車輛系統 (儀表板時鐘) 與 Android 的時鐘同步。

AAOS 會在啟動期間將此屬性 WRITE 一次，之後只會在時間來源變更時 WRITE。AAOS 會正確填入 VehiclePropValue.timestamp。AAOS 不會傳送自然流逝時間的更新內容。int64Values[0] = 提供的 Unix 時間 (以毫秒為單位)。

屬性可能需要超過 0 毫秒的時間才能透過堆疊傳播，因此，使用帶有時間戳記的屬性有助於減少時間漂移。因此，對於屬性的所有 WRITE，時間戳記可用於消除這項誤差：

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

變更模式：ON_CHANGE
存取模式：WRITE
列舉類型：N/A
單位類型：VehicleUnit:MILLI_SECS
版本：Android 13

AP_POWER_BOOTUP_REASON

用來回報目前開機原因的屬性。這是 STATIC 屬性，在整個期間 (直到關機為止) 都不會變更。舉例來說，即使使用者在自動開機並解鎖門後按下電源鍵，啟動原因仍須保持 VehicleApPowerBootupReason#USER_UNLOCK int32Values[0] 必須為 VehicleApPowerBootupReason

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

AP_POWER_STATE_REPORT

用來回報應用程式處理器電力狀態的屬性。假設 AP 的電源狀態是由獨立的電源控制器控制。

• int32Values[0] VehicleApPowerStateReport 列舉值
• int32Values[1] 喚醒時間 (以毫秒為單位，如有必要) (否則為 0)

變更模式：ON_CHANGE
存取模式：READ_WRITE
列舉類型：N/A
單位類型：N/A
版本：Android 13

AP_POWER_STATE_REQ

用來控制應用程式處理器電力狀態的屬性。假設 AP 的電源狀態是由獨立的電源控制器控制。如需設定資訊，VehiclePropConfig.configArray 必須在 VehicleApPowerStateConfigFlag 中具有位元旗標組合值

• int32Values[0] VehicleApPowerStateReq 列舉值
• int32Values[1] 與每個狀態相關的額外參數，如果未使用，則為 0。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：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 和 ErrorState 的所有狀態都受支援 (包括 OTHER，但不建議使用)。

變更模式：ON_CHANGE
存取模式：READ
Enun 類型：ForwardCollisionWarningState/ErrorState
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：Android 14

BLIND_SPOT_WARNING_STATE

盲點警示 (BSW) 狀態。傳回 BSW 的目前狀態。此屬性必須一律傳回 BlindSpotWarningState 或 ErrorState 中定義的有效狀態。不得透過 StatusCode 顯示錯誤，而必須改用支援的錯誤狀態。

對於每個支援的區域 ID，除非支援 BlindSpotWarningState 和 ErrorState 的所有狀態 (包括 OTHER，但不建議使用)，否則必須定義 StatusCode#VehicleAreaConfig#supportedEnumValues 陣列。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：BlindSpotWarningState/ErrorState
單位類型：N/A
版本：Android 14

CABIN_LIGHTS_STATE

傳回車廂燈的狀態。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleLightState
單位類型：N/A
版本：Android 13

CABIN_LIGHTS_SWITCH

車廂燈開關。控制車內燈具的實體開關位置。如果燈光是因為門打開或語音指令而開啟，這個值可能與 CABIN_LIGHTS_STATE 不同。例如切換鈕處於「關閉」或「自動」位置時。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleLightSwitch
單位類型：N/A
版本：Android 13

CLUSTER_DISPLAY_STATE

變更儀表板螢幕的狀態。

• 邊界：用於算繪叢集活動的區域。
• 內嵌：活動不應放置重要資訊的區域。

可能的值：

• 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
列舉類型：N/A
單位類型：N/A
版本：Android 13

CLUSTER_NAVIGATION_STATE

告知目前的導航狀態。bytes：NavigationStateProto 的序列化訊息。

變更模式：ON_CHANGE
存取模式：WRITE
列舉類型：
單位類型：N/A
版本：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] Inset - right
• int32[8] 插邊 - 底部
• int32[9] 全螢幕或主畫面中的 ClusterUI 類型。0 代表 ClusterHome。其他值則會加上原始設備製造商 (OEM) 的定義。
• int32[10] 如果目前顯示兩個 UI，則子畫面中的 ClusterUI 類型。-1 表示該區域已不再使用。bytes：用於代表 ClusterUI 可用性的陣列。0 代表不可用，1 代表可用。舉例來說，如果車輛支援三個原始設備製造商定義的 ClusterUI (例如「HOME」、「MAPS」和「CALL」)，且僅在有行動網路時支援「CALL」使用者介面。接著，如果網路可用，就會傳送 [1 1 1]，如果網路無法使用，則傳送 [1 1 0]。

變更模式：ON_CHANGE
存取模式：WRITE
列舉類型：VehicleLightSwitch
單位類型：N/A
版本：Android 13

CLUSTER_REQUEST_DISPLAY

要求變更叢集顯示狀態，以便顯示部分 ClusterUI。當目前的螢幕狀態為關閉時，ClusterHome 會將這則訊息傳送至 ClusterOS，要求開啟螢幕並顯示特定的 ClusterUI。ClusterOS 應回覆此訊息，並附上 CLUSTER_DISPLAY_STATE

• int32 要顯示的 ClusterUI 類型

變更模式：ON_CHANGE
存取模式：WRITE
列舉類型：N/A
單位類型：N/A
版本：Android 13

CLUSTER_SWITCH_UI

在儀表板螢幕中啟動 ClusterUI。

• int32 要顯示的 ClusterUI 類型：0 表示 ClusterHome，也就是儀表板螢幕的 Home 畫面，可為儀表板螢幕提供預設 UI 和某種啟動器功能。其他值則依 OEM 定義而定。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

CREATE_USER

由 Android 系統在建立 Android 使用者後呼叫。HAL 可使用這項屬性建立等同的使用者。這是非同步要求：Android 會透過設定 VehiclePropValue 提出要求，而 HAL 必須以屬性變更回應，指出要求是否成功或失敗。如果失敗，Android 系統會移除使用者。

要求的格式由 CreateUserRequest 定義，回應的格式則由 CreateUserResponse 定義。舉例來說，如果系統有兩個使用者 (0 和 10)，並且已建立第三個使用者 (即暫時性訪客)，要求會是：

• int32[0] 42 // 要求 ID
• int32[1] 11 // 已建立使用者的 Android ID
• int32[2] 6 // 已建立使用者的 Android 標記 (暫時性訪客)
• int32[3] 10 // 目前使用者
• int32[4] 0 // 目前使用者標記 (無)
• int32[5] 3 // 使用者人數
• int32[6] 0 // 第一位使用者 (使用者 0)
• int32[7] 0 // 第一個使用者旗標 (無)
• int32[8] 10 // 第二位使用者 (使用者 10)
• int32[9] 0 // 第二個使用者旗標 (無)
• int32[10] 11 // 第三位使用者 (使用者 11)
• int32[11] 6 // 第三方使用者標記 (暫時性訪客) 字串：「ElGuesto」// 新使用者的名稱

如果要求成功，HAL 會傳回：

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

但如果失敗，請按照下列步驟操作：

• int32[0] 42 // 要求 ID
• int32[1] 2 // CreateUserStatus::FAILURE string: "D'OH!" //

這代表黑箱，並會傳遞給呼叫端 (例如設定 UI)，以便採取適當的動作。

變更模式：ON_CHANGE
存取模式：READ_WRITE
列舉類型：N/A
單位類型：N/A
版本：Android 13

CRITICALLY_LOW_TIRE_PRESSURE

這個屬性會指出每個輪胎的嚴重低壓門檻。這項資訊可指出何時需要更換或修理輪胎。這個值必須小於或等於 TIRE_PRESSURE 中的 minFloatValue。最小和最大屬性值 (minFloatValue 和 maxFloatValue) 不適用於此屬性。

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:KILOPASCAL
版本：Android 13

CRUISE_CONTROL_COMMAND

WRITE 巡航定速 (CC) 指令。如要進一步瞭解每個支援指令的詳細資訊，請參閱 CruiseControlCommand。針對全域區域 ID (0)，除非支援 CruiseControlState 的所有狀態，否則必須定義 StatusCode#VehicleAreaConfig#supportedEnumValues 陣列。透過此屬性傳送的任何不支援的指令都必須傳回 StatusCode#INVALID_ARG。當 CC 處於停用狀態 (例如 CRUISE_CONTROL_ENABLED 為 false) 而無法使用此屬性時，此屬性必須傳回 StatusCode#NOT_AVAILABLE_DISABLED。如果已實作 CRUISE_CONTROL_STATE，且狀態設為 ErrorState 值，則此屬性必須傳回與 ErrorState 值相符的 StatusCode。舉例來說，如果 CRUISE_CONTROL_STATE 設為 ErrorState#NOT_AVAILABLE_SPEED_LOW，則這個屬性必須傳回 StatusCode#NOT_AVAILABLE_SPEED_LOW

變更模式：ON_CHANGE
存取模式：WRITE
列舉類型：CruiseControlCommand
單位類型：N/A
版本：Android 14

CRUISE_CONTROL_ENABLED

啟用或停用定速巡航控制 (CC)。設為 true 可啟用輔助字幕，設為 false 則可停用輔助字幕。所有形式的 CruiseControlType 都會共用這個屬性。啟用 CC 後，車輛的 ADAS 系統應會開啟並回應指令。一般來說，CRUISE_CONTROL_ENABLED 一律應傳回 true 或 false。如果某些暫時狀態 (例如車輛速度過低) 導致無法使用這項功能，則必須透過 CRUISE_CONTROL_STATE 屬性中的 ErrorState 值傳遞該資訊。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

CRUISE_CONTROL_STATE

巡航定速 (CC) 的目前狀態。這個屬性會傳回 CC 的目前狀態。一般來說，這個屬性應傳回在 CruiseControlState 或 ErrorState 中定義的有效狀態。舉例來說，如果某項功能因某些暫時狀態而無法使用，則應透過 ErrorState 傳送相關資訊。如果是全域區域 ID (0)，則必須定義 VehicleAreaConfig#supportedEnumValue 陣列，除非 CruiseControlState 的所有狀態 (包括不建議使用的 OTHER) 和 ErrorState 都受支援。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：CruiseControlState/ErrorState
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：VehicleUnit:METER_PER_SEC
版本：Android 14

CRUISE_CONTROL_TYPE

目前的巡航控制器 (CC) 類型。如果 CRUISE_CONTROL_ENABLED 為 true，這個屬性會傳回目前啟用的字幕類型 (例如標準字幕和自適應字幕、預測字幕)。一般來說，這個屬性應會傳回 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
單位類型：N/A
版本：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
單位類型：N/A
版本：Android 13

CURRENT_POWER_POLICY

將目前的電源政策通知 VHAL 層。當目前的電源政策變更時，車輛電源政策服務會設定這個屬性

string: "sample_policy_id" // power policy ID

變更模式：ON_CHANGE
存取模式：READ_WRITE
列舉類型：N/A
單位類型：N/A
版本：Android 13

DISABLED_OPTIONAL_FEATURES

允許在 VHAL 中停用選用功能。此屬性會回報應停用的選用功能。系統允許的所有選用功能都會在 Car 服務疊加層中宣告，config_allowed_optional_car_features 這個屬性可讓您停用疊加層中定義的功能。如果沒有這項屬性，系統會啟用疊加層中宣告的所有功能。值 READ 應包含所有已停用的功能，並以半形逗號 (,) 分隔。例如，com.android.car.user.CarUserNoticeService,storage_monitoring

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

DISPLAY_BRIGHTNESS

用來代表螢幕亮度的屬性。部分車輛提供單一控制項，可調整所有螢幕的亮度。這項屬性可用於分享該控制項的變更。在螢幕亮度可個別控制的車輛中，螢幕必須使用 PER_DISPLAY_BRIGHTNESS。請只實作 DISPLAY_BRIGHTNESS 和 PER_DISPLAY_BRIGHTNESS 其中一個。如果兩者皆可使用，AAOS 會使用 PER_DISPLAY_BRIGHTNESS。如果可寫入，Android 就能在使用者透過「設定」變更螢幕亮度時設定這個值。如果這項設定僅限 READ，使用者仍可透過「設定」變更螢幕亮度，但變更內容不得反映在其他螢幕上。

變更模式：ON_CHANGE
存取模式：READ_WRITE
列舉類型：N/A
單位類型：N/A
版本：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
單位類型：N/A
版本：Android 13

DOOR_CHILD_LOCK_ENABLED

已啟用車門兒童安全鎖功能。如果已啟用門鎖兒童安全鎖功能，則會傳回 true，如果已停用，則會傳回 false。啟用後，門就無法從內部開啟。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

DOOR_LOCK

門鎖為 true 表示門已上鎖。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：Android 13

E 到 G

ELECTRONIC_TOLL_COLLECTION_CARD_STATUS

電子道路收費卡狀態。這個屬性會指出車輛中 ETC 卡的狀態。如果車用運算主機偵測到車輛上有 ETC 卡，ELECTRONIC_TOLL_COLLECTION_CARD_TYPE 就會提供卡片的狀態。否則，此屬性應為 UNAVAILABLE

變更模式：ON_CHANGE
存取模式：READ
列舉類型：ElectronicTollCollectionCardStatus
單位類型：N/A
版本：Android 13

ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

電子道路收費 (ETC) 卡片類型。這個屬性會指出車輛中的 ETC 卡類型。如果車輛主機知道車輛上有 ETC 卡，這項屬性應會傳回所附卡片的類型；否則，這項屬性應為 UNAVAILABLE

變更模式：ON_CHANGE
存取模式：READ
列舉類型：ElectronicTollCollectionCardType
單位類型：N/A
版本：Android 13

EMERGENCY_LANE_KEEP_ASSIST_ENABLED

啟用或停用緊急車道維持輔助 (ELKA)。設為 true 可啟用 ELKA，設為 false 則可停用 ELKA。啟用 ELKA 時，車輛的 ADAS 系統應已開啟，並監控駕駛員是否有危險的車道變換行為。當系統偵測到不安全的操控動作時，ELKA 會發出警示，並套用轉向修正，讓車輛保持在原始車道。一般來說，EMERGENCY_LANE_KEEP_ASSIST_ENABLED 一律應傳回 true 或 false。如果某些暫時狀態 (例如車輛速度過慢) 導致無法使用這項功能，則必須透過 EMERGENCY_LANE_KEEP_ASSIST_STATE 屬性中的 ErrorState 值傳送該資訊。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式： READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

EMERGENCY_LANE_KEEP_ASSIST_STATE

緊急車道維持輔助 (ELKA) 狀態。傳回 ELKA 的目前狀態。一般來說，這個屬性應會傳回在 EmergencyLaneKeepAssistState 或 ErrorState 中定義的有效狀態。舉例來說，如果某項功能因某些暫時狀態而無法使用，則應透過 ErrorState 傳送該資訊。如果是全域區域 ID (0)，則必須定義 VehicleAreaConfig#supportedEnumValues 陣列，除非 EmergencyLaneKeepAssistState 的所有狀態 (包括不建議使用的 OTHER) 和 ErrorState 都已支援。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：EmergencyLaneKeepAssistState/ErrorState
單位類型：N/A
版本：Android 14

ENGINE_COOLANT_TEMP

引擎冷卻液溫度。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:CELSIUS
版本：Android 13

ENGINE_IDLE_AUTO_STOP_ENABLED

代表引擎怠速自動停止功能。如果為 True，車輛可能會在不需要時自動關閉引擎，然後在需要時自動重新啟動。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

ENGINE_OIL_LEVEL

機油量。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleOilLevel
單位類型：N/A
版本：Android 13

ENGINE_OIL_TEMP

機油溫度。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:CELSIUS
版本：Android 13

ENGINE_RPM

每分鐘引擎轉數 (RPM)。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:RPM
版本：Android 13

ENV_OUTSIDE_TEMPERATURE

室外溫度。此屬性必須傳達車輛外部環境的溫度讀數。如果有多個感應器用於測量外部溫度，則這個屬性應填入平均值，或最能代表外部環境溫度的有意義加權平均值。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:CELSIUS
版本：Android 13

EV_BATTERY_DISPLAY_UNITS

顯示電動車電池單位。指出車輛會使用哪些單位向使用者顯示電動車電池資訊。例如瓦特小時 (Wh)、千瓦小時 (kWh) 或安培小時 (Ah)。VehiclePropConfig.configArray 用於表示支援的電能。單位。電能單位在 VehicleUnit 中定義。例如：

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

如果更新 EV_BATTERY_DISPLAY_UNITS 會影響其他 *_DISPLAY_UNITS 屬性的值，則必須更新這些值，並將這些值傳達至 AAOS 架構。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleUnit
單位類型：N/A
版本：Android 13

EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

電動車瞬間充電率，以毫瓦為單位。正值表示電池正在充電。負值表示電池正在放電。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:MW
版本：Android 13

EV_BATTERY_LEVEL

傳回目前的電池電量，無論是電動車或油電混合車皆可。這個值不會超過 EV_CURRENT_BATTERY_CAPACITY。如要計算電池百分比，請使用 (EV_BATTERY_LEVEL, EV_CURRENT_BATTERY_CAPACITY)*100。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:WH
版本：Android 13

EV_BRAKE_REGENERATION_LEVEL

電動車的再生煞車等級。必須定義 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必須支援 minInt32Value 和 maxInt32Value 之間的所有值。minInt32Value 必須為 0。maxInt32Value 表示煞車時可回收的最大能量設定。minInt32Value 表示不使用再生煞車的設定。這個屬性是 EV_REGENERATIVE_BRAKING_STATE 的更精細形式。如果 OEM 認為 EvRegenerativeBrakingState 中的狀態不夠精細，使用者就能藉由這個屬性設定更精確的再生煞車等級。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式： READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

EV_CHARGE_CURRENT_DRAW_LIMIT

表示使用者設定的充電電流最大汲取閾值。EvChargeState::configArray[0] 用於以安培為單位，指定車輛允許的最大電流消耗量。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式： READ_WRITEREAD
列舉類型：N/A
單位類型：VehicleUnit:AMPERE
版本：Android 13

EV_CHARGE_PERCENT_LIMIT

表示使用者設定的最高收費百分比門檻。表示使用者設定的最高收費百分比門檻。傳回介於 0 到 100 的浮點值。configArray 用於指定有效值。舉例來說，如果車輛支援以下充電百分比限制值：[20, 40, 60, 80, 100]，則 configArray 應為 {20, 40, 60, 80, 100}。如果 configArray 為空白，則 0 到 100 之間的所有值都必須有效。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE,, READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

EV_CHARGE_PORT_CONNECTED

已連接電動車充電座。如果車輛有多個充電座，則此屬性必須在任何充電座連線時傳回 true。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

EV_CHARGE_PORT_OPEN

電動車充電座已開啟。如果車輛有多個充電埠，當任何充電埠開啟時，這個屬性必須傳回「是」。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式： READ_WRITEREAD
列舉類型：N/A
單位類型：N/A
版本：Android 13

EV_CHARGE_STATE

車輛的充電狀態 傳回車輛目前的充電狀態。如果車輛的目標充電百分比不是 100%，當電池電量達到目標等級時，這個屬性必須傳回 EvChargeState::STATE_FULLY_CHARGED。如需更多背景資訊，請參閱 EvChargeState::EV_CHARGE_PERCENT_LIMIT。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：EvChargeState
單位類型：N/A
版本：Android 13

EV_CHARGE_SWITCH

開始或停止為電動車電池充電。使用者想要的設定。將此屬性設為 true 可開始充電，設為 false 則可停止充電。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITEREAD
列舉類型：N/A
單位類型：N/A
版本：Android 13

EV_CHARGE_TIME_REMAINING

預估剩餘充電時間 (以秒為單位)。如果車輛未充電，則傳回 0。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:SECS
版本：Android 13

EV_CURRENT_BATTERY_CAPACITY

電動車或油電混合車目前可用的電池容量。在電動車或油電混合車上，傳回電池容量的實際值。這項屬性會擷取即時可用的電池容量，並考量電池老化和溫度依賴性等因素。這個值可能與 INFO_EV_BATTERY_CAPACITY 不同，因為 INFO_EV_BATTERY_CAPACITY 會傳回車輛全新狀態的電池額定容量。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:WH
版本：Android 14

EV_REGENERATIVE_BRAKING_STATE

車輛的再生煞車或單踏板駕駛設定。傳回與車輛再生煞車設定相關聯的目前設定。如果原始設備製造商需要的設定比 EvRegenerativeBrakingState 中提供的還要多，可以改用 EV_BRAKE_REGENERATION_LEVEL 屬性，因為後者提供更詳細的資訊。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：EvRegenerativeBrakingState
單位類型：N/A
版本：Android 13

EV_STOPPING_MODE

代表車輛目前停車模式的屬性。對於全球區域 ID (0)，除非支援 EvStoppingMode 的所有列舉值，否則必須定義 VehicleAreaConfig#supportedEnumValues。EvStoppingMode 列舉可能會在日後擴充，納入更多狀態。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以選擇只將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式： READ_WRITE/READ
列舉類型：EvStoppingMode
單位類型：N/A
版本：Android 14

EVS_SERVICE_REQUEST

啟用並要求 EVS 服務。這項屬性提供觸發 EVS 服務的方式。VHAL 應使用這項屬性，要求 Android 啟動或停止 EVS 服務。

• int32Values[0] EVS 服務類型。這個值必須是 EvsServiceType 中的列舉。
• int32Values[1] EVS 服務的狀態。這個值必須是 EvsServiceState 中的其中一個列舉。

舉例來說，如要啟用後視鏡 EVS 服務，Android 可以將屬性值設為：

[EvsServiceType::REAR_VIEW, EvsServiceState::ON]

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

EXTERNAL_CAR_TIME

建議的目前日期和時間，以 Epoch 紀元時間 (以毫秒為單位) 編碼。這個值代表自 1970 年 1 月 1 日世界標準時間起經過的毫秒數。這個屬性會向 Android 傳送 CarTime 變更信號。如果系統支援該屬性，VHAL 必須在讀取該屬性時回報最準確的目前 CarTime，並在 CarTime 值變更時發布該屬性的變更。

除了自然流逝的時間外，CarTime 若因任何原因而變更，就必須發布此屬性的 on-change 事件 (時間差小於 500 毫秒時，不應觸發 on-change 事件)。Android 會讀取並訂閱這項資源，以便從 VHAL 擷取時間。這項資訊可用於將 Android 時間與其他車輛系統 (儀表板時鐘) 同步。int64Values[0] = 提供的 Epoch 時間 (以毫秒為單位)。每當收到屬性的新值，AAOS 就會建立並傳送 ExternalTimeSuggestion 至 TimeDetectorService。

如果其他來源的優先順序較低，Android 就會使用此來源來設定系統時間。如要瞭解如何調整時間來源優先順序，以及如何處理時間建議 (包括 Android 如何處理抖動、漂移和最小解析度)，請參閱 Time Detector Service 說明文件。

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

我們強烈建議您不要使用這個屬性，透過協定 (例如 GNSS、NTP 和電話) 從 ECU 擷取時間。由於 Android 已支援這些通訊協定，因此建議您使用 Android 系統，而非透過 VHAL 與此屬性連接。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:MILLI_SECS
版本：Android 13

FOG_LIGHTS_STATE

霧燈狀態。傳回目前的霧燈狀態。如果：

• 車輛有前後霧燈。前後霧燈只能一起控制。必須實作 FOG_LIGHTS_STATE。FRONT_FOG_LIGHTS_STATE 和 REAR_FOG_LIGHTS_STATE 不得實作。
• 前後霧燈只能單獨控制。 FOG_LIGHTS_STATE 不得實作，但必須實作 FRONT_FOG_LIGHTS_STATE 和 REAR_FOG_LIGHTS_STATE。
• 車輛只有前霧燈。您必須實作 FOG_LIGHTS_STATE 或 FRONT_FOG_LIGHTS_STATE 其中之一 (不能同時實作兩者)。REAR_FOG_LIGHTS_STATE 不得實作。
• 車輛只有後霧燈。您必須實作 FOG_LIGHTS_STATE 或 REAR_FOG_LIGHTS_STATE 其中之一 (不能同時實作兩者)。FRONT_FOG_LIGHTS_STATE 不得實作。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleLightState
單位類型：N/A
版本：Android 13

FOG_LIGHTS_SWITCH

霧燈開關。使用者想要的設定。如果：

• 車輛同時配備前後霧燈。如果前後霧燈只能一起控制，就必須實作 FOG_LIGHTS_SWITCH。FRONT_FOG_LIGHTS_SWITCH 和 REAR_FOG_LIGHTS_SWITCH 不得實作。
• 前後霧燈只能分別控制。FOG_LIGHTS_SWITCH 不得實作。必須實作 FRONT_FOG_LIGHTS_SWITCH 和 REAR_FOG_LIGHTS_SWITCH。
• 車輛只有前霧燈。您必須實作 FOG_LIGHTS_SWITCH 或 FRONT_FOG_LIGHTS_SWITCH 其中之一 (不能同時實作兩者)。REAR_FOG_LIGHTS_SWITCH 不得實作。
• 車輛只有後霧燈。您必須實作 FOG_LIGHTS_SWITCH 或 REAR_FOG_LIGHTS_SWITCH 其中之一 (不能同時實作兩者)。FRONT_FOG_LIGHTS_SWITCH 不得實作。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式： READ_WRITE/READ
列舉類型：VehicleLightSwitch
單位類型：N/A
版本：Android 13

FORWARD_COLLISION_WARNING_ENABLED

啟用或停用前方碰撞預警系統 (FCW)。設為 true 可啟用 FCW，設為 false 則可停用 FCW。啟用 FCW 時，車輛的 ADAS 系統應已開啟，並監控潛在的碰撞情形。一般來說，FORWARD_COLLISION_WARNING_ENABLED 一律應傳回 true 或 false。如果因為某些暫時狀態 (例如車輛速度過低) 而無法使用這項功能，則必須透過 FORWARD_COLLISION_WARNING_STATE 屬性中的 ErrorState 值傳送該資訊。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式： READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

FORWARD_COLLISION_WARNING_STATE

前方碰撞預警系統 (FCW) 狀態。傳回 FCW 的目前狀態。此屬性必須一律傳回 ForwardCollisionWarningState 或 ErrorState 中定義的有效狀態。不得透過 StatusCode 顯示錯誤，而必須改用支援的錯誤狀態。對於全域區域 ID (0)，除非 ForwardCollisionWarningState 和 ErrorState 都支援所有狀態 (包括不建議使用的 OTHER)，否則必須定義 VehicleAreaConfig#supportedEnumValues 陣列。

變更模式：ON_CHANGE
存取模式：READ
Enun 類型：ForwardCollisionWarningState/ErrorState
單位類型：N/A
版本：Android 14

FRONT_FOG_LIGHTS_STATE

前霧燈狀態。傳回前霧燈的目前狀態。您必須實作 FOG_LIGHTS_STATE 或 FRONT_FOG_LIGHTS_STATE 其中之一。詳情請參閱 FOG_LIGHTS_STATE 的說明文件。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleLightState
單位類型：N/A
版本：Android 13

FRONT_FOG_LIGHTS_SWITCH

前霧燈開關。使用者想要的設定。您只需要實作 FOG_LIGHTS_SWITCH 或 FRONT_FOG_LIGHTS_SWITCH 其中之一。詳情請參閱 FOG_LIGHTS_SWITCH 的說明文件。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleLightSwitch
單位類型：N/A
版本：Android 13

FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

顯示的油耗單位。指出車輛用來向使用者顯示油耗資訊的單位類型。如果為 True，表示單位是距離除以油量，例如每加侖英哩。值為 False 表示單位是距離的體積，例如 L/100KM。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

FUEL_DOOR_OPEN

油箱蓋打開。此屬性必須傳達車輛的油箱門是否已開啟。這項屬性不適用於電動車。也就是說，如果 INFO_FUEL_TYPE 只包含 FuelType::FUEL_TYPE_ELECTRIC，則不得實作這項屬性。針對電動車，請實作 EV_CHARGE_PORT_OPEN。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式： READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

FUEL_LEVEL

車輛剩餘的燃料量，以毫升為單位。此屬性必須以毫升為單位，傳達車輛目前剩餘的燃料量。這項屬性不適用於電動車。也就是說，如果 INFO_FUEL_TYPE 只包含 FuelType::FUEL_TYPE_ELECTRIC，就必須實作這項屬性。針對電動車，請實作 EV_BATTERY_LEVEL 值不得超過 INFO_FUEL_CAPACITY

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:MILLILITER
版本：Android 13

FUEL_LEVEL_LOW

油量偏低的警告。這項屬性對應於資訊主頁上的低油量警告。設定 FUEL_LEVEL_LOW 後，必須在車輛加油後才應清除。這項屬性可計算車輛的所有燃料來源。例如：

• 汽油車：這項屬性僅根據汽油量計算。
• 電池供電車輛：這項屬性僅根據電池電量。
• 油電混合車輛：這項屬性可根據油量和電量等級的組合值，由原始設備製造商自行決定。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

FUEL_VOLUME_DISPLAY_UNITS

顯示的燃料量單位。指出車輛會使用哪些單位向使用者顯示油量。例如公升或加侖。VehiclePropConfig.configArray 用於表示支援的燃料量顯示單位。音量單位是在 VehicleUnit 中定義。舉例來說，configArray[0] = LITER configArray[1] = GALLON 如果更新 FUEL_VOLUME_DISPLAY_UNITS 會影響其他 *_DISPLAY_UNITS 屬性的值，則必須更新這些值，並將其傳達至 AAOS 架構。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式： READ_WRITE/READ
列舉類型：VehicleUnit
單位類型：N/A
版本：Android 13

GEAR_SELECTION

使用者選取的齒輪。設定資料中的值必須代表此車輛支援的檔位清單。舉例來說，自動變速箱的設定資料必須包含 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_DRIVE, GEAR_1, GEAR_2,...}，手動變速箱的清單則必須是 {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}。如果是自動變速箱車輛，允許駕駛人視需要選取特定檔位 (例如手動模式)，GEAR_SELECTION 的值就必須設為駕駛人選取的特定檔位，而非 GEAR_DRIVE。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleGear
單位類型：N/A
版本：Android 13

GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT

歐盟的一般安全法規遵循要求。傳回值，指出是否需要遵守一般安全性法規，如果需要，則傳回規定類型。

變更模式：STATIC
存取模式：READ
列舉類型：GsrComplianceRequirementType
單位類型：N/A
版本：Android 14

GLOVE_BOX_DOOR_POS

代表雜物箱門目前位置的屬性。必須定義 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必須支援介於 minInt32Value 和 maxInt32Value 之間的所有整數。minInt32Value 表示手套箱門已關閉。minInt32Value 必須為 0。maxInt32Value 表示手套箱門已完全打開。minInt32Value 和 maxInt32Value 之間的值表示關閉和完全開啟位置之間的轉換狀態。

這個屬性並非屬於任何特定單位，而是屬於特定範圍的相對位置。區域 ID 必須與手套箱預期使用的座位相符。舉例來說，如果前右側儀表板內嵌有手套箱，則區域 ID 應為 SEAT_1_RIGHT

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

GLOVE_BOX_LOCKED

鎖定或解鎖手套箱。如果為 true，則手套箱處於鎖定狀態。如果為 false，則手套箱會解鎖。區域 ID 必須與手套箱預期使用的座位相符。舉例來說，如果前右側儀表板內嵌有手套箱，則區域 ID 應為 VehicleAreaSeat#ROW_1_RIGHT

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式： READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

H 到 I

HANDS_ON_DETECTION_DRIVER_STATE

駕駛人手部偵測 (HOD) 狀態。傳回駕駛者的雙手是否放在方向盤上。一般來說，這個屬性應傳回 HandsOnDetectionDriverState 或 ErrorState 中定義的有效狀態。舉例來說，如果某項功能因某種暫時狀態而無法使用，則應透過 ErrorState 傳達該資訊。如果車輛因駕駛者手離方向盤太久而想傳送警告訊息給使用者，則應透過 HANDS_ON_DETECTION_WARNING 顯示警告訊息。如果是全域區域 ID (0)，則必須定義 VehicleAreaConfig#supportedEnumValues 陣列，除非 HandsOnDetectionDriverState 和 ErrorState 的所有狀態都受支援 (不建議使用 OTHER)。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：HandsOnDetectionDriverState/ErrorState
單位類型：N/A
版本：Android 14

HANDS_ON_DETECTION_ENABLED

啟用或停用手動偵測 (HOD)。設為 true 可啟用 HOD，設為 false 則可停用 HOD。啟用 HOD 時，車內系統應監控駕駛者的雙手是否放在方向盤上，並在偵測到駕駛者的雙手不再放在方向盤上時發出警告。一般來說，HANDS_ON_DETECTION_ENABLED 一律應傳回 true 或 false。

如果某項功能因暫時狀態而無法使用，則必須透過 HANDS_ON_DETECTION_STATE 屬性中的 ErrorState 值傳達該資訊。這項屬性定義為 minInt32Value VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 只能在 VehiclePropertyAccess.READ 中實作。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

HANDS_ON_DETECTION_WARNING

手部偵測 (HOD) 警告。傳回是否向駕駛人發出警告，因為駕駛人雙手離開方向盤的時間過長。一般來說，這個屬性應會傳回在 HandsOnDetectionWarning 或 ErrorState 中定義的有效狀態。舉例來說，如果某項功能因某些暫時狀態而無法使用，則應透過 ErrorState 傳送相關資訊。針對全域區域 ID (0)，必須定義 VehicleAreaConfig#supportedEnumValues 陣列，除非 HandsOnDetectionWarning (包括不建議使用的 OTHER) 和 ErrorState 的所有狀態都受支援。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：HandsOnDetectionWarning/ErrorState
單位類型：N/A
版本：Android 14

HAZARD_LIGHTS_STATE

警示燈狀態。傳回警示燈的目前狀態。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleLightState
單位類型：N/A
版本：Android 13

HAZARD_LIGHTS_SWITCH

警示燈開關。使用者想要的設定。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleLightSwitch
單位類型：N/A
版本：Android 13

HEADLIGHTS_STATE

車頭燈狀態。傳回大燈的目前狀態。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleLightState
單位類型：N/A
版本：Android 13

HEADLIGHTS_SWITCH

車頭燈開關。使用者想要的設定。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleLightSwitch
單位類型：N/A
版本：Android 13

HIGH_BEAM_LIGHTS_STATE

遠光燈狀態。傳回遠光燈的目前狀態。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleLightState
單位類型：N/A
版本：Android 13

HIGH_BEAM_LIGHTS_SWITCH

遠光燈開關。使用者想要的設定。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleLightSwitch
單位類型：N/A
版本：Android 13

HVAC_AC_ON

為指定的 areaId 開啟和關閉空調。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以將其實作為 VehiclePropertyAccess.READ

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_ACTUAL_FAN_SPEED_RPM

實際風扇速度。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_AUTO_ON

開啟或關閉自動恆溫空調。如果為 true，則自動恆溫空調會開啟。如果為 false，表示自動空調系統已關閉。如果車輛不支援直接關閉自動空調系統，原始設備製造商應在 VHAL 實作中加入邏輯，將 HVAC_AUTO_ON 設為 false，藉此變更必要的 HVAC 設定，間接關閉 HVAC_AUTO_ON。理想情況下，這項操作不應干擾使用者。原始設備製造商 (OEM) 應將自動溫度控制系統關閉時所修改的所有設定還原為先前的狀態。如此一來，HVAC_AUTO_ON 關閉的唯一結果應為關閉。如果無法將 HVAC 設定還原為先前的設定，則原始設備製造商應實施最不受干擾的變更。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_AUTO_RECIRC_ON

自動循環模式開啟或關閉。當自動循環模式開啟時，如果車輛偵測到進氣空氣品質不佳，空調系統可能會自動切換為循環模式。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_DEFROSTER

指定窗戶的風扇式除霜功能。此屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 廠商可以將其實作為 VehiclePropertyAccess.READ

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_DUAL_ON

啟用區域之間的溫度耦合。HVAC_DUAL_ON 屬性的 AreaIDs 應包含可連結的 HVAC_TEMPERATURE_SET AreaIDs 組合。如果 HVAC_TEMPERATURE_SET 對應至 AreaIDs[a_1, a_2, ..., a_n]，且 HVAC_DUAL_ON 可啟用來連結 a_i 和 a_j，則 HVAC_DUAL_ON 屬性必須對應至 [a_i | a_j]。此外，如果 a_k 和 a_l 也可以個別配對，則 HVAC_DUAL_ON 必須對應至 [a_i | a_j, a_k | a_l]。舉例來說，一輛車有兩個前座 (ROW_1_LEFT 和 ROW_1_RIGHT) 和三個後座 (ROW_2_LEFT、ROW_2_CENTER 和 ROW_2_RIGHT)。車輛有兩個溫度控制單元 (駕駛座和乘客座)，可視需要進行同步。這可以在 AreaIDs 中以以下方式表示：

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

啟用此屬性後，ECU 必須同步處理受影響區域的溫度。開啟或關閉 DUAL_ON 參數的副作用，會產生 onPropertyEvent() 回呼至 VHAL。此外，如果設定溫度 (例如駕駛座溫度) 會變更其他溫度 (例如前座乘客溫度)，則必須產生適當的 onPropertyEvent() 回呼。

如果使用者變更溫度而中斷耦合 (例如獨立設定乘客溫度)，則 VHAL 必須傳送適當的 onPropertyEvent() 回呼 (包括 HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx)。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_ELECTRIC_DEFROSTER_ON

電解霜器的狀態。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以將其實作為 VehiclePropertyAccess.READ

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_FAN_DIRECTION

風扇方向設定。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleHvacFanDirection
單位類型：N/A
版本：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
單位類型：N/A
版本：Android 13

HVAC_FAN_SPEED

風扇速度設定。必須定義 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必須支援 minInt32Value 和 maxInt32Value 之間的所有整數。

• minInt32Value 風扇最低速度
• maxInt32Value 最高風扇速度

這個屬性並未以任何特定單位表示，而是以特定的相對速度範圍表示。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以選擇只將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_MAX_AC_ON

開啟或關閉 MAX AC。當 MAX AC 開啟時，ECU 可視需要調整通風口位置、風扇速度和溫度，盡快為車輛降溫。開啟或關閉 MAX AC 參數的副作用會產生 onPropertyEvent() 回呼至 VHAL，而任何修改的參數都會產生此副作用。此屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 廠商可以將其實作為 VehiclePropertyAccess.READ

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_MAX_DEFROST_ON

開啟或關閉「MAX DEFROST」。當「MAX DEFROST」開啟時，ECU 可視需要調整通風口位置、風扇速度和溫度等項目，盡可能快速除霜。開啟或關閉 MAX DEFROST 參數時，任何參數的修改都會產生 onPropertyEvent() 回呼至 VHAL。HVAC_MAX_DEFROST_ON 的 AreaIDs 表示可在該區域控制 MAX DEFROST。舉例來說，areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT} 表示 HVAC_MAX_DEFROST_ON 只能控制前排。此屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 廠商可以將其實作為 VehiclePropertyAccess.READ

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_POWER_ON

代表空調的全球電源狀態。如果將這個屬性設為 false，可能會將控制個別 HVAC 功能和子系統的部分屬性標示為「無法使用」狀態。將這個屬性設為 true 可能會將控制個別 HVAC 功能和子系統的部分屬性標示為「可用」狀態 (除非任何或所有屬性本身都處於「不可用」狀態)。

HvacPower_DependentProperties 是指需要 HVAC 開啟才能啟用功能的屬性。舉例來說，在某些車款中，如要開啟空調，必須先開啟 HVAC。HvacPower_DependentProperties 清單必須設在 VehiclePropConfig.configArray 中，HvacPower_DependentProperties 只能包含與 VehicleArea:SEAT 相關聯的屬性

HVAC_POWER_ON 屬性的 AreaID 對應必須包含 HvacPower_DependentProperties 對應到的所有 AreaIDs。舉例來說，汽車有兩個：

1. 前座 (ROW_1_LEFT、ROW_1_RIGHT) 和三個後座 (ROW_2_LEFT、ROW_2_CENTER、ROW_2_RIGHT)。如果車內的空調功能 (空調、溫度等) 都依賴單一空調電源控制器，則 HVAC_POWER_ON 必須對應至 [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
2. 前排座位 (ROW_1_LEFT、ROW_1_RIGHT) 和後排 (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) 和第三排 (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT) 的三個座位。如果車輛的前排溫度控制器可完全獨立於車輛後方的溫度控制器運作，則 HVAC_POWER_ON 必須對應至兩個元素陣列：

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

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以選擇只將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_RECIRC_ON

開啟或關閉循環功能。控制車內外部空氣的流通。Recirc on 表示進入車室的空氣大多來自車室內部。Recirc off 表示車內的空氣大多來自車外。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 廠商可以將其實作為 VehiclePropertyAccess.READ

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_SEAT_TEMPERATURE

座椅暖氣和冷氣功能。VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value 必須定義。必須支援 minInt32Value 和 maxInt32Value 之間的所有整數。maxInt32Value 表示座椅加熱溫度的最高設定。除非車輛支援座椅冷卻功能，否則 minInt32Value 必須為 0。在本例中，minInt32Value 表示座椅冷氣設定的最高溫度。這個屬性並未使用任何特定單位，而是使用相對溫度設定的指定範圍。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_SEAT_VENTILATION

座椅通風功能。VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value 必須定義。必須支援 minInt32Value 和 maxInt32Value 之間的所有整數。minInt32Value 必須為 0。maxInt32Value 表示座椅可用的最大通風設定。

這個屬性並未使用任何特定單位，而是使用通風設定的指定範圍。

空調應用程式和 Google 助理會使用這項權限，啟用、變更或讀取座椅通風狀態。這與座椅冷卻功能不同。可以與冷卻同時開啟，也可以不開啟。

這個屬性定義為 >VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：Android 13

HVAC_TEMPERATURE_CURRENT

空調系統目前的溫度。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:CELSIUS
版本：Android 13

HVAC_TEMPERATURE_DISPLAY_UNITS

顯示的溫度單位。指出溫度是否以攝氏或華氏為單位顯示。VehiclePropConfig.configArray 表示系統支援的溫度顯示單位。例如，configArray[0] = CELSIUS configArray[1] = FAHRENHEIT 這個參數可用來顯示系統中的任何空調溫度。值必須是 VehicleUnit.CELSIUS 或 VehicleUnit.FAHRENHEIT 其中之一

如果更新 HVAC_TEMPERATURE_DISPLAY_UNITS 會影響其他 *_DISPLAY_UNITS 屬性的值，則必須更新這些屬性的值，並將值傳送至 AAOS 架構。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以實作 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleUnit
單位類型：N/A
版本：Android 13

HVAC_TEMPERATURE_SET

空調系統目標溫度設定值以攝氏為單位。

VehicleAreaConfig 中的 minFloatValue 和 maxFloatValue 必須定義：

• minFloatValue 最低溫度設定 (攝氏)。
• maxFloatValue 最高溫度設定值 (攝氏)。

如果系統不支援 minFloatValue 和 maxFloatValue 之間的所有值，請使用 configArray 列出可設定的有效溫度值。這也說明瞭查詢表格，用於將車輛的溫度從攝氏轉換為華氏 (反之亦然)。如果車輛不支援標準單位轉換，則必須定義 configArray。

configArray 的設定如下：

• configArray[0] [支援溫度的下限攝氏度] * 10
• configArray[1] [支援的攝氏溫度上限] * 10
• configArray[2] [攝氏增量] * 10
• configArray[3] [支援溫度的下限，以華氏為單位] * 10
• configArray[4] [支援溫度的上限 (以華氏為單位)] * 10
• configArray[5] [華氏增量] * 10

VehicleAreaConfig 中的 minFloatValue 和 maxFloatValue 必須分別等於 configArray[0] 和 configArray[1]。舉例來說，如果車輛支援以華氏為單位的 [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5] 溫度值，configArray 應為 configArray = {160, 280, 5, 605, 845, 10}

理想情況下，攝氏增量與華氏增量的比率應盡可能接近實際比率，即攝氏 1 度對應華氏 1.8 度。所有攝氏值必須一對一對應至 configArray 定義的華氏值。configArray 可供用戶端使用，將此屬性的溫度從攝氏轉換為華氏。此外，它還可讓客戶瞭解要設定哪個攝氏值，才能讓系統達到所需的華氏值。如果 ECU 沒有所有攝氏值與華氏值的一對一對應，則 configArray 應只定義有 1 對 1 對應的攝氏和華氏值清單。

舉例來說，如果 ECU 支援的攝氏值介於 16 到 28 之間，而華氏值介於 60 到 85 之間，每個值的增量為 1，則可能的 configArray 為 code>{160, 280, 10, 600, 840, 20}。在此情況下，85 不是支援的溫度。

任何介於有效值之間的值都應四捨五入至最接近的有效值。我們強烈建議原始設備製造商也實作 HVAC_TEMPERATURE_VALUE_SUGGESTION 車輛屬性，因為這項屬性可讓應用程式以簡單的方法，判斷可為車輛設定的溫度值，以及在攝氏和華氏之間轉換值。

這個屬性定義為 VehiclePropertyAccess.READ，但原始設備製造商 (OEM) 可以將其實作為 VehiclePropertyAccess.READ

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：VehicleUnit:CELSIUS
版本：Android 13

HVAC_TEMPERATURE_VALUE_SUGGESTION

設定空調溫度的建議值。

實作此屬性，協助應用程式瞭解最接近的支援溫度值，以攝氏或華氏為單位。

• floatValues[0] 應用程式要設定的溫度值。
• floatValues[1] floatValues[0] 的單位，應為 {VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT} 的其中一個
• floatValues[2] OEM 建議的攝氏溫度值 (這項值不會包含在要求中)。
• floatValues[3] OEM 建議的 FAHRENHEIT 值 (此值未包含在要求中)。

應用程式會使用要求的值和值的單位呼叫 set(VehiclePropValue propValue)。OEM 必須透過 onPropertyEvent() 回呼，在 floatValues[2] 和 floatValues[3] 中傳回建議值。建議值必須符合可從 HVAC_TEMPERATURE_SET configArray 衍生出的值。換句話說，建議值和 configArray 的值表應相同。

我們建議原始設備製造商在 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;

舉例來說，當駕駛者使用語音助理將空調溫度設為華氏 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 度值為華氏 70 度，則 VHAL 必須產生具有屬性值 [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0] 的回呼。在這種情況下，應用程式可得知車輛使用者介面中的值為 70.0 華氏度。

變更模式：ON_CHANGE
存取模式：READ_WRITE
列舉類型：N/A
單位類型：N/A
版本：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
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：Android 13

HW_KEY_INPUT_V2

用來將硬體輸入事件提供給 Android 的屬性。

• int32array[0] 由 VehicleDisplay 定義的目標螢幕，例如：
  VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
• int32array[1] 鍵碼，必須使用標準 Android 鍵碼，例如 KEYCODE_HOME 和 KEYCODE_BACK
• int32array[2] 在 VehicleHwKeyInputAction 中定義的動作，例如：
  VehicleHwKeyInputAction::ACTION_UP, VehicleHwKeyInputAction::ACTION_UP
• int32array[3] 事件重複次數。對於按下按鍵事件，這是重複計數，其中第一次按下按鍵的計數從 0 開始，並從該點開始計數。對於按鍵釋放事件，這個值一律等於 0。
• int64array[0] 自上次啟動以來，停機時間 (以奈秒為單位)。表示最近一次按下按鍵事件的時間。對於下行事件，這是下行事件的事件時間。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

HW_MOTION_INPUT

用來將硬體輸入事件提供給 Android 的屬性。

• int32array[0] 由 VehicleDisplay 定義的目標螢幕，例如：
  VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER、VehicleDisplay::AUX
• int32array[1] 在 VehicleHwMotionInputSource 中定義的輸入類型，例如：
  VehicleHwMotionInputSource::SOURCE_KEYBOARD、VehicleHwMotionInputSource::SOURCE_DPAD
• int32array[2] 在 VehicleHwMotionInputAction 中定義的動作代碼，例如：
  VehicleHwMotionInputAction::ACTION_UP、VehicleHwMotionInputAction::ACTION_DOWN
• int32array[3] 在 VehicleHwMotionButtonStateFlag 中定義的按鈕狀態標記，例如：
  VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY、VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
• int32array[4] 指標事件計數，N。N 必須是正整數。
• int32array[5:5+N-1] 指標 ID，長度為 N
• int32array[5+N:5+2*N-1] 工具類型，長度為 N。如 VehicleHwMotionToolType 所定義，例如：
  VehicleHwMotionToolType::TOOL_TYPE_FINGER、VehicleHwMotionToolType::TOOL_TYPE_STYLUS
• floatArray[0:N-1] x 資料，長度為 N
• floatArray[N:2*N-1] y 資料，長度為 N
• floatArray[2*N:3*N-1] 壓力資料，長度為 N
• floatArray[3*N:4*N-1] 大小資料，長度為 N
• int64array[0] 停機時間，自開機起經過的奈秒數。表示使用者最初按下按鈕開始位置事件串流的時間。如果是 down 事件，則為 down 事件的事件時間。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：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
單位類型：N/A
版本：Android 13

IGNITION_STATE

代表點火狀態。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleIgnitionState
單位類型：N/A
版本：Android 13

INFO_DRIVER_SEAT

駕駛座位位置 VHAL 實作必須忽略 areaId。使用 VehicleArea:GLOBAL

變更模式：STATIC
存取模式：READ
列舉類型：VehicleAreaSeat
單位類型：N/A
版本：Android 13

INFO_EV_BATTERY_CAPACITY

電動車或油電混合車的電池額定容量。傳回電池的額定容量、電動車或油電混合車。這是車輛全新狀態下的總電池容量。這個值可能與 EV_CURRENT_BATTERY_CAPACITY 不同，因為 EV_CURRENT_BATTERY_CAPACITY 會傳回即時可用的電池容量，並考量電池老化和溫度依賴性等因素。

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:WH
版本：Android 13

INFO_EV_CONNECTOR_TYPE

這部電動車可能會使用的連接器清單。如果車輛有多個充電埠，這個屬性必須傳回車輛上至少一個充電埠可使用的所有可能的連接器類型。

變更模式：STATIC
存取模式：READ
列舉類型：EvConnectorType
單位類型：N/A
版本：Android 13

INFO_EV_PORT_LOCATION

這個屬性必須使用 PortLocationType 列舉，傳達電動車上充電埠的位置。如果車輛有多個充電座，這個屬性必須傳回可讓車輛以最快速度充電的充電座。如要傳達所有通訊埠位置，請使用 INFO_MULTI_EV_PORT_LOCATIONS

INFO_EXTERIOR_DIMENSIONS

車輛外部尺寸：

• 高度：int32Values[0]
• 長度：int32Values[1]
• 寬度：int32Values[2]
• 寬度 (含鏡像)：int32Values[3]
• 輪距 (含後照鏡)：int32Values[4]
• 音軌寬度前端：int32Values[5]
• 後置音軌寬度：int32Values[6]
• 路邊轉彎直徑：int32Values[7]

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:MILLIMETER
版本：Android 13

INFO_FUEL_CAPACITY

車輛的油箱容量 (以毫升為單位)。這項屬性必須以毫升為單位，傳達車輛可儲存的燃料上限。這項屬性不適用於電動車 (EV)。也就是說，如果 INFO_FUEL_TYPE 只包含 FuelType::FUEL_TYPE_ELECTRIC，就必須實作 INFO_FUEL_CAPACITY。如果是電動車，請實作 INFO_EV_BATTERY_CAPACITY。

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:MILLILITER
版本：Android 13

INFO_FUEL_DOOR_LOCATION

油箱蓋的位置。這個屬性必須提供車輛加油口的位置。這項屬性不適用於電動車。也就是說，如果 INFO_FUEL_TYPE 只包含 FuelType::FUEL_TYPE_ELECTRIC，則不得實作這項屬性。針對電動車，請實作 INFO_EV_PORT_LOCATION 或 INFO_MULTI_LOCATIONS

變更模式：STATIC
存取模式：READ
列舉類型：PortLocationType
單位類型：N/A
版本：Android 13

INFO_FUEL_TYPE

車輛可能使用的燃料清單。只有在車輛可插電充電時，才需要納入 FuelType::FUEL_TYPE_ELECTRIC。舉例來說，由於 INFO_FUEL_TYPE INFO_FUEL_TYPE 的 INT32_VEC 值可填入 FuelType::FUEL_TYPE_ELECTRIC，因此 Fully Hybrid Electric Vehicle (FHEV) 不得包含 FuelType::FUEL_TYPE_ELECTRIC。

int32Values = { FuelType::FUEL_TYPE_UNLEADED }

變更模式：STATIC
存取模式：READ
列舉類型：FuelType
單位類型：N/A
版本：Android 13

INFO_MAKE

車輛製造商。這個屬性必須提供車輛的公開品牌名稱。

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

INFO_MODEL

車輛型號。這個屬性必須傳達車輛的公開型號名稱。

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

INFO_MODEL_YEAR

車輛的車型年份，格式為 `YYYY`，以公曆年為準。

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:YEAR
版本：Android 13

INFO_MULTI_EV_PORT_LOCATIONS

多個電動車充電座位置。如果車輛有多個電動車充電埠，請實作此屬性。通訊埠位置是在 PortLocationType 中定義。舉例來說，如果車輛有一個前左側和一個後左側的通訊埠：

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

如果車輛只有一個連接埠，則這個屬性的值應列出一個元素。如要說明一個通訊埠位置，請參閱 INFO-EV-PORT-LOCATION

變更模式：STATIC
存取模式：READ
列舉類型：PortLocationType
單位類型：N/A
版本：Android 13

INFO_VIN

車輛的車輛識別碼 (VIN)。

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

INITIAL_USER_INFO

定義初始化期間要使用的 Android 使用者。Android 系統會在初始化時呼叫這個屬性，並讓 HAL 定義應啟動的 Android 使用者。這項要求是透過設定 VehiclePropValue (由 InitialUserInfoRequest 定義) 而提出，而 HAL 必須以屬性變更事件 (由 InitialUserInfoResponse 定義) 回應。如果 HAL 在 Android 系統定義的時間後未回應，Android 系統會繼續執行，就好像 HAL 傳回 InitialUserInfoResponseAction:DEFAULT 動作的回應一樣。舉例來說，首次啟動時，要求可能會是：

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

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

變更模式：ON_CHANGE
存取模式：READ_WRITE
列舉類型：N/A
單位類型：N/A
版本：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
單位類型：N/A
版本：Android 14

LANE_CENTERING_ASSIST_ENABLED

啟用或停用車道置中輔助 (LCA)。設為 true 可啟用 LCA，設為 false 則可停用 LCA。啟用 LCA 時，車輛的 ADAS 系統應已開啟，並等待駕駛人的啟動訊號。啟用這項功能後，ADAS 系統應會轉動車輛，讓車輛保持在目前車道中央。

這與車道維持輔助 (LKA) 不同，後者會監控駕駛員是否不小心偏離或越過車道標線。如果系統偵測到車輛不小心偏離車道，就會啟用轉向控制功能，將車輛駛回目前車道。一般來說，LANE_CENTERING_ASSIST_ENABLED 一律應傳回 true 或 false。如果某些暫時狀態 (例如車輛速度過慢或過快) 導致無法使用這項功能，則必須透過 LANE_CENTERING_ASSIST_STATE 屬性中的 ErrorState 值傳遞該資訊。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

LANE_CENTERING_ASSIST_STATE

車道居中輔助 (LCA) 狀態。傳回 LCA 的目前狀態。此屬性必須一律傳回 LaneCenteringAssistState 或 ErrorState 中定義的有效狀態。不得透過 StatusCode 顯示錯誤，而必須改用支援的錯誤狀態。

如果 LCA 包含車道偏離警示，則必須透過車道偏離警示 (LDW) 屬性顯示這些警示。

對於全域區域 ID (0)，除非 LaneCenteringAssistState 和 ErrorState 都支援所有狀態 (包括不建議使用的 OTHER)，否則必須定義 VehicleAreaConfig#supportedEnumValues 陣列。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：LaneCenteringAssistState/ErrorState
單位類型：N/A
版本：Android 14

LANE_DEPARTURE_WARNING_ENABLED

啟用或停用車道偏移警示系統 (LDW)。設為 true 可啟用 LDW，設為 false 則可停用 LDW。啟用 LDW 時，車輛的 ADAS 系統應會開啟，並監控車輛是否接近或越過車道線，並在這種情況下發出警告。

一般來說，LANE_DEPARTURE_WARNING_ENABLED 一律應傳回 true 或 false。如果因為某些暫時狀態 (例如車輛速度過高或過低) 而無法使用這項功能，則必須透過 LANE_DEPARTURE_WARNING_STATE 屬性中的 ErrorState 值傳遞該資訊。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

LANE_DEPARTURE_WARNING_STATE

車道偏離警示系統 (LDW) 狀態。傳回 LDW 的目前狀態。此屬性必須一律傳回 LaneDepartureWarningState 或 ErrorState 中定義的有效狀態。不得透過 StatusCode 顯示錯誤，而必須改用支援的錯誤狀態。

對於全域區域 ID (0)，除非 LaneDepartureWarningState 和 ErrorState 都支援所有狀態 (包括不建議使用的 OTHER)，否則必須定義 VehicleAreaConfig#supportedEnumValues 陣列。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：LaneDepartureWarningState/ErrorState
單位類型：N/A
版本：Android 14

LANE_KEEP_ASSIST_ENABLED

啟用或停用車道維持輔助 (LKA)。設為 true 可啟用 LKA，設為 false 則可停用 LKA。啟用 LKA 時，車輛中的 ADAS 系統應會開啟，並監控駕駛人是否不小心偏離或越過車道標線。如果系統偵測到車輛不小心偏離車道，就會啟用轉向控制功能，將車輛駛回目前車道。這與車道置中輔助 (LCA) 不同，後者在啟用時會持續應用轉向控制，讓車輛保持在目前車道中央。

一般來說，LANE_KEEP_ASSIST_ENABLED 一律應傳回 true 或 false。如果某些暫時狀態 (例如車輛速度過慢或過快) 導致無法使用這項功能，則必須透過 LANE_KEEP_ASSIST_STATE 屬性中的 ErrorState 值傳遞該資訊。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

LANE_KEEP_ASSIST_STATE

車道維持輔助 (LKA) 狀態。傳回 LKA 的目前狀態。這個屬性必須一律傳回 LaneKeepAssistState 或 ErrorState 中定義的有效狀態。它不得透過 StatusCode 顯示錯誤，而必須改用支援的錯誤狀態。

如果 LKA 在套用轉向修正前提供車道偏離警告，則必須透過車道偏離警告 (LDW) 屬性顯示這些警告。

對於全域區域 ID (0)，必須定義 VehicleAreaConfig#supportedEnumValues 陣列，除非 LaneKeepAssistState 和 ErrorState 的所有狀態都受支援 (包括不建議使用的 OTHER)。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：LaneKeepAssistState/ErrorState
單位類型：N/A
版本：Android 14

LOCATION_CHARACTERIZATION

用於計算位置的輸入內容特徵。當系統透過 GNSS HAL 計算車輛位置並與 Android 共用時，這項屬性必須指出系統會考慮哪些資料和感應器輸入內容 (如果有)。

值必須傳回位元旗標集合。位元旗標已在 LocationCharacterization 中定義。值的位元標記集合中，也必須包含 DEAD_RECKONED 或 RAW_GNSS_ONLY 其中一個。

如果系統不支援此屬性，則會假設沒有額外感應器輸入內容會融合至透過 GNSS HAL 提供的 GNSS 更新。除非透過 GNSS HAL 介面指定其他值，否則就是如此。

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

MIRROR_AUTO_FOLD_ENABLED

代表 Mirror Auto Fold 功能的屬性。啟用自動收折車輛側鏡的功能時，這個屬性會設為 true (例如，當使用者下車並上鎖時，側鏡會自動收折)。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

MIRROR_AUTO_TILT_ENABLED

代表鏡像自動傾斜功能的屬性。啟用自動傾斜車輛側鏡的功能 (例如，當車輛倒車時，側鏡會自動向下傾斜) 時，這個屬性會設為 true。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

MIRROR_FOLD

鏡像折疊。如果為 True，表示鏡子已折疊。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

MIRROR_LOCK

鏡像鎖定。值為「True」表示鏡像位置已鎖定，無法變更。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：Android 13

NIGHT_MODE

True 表示夜間模式感應器偵測到車內環境光線不足。平台可以利用這項資訊，例如啟用適當的 UI，以便在黑暗或光線不足的環境中提供更好的觀看體驗。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：Android 13

OBD2_FREEZE_FRAME_INFO

這個屬性會說明目前儲存在車輛記憶體中，可透過 OBD2_FREEZE_FRAME 擷取的暫停畫面。值的解讀方式如下：int64Values 的每個元素都必須是偵測到錯誤代碼並儲存對應暫停畫面的時間戳記，且每個元素都可以做為 OBD2_FREEZE_FRAME 的索引鍵，用來擷取對應的暫停畫面。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

OBD2_LIVE_FRAME

回報可用 OBD2 感應器的目前 (即時) 值快照。設定陣列的設定如下：

• configArray[0] 供應商專屬整數值感應器數量
• configArray[1] 供應商專屬浮點值感應器數量

這項屬性的值會按照下列範例解讀。考量 configArray = {2,3} int32Values 必須是包含 Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX 加上兩個元素的向量 (或 33 個元素)。floatValues 必須是包含 Obd2FloatSensorIndex.LAST_SYSTEM_INDEX 加上三個元素的向量 (或 73 個元素)。

每個影格可能包含不同的感應器值子集，包括系統提供的感應器和供應商專屬感應器。為支援此功能，系統會將屬性值的位元組元素用作位元遮罩。位元組必須有足夠的位元組數，才能代表可能的傳感器總數 (在本例中，14 位元組可代表 106 個可能的值)。這會以連續位元遮罩的形式讀取，每個位元都會指出畫格是否含有感應器，從 int32Values 的大小開始，緊接著是 floatValues 的大小。

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

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

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

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

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

ON_CHANGE

變更模式：
存取模式：READ_WRITE/READ
列舉類型： VehicleLightSwitch
單位類型：N/A
版本：Android 13

PARKING_BRAKE_AUTO_APPLY

自動套用停車煞車。如果為 true，則表示車輛已啟用自動手煞車。值為 False 表示車輛的自動停車煞車功能已停用。這個屬性經常會與 PARKING_BRAKE_ON 混淆。兩者的差異在於 PARKING_BRAKE_ON 會指出實際的停車煞車是否已開啟或關閉，而 PARKING_BRAKE_AUTO_APPLY 則會指出自動停車煞車功能是否已啟用或停用，並不會說明實際的停車煞車目前狀態。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

PARKING_BRAKE_ON

停車煞車狀態。如果為 true，這項屬性表示車輛已踩下手煞車。值為 False 表示車輛的駐車煞車已解除。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

PER_DISPLAY_BRIGHTNESS

用來代表個別控制的螢幕亮度。部分車輛有一或多個螢幕，其亮度可個別控制，而這個屬性則用於通知每個乘客螢幕的亮度。在所有螢幕亮度都由車輛控制的車款中，必須使用 DISPLAY_BRIGHTNESS

請只實作 PER_DISPLAY_BRIGHTNESS 或 PER_DISPLAY_BRIGHTNESS 其中一個。如果兩者皆可使用，AAOS 會使用 PER_DISPLAY_BRIGHTNESS。

螢幕輸出埠會明確指出裝置上用於螢幕輸出的實體連接埠，範圍為 0 到 255。

• int32Values[0] 螢幕連接埠
• int32Values[1] 亮度

變更模式：ON_CHANGE
存取模式：READ_WRITE
列舉類型：N/A
單位類型：N/A
版本：Android 14

PERF_ODOMETER

車輛目前的里程表值。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:KILOMETER
版本：Android 13

PERF_REAR_STEERING_ANGLE

後方自行車模型車輛轉向角度。角度以度為單位。左側為負值。這項屬性與方向盤的角度無關。這個屬性必須傳達後輪相對於車輛的角度，而非方向盤的角度。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:DEGREES
版本：Android 13

PERF_STEERING_ANGLE

車輛的前方自行車模型轉向角度。角度以度為單位。左側為負值。這項屬性與方向盤的角度無關。這個屬性必須傳達前輪相對於車輛的角度，而非方向盤的角度。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：N/A
單位類型：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
列舉類型：N/A
單位類型：VehicleUnit:METER_PER_SEC
版本：Android 13

POWER_POLICY_GROUP_REQ

定義要求，用於設定用來決定每個電源狀態轉換作業的預設電源政策的電源政策群組。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

POWER_POLICY_REQ

定義套用電源政策的要求。VHAL 會設定這個屬性，以便變更車輛電源政策。車輛電源政策服務會訂閱這項屬性，並實際變更電源政策。這項要求會透過設定 VehiclePropValue，使用在 /vendor/etc/automotive/power_policy.xml 中定義的電源政策 ID。如果未定義指定 ID，車輛電源政策服務會忽略要求，並維持目前的電源政策。

string: "sample_policy_id" // power policy ID

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：Android 13

RANGE_REMAINING

剩餘的距離。剩餘的油量和電量。剩餘續航里程應包含車輛的所有能源來源。舉例來說，油電混合車的續航力是燃料和電池續航力的總和。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，因為導航應用程式可根據即將前往的路線，更新這個範圍。這項屬性只能由 OEM 視需要實作為 VehiclePropertyAccess.READ。

變更模式：CONTINUOUS
存取模式：READ_WRITE
列舉類型：N/A
單位類型：VehicleUnit:METER
版本：Android 13

READING_LIGHTS_STATE

傳回閱讀燈的目前狀態。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleLightState
單位類型：N/A
版本：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
單位類型：N/A
版本：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
單位類型：N/A
版本：Android 13

REMOVE_USER

在 Android 使用者遭到移除後，由 Android 系統呼叫。HAL 可以使用這個屬性移除等效使用者。這是只寫型 cal。Android 系統不會預期 HAL 的回覆。因此，這項要求不應失敗。如果無法移除等效的 HAL 使用者，則 HAL 應將其標示為非活動狀態，或以其他方式復原。

這項要求會透過設定 VehiclePropValue 與 RemoveUserRequest 定義的內容來提出。舉例來說，如果系統有 3 位使用者 (0、10 和 11)，且使用者 11 已遭移除，則要求會是：

• int32[0] 42 // 要求 ID
• int32[1] 11 // (已移除使用者的 Android 使用者 ID)
• int32[2] 0 // (已移除使用者的 Android 使用者標記)
• int32[3] 10 // 目前使用者
• int32[4] 0 // 目前使用者標記 (無)
• int32[5] 2 // 使用者人數
• int32[6] 0 // 第一位使用者 (使用者 0)
• int32[7] 0 // 第一個使用者旗標 (無)
• int32[8] 10 // 第二位使用者 (使用者 10)
• int32[9] 0 // 第二個使用者標記 (無)

變更模式：STATIC
存取模式：WRITE
列舉類型：N/A
單位類型：N/A
版本：Android 13

S 到 Z

SEAT_AIRBAG_ENABLED

代表在觸發時，啟動及停用座位部署安全氣囊的功能 (例如碰撞時)。如果為 true，表示座椅的安全氣囊已啟用，且在觸發時會展開。如果為 true，則座椅的安全氣囊會停用，並且在任何情況下都不會彈出。這個屬性不會指出氣囊是否已部署完成，

這個屬性可設為 VehiclePropertyAccess.READ 唯讀，以便 法規或安全疑慮。

這項屬性已定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以 請僅以 VehiclePropertyAccess.READ 的形式實作。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

SEAT_BACKREST_ANGLE_1_MOVE

座椅靠背角度 1 個移動。maxInt32Value和minInt32Value 每個 VehicleAreaConfig 都必須定義必須支援介於 minInt32Value 和 maxInt32Value 之間的所有整數。maxInt32Value 代表座椅靠背向前傾時的最大移動速度。minInt32Value 表示座位的最大移動速度 下次回電時 再次往前走

絕對值越大 (無論正負)，移動速度就越快。座椅靠背達到位置限制後，必須將值重設為 0。如果 SEAT_BACKREST_ANGLE_1_MOVE 為 0，沒有發生任何動作。

這個屬性會以特定相對移動速度的指定範圍表示。

這項屬性已定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以 請僅以 VehiclePropertyAccess.READ 的形式實作。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：Android 13

SEAT_BACKREST_ANGLE_2_MOVE

座椅靠背角度 2 度移動。必須定義每個 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必須支援 minInt32Value 和 maxInt32Value 之間的所有整數。

maxInt32Value 代表上座椅背後的最大移動速度 也能夠積極參與minInt32Value 代表座椅靠背在傾斜時的最大移動速度。

絕對值越大 (正數或負數) 表示移動速度越快。產生 剩餘座位數量達到位置限制，值必須重設為 0。如果 SEAT_BACKREST_ANGLE_2_MOVE 目前為 0，目前沒有移動中的動作。

這個屬性以指定的相對移動速度範圍表示。

這項屬性已定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以 請僅以 VehiclePropertyAccess.READ 的形式實作。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：無 單位類型：不適用
版本：Android 13

SEAT_BACKREST_ANGLE_2_POS

後置角度為 2 位置。靠背角度 2 是指從座椅底部往上數的下一個致動器。

VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value 必須定義。minInt32Value 和 maxInt32Value 之間的所有整數都必須為 #0supported。

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
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：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
列舉類型：N/A
單位類型：N/A
版本：Android 13

SEAT_DEPTH_POS

座位深度位置。設定座椅深度，即從靠背到座椅前緣的距離。

必須定義 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必須支援介於 minInt32Value 和 maxInt32Value 之間的所有整數。

minInt32Value 表示座位位於西北方位置 (例如 座椅坐墊的正面與座椅背面的最小距離)。

maxInt32Value 表示座椅處於最深的位置 (例如座椅靠背與座椅墊前緣之間的距離最長的位置)。

minInt32Value 和 maxInt32Value 之間的值表示 首位

此屬性會以指定的相對位置範圍表示。

此屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以將其實作為 <covehiclepropertyaccess.read< code=""> only..</covehiclepropertyaccess.read<>

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：不適用
單位類型：不適用
版本：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_州

代表座位上燈狀態的房源。SEAT_FOOTWELL_LIGHTS_STATE 反映 所有時間點的目前狀態。這與 SEAT_FOOTWELL_LIGHTS_SWITCH 的功能不同，後者代表控制燈具的開關位置。

因此， SEAT_FOOTWELL_LIGHTS_STATE 可能與 SEAT_FOOTWELL_LIGHTS_SWITCH 的值不符 (例如 SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC 和 SEAT_FOOTWELL_LIGHTS_SWITCH=ON)。

只有在 SEAT_FOOTWELL_LIGHTS_STATE 的值可能與 CABIN_LIGHTS_STATE 不同時，才應實作這項屬性。

每個支援區域 ID 都必須定義 VehicleAreaConfig#supportedEnumValues，除非 支援 VehicleLightState 的所有列舉值。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleLightState
單位類型：不適用
版本：Android 14

SEAT_FOOTWELL_LIGHTS_SWITCH

代表座位上燈開關的房源。SEAT_FOOTWELL_LIGHTS_SWITCH 代表控制燈具的開關位置。這與 SEAT_FOOTWELL_LIGHTS_STATE 可反映任何時間點的燈號狀態。 因此，SEAT_FOOTWELL_LIGHTS_SWITCH 可能與 SEAT_FOOTWELL_LIGHTS_STATE 的值不符 (例如 SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC 和 SEAT_FOOTWELL_LIGHTS_SWITCH=ON)。

只有在 SEAT_FOOTWELL_LIGHTS_SWITCH 的值可能與 CABIN_LIGHTS_SWITCH 的值不同時，才應實作這項屬性。

每個支援區域 ID 都必須定義 VehicleAreaConfig#supportedEnumValues，除非所有 支援 VehicleLightSwitch 的列舉值。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleLightSwitch
單位類型：N/A
版本：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

頭枕角度移動。各自的maxInt32Value和minInt32Value 必須定義 VehicleAreaConfig。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

頭枕角度位置。maxInt32Value和minInt32Value 必須定義 VehicleAreaConfig。必須支援 minInt32Value 和 maxInt32Value 之間的所有整數。

minInt32Value 表示頭枕已完全傾斜。 maxInt32Value 表示頭部處於最直立和正向的位置。

minInt32Value 和 maxInt32Value 之間的值表示 整個矩形間和最直立及向前位置之間的轉換狀態

這個屬性會以指定的相對位置範圍表示。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 廠商只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

SEAT_HEADREST_FORE_AFT_MOVE

頭枕前後移動。maxInt32Value和minInt32Value 每個 VehicleAreaConfig 都必須定義介於 必須支援 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

頭枕前後位置。《maxInt32Value》和《minInt32Value》 在 VehicleAreaConfig 中必須定義。必須支援 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
列舉類型：N/A
單位類型：N/A
版本：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

座位高度位置。maxInt32Value和minInt32Value 必須定義 VehicleAreaConfig。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
列舉類型：N/A
單位類型：N/A
版本：Android 13

SEAT_LUMBAR_FORE_AFT_POS

木材叉和升高姿勢。maxInt32Value和minInt32Value 必須定義 VehicleAreaConfig。必須支援 minInt32Value 和 maxInt32Value 之間的所有整數。

minInt32Value 表示腰部支撐墊處於最後方的位置 (例如最不提供支撐的位置)。maxInt32Value 表示 Lumbar 就是尋求支援 (例如最支持的立場)。

minInt32Value 和 maxInt32Value 之間的值表示進行轉換 往前與往後位置之間的狀態。

這個屬性會以指定的相對位置範圍表示。

這項屬性已定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以 請僅以 VehiclePropertyAccess.READ 的形式實作。

變更模式：ON_CHANGE
存取權類型：READ_WRITE/READ
列舉類型：不適用
單位類型：不適用
版本：Android 13

SEAT_LUMBAR_SIDE_SUPPORT_MOVE

腰部側邊支撐物移動。各自的maxInt32Value和minInt32Value 必須定義 VehicleAreaConfig。必須支援 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

腰側支撐位置。maxInt32Value和minInt32Value 必須定義 VehicleAreaConfig。必須支援 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 表示 Lumbar 支援的速度最快 minInt32Value 表示腰部支撐裝置以最快的速度下降。

較大的絕對值 (正或負) 表示移動速度較快。座椅靠墊側邊支架達到位置限制後，必須將值重設為 0。如果 SEAT_LUMBAR_VERTICAL_MOVE's 的值為 0，則表示沒有移動。

此屬性會以指定的相對移動速度範圍表示。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

SEAT_LUMBAR_VERTICAL_POS

代表座椅腰部支撐裝置垂直位置的屬性。maxInt32Value 必須在每個 VehicleAreaConfig 中定義 minInt32Value介於 必須支援 minInt32Value 和 maxInt32Value。 maxInt32Value 表示 Lumbar 支援的最高位置。 minInt32Value 表示 Lumbar 支撐程序的最低位置。

minInt32Value 和 maxInt32Value 之間的值表示最低和最高位置之間的轉換狀態。

這個屬性會以指定的相對位置範圍表示。

這項屬性已定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以 請僅以 VehiclePropertyAccess.READ 的形式實作。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

SEAT_MEMORY_SELECT

這個參數會選取用於選取座椅位置的記憶預設值。必須定義 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。必須支援 minInt32Value 和 maxInt32Value 之間的所有整數。minInt32Value 一律為 0，而 maxInt32Value 判定 可用的預設記憶體運算單元數量 (例如 numSeatPresets - 1)。舉例來說，如果駕駛座有三個記憶座椅設定，maxInt32Value 則為兩個。使用者選取預設值時，系統會設定所需的預設值編號 (0、1 或 2)。

變更模式：ON_CHANGE
存取模式：WRITE
列舉類型：N/A
單位類型：N/A
版本：Android 13

SEAT_MEMORY_SET

這項設定可讓使用者將目前座椅位置設定儲存至所選預設位置。maxInt32Value和minInt32Value 必須定義 VehicleAreaConfig。minInt32Value 必須為 0，且每個座位位置的 maxInt32Value 都必須與 SEAT_MEMORY_SELECT 的 maxInt32Value 相符

變更模式：ON_CHANGE
存取模式：WRITE
列舉類型：不適用
單位類型：不適用
版本：Android 13

SEAT_OCCUPANCY

指出特定座位是否有人坐，以便車輛盡可能判斷。有效值摘錄自 VehicleSeatOccupancyState 列舉。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleSeatOccupancyState
單位類型：N/A
版本：Android 13

SEAT_TILT_MOVE

請傾斜傾斜角度。各自的maxInt32Value和minInt32Value 必須定義 VehicleAreaConfig。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 之間的值表示正常和 walk-in 位置之間的轉換狀態。

這個屬性會以指定的相對位置範圍表示。

這個區域 ID 必須與臨櫃維修功能時實際移動的座位相符，而非 乘客預計的座位。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：不適用
單位類型：不適用
版本：Android 13

SHUTDOWN_要求

要求關閉車用運算主機。

這是在車用運算主機關閉時 (遠端工作功能) 時執行工作的必要條件。 車用運算主機開機執行工作後，應關機。頭部 工作完成後，系統就會傳送這則訊息。

使用者想關閉車用運算主機時，則不適用這個屬性。

這通常涉及告知車用運算主機以外的獨立系統 (例如電源控制器)，準備關閉車用運算主機。

外部系統必須檢查車輛是否位於 相關單位會如何運用資料，並讓他們覺得自己 獲得充分告知，且能夠針對該使用方式表示同意如果使用者在 SHUTDOWN_REQUEST 傳送後進入車輛，系統必須忽略這項要求。建議將 VehicleInUse 屬性儲存在電源控制器中 會透過 VEHICLE_IN_USE 屬性公開。如果 VehicleInUse 為 True，系統就必須忽略關機要求。

如果允許，外部系統會傳送關機訊號至車用運算主機，導致 VHAL 傳送 SHUTDOWN_PREPARE 訊息到 Android。接著，Android 會處理訊息，開始關機程序。

這個屬性僅適用於發出要求，且僅支援寫入。每次設定此屬性值時，系統都會發出關機要求，無論目前的屬性值為何。目前的屬性值沒有任何意義。

由於這個屬性為唯寫，因此系統不允許訂閱，也不會產生屬性變更事件。

要設定的值代表關閉選項，該選項必須為以下其中一項： {@code VehicleApPowerStateShutdownParam} 例如： VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY。但這個關機選項可能 系統不支援此選項。這種情況下，系統不會傳回錯誤。

如需設定資訊，VehiclePropConfig.configArray 必須含有 Bit 標記 結合 {@code VehicleApPowerStateConfigFlag} 中的值來指出 系統支援所有選項。

如果無法將關機要求傳送至其他系統，則會傳回錯誤。

變更模式：ON_CHANGE
存取模式：WRITE
列舉類型：VehicleApPowerStateShutdownParam>
單位類型：N/A
版本：Android 14

STEERING_WHEEL_DEPTH_MOVE

方向盤深度移動。《maxInt32Value》和《minInt32Value》 在 VehicleAreaConfig 中，您必須定義。minInt32Value 到 之間的所有值 必須支援 maxInt32Value。

maxInt32Value 表示方向盤離開駕駛者。minInt32Value 表示方向盤朝駕駛員移動。

正數或負數的較大整數，代表移動速度較快。當方向盤達到位置限制時，值必須重設為 0。如果 STEERING_WHEEL_DEPTH_MOVE 目前為 0，目前沒有移動中的動作。

此屬性以特定相對範圍表示 移動速度

這項屬性已定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以 請僅以 VehiclePropertyAccess.READ 的形式實作。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：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

方向盤中的高度移動。《maxInt32Value》和《minInt32Value》 在 VehicleAreaConfig 中，您必須定義。minInt32Value 到 之間的所有值 必須支援 maxInt32Value。

maxInt32Value 表示方向盤向上移動。minInt32Value 表示方向盤向下移動。

整數較大的整數 (正或負數) 表示移動速度更快。產生 方向盤已達到位置限制，值必須重設為 0。如果 STEERING_WHEEL_HEIGHT_MOVE 的值目前為 0，表示沒有移動情形 目前發生的事件。

此屬性會以指定的相對移動速度範圍表示。

這項屬性已定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以 請僅以 VehiclePropertyAccess.READ 的形式實作。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：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_州

方向盤燈光狀態。代表方向盤燈的目前狀態。這與 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 值可能不同時，才導入這項屬性 。

如果是全球區域 ID (0)，則必須定義 VehicleAreaConfig#supportedEnumValues，除非所有 支援 VehicleLightState 的列舉值。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleLightState
單位類型：不適用
版本：Android 14

STEERING_WHEEL_LIGHTS_SWITCH

方向盤燈光開關。代表控制方向盤燈光的切換鈕位置。這與 不同，後者代表目前的狀態 方向。因此，STEERING_WHEEL_LIGHTS_SWITCH 可能與 STEERING_WHEEL_LIGHTS_STATE 的值不符。例如 STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC 和 STEERING_WHEEL_LIGHTS_STATE=ON。

這個屬性只有在 STEERING_WHEEL_LIGHTS_SWITCH可以與 CABIN_LIGHTS_SWITCH。

對於全球區域 ID (0)，除非支援 VehicleLightSwitch 的所有列舉值，否則必須定義 VehicleAreaConfig#supportedEnumValues。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleLightSwitch
單位類型：不適用
版本：Android 14

STEERING_WHEEL_LOCKED

方向盤已鎖定。如果設為 true，方向盤的位置會鎖定，無法變更。 這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商可以將其實作為 <covehiclepropertyaccess.read< code=""> only./p> </covehiclepropertyaccess.read<>

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

STEERING_WHEEL_THEFT_LOCK_ENABLED

已啟用方向盤盜竊鎖定功能。如果為 true，系統會自動鎖定方向盤，以防在特定情況下遭竊。此屬性定義為 VehiclePropertyAccess.READ_WRITE、 但原始設備製造商 (OEM) 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

STORAGE_ENCRYPTION_BINDING_SEED

外部加密繫結種子。這個值與本機金鑰儲存空間加密金鑰混合。 這個屬性包含 16 個位元組，且應保存在 IVI 以外的 ECU。 這個屬性最初是由 AAOS 設定，AAOS 會使用 CSRNG 產生。AAOS 會在後續啟動時讀取該屬性。綁定種子應可可靠地保留。與 導致 IVI 恢復原廠設定。

變更模式：ON_CHANGE
存取模式：READ_WRITE
列舉類型：N/A
單位類型：N/A
版本：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 無法寫入 provider_prop_2 的值。

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

支援資源 IDS

(已淘汰) 所有支援的屬性 ID 清單。

變更模式：STATIC
存取模式：READ
列舉類型：不適用
單位類型：不適用
版本：Android 14

SWITCH_使用者

定義切換前景 Android 使用者的要求。

Android 系統主要會使用這項屬性來通知 HAL， 前景 Android 使用者正在切換，但 HAL 也可利用它來要求 用來切換使用者的 Android 系統。該要求是由 Android 發出時，會設定 VehiclePropValue HAL 必須透過屬性變更事件回應當 HAL 提出要求時，也必須透過屬性變更事件提出要求 (主要差異在於要求 ID 在前者為正值，在後者為負值)。SwitchUserMessageType 也有所不同。

• LEGACY_ANDROID_SWITCH Android 系統會呼叫以表示 Android 使用者 即將變更，那麼，變更請求的提出方式與 HAL (例如透過 ADB 殼層 am Switch-user)。HAL 收到這項要求後，可以切換其內部使用者，但不需要回覆 Android 系統。如果因某些原因無法變更內部使用者，則必須等待 SWITCH_USER(type=ANDROID_POST_SWITCH) 呼叫復原 (例如，可以發出 SWITCH_USER(type=VEHICLE_REQUEST) 以切換回先前的使用者)。理想情況下，這項功能不應失敗 (因為切換回來可能會讓使用者感到困惑)。
  舉例來說，如果系統有使用者 (0、10、11)，且從 0 切換至 11 (其中沒有任何特殊標記)，要求會是：
  
  • int32[0] 42 // 要求 ID
  • int32[1] 1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCH
  • int32[2] 11 // 目標使用者 ID
  • int32[3] 0 // 目標使用者標記 (無)
  • int32[4] 10 // 目前的使用者
  • int32[5] 0 // 目前使用者標記 (無)
  • int32[6] 3 // 使用者人數
  • int32[7] 0 // 使用者 #0 (Android 使用者 ID 0)
  • int32[8] 0 // 使用者 0 的標記 (無)
  • int32[9] 10 // 使用者 #1 (Android 使用者 ID 10)
  • int32[10] 0 // 使用者 #1 的旗標 (無)
  • int32[11] 11 // 使用者 #2 (Android 使用者 ID 11)
  • int32[12] 0 // 使用者 2 的標記 (無)
• ANDROID_SWITCH Android 系統會呼叫，指出 Android 使用者即將變更。 但 Android 會等待 HAL 回應 (最多時間) 再繼續進行。HAL 收到這項要求後，必須切換其內部使用者，然後透過 SWITCH_USER(type=VEHICLE_RESPONSE) 回應 Android，指出是否已切換內部使用者 (透過 SwitchUserStatus 列舉)。舉例來說，如果 Android 有使用者 (0、10、11)，且從 10 切換至 11 (兩者都沒有任何特殊標記)，要求會是：
  • int32[0] 42 // 請求 ID
  • int32[1] 2 // SwitchUserMessageType::ANDROID_SWITCH
  • int32[2] 11 // 目標使用者 ID
  • int32[3] 0 // 目標使用者標記 (無)
  • int32[4] 10 // 目前的使用者
  • int32[5] 0 // 目前使用者標記 (無)
  • int32[6] 3 // 使用者人數
  • int32[7] 0 // 最初招攬到使用者 (使用者 0)
  • int32[8] 1 // 第一個使用者旗標 (系統)
  • int32[9] 10 // 第二位使用者 (使用者 10)
  • int32[10] 0 // 第二個使用者標記 (無)
  • int32[11] 11 // 第 3 名使用者 (使用者 11)
  • int32[12] 0 // 第 3 個使用者標記 (無)

  如果要求成功，HAL 必須使用以下方式更新屬性：

  • int32[0] 42 // 要求 ID
  • int32[1] 3 // messageType：SwitchUserMessageType::VEHICLE_Response
  • int32[2] 1 // status: SwitchUserStatus::SUCCESS

  如果要求失敗，回應會類似以下內容：

  • int32[0] 42 // 要求 ID
  • int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
  • int32[2] 2 // status: SwitchUserStatus::FAILURE string: "108-D'OH!"
  • 原始設備製造商 (OEM) 專屬錯誤訊息
• VEHICLE_RESPONSE HAL 呼叫，以表示要求類型是否為 ANDROID_SWITCH 應該繼續或中止。另請參閱 ANDROID_SWITCH。
• VEHICLE_REQUEST 由 HAL 呼叫，要求切換目前的前景 Android 使用者。這項功能在 Android 以某位使用者身分啟動，但車輛將駕駛人識別為其他使用者的情況下非常實用。舉例來說，使用者 A 使用遙控車鑰解鎖汽車 使用者 BINITIAL_USER_INFO 要求傳回使用者 B，但臉部辨識子系統後來將使用者識別為 A。HAL 會透過屬性變更事件發出這項要求 (傳遞排除要求 ID)，Android 系統回應則會發出 ANDROID_POST_SWITCH 呼叫，同一個請求 ID。舉例來說，如果目前的前景 Android 使用者為 10，而 HAL 要求切換至 11，要求會是：
  • int32[0] -108 // 要求 ID
  • int32[1] 4 // messageType: SwitchUserMessageType::VEHICLE_REQUEST
  • int32[2] 11 // Android 使用者 ID

  如果要求成功，且 Android 有三個使用者 (0、10 和 11)，回應會是：

  • int32[0] -108 // 請求 ID
  • int32[1] 5 // messageType：SwitchUserMessageType::ANDROID_POST_SWITCH
  • int32[2] 11 // 目標使用者 ID
  • int32[3] 0 // 目標使用者 ID 標記 (無)
  • int32[4] 11 // 目前使用者
  • int32[5] 0 // 目前使用者標記 (無)
  • int32[6] 3 // 使用者人數
  • int32[7] 0 // 第一位使用者 (使用者 0)
  • int32[8] 0 // 最初使用者標記 (無)
  • int32[9] 10 // 第二位使用者 (使用者 10)
  • int32[10] 4 // 第二個使用者旗標 (無)
  • int32[11] 11 // 第三位使用者 (使用者 11)
  • int32[12] 3 // 第三位使用者標記 (無)

  目前和目標使用者 ID 相同。如果要求失敗，則兩者會有所不同。 舉例來說，目標使用者為 11，而目前的使用者為 10。

• ANDROID_POST_SWITCH 在提出切換使用者的要求後，Android 系統會呼叫此方法。 在任何類型的切換要求之後 (例如，>code>LEGACY_ANDROID_SWITCH、 >code>ANDROID_SWITCH 或 VEHICLE_REQUEST)，可用於判斷要求是否成功， 失敗。
  • 成功呼叫後，系統會在 Android 使用者處於解鎖狀態時呼叫呼叫器， 回應中目前與使用者 ID 的值相同。這是 相當於在 Android 應用程式中接收 Intent.ACTION_USER_UNLOCKED。
  • 失敗時，系統會立即呼叫此方法，且回應中目前和目標使用者 ID 的值會不同 (因為目前使用者並未變更為目標)。
  • 如果在 HAL 回應先前的切換要求或使用者解鎖之前，就提出新的切換要求，則不會提出 ANDROID_POST_SWITCH 要求。舉例來說，駕駛可能會不小心切換到有鎖定憑證的錯誤使用者，然後在輸入憑證前切換回正確的使用者。

  HAL 可以在收到這項要求後更新內部狀態，但不需要 回覆 Android 系統

  • 。INITIAL_USER_INFO 定義的前 N 個值 (索引 1 的特定要求值為 SwitchUserMessageType::ANDROID_POST_SWITCH)，接著是目標使用者 ID 的另外兩個值 (例如要求切換到的 Android 使用者 ID) 和標記 (由 UserFlags 定義)。
  • 回覆：無。如需範例，請參閱 VEHICLE_REQUEST

變更模式：ON_CHANGE
存取模式：READ_WRITE
列舉類型：N/A
單位類型：N/A
版本：Android 13

TIRE_PRESSURE

胎壓。每個輪胎都會透過 areaConfig.areaId 設定進行辨識。分別使用 minFloatValue 和 maxFloatValue 儲存 OEM 建議的壓力範圍。minFloatValue 和 maxFloatValue 在 VehicleAreaConfig 中，您必須定義。

areaConfig 資料中的 minFloatValue 代表建議輪胎壓力下限。regionConfig 資料中的 maxFloatValue 代表 建議輪胎舉例來說，這個 areaConfig 會指出左前輪的建議胎壓為 200.0kPa 到 240.0kPa。

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

變更模式：CONTINUOUS
存取模式：READ
列舉類型：不適用
單位類型：VehicleUnit:KILOPASCAL
版本：Android 13

TIRE_PRESSURE_DISPLAY_UNITS

顯示的胎壓單位。指出車輛會使用哪種單位向使用者顯示輪胎氣壓。例如 PSI、Bar 或 Kilopascal。VehiclePropConfig.configArray 用於指出支援的壓力顯示單位。車用運算單位中定義了壓力單位。 例如 configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR

如果更新 TIRE_PRESSURE_DISPLAY_UNITS 會影響其他 *_DISPLAY_UNITS 屬性的值， 這些值也必須更新並提供給 AAOS 架構。 這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商可以將其實作為 <covehiclepropertyaccess.read< code=""> only./p> </covehiclepropertyaccess.read<>

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：VehicleUnit
單位類型：不適用
版本：Android 13

TRACTION_CONTROL_ACTIVE

啟用追蹤控制項 (TC) 時，設為 true；如果 TC 停用，則設為 false。這個 屬性可以依據資訊公開和同意聲明系統的即時狀態，間歇性設定 (脈衝)。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

TRAILER_PRESENT

傳回車輛的拖車狀態。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：TrailerState
單位類型：N/A
版本：Android 13

TURN_SIGNAL_STATE

車輛轉彎狀態。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：VehicleTurnSignal
單位類型：N/A
版本：Android 13

USER_IDENTIFICATION_ASSOCIATION

用於將目前使用者與車輛專屬識別機制 (例如車鑰 FOB) 建立關聯 (或查詢關聯) 的屬性。

這是選用的使用者管理屬性。原始設備製造商 (OEM) 仍可支援使用者管理作業，前提是不需要 定義模型事實上，這項屬性可用來排除與核心使用者相關的功能 函式，如 INITIAL_USER_INFO 所述。

為了查詢關聯，Android 系統會取得屬性，並傳遞 VehiclePropValue 包含查詢的關聯類型，如 UserIdentificationGetRequest。HAL 必須立即傳回，傳回含有 UserIdentificationResponse。

請注意，使用者識別是在系統啟動時發生。takehe VHAL 實作應只傳回已識別的關聯 (例如用於解鎖車輛的鑰匙 FOB)，而非透過 get 呼叫啟動新的關聯。

為關聯類型設定屬性時，Android 系統會傳遞 VehiclePropValue，其中包含 UserIdentificationSetRequest 定義的關聯類型和值。

接著，HAL 會使用屬性變更事件 (其 VehiclePropValue 由 UserIdentificationResponse 定義)，指出要求後的類型目前狀態。

例如，如要查詢目前的使用者 (10) 是否與解鎖車輛的 FOB 相關聯 以及原始設備製造商 (OEM) 提供的自訂機制，則要求為：

• int32[0] 42 // 要求 ID
• int32[1] 10 (Android 使用者 ID)
• int32[2] 0 (Android 使用者旗標)
• int32[3] 2 (查詢的類型數量)
• int32[4] 1 (第一個查詢類型，UserIdentificationAssociationType::KEY_FOB)
• int32[5] 101 (第二類型查詢，UserIdentificationAssociationType::CUSTOM_1)

如果使用者已與 FOB 建立關聯，但未與自訂機制建立關聯，則回應如下：

• int32[0] 42 // 要求 ID
• int32[1] 2 (回應中的關聯數量)
• int32[2] 1 (第一個類型：UserIdentificationAssociationType::KEY_FOB)
• int32[3] 2 (第一個值：UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
• int32[4] 101 (第一個類型：UserIdentificationAssociationType::CUSTOM_1)
• int32[5] 4 (第二個值：UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)

然後，為了使用者與自訂機制建立關聯，系統會發出一組要求：

• int32[0] 43 // 要求 ID
• int32[1] 10 (Android 使用者 ID)
• int32[2] 0 (Android 使用者旗標)
• int32[3] 1 (正在設定的關聯數量)
• int32[4] 101 (第一個類型：UserIdentificationAssociationType::CUSTOM_1)

如果要求成功，回應會如下所示：

• int32[0] 43 // 要求 ID
• int32[1] 1 (回應中的關聯項目數量)
• int32[2] 101 (第一個類型：UserIdentificationAssociationType::CUSTOM_1)
• int32[3] 1 (第一個值：UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)

設定要求不會新增關聯，但不會移除現有關聯。在前一個 例如，結束狀態會是兩個關聯 (FOB 和 CUSTOM_1)。建立使用者與使用者的關聯 就是 CUSTOM_1，而不是 FOB，那麼要求就會是：

• int32[0] 43 // 要求 ID
• int32[1] 10 (Android 使用者 ID)
• int32[2] 2 (設定的類型數量)
• int32[3] 1 (第一個類型：UserIdentificationAssociationType::KEY_FOB)
• int32[4] 2 (第一個值：UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)
• int32[5] 101 (第二種類型：UserIdentificationAssociationType::CUSTOM_1)
• int32[6] 1 (第二個值：UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)

變更模式：ON_CHANGE
存取模式：READ_WRITE
列舉類型：不適用
單位類型：不適用
版本：Android 13

VEHICLE_CURB_WEIGHT

傳回車輛的空車重量 (以公斤為單位)。空車重量是指車輛的總重量，包括標準配備和所有必要的耗材，例如機油、變速箱油、煞車油、冷卻液、空調冷媒，以及在沒有乘客或貨物時，油箱的額定容量重量。

configArray[0] 用於以公斤為單位指定車輛的總重量。車輛總價 重量是製造商指定的最大車輛總重量 包括車輛底座、身體、引擎、引擎液體、燃料、配件、驅動程式 乘客和貨物，但不包含任何拖車。

變更模式：STATIC
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:KILOGRAM
版本：Android 13

VEHICLE_IN_USE

指出車輛是否正在使用中。使用中是指有人在場並打算使用車輛。但這不代表人類使用者就在車上。舉例來說， 人類使用者從遠端解鎖車輛，系統會認定該車輛處於使用中狀態。如果此屬性 支援：

• 每當使用者開啟車輛或系統偵測到使用者在場時，VEHICLE_IN_USE 都必須設為 true。每當使用者關閉車輛或系統偵測到使用者不在車上時，VEHICLE_IN_USE 都必須設為 false。
• 如果使用者關閉車輛，或系統偵測到使用者不在車上，VEHICLE_IN_USE 就必須設為 false。
• 如果使用者車輛上電源，或是系統偵測到使用者身邊， VEHICLE_IN_USE 必須設為 true。

這項屬性與 AP_POWER_BOOTUP_REASON 的差異在於，AP_POWER_BOOTUP_REASON 只會在系統啟動期間設定一次。不過，這個屬性可能會在系統開機週期中多次變更。舉例來說，假設裝置目前未 。執行遠端工作的系統開機。VEHICLE_IN_USE 為 false。在遠端工作執行時，使用者進入車輛並開啟車輛。VEHICLE_IN_USE 設為 true。駕駛課程結束後，使用者將車輛關機 VEHICLE_IN_USE 設為 false。

這項屬性已定義為 VehiclePropertyAccess.READ_WRITE，但原始設備製造商 (OEM) 可以 請僅以 VehiclePropertyAccess.READ 的形式實作。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 14

VEHICLE_MAP_服務

車輛地圖服務 (VMS) 訊息。這項屬性會使用混合資料傳送 VMS 訊息。這裡可以按照以下方式解讀內容。VmsMessageIntegerValuesInde 中定義的索引 用於從 int32Values 讀取。是 VMS 中定義的序列化 VMS 訊息 但對架構而言不透明IVehicle#get 一律必須返回 StatusCode::NOT_AVAILABLE。

變更模式：ON_CHANGEREAD_WRITE
存取模式：READ_WRITE
列舉類型：N/A
單位類型：N/A
版本：Android 13

VEHICLE_SPEED_DISPLAY_UNITS

用於螢幕的速度單位。指出用來向使用者顯示速度的單位類型。例如，m/s、 km/h 或 mph。VehiclePropConfig.configArray 表示支援的速度 多媒體廣告單元車用運算單位中定義了壓力單位。例如：

.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 應每隔三秒就將系統正常運作時間寫入這項屬性。Car Watchdog 會訂閱這個屬性，並檢查該屬性是否每三秒更新一次。在緩衝時間為三秒的情況下，車輛監控計時器會等待活動訊號，從上次活動訊號傳送後的六秒內傳送。如果不是，Car Watchdog 會將 VHAL 視為不健康，並終止該服務。如果 VHAL 不支援這個屬性，車輛監控計時器就無法 檢查 VHAL 健康狀態

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

WATCHDOG_ALIVE

定義一項事件，讓車輛監控計時器更新以表示活動處於啟用狀態。由車輛監控計時器設定 每三秒以毫秒為單位執行系統運作時間啟動期間，更新作業可能會 需要較長的時間才能完成

變更模式：ON_CHANGE
存取模式：WRITE
列舉類型：N/A
單位類型：N/A
版本：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

回報輪狀圖記號。向量中的第一個元素是重設計數。重設表示先前的計時次數無法與此和日後的計時次數相比較。發生某種不連續的計時情況。

接下來的四個元素代表個別輪子的刻度，依序為：

1. 前置左聲道
2. 前置右聲道
3. 右側後座
4. 左後方

所有的滴答數都會累積。車輛往前移動時，累計計數會隨之增加， 減少的時間。車輛啟動時，應將刻度歸零。

• 重設次數：int64Values[0]
• int64Values[1] 個左前引號
• int64Values[2]右前方刻度
• int64Values[3] 右後刻度
• int64Values[4]左後方刻度

configArray 用於表示每輪搖桿的微米值，以及 系統支援的 configArray 設定如下：

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

使用列舉 Wheel。例如，如果支援所有輪子，則：

• configArray[0] VehicleAreaWheel::LEFT_FRONT |VehicleAreaWheel：:RIGHT_FRONT |VehicleAreaWheel：:LEFT_REAR |VehicleAreaWheel：:RIGHT_REAR
• configArray[1] 每個前輪刻度點的微米
• configArray[2] 每個前輪刻度點的微米
• configArray[3] 每個後輪刻度點的微米
• configArray[4] 每個後輪刻度點的微米數。

如果不支援輪子，則其值一律應設為 0。

VehiclePropValue.timestamp 必須填入。

變更模式：CONTINUOUS
存取模式：READ
列舉類型：不適用
單位類型：不適用
版本：Android 13

WINDOW_LOCK

窗口子鎖。True 表示視窗已鎖定。這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

WINDOW_MOVE

移動視窗。各自的maxInt32Value和minInt32Value 必須定義 VehicleAreaConfig。minInt32Value 到 之間的所有整數 必須支援 maxInt32Value。maxInt32Value 表示車窗在飛機上開著/閉上最快到飛機外 速度。minInt32Value 表示在 能以最快的速度呈現出飛機的偏離航線

較大的絕對值 (正或負) 表示移動速度較快。產生 視窗達到位置限制，此值必須重設為 0。如果 WINDOW_MOVE 的值為 0，表示沒有任何移動動作。這個屬性以 指定的相對移動速度範圍。

對於可能對外開放的窗口 (天窗的出風模式)，這個參數的運作方式為 後面。如果：

• 天窗已開啟：
  • Max 進一步打開天窗，在完全打開後自動停止。
  • Min 關閉天窗，並在天窗關閉時自動停止。
• Vent 已開啟：
  • Max關閉通風口，通風口關閉後自動停止運轉。
  • Min更遠一點，通風系統完全打開後會自動停止。
• 天窗已關閉：
  • Max 打開天窗，當太陽完全打開時，自動停止。
  • Min開口，在通風口完全打開後自動停止。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：不適用
單位類型：不適用
版本：Android 13

WINDOW_POS

視窗位置。各自的maxInt32Value和minInt32Value 必須定義 VehicleAreaConfig。minInt32Value 到 之間的所有整數 必須支援 maxInt32Value。minInt32Value 表示視窗 或完全公開在飛機上如果視窗無法從飛機上打開 minInt32Value 是在完全關閉時的視窗位置，必須為 0。如果 視窗可能從飛機上開啟，minInt32Value 表示視窗已完全開啟 看起來會超出平面，並且為負值。請參閱下方示例，瞭解更詳細的說明。maxInt32Value 表示視窗已完全開啟。

minInt32Value 和 maxInt32Value 之間的值表示在關閉/完全開啟的平面和完全開啟位置之間的轉換狀態。這個資源不是 ，但落在指定的相對位置範圍。舉例來說，以下是 屬性適用於可以移出機體的視窗：對於可能開啟 飛機 (日照模式的發射模式) 這個參數可以與負值搭配運作，如下所示：

• Max完全開放 (0 代表日照量)。
• Min 天窗通風口完全開啟 (0 代表天窗關閉)。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：N/A
單位類型：N/A
版本：Android 13

WINDSHIELD_WIPERS_PERIOD

擋風玻璃雨刷的週期 (毫秒)。傳回擋風玻璃雨刷一整個週期的瞬間時間長度 (以毫秒為單位)。完整週期是指從 然後回到其餘位置選取間歇性清除設定時，這個屬性 在間歇清除期間，值必須設為 0。必須定義 VehicleAreaConfig 中的 maxInt32Value 和 minInt32Value。每個區域 ID 的 maxInt32Value 必須指定最長的清除週期。 每個區域 ID 的 minInt32Value 都必須設為 0。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：N/A
單位類型：VehicleUnit:MILLI_SECS
版本：Android 14

WINDSHIELD_WIPERS_STATE

擋風玻璃清除工具狀態。傳回擋風玻璃雨刷的目前狀態。WINDSHIELD_WIPERS_STATE 的值可能與 WINDSHIELD_WIPERS_SWITCH 的值不符。例如 WINDSHIELD_WIPERS_STATE: ON 和 WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO。如果實作 WINDSHIELD_WIPERS_STATE: ON 和 WINDSHIELD_WIPERS_PERIOD，WINDSHIELD_WIPERS_PERIOD 必須反映雨刷器一整個週期的時間長度。

對於每個支援的區域 ID，除非支援 WindshieldWipersState 中的所有狀態 (包括不建議使用的 OTHER)，否則必須定義 VehicleAreaConfig#supportedEnumValues 陣列。

變更模式：ON_CHANGE
存取模式：READ
列舉類型：WindshieldWipersState
單位類型：N/A
版本：Android 14

WINDSHIELD_WIPERS_SWITCH

擋風玻璃雨刷開關。此屬性代表控制擋風盾的開關的位置 使用者。WINDSHIELD_WIPERS_SWITCH 的值可能與 WINDSHIELD_WIPERS_STATE，例如 WINDSHIELD_WIPERS_SWITCH: AUTO 和 WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON針對每個支援的區域 ID， 必須定義 VehicleAreaConfig#supportedEnumValues 陣列，除非 支援 WindshieldWipersSwitch (包括 OTHER，但不建議)。

這個屬性定義為 VehiclePropertyAccess.READ_WRITE，但 OEM 只能將其實作為 VehiclePropertyAccess.READ。如果這個屬性是以 VehiclePropertyAccess.READ_WRITE 實作，且 OTHER 狀態列於 VehicleAreaConfig#supportedEnumValues 陣列中，則 OTHER 並非寫入時支援的值，僅支援讀取時使用。

變更模式：ON_CHANGE
存取模式：READ_WRITE/READ
列舉類型：WindshieldWipersSwitch
單位類型：不適用
版本：Android 14