Trang này liệt kê các thuộc tính hệ thống được hỗ trợ trong VHAL. Các thuộc tính mà VHAL hỗ trợ phải là thuộc tính hệ thống trong danh sách bên dưới hoặc thuộc tính của nhà cung cấp. Trong Android 14 trở lên, các định nghĩa thuộc tính được xác định tại hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl
.
Định nghĩa thuộc tính được xác định trong giao diện AIDL, android.hardware.automotive.vehicle.property
, tách biệt với giao diện VHAL (android.hardware.automotive.vehicle
). Các hoạt động triển khai VHAL và ứng dụng VHAL phải phụ thuộc vào cả hai giao diện.
Chế độ truy cập và chế độ thay đổi được tạo tự động
Trong Android 14 trở lên, để hỗ trợ việc triển khai VHAL, chúng tôi cung cấp các tệp tiêu đề C++ và các tệp lớp Java được tạo tự động với chế độ thay đổi hoặc chế độ truy cập được cho phép cho các thuộc tính hệ thống. Các hoạt động triển khai VHAL của nhà cung cấp có thể sử dụng các thuộc tính này để đảm bảo cấu hình thuộc tính đáp ứng thông số kỹ thuật.
A đến D
ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE
Khoảng cách được đo từ xe dẫn đầu khi sử dụng tính năng Kiểm soát hành trình thích ứng (ACC) hoặc Kiểm soát hành trình dự đoán (PCC). Trả về khoảng cách được đo bằng milimét giữa điểm cuối cùng của xe dẫn đầu và điểm đầu tiên của xe ACC. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig
. minInt32Value
phải là 0. maxInt32Value
phải được điền bằng phạm vi tối đa mà cảm biến khoảng cách có thể hỗ trợ. Giá trị này phải là số không âm.
Khi không phát hiện thấy xe dẫn đầu (tức là khi không có xe dẫn đầu hoặc xe dẫn đầu quá xa để cảm biến phát hiện), thuộc tính này sẽ trả về StatusCode.NOT_AVAILABLE
Khi thuộc tính này không có sẵn do CC bị tắt (ví dụ: StatusCode#NOT_AVAILABLE_DISABLED
là sai), thuộc tính này phải trả về StatusCode#NOT_AVAILABLE_DISABLED
. Nếu CRUISE_CONTROL_STATE
được triển khai và trạng thái được đặt thành giá trị ErrorState
, thì thuộc tính này phải trả về một StatusCode
phù hợp với giá trị ErrorState
. Ví dụ: nếu bạn đặt CRUISE_CONTROL_STATE
thành ErrorState#NOT_AVAILABLE_SPEED_LOW
, thì thuộc tính này phải trả về StatusCode#NOT_AVAILABLE_SPEED_LOW
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: VehicleUnit:MILLIMETER
Bản phát hành: Android 14
ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP
Khoảng thời gian mục tiêu hiện tại cho ACC hoặc PCC tính bằng mili giây. Thuộc tính này phải chỉ định khoảng thời gian mục tiêu so với xe dẫn đầu. Khoảng cách này được xác định là thời gian để đi quãng đường giữa điểm cuối cùng ở phía sau của xe dẫn đầu đến điểm đầu tiên ở phía trước của xe ACC. Khoảng thời gian thực tế so với xe dẫn đầu có thể cao hơn hoặc thấp hơn giá trị này.
Các giá trị có thể đặt cho khoảng thời gian mục tiêu phải được chỉ định trong configArray theo thứ tự tăng dần. Tất cả các giá trị đều phải là số dương. Nếu thuộc tính có thể ghi, thì tất cả các giá trị đều phải có thể ghi. Khi thuộc tính này không có sẵn do CC bị tắt (ví dụ: CRUISE_CONTROL_ENABLED
là false), thuộc tính này phải trả về StatusCode#NOT_AVAILABLE_DISABLED
Nếu CRUISE_CONTROL_STATE
được triển khai và trạng thái được đặt thành giá trị ErrorState
, thì thuộc tính này phải trả về một StatusCode
phù hợp với giá trị ErrorState
. Ví dụ: nếu CRUISE_CONTROL_STATE
được đặt thành ErrorState#NOT_AVAILABLE_SPEED_LOW
, thì thuộc tính này phải trả về StatusCode#NOT_AVAILABLE_SPEED_LOW
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: VehicleUnit:MILLI_SECS
Bản phát hành: Android 14
ABS_ACTIVE
Hệ thống chống bó cứng phanh (ABS) đang hoạt động. Đặt thành true khi ABS đang hoạt động và đặt lại thành false khi ABS tắt. Bạn có thể đặt thuộc tính này theo từng khoảng thời gian (điều chế xung) dựa trên trạng thái theo thời gian thực của hệ thống ABS.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
ANDROID_EPOCH_TIME
Ngày và giờ hiện tại, được mã hoá dưới dạng Thời gian bắt đầu của hệ thống (tính bằng mili giây). Giá trị này biểu thị số mili giây đã trôi qua kể từ ngày 1 tháng 1 năm 1970 (theo giờ UTC).
Giá trị này biểu thị số mili giây đã trôi qua kể từ ngày 1 tháng 1 năm 1970 (theo giờ UTC).
CarServices WRITE
đến giá trị này để cung cấp cho VHAL thời gian của hệ thống Android, nếu VHAL hỗ trợ thuộc tính này. Điều này có thể hữu ích để đồng bộ hoá các hệ thống khác của xe (đồng hồ trên bảng điều khiển) với thời gian của Android.
AAOS WRITE
đến thuộc tính này một lần trong quá trình khởi động và sau đó WRITE
chỉ khi các thay đổi về nguồn thời gian được truyền. AAOS sẽ điền chính xác VehiclePropValue.timestamp. AAOS không gửi thông tin cập nhật cho thời gian trôi qua tự nhiên. int64Values[0] = thời gian Unix đã cung cấp (tính bằng mili giây).
Thuộc tính này có thể mất hơn 0 mili giây để được truyền qua ngăn xếp và việc có một thuộc tính được gắn dấu thời gian sẽ giúp giảm mọi độ trễ về thời gian. Vì vậy, đối với tất cả WRITE
đến thuộc tính, bạn có thể sử dụng dấu thời gian để loại bỏ sự chênh lệch này:
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: Không áp dụng
Loại đơn vị: VehicleUnit:MILLI_SECS
Bản phát hành: Android 13
AP_POWER_BOOTUP_REASON
Thuộc tính để báo cáo lý do khởi động cho trạng thái bật nguồn hiện tại. Đây là thuộc tính STATIC
sẽ không thay đổi trong toàn bộ thời lượng cho đến khi tắt nguồn. Ví dụ: ngay cả khi người dùng nhấn nút nguồn sau khi tự động bật nguồn bằng tính năng mở khoá cửa, lý do khởi động phải vẫn là VehicleApPowerBootupReason#USER_UNLOCK
int32Values[0]
phải là VehicleApPowerBootupReason
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
AP_POWER_STATE_REPORT
Thuộc tính để báo cáo trạng thái nguồn của bộ xử lý ứng dụng. Giả sử trạng thái nguồn của AP được điều khiển bằng bộ điều khiển nguồn riêng biệt.
int32Values[0]
Giá trị enum VehicleApPowerStateReportint32Values[1]
Thời gian tính bằng mili giây để đánh thức, nếu cần (nếu không thì là 0)
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
AP_POWER_STATE_REQ
Thuộc tính để kiểm soát trạng thái nguồn của bộ xử lý ứng dụng. Giả sử trạng thái nguồn của AP được điều khiển bởi một bộ điều khiển nguồn riêng biệt. Đối với thông tin cấu hình, VehiclePropConfig.configArray
phải có giá trị kết hợp cờ bit trong VehicleApPowerStateConfigFlag
int32Values[0]
Giá trị enum VehicleApPowerStateReqint32Values[1]
Một thông số bổ sung liên quan đến từng trạng thái, 0 nếu không được sử dụng.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
AUTOMATIC_EMERGENCY_BRAKING_ENABLED
Bật hoặc tắt tính năng Phanh tự động trong trường hợp khẩn cấp (AEB).
Đặt thành true để bật AEB và false để tắt AEB. Khi bật AEB, bạn phải bật và theo dõi hệ thống ADAS trong xe để tránh các va chạm tiềm ẩn. Thuộc tính này chỉ nên áp dụng cho các ứng dụng có tốc độ cao hơn. Để bật tính năng phanh khẩn cấp tự động ở tốc độ thấp, bạn nên sử dụng LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED
.
Nhìn chung, AUTOMATIC_EMERGENCY_BRAKING_ENABLED
phải luôn trả về true hoặc false.
Nếu tính năng này không hoạt động do một số trạng thái tạm thời, chẳng hạn như tốc độ xe quá thấp, thì thông tin đó phải được truyền qua các giá trị ErrorState
trong thuộc tính AUTOMATIC_EMERGENCY_BRAKING_STATE
.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng OEM chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
AUTOMATIC_EMERGENCY_BRAKING_STATE
Trạng thái của tính năng Phanh tự động trong trường hợp khẩn cấp (AEB). Trả về trạng thái hiện tại của AEB. Thuộc tính này phải luôn trả về một trạng thái hợp lệ được xác định trong AutomaticEmergencyBrakingState hoặc ErrorState
. Thuộc tính này không được hiển thị lỗi thông qua StatusCode
và phải sử dụng các trạng thái lỗi được hỗ trợ. Thuộc tính này chỉ áp dụng cho các ứng dụng có tốc độ cao hơn. Để biểu thị trạng thái của hệ thống phanh khẩn cấp tự động ở tốc độ thấp, bạn nên sử dụng LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE
.
Nếu AEB bao gồm cảnh báo va chạm phía trước trước khi kích hoạt phanh, thì các cảnh báo đó phải xuất hiện thông qua thuộc tính Cảnh báo va chạm phía trước (FCW).
Đối với mã khu vực chung (0), bạn phải xác định mảng StatusCode#VehicleAreaConfig#supportedEnumValues
, trừ phi tất cả các trạng thái của cả AutomaticEmergencyBrakingState
(bao gồm cả OTHER
, không nên dùng) và ErrorState
đều được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enun: ForwardCollisionWarningState/ErrorState
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
BLIND_SPOT_WARNING_ENABLED
Bật và tắt tính năng Cảnh báo điểm mù (BSW). Đặt thành true để bật BSW và false để tắt BSW. Khi BSW được bật, hệ thống ADAS trong xe phải được bật và theo dõi các đối tượng trong điểm mù của xe.
Nhìn chung, BLIND_SPOT_WARNING_ENABLED
phải luôn trả về true hoặc false. Nếu tính năng này không hoạt động do một số trạng thái tạm thời, chẳng hạn như tốc độ xe quá thấp, thì thông tin đó phải được truyền qua các giá trị ErrorState
trong thuộc tính BLIND_SPOT_WARNING_STATE
.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
BLIND_SPOT_WARNING_STATE
Trạng thái của tính năng Cảnh báo điểm mù (BSW). Trả về trạng thái hiện tại của BSW. Thuộc tính này phải luôn trả về một trạng thái hợp lệ được xác định trong BlindSpotWarningState
hoặc ErrorState
. Thuộc tính này không được hiển thị lỗi thông qua StatusCode
và phải sử dụng các trạng thái lỗi được hỗ trợ.
Đối với mỗi mã khu vực được hỗ trợ, bạn phải xác định mảng StatusCode#VehicleAreaConfig#supportedEnumValues
, trừ phi tất cả các trạng thái của cả BlindSpotWarningState
(bao gồm cả OTHER
, không nên dùng) và ErrorState
đều được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: BlindSpotWarningState/ErrorState
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
CABIN_LIGHTS_STATE
Trả về trạng thái của đèn trong khoang.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleLightState
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
CABIN_LIGHTS_SWITCH
Công tắc đèn trong xe. Vị trí của nút chuyển thực tế dùng để điều khiển đèn trong khoang.
Điều này có thể khác với CABIN_LIGHTS_STATE
nếu đèn bật do cửa đang mở hoặc do lệnh thoại. Ví dụ: khi nút chuyển ở vị trí tắt hoặc tự động.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng OEM chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: VehicleLightSwitch
Loại đơn vị: N/A
Bản phát hành: Android 13
CLUSTER_DISPLAY_STATE
Thay đổi trạng thái của màn hình cụm đồng hồ.
- Giới hạn: Khu vực hiển thị Hoạt động cụm.
- Phần lồng ghép: Khu vực mà Hoạt động không được đặt thông tin quan trọng.
Các giá trị có thể:
int32[0]
Bật, Tắt: 0 – tắt, 1 – bật, -1 – không quan tâmint32[1]
Giới hạn – trái: số dương – vị trí trái tính bằng pixel –1 – không quan trọng (nên đặt tất cả các trường Giới hạn)int32[2]
Giới hạn – trên cùng: cùng định dạng với "bên trái"int32[3]
Giới hạn – phải: cùng định dạng với "trái"int32[4]
Giới hạn – dưới cùng: cùng định dạng với "bên trái"int32[5]
Lồng ghép – bên trái: số dương – giá trị lồng ghép thực tế bên trái tính bằng pixel –1 – không quan trọng (nên đặt "không quan trọng" cho tất cả các trường Lồng ghép)int32[6]
Phần lồng ghép – trên cùng: cùng định dạng với "bên trái"int32[7]
Lồng ghép – phải: cùng định dạng với "trái"int32[8]
Phần lồng ghép – dưới cùng: cùng định dạng với "trái"
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
CLUSTER_NAVIGATION_STATE
Thông báo trạng thái điều hướng hiện tại. bytes: thông báo được chuyển đổi tuần tự của NavigationStateProto.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum:
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
CLUSTER_REPORT_STATE
Báo cáo trạng thái hiển thị hiện tại và trạng thái ClusterUI.
ClusterHome
gửi thông báo này khi xử lý CLUSTER_SWITCH_UI
, CLUSTER_DISPLAY_STATE
Ngoài ra, ClusterHome
sẽ gửi thông báo này khi khởi động lần đầu. Khi ClusterOS nhận được thông báo này và nếu
kỳ vọng nội bộ khác với thông báo đã nhận, thì hệ thống sẽ gửi lại
CLUSTER_SWITCH_UI
, CLUSTER_DISPLAY_STATE
để khớp với trạng thái.
- Bật/tắt
int32[0]
: 0 – tắt, 1 – bật int32[1]
Ranh giới – tráiint32[2]
Giới hạn – trên cùngint32[3]
Ranh giới – bên phảiint32[4]
Giới hạn – dưới cùngint32[5]
Phần lồng ghép – tráiint32[6]
Phần lồng ghép – trên cùngint32[7]
Phần lồng ghép – bên phảiint32[8]
Phần lồng ghép – dưới cùngint32[9]
Loại ClusterUI ở chế độ toàn màn hình hoặc màn hình chính. 0 cho biếtClusterHome
. Các giá trị khác được theo sau là định nghĩa của OEM.int32[10]
Loại ClusterUI trong màn hình phụ nếu hiện có hai giao diện người dùng. -1 cho biết khu vực không còn được sử dụng nữa. bytes: mảng đại diện cho tình trạng có sẵn của ClusterUI. 0 cho biết không có và 1 cho biết có. Ví dụ: nếu một ô tô hỗ trợ 3 ClusterUI do OEM xác định như HOME, MAPS và CALL và chỉ hỗ trợ giao diện người dùng CALL khi có mạng di động. Sau đó, nếu có mạng, thiết bị sẽ gửi [1 1 1] và nếu không có mạng, thiết bị sẽ gửi [1 1 0].
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: VehicleLightSwitch
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
CLUSTER_REQUEST_DISPLAY
Yêu cầu thay đổi trạng thái hiển thị cụm để hiển thị một số ClusterUI. Khi trạng thái màn hình hiện tại tắt và ClusterHome
gửi thông báo này đến ClusterOS để yêu cầu bật màn hình hiển thị một ClusterUI cụ thể. ClusterOS sẽ phản hồi bằng CLUSTER_DISPLAY_STATE
int32
Loại ClusterUI cần hiển thị
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
CLUSTER_SWITCH_UI
Khởi động ClusterUI trong màn hình cụm đồng hồ.
int32
Loại ClusterUI để hiển thị 0 cho biếtClusterHome
, màn hình Home (Trang chủ) của màn hình cụm đồng hồ, đồng thời cung cấp giao diện người dùng mặc định và một loại chức năng trình chạy cho màn hình cụm đồng hồ. Các giá trị khác là theo định nghĩa của nhà sản xuất thiết bị gốc (OEM).
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
CREATE_USER
Được Hệ thống Android gọi sau khi tạo người dùng Android. HAL có thể sử dụng thuộc tính này để tạo người dùng tương đương. Đây là một yêu cầu không đồng bộ: Android đưa ra yêu cầu bằng cách đặt VehiclePropValue và HAL phải phản hồi bằng một thay đổi thuộc tính cho biết yêu cầu đã thành công hay không. Nếu không thành công, hệ thống Android sẽ xoá người dùng đó.
Định dạng của yêu cầu được xác định bằng CreateUserRequest và định dạng của phản hồi được xác định bằng CreateUserResponse. Ví dụ: nếu hệ thống có hai người dùng (0 và 10) và một người dùng thứ ba (là một khách tạm thời) được tạo, thì yêu cầu sẽ là:
int32[0]
42 // mã yêu cầuint32[1]
11 // Mã nhận dạng Android của người dùng đã tạoint32[2]
6 // Cờ Android (khách tạm thời) của người dùng đã tạoint32[3]
10 // người dùng hiện tạiint32[4]
0 // cờ người dùng hiện tại (không có)int32[5]
3 // số người dùngint32[6]
0 // người dùng đầu tiên (người dùng 0)int32[7]
0 // cờ người dùng đầu tiên (không có)int32[8]
10 // người dùng thứ hai (người dùng 10)int32[9]
0 // cờ người dùng thứ hai (không có)int32[10]
11 // người dùng thứ ba (người dùng 11)int32[11]
6 // chuỗi cờ người dùng thứ ba (khách tạm thời): "ElGuesto" // tên của người dùng mới
Nếu yêu cầu thành công, HAL sẽ trả về:
int32[0]
42 // mã yêu cầuint32[1]
1 // CreateUserStatus::SUCCESS
Nhưng nếu không thành công:
int32[0]
42 // mã yêu cầuint32[1]
2 // Chuỗi CreateUserStatus::FAILURE: "D'OH!" //
Ý nghĩa là hộp đen và được chuyển đến phương thức gọi (chẳng hạn như giao diện người dùng Cài đặt) để thực hiện hành động thích hợp.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
CRITICALLY_LOW_TIRE_PRESSURE
Thuộc tính này cho biết ngưỡng áp suất thấp nghiêm trọng cho mỗi lốp. Chỉ báo này cho biết thời điểm thay thế hoặc sửa chữa lốp. Giá trị này phải nhỏ hơn hoặc bằng minFloatValue trong TIRE_PRESSURE. Giá trị thuộc tính tối thiểu và tối đa (minFloatValue và maxFloatValue) không áp dụng cho thuộc tính này.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: VehicleUnit:KILOPASCAL
Bản phát hành: Android 13
CRUISE_CONTROL_COMMAND
WRITE
Lệnh Điều khiển hành trình (CC).
Hãy xem CruiseControlCommand để biết thông tin chi tiết về từng lệnh được hỗ trợ. Đối với mã khu vực toàn cầu (0), bạn phải xác định mảng StatusCode#VehicleAreaConfig#supportedEnumValues
trừ phi tất cả các trạng thái của CruiseControlState
đều được hỗ trợ. Mọi lệnh không được hỗ trợ được gửi qua thuộc tính này phải trả về StatusCode#INVALID_ARG
. Khi thuộc tính này không hoạt động do CC bị tắt (ví dụ: CRUISE_CONTROL_ENABLED
là sai), thuộc tính này phải trả về StatusCode#NOT_AVAILABLE_DISABLED
. Nếu CRUISE_CONTROL_STATE
được triển khai và trạng thái được đặt thành giá trị ErrorState
, thì thuộc tính này phải trả về một StatusCode
phù hợp với giá trị ErrorState
.
Ví dụ: nếu CRUISE_CONTROL_STATE
được đặt thành ErrorState#NOT_AVAILABLE_SPEED_LOW
, thì thuộc tính này phải trả về StatusCode#NOT_AVAILABLE_SPEED_LOW
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: CruiseControlCommand
Loại đơn vị: N/A
Bản phát hành: Android 14
CRUISE_CONTROL_ENABLED
Bật hoặc tắt tính năng kiểm soát hành trình (CC). Đặt giá trị true để bật CC và false để tắt CC. Tất cả các hình thức của CruiseControlType đều dùng chung thuộc tính này. Khi CC được bật, hệ thống ADAS trong xe phải được bật và phản hồi các lệnh. Nhìn chung, CRUISE_CONTROL_ENABLED
phải luôn trả về giá trị true hoặc false. Nếu tính năng này không hoạt động do một số trạng thái tạm thời, chẳng hạn như tốc độ xe quá thấp, thì thông tin đó phải được truyền qua các giá trị ErrorState
trong thuộc tính CRUISE_CONTROL_STATE
. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
CRUISE_CONTROL_STATE
Trạng thái hiện tại của tính năng Điều khiển hành trình (CC). Thuộc tính này trả về trạng thái hiện tại của CC. Nhìn chung, thuộc tính này sẽ trả về một trạng thái hợp lệ được xác định trong CruiseControlState hoặc ErrorState
. Ví dụ: nếu không có tính năng này do một số trạng thái tạm thời, thì thông tin đó phải được truyền qua ErrorState
. Đối với mã khu vực toàn cầu (0), bạn phải xác định mảng VehicleAreaConfig#supportedEnumValue
trừ phi tất cả các trạng thái của CruiseControlState (bao gồm cả OTHER, không được đề xuất) và ErrorState
được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: CruiseControlState/ErrorState
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
CRUISE_CONTROL_TARGET_SPEED
Tốc độ mục tiêu hiện tại cho tính năng Kiểm soát hành trình (CC). Nhà sản xuất thiết bị gốc (OEM) nên đặt giá trị minFloatValue và maxFloatValue cho thuộc tính này để xác định giá trị tốc độ mục tiêu tối thiểu và tối đa. Các giá trị này phải là số không âm. maxFloatValue thể hiện giới hạn trên của tốc độ mục tiêu.
minFloatValue thể hiện giới hạn dưới của tốc độ mục tiêu.
Khi thuộc tính này không có sẵn do CC bị tắt (ví dụ: CRUISE_CONTROL_ENABLED
là sai), thuộc tính này phải trả về StatusCode#NOT_AVAILABLE_DISABLED
. Nếu CRUISE_CONTROL_STATE
được triển khai và trạng thái được đặt thành giá trị ErrorState, thì thuộc tính này phải trả về StatusCode
phù hợp với giá trị ErrorState. Ví dụ: nếu bạn đặt CRUISE_CONTROL_STATE
thành ErrorState#NOT_AVAILABLE_SPEED_LOW
, thì thuộc tính này phải trả về StatusCode#NOT_AVAILABLE_SPEED_LOW
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: VehicleUnit:METER_PER_SEC
Bản phát hành: Android 14
CRUISE_CONTROL_TYPE
Loại hiện tại của Cruise Control (CC). Khi CRUISE_CONTROL_ENABLED
là true, thuộc tính này sẽ trả về loại CC hiện đang được bật (ví dụ: CC chuẩn và CC thích ứng, dự đoán).
Nhìn chung, thuộc tính này sẽ trả về một trạng thái hợp lệ được xác định trong CruiseControlType
hoặc ErrorState
. Ví dụ: nếu tính năng không hoạt động do một số trạng thái tạm thời, thì thông tin đó phải được truyền qua ErrorState
. Đối với mã khu vực toàn cầu (0), bạn phải xác định mảng StatusCode#VehicleAreaConfig#supportedEnumValues
, trừ phi tất cả các trạng thái của CruiseControlType
(bao gồm cả OTHER
không được đề xuất) và ErrorState
đều được hỗ trợ. Việc cố gắng WRITE
CruiseControlType#OTHER
hoặc ErrorState
vào thuộc tính này sẽ gửi một IllegalArgumentException
. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng OEM chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: CruiseControlType
ErrorState
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
CURRENT_GEAR
Băng truyền hiện tại. Trong trường hợp không phải chế độ thủ công, bánh răng đã chọn có thể không khớp với bánh răng hiện tại. Ví dụ: nếu bánh răng được chọn là GEAR_DRIVE
, thì bánh răng hiện tại sẽ là một trong các bánh răng GEAR_1
, GEAR_2
, v.v., phản ánh bánh răng thực tế mà hộp số đang chạy. Các giá trị trong dữ liệu cấu hình phải thể hiện danh sách các bánh răng được hỗ trợ cho xe này. Ví dụ: dữ liệu cấu hình cho hộp số tự động phải chứa {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_1, GEAR_2,...}
và đối với hộp số thủ công, danh sách phải là {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
. Danh sách này không cần giống với danh sách các bánh răng được hỗ trợ được báo cáo trong GEAR_SELECTION
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleGear
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
CURRENT_POWER_POLICY
Thông báo chính sách nguồn hiện tại cho lớp VHAL. Dịch vụ chính sách sử dụng điện của ô tô sẽ đặt thuộc tính này khi chính sách sử dụng điện hiện tại thay đổi
string: "sample_policy_id" // power policy ID
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
DISABLED_OPTIONAL_FEATURES
Cho phép tắt các tính năng không bắt buộc trong VHAL. Thuộc tính này báo cáo các tính năng không bắt buộc mà bạn nên tắt. Tất cả tính năng không bắt buộc được phép cho hệ thống đều được khai báo trong lớp phủ Dịch vụ ô tô, config_allowed_optional_car_features
. Thuộc tính này cho phép tắt các tính năng được xác định trong lớp phủ. Nếu không có thuộc tính này, tất cả các tính năng được khai báo trong lớp phủ sẽ được bật.
Giá trị READ
phải bao gồm tất cả các tính năng bị tắt bằng dấu phẩy (,
) phân tách.
Ví dụ: com.android.car.user.CarUserNoticeService,storage_monitoring
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
DISPLAY_BRIGHTNESS
Thuộc tính đại diện cho độ sáng của màn hình. Một số ô tô có một chế độ điều khiển duy nhất cho độ sáng của tất cả màn hình. Thuộc tính này dùng để chia sẻ các thay đổi trong chế độ kiểm soát đó. Trong những ô tô có màn hình được kiểm soát độ sáng riêng biệt, chúng phải sử dụng PER_DISPLAY_BRIGHTNESS
. Chỉ nên triển khai một trong hai DISPLAY_BRIGHTNESS
và PER_DISPLAY_BRIGHTNESS
. Nếu có cả hai, AAOS sẽ sử dụng PER_DISPLAY_BRIGHTNESS
. Nếu thuộc tính này có thể ghi, Android có thể đặt giá trị này khi người dùng thay đổi độ sáng màn hình trong phần Cài đặt. Nếu chỉ có READ
, người dùng vẫn có thể thay đổi độ sáng màn hình trong phần Cài đặt, nhưng thay đổi này không được phản ánh trên các màn hình khác.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
DISTANCE_DISPLAY_UNITS
Đơn vị khoảng cách để hiển thị. Cho biết đơn vị mà ô tô đang sử dụng để hiển thị khoảng cách cho người dùng. Ví dụ: Dặm, Mét hoặc Kilômét. Đơn vị khoảng cách được xác định trong VehicleUnit.
VehiclePropConfig.configArray được dùng để chỉ định các đơn vị hiển thị khoảng cách được hỗ trợ.
Ví dụ: configArray[0] = METER configArray[1] = KILOMETER configArray[2] = MILE
Nếu việc cập nhật DISTANCE_DISPLAY_UNITS
ảnh hưởng đến các giá trị của các thuộc tính *_DISPLAY_UNITS
khác, thì bạn cũng phải cập nhật và thông báo các giá trị đó cho khung AAOS.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: VehicleUnit
Loại đơn vị: N/A
Bản phát hành: Android 13
DOOR_CHILD_LOCK_ENABLED
Đã bật tính năng khoá trẻ em cho cửa. Trả về true nếu tính năng khoá trẻ em cho cửa được bật và trả về false nếu tính năng này bị tắt. Nếu bật, bạn sẽ không thể mở cửa từ bên trong. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
DOOR_LOCK
Giá trị true của khoá cửa cho biết cửa đang được khoá. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
DOOR_MOVE
Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
đều phải được hỗ trợ. maxInt32Value
thể hiện tốc độ di chuyển tối đa của cửa khi mở. minInt32Value
thể hiện tốc độ di chuyển tối đa của cửa khi đóng.
Giá trị tuyệt đối lớn hơn, dương hoặc âm, cho biết tốc độ di chuyển nhanh hơn. Khi cửa đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu giá trị của DOOR_MOVE
là 0, thì tức là không có chuyển động nào đang diễn ra.
Thuộc tính này không ở bất kỳ đơn vị cụ thể nào mà ở một phạm vi tốc độ chuyển động tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
DOOR_POS
Vị trí cửa. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig
.
Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết cửa đã đóng. minInt32Value
phải là 0.
maxInt32Value
cho biết cửa đã mở hoàn toàn. Các giá trị từ minInt32Value
đến maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí đóng và vị trí mở hoàn toàn.
Thuộc tính này không nằm trong bất kỳ đơn vị cụ thể nào mà nằm trong một phạm vi vị trí tương đối được chỉ định.
Một số xe (xe đa dụng) có thể mở cửa bằng điện. Do đó, bạn có thể WRITE
thuộc tính này. Thuộc tính này được xác định là VehiclePropertyAccess
READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
E đến G
ELECTRONIC_TOLL_COLLECTION_CARD_STATUS
Trạng thái thẻ thu phí điện tử. Thuộc tính này cho biết trạng thái của thẻ ETC trong xe này. Nếu đầu phát trung tâm nhận biết được thẻ ETC gắn trên xe, thì ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
sẽ cho biết trạng thái của thẻ đó. Nếu không, thuộc tính này phải là UNAVAILABLE
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: ElectronicTollCollectionCardStatus
Loại đơn vị: N/A
Bản phát hành: Android 13
ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
Loại thẻ thu phí điện tử (ETC). Thuộc tính này cho biết loại thẻ ETC trong xe này. Nếu đầu phát trung tâm nhận biết được thẻ ETC được gắn vào xe, thì thuộc tính này sẽ trả về loại thẻ được gắn; nếu không, thuộc tính này sẽ là UNAVAILABLE
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: ElectronicTollCollectionCardType
Loại đơn vị: N/A
Bản phát hành: Android 13
EMERGENCY_LANE_KEEP_ASSIST_ENABLED
Bật hoặc tắt tính năng Hỗ trợ giữ làn đường khẩn cấp (ELKA). Đặt thành true để bật ELKA và false để tắt ELKA. Khi ELKA được bật, hệ thống ADAS trong xe phải bật và theo dõi các trường hợp người lái xe chuyển làn không an toàn. Khi phát hiện thấy một thao tác không an toàn, ELKA sẽ cảnh báo người lái xe và áp dụng các biện pháp điều chỉnh tay lái để giữ cho xe ở làn đường ban đầu.
Nhìn chung, EMERGENCY_LANE_KEEP_ASSIST_ENABLED
phải luôn trả về true hoặc false.
Nếu tính năng này không hoạt động do một số trạng thái tạm thời, chẳng hạn như tốc độ xe quá thấp, thì thông tin đó phải được truyền qua các giá trị ErrorState
trong thuộc tính EMERGENCY_LANE_KEEP_ASSIST_STATE
. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
EMERGENCY_LANE_KEEP_ASSIST_STATE
Trạng thái của tính năng Hỗ trợ duy trì làn đường trong trường hợp khẩn cấp (ELKA). Trả về trạng thái hiện tại của ELKA. Nhìn chung, thuộc tính này sẽ trả về một trạng thái hợp lệ được xác định trong EmergencyLaneKeepAssistState
hoặc ErrorState
. Ví dụ: nếu tính năng không hoạt động do một số trạng thái tạm thời, thì thông tin đó phải được truyền qua ErrorState
. Đối với mã khu vực toàn cầu (0), bạn phải xác định mảng VehicleAreaConfig#supportedEnumValues
trừ phi tất cả trạng thái của EmergencyLaneKeepAssistState
(bao gồm cả OTHER, không nên dùng) và ErrorState
đều được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: EmergencyLaneKeepAssistState/ErrorState
Loại đơn vị: N/A
Bản phát hành: Android 14
ENGINE_COOLANT_TEMP
Nhiệt độ của chất làm mát động cơ.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:CELSIUS
Bản phát hành: Android 13
ENGINE_IDLE_AUTO_STOP_ENABLED
Biểu thị tính năng tự động dừng động cơ ở chế độ không tải. Nếu đúng, xe có thể tự động tắt động cơ khi không cần thiết và sau đó tự động khởi động lại khi cần.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
ENGINE_OIL_LEVEL
Mức dầu động cơ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleOilLevel
Loại đơn vị: N/A
Bản phát hành: Android 13
ENGINE_OIL_TEMP
Nhiệt độ của dầu động cơ.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:CELSIUS
Bản phát hành: Android 13
ENGINE_RPM
Số vòng quay động cơ mỗi phút (RPM).
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:RPM
Bản phát hành: Android 13
ENV_OUTSIDE_TEMPERATURE
Nhiệt độ bên ngoài. Thuộc tính này phải thông báo kết quả đo nhiệt độ của môi trường bên ngoài xe. Nếu có nhiều cảm biến để đo nhiệt độ bên ngoài, thì bạn nên điền giá trị trung bình hoặc trung bình trọng số có ý nghĩa của các lần đọc thể hiện tốt nhất nhiệt độ của môi trường bên ngoài vào thuộc tính này.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:CELSIUS
Bản phát hành: Android 13
EV_BATTERY_DISPLAY_UNITS
Đơn vị pin xe điện để hiển thị. Cho biết đơn vị mà ô tô đang sử dụng để hiển thị thông tin về pin xe điện cho người dùng. Ví dụ: watt giờ (Wh), kilowatt giờ (kWh) hoặc ampe giờ (Ah).
VehiclePropConfig.configArray
được dùng để cho biết năng lượng điện được hỗ trợ.
đơn vị. Các đơn vị năng lượng điện được xác định trong VehicleUnit
Ví dụ:
configArray[0] = WATT_HOUR configArray[1] = AMPERE_HOURS configArray[2] = KILOWATT_HOUR
Nếu việc cập nhật EV_BATTERY_DISPLAY_UNITS
ảnh hưởng đến các giá trị của các thuộc tính *_DISPLAY_UNITS
khác, thì bạn cũng phải cập nhật và thông báo các giá trị đó cho khung AAOS.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: VehicleUnit
Loại đơn vị: N/A
Bản phát hành: Android 13
EV_BATTERY_INSTANTANEOUS_CHARGE_RATE
Tốc độ sạc tức thời của xe điện tính bằng miliwatt. Giá trị dương cho biết pin đang sạc. Giá trị âm cho biết pin đang được xả.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:MW
Bản phát hành: Android 13
EV_BATTERY_LEVEL
Trả về mức pin hiện tại, cho dù là xe điện hay xe lai. Giá trị này sẽ không vượt quá EV_CURRENT_BATTERY_CAPACITY
. Để tính phần trăm pin, hãy sử dụng (EV_BATTERY_LEVEL
, EV_CURRENT_BATTERY_CAPACITY
)*100.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:WH
Bản phát hành: Android 13
EV_BRAKE_REGENERATION_LEVEL
Mức phanh tái sinh của xe điện. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig. Tất cả giá trị từ minInt32Value
đến maxInt32Value
đều phải được hỗ trợ. minInt32Value
phải là 0. maxInt32Value
cho biết chế độ cài đặt lượng năng lượng tối đa được tái sinh từ quá trình phanh. minInt32Value
cho biết chế độ cài đặt không phanh tái sinh. Thuộc tính này là một dạng chi tiết hơn của EV_REGENERATIVE_BRAKING_STATE
. Thuộc tính này cho phép người dùng đặt mức độ phanh tái sinh cụ thể hơn nếu các trạng thái trong EvRegenerativeBrakingState
không đủ chi tiết cho nhà sản xuất thiết bị gốc (OEM). Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
EV_CHARGE_CURRENT_DRAW_LIMIT
Cho biết ngưỡng dòng điện tối đa để sạc do người dùng đặt.
EvChargeState::configArray[0]
được dùng để chỉ định mức tiêu thụ dòng điện tối đa mà xe cho phép tính bằng Ampe. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITEREAD
Loại enum: N/A
Loại đơn vị: VehicleUnit:AMPERE
Bản phát hành: Android 13
EV_CHARGE_PERCENT_LIMIT
Cho biết ngưỡng tỷ lệ phần trăm mức sạc tối đa do người dùng đặt. Cho biết ngưỡng tỷ lệ phần trăm phí sạc tối đa do người dùng đặt. Trả về một giá trị float từ 0 đến 100.
configArray được dùng để chỉ định các giá trị hợp lệ. Ví dụ: nếu xe hỗ trợ các giá trị giới hạn phần trăm sạc sau: [20, 40, 60, 80, 100], thì configArray phải là {20, 40, 60, 80, 100}. Nếu configArray trống, thì tất cả giá trị từ 0 đến 100 phải hợp lệ.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE,
, READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
EV_CHARGE_PORT_CONNECTED
Cổng sạc xe điện đã kết nối. Nếu xe có nhiều cổng sạc, thì thuộc tính này phải trả về giá trị
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
EV_CHARGE_PORT_OPEN
Cổng sạc xe điện đang mở. Nếu xe có nhiều cổng sạc, thì thuộc tính này phải trả về giá trị true nếu có bất kỳ cổng sạc nào đang mở. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITEREAD
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
EV_CHARGE_STATE
Trạng thái sạc của ô tô
Trả về trạng thái sạc hiện tại của ô tô.
Nếu xe có tỷ lệ phần trăm sạc mục tiêu khác 100, thì thuộc tính này phải trả về EvChargeState::STATE_FULLY_CHARGED
khi mức pin đã đạt đến mức mục tiêu. Hãy xem EvChargeState::EV_CHARGE_PERCENT_LIMIT
để biết thêm thông tin.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: EvChargeState
Loại đơn vị: N/A
Bản phát hành: Android 13
EV_CHARGE_SWITCH
Bắt đầu hoặc dừng sạc pin xe điện. Chế độ cài đặt mà người dùng muốn. Việc đặt thuộc tính này thành true sẽ bắt đầu sạc pin và false để ngừng sạc. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITEREAD
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
EV_CHARGE_TIME_REMAINING
Thời gian sạc còn lại ước tính tính bằng giây. Trả về 0 nếu xe không sạc.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:SECS
Bản phát hành: Android 13
EV_CURRENT_BATTERY_CAPACITY
Dung lượng pin có thể sử dụng hiện tại của xe điện hoặc xe lai. Trả về giá trị thực tế của dung lượng pin, khi là xe điện hoặc xe lai. Thuộc tính này ghi lại dung lượng pin có thể sử dụng theo thời gian thực, đồng thời tính đến các yếu tố như tuổi thọ pin và độ phụ thuộc vào nhiệt độ. Giá trị này có thể khác với INFO_EV_BATTERY_CAPACITY
vì INFO_EV_BATTERY_CAPACITY
trả về dung lượng pin danh nghĩa từ khi xe còn mới.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:WH
Bản phát hành: Android 14
EV_REGENERATIVE_BRAKING_STATE
Chế độ phanh tái sinh hoặc chế độ lái một chân ga của ô tô. Trả về chế độ cài đặt hiện tại liên kết với chế độ cài đặt phanh tái sinh trong ô tô. Nếu nhà sản xuất thiết bị gốc (OEM) yêu cầu nhiều chế độ cài đặt hơn những chế độ được cung cấp trong EvRegenerativeBrakingState
, thì bạn có thể sử dụng thuộc tính EV_BRAKE_REGENERATION_LEVEL
để cung cấp thêm thông tin chi tiết.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: EvRegenerativeBrakingState
Loại đơn vị: N/A
Bản phát hành: Android 13
EV_STOPPING_MODE
Biểu thị thuộc tính cho chế độ dừng hiện tại của xe. Đối với mã khu vực toàn cầu (0), bạn phải xác định VehicleAreaConfig#supportedEnumValues
trừ phi tất cả các giá trị enum của EvStoppingMode
đều được hỗ trợ. Enum EvStoppingMode
có thể được mở rộng để bao gồm nhiều trạng thái hơn trong tương lai. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể chỉ triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: EvStoppingMode
Loại đơn vị: N/A
Bản phát hành: Android 14
EVS_SERVICE_REQUEST
Bật và yêu cầu dịch vụ EVS. Thuộc tính này cung cấp một cách để kích hoạt các dịch vụ EVS. VHAL nên sử dụng thuộc tính này để yêu cầu Android bắt đầu hoặc dừng dịch vụ EVS.
int32Values[0]
Loại dịch vụ EVS. Giá trị phải là một enum trong EvsServiceType.int32Values[1]
Trạng thái của dịch vụ EVS. Giá trị phải là một trong các enum trong EvsServiceState.
Ví dụ: để bật dịch vụ EVS cho chế độ xem sau, Android có thể đặt giá trị thuộc tính thành:
[EvsServiceType::REAR_VIEW, EvsServiceState::ON]
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
EXTERNAL_CAR_TIME
Đề xuất ngày và giờ hiện tại cho cr, được mã hoá dưới dạng Thời gian bắt đầu của hệ thống (tính bằng mili giây). Giá trị này biểu thị số mili giây đã trôi qua kể từ ngày 1 tháng 1 năm 1970 (theo giờ UTC). Thuộc tính này cho biết có thay đổi trong CarTime thành Android. Nếu thuộc tính này được hỗ trợ, VHAL phải báo cáo CarTime hiện tại chính xác nhất khi thuộc tính này được đọc và phát hành thay đổi đối với thuộc tính này khi giá trị CarTime thay đổi.
Bạn phải phát hành sự kiện thay đổi cho thuộc tính này khi CarTime thay đổi vì bất kỳ lý do nào khác ngoài thời gian tự nhiên đã trôi qua (delta thời gian nhỏ hơn 500 mili giây sẽ không kích hoạt sự kiện thay đổi). Android sẽ đọc và đăng ký thuộc tính này để tìm nạp thời gian từ VHAL. Điều này có thể hữu ích để đồng bộ hoá thời gian của Android với các hệ thống xe khác (đồng hồ trên bảng điều khiển). int64Values[0] = thời gian Epoch được cung cấp (tính bằng mili giây) Bất cứ khi nào nhận được một Giá trị mới cho thuộc tính, AAOS sẽ tạo và gửi ExternalTimeSuggestion đến TimeDetectorService.
Nếu các nguồn khác không có mức độ ưu tiên cao hơn, Android sẽ sử dụng nguồn này để đặt thời gian hệ thống. Để biết thông tin về cách điều chỉnh mức độ ưu tiên của nguồn thời gian và cách xử lý đề xuất thời gian (bao gồm cả cách Android xử lý độ trễ, độ lệch và độ phân giải tối thiểu), hãy xem tài liệu về Dịch vụ phát hiện thời gian.
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
Bạn không nên sử dụng thuộc tính này để truy xuất thời gian từ ECU bằng các giao thức (chẳng hạn như GNSS, NTP và Telephony). Vì các giao thức này đã được Android hỗ trợ, nên bạn nên sử dụng các hệ thống Android thay vì kết nối qua VHAL bằng thuộc tính này.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:MILLI_SECS
Bản phát hành: Android 13
FOG_LIGHTS_STATE
Trạng thái đèn sương mù. Trả về trạng thái hiện tại của đèn sương mù. Nếu:
- Xe có đèn sương mù trước và sau. Bạn chỉ có thể điều khiển cùng lúc đèn sương mù trước và sau. Phải triển khai
FOG_LIGHTS_STATE
. Không được triển khaiFRONT_FOG_LIGHTS_STATE
vàREAR_FOG_LIGHTS_STATE
. - Bạn chỉ có thể điều khiển đèn sương mù trước và sau một cách độc lập.
Không được triển khai
FOG_LIGHTS_STATE
và phải triển khaiFRONT_FOG_LIGHTS_STATE
vàREAR_FOG_LIGHTS_STATE
. - Xe chỉ có đèn sương mù phía trước. Bạn chỉ được triển khai một trong hai
FOG_LIGHTS_STATE
hoặcFRONT_FOG_LIGHTS_STATE
(không phải cả hai). Không được triển khaiREAR_FOG_LIGHTS_STATE
. - Xe chỉ có đèn sương mù sau. Bạn chỉ được triển khai một trong hai
FOG_LIGHTS_STATE
hoặcREAR_FOG_LIGHTS_STATE
(không phải cả hai). Không được triển khaiFRONT_FOG_LIGHTS_STATE
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleLightState
Loại đơn vị: N/A
Bản phát hành: Android 13
FOG_LIGHTS_SWITCH
Công tắc đèn sương mù. Chế độ cài đặt mà người dùng muốn. Nếu:
- Xe có cả đèn sương mù trước và sau. Nếu chỉ có thể điều khiển cùng lúc đèn sương mù trước và sau, bạn phải triển khai
FOG_LIGHTS_SWITCH
. Không được triển khaiFRONT_FOG_LIGHTS_SWITCH
vàREAR_FOG_LIGHTS_SWITCH
. - Bạn chỉ có thể điều khiển đèn sương mù trước và sau một cách độc lập. Không được triển khai
FOG_LIGHTS_SWITCH
. Bạn phải triển khaiFRONT_FOG_LIGHTS_SWITCH
vàREAR_FOG_LIGHTS_SWITCH
. - Xe chỉ có đèn sương mù phía trước. Bạn chỉ được triển khai một trong hai
FOG_LIGHTS_SWITCH
hoặcFRONT_FOG_LIGHTS_SWITCH
(không phải cả hai). Không được triển khaiREAR_FOG_LIGHTS_SWITCH
. - Xe chỉ có đèn sương mù sau. Bạn chỉ được triển khai một trong hai
FOG_LIGHTS_SWITCH
hoặcREAR_FOG_LIGHTS_SWITCH
(chứ không phải cả hai). Không được triển khaiFRONT_FOG_LIGHTS_SWITCH
.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: VehicleLightSwitch
Loại đơn vị: N/A
Bản phát hành: Android 13
FORWARD_COLLISION_WARNING_ENABLED
Bật hoặc tắt tính năng Cảnh báo va chạm phía trước (FCW). Đặt thành true để bật FCW và false để tắt FCW. Khi FCW được bật, hệ thống ADAS trong xe phải được bật và giám sát các vụ va chạm tiềm ẩn. Nhìn chung, FORWARD_COLLISION_WARNING_ENABLED
phải luôn trả về true hoặc false. Nếu tính năng này không hoạt động do một số trạng thái tạm thời, chẳng hạn như tốc độ xe quá thấp, thì thông tin đó phải được truyền qua các giá trị ErrorState
trong thuộc tính FORWARD_COLLISION_WARNING_STATE
.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
FORWARD_COLLISION_WARNING_STATE
Trạng thái của tính năng Cảnh báo va chạm phía trước (FCW). Trả về trạng thái hiện tại của FCW. Thuộc tính này phải luôn trả về một trạng thái hợp lệ được xác định trong ForwardCollisionWarningState
hoặc ErrorState
. Thuộc tính này không được hiển thị lỗi thông qua StatusCode và phải sử dụng các trạng thái lỗi được hỗ trợ.
Đối với mã khu vực chung (0), bạn phải xác định mảng VehicleAreaConfig#supportedEnumValues
trừ phi tất cả các trạng thái của cả ForwardCollisionWarningState
(bao gồm cả OTHER, không nên dùng) và ErrorState
đều được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enun: ForwardCollisionWarningState/ErrorState
Loại đơn vị: N/A
Bản phát hành: Android 14
FRONT_FOG_LIGHTS_STATE
Trạng thái đèn sương mù phía trước. Trả về trạng thái hiện tại của đèn sương mù phía trước. Bạn chỉ được triển khai một trong hai thuộc tính FOG_LIGHTS_STATE
hoặc FRONT_FOG_LIGHTS_STATE
.
Hãy tham khảo tài liệu về FOG_LIGHTS_STATE
để biết thêm thông tin.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleLightState
Loại đơn vị: N/A
Bản phát hành: Android 13
FRONT_FOG_LIGHTS_SWITCH
Công tắc đèn sương mù trước. Chế độ cài đặt mà người dùng muốn. Bạn chỉ được triển khai một trong hai thuộc tính FOG_LIGHTS_SWITCH
hoặc FRONT_FOG_LIGHTS_SWITCH
. Hãy tham khảo tài liệu về FOG_LIGHTS_SWITCH
để biết thêm thông tin.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: VehicleLightSwitch
Loại đơn vị: N/A
Bản phát hành: Android 13
FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME
Đơn vị tiêu thụ nhiên liệu để hiển thị.
Cho biết loại đơn vị mà ô tô đang sử dụng để hiển thị thông tin về mức tiêu thụ nhiên liệu cho người dùng
True cho biết đơn vị là quãng đường trên thể tích, chẳng hạn như MPG. False cho biết đơn vị là thể tích trên quãng đường, chẳng hạn như L/100KM. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
FUEL_DOOR_OPEN
Nắp bình xăng đang mở. Thuộc tính này phải thông báo liệu cửa nhiên liệu trên xe có mở hay không.
Thuộc tính này không áp dụng cho xe điện. Tức là nếu INFO_FUEL_TYPE
chỉ chứa FuelType::FUEL_TYPE_ELECTRIC
, thì bạn không được triển khai thuộc tính này. Đối với xe điện, hãy triển khai EV_CHARGE_PORT_OPEN
. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
FUEL_LEVEL
Lượng nhiên liệu còn lại trong xe, tính bằng mililit. Thuộc tính này phải thông báo lượng nhiên liệu còn lại trong xe theo đơn vị mililit. Thuộc tính này không áp dụng cho xe điện. Tức là nếu INFO_FUEL_TYPE
chỉ chứa FuelType::FUEL_TYPE_ELECTRIC
, thì bạn không được triển khai thuộc tính này. Đối với xe điện, hãy triển khai EV_BATTERY_LEVEL
Giá trị không được vượt quá INFO_FUEL_CAPACITY
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:MILLILITER
Bản phát hành: Android 13
FUEL_LEVEL_LOW
Cảnh báo mức nhiên liệu thấp. Thuộc tính này tương ứng với cảnh báo mức nhiên liệu thấp trên trang tổng quan.
Sau khi đặt FUEL_LEVEL_LOW
, bạn không được xoá giá trị này cho đến khi thêm nhiên liệu vào xe. Thuộc tính này có thể tính đến tất cả nguồn nhiên liệu trong một xe. Ví dụ: trong:
- Xe chạy bằng xăng, thuộc tính này chỉ dựa trên mức xăng.
- Xe chạy bằng pin, thuộc tính này chỉ dựa trên mức pin.
- Xe lai: thuộc tính này có thể dựa trên mức xăng và mức pin, tuỳ thuộc vào quyết định của nhà sản xuất thiết bị gốc (OEM).
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
FUEL_VOLUME_DISPLAY_UNITS
Đơn vị thể tích nhiên liệu để hiển thị. Cho biết đơn vị mà ô tô đang sử dụng để hiển thị lượng nhiên liệu cho người dùng. Ví dụ: Lít hoặc Gallon. VehiclePropConfig.configArray
được dùng để cho biết các đơn vị hiển thị dung tích nhiên liệu được hỗ trợ. Các đơn vị âm lượng được xác định trong VehicleUnit
. Ví dụ: configArray[0] = LITER configArray[1] = GALLON
. Nếu việc cập nhật FUEL_VOLUME_DISPLAY_UNITS
ảnh hưởng đến các giá trị của các thuộc tính *_DISPLAY_UNITS
khác, thì bạn cũng phải cập nhật và thông báo các giá trị đó cho khung AAOS.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: VehicleUnit
Loại đơn vị: N/A
Bản phát hành: Android 13
GEAR_SELECTION
Bánh răng do người dùng chọn. Các giá trị trong dữ liệu cấu hình phải thể hiện danh sách các bánh răng được hỗ trợ cho xe này. Ví dụ: dữ liệu cấu hình cho hộp số tự động phải chứa {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK,
và đối với hộp số tay, danh sách phải là GEAR_DRIVE
, GEAR_1, GEAR_2,...}{GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
. Đối với xe có hộp số tự động cho phép người lái xe chọn các bánh răng cụ thể theo yêu cầu (ví dụ: chế độ thủ công), bạn phải đặt giá trị cho GEAR_SELECTION
thành bánh răng cụ thể do người lái xe chọn thay vì GEAR_DRIVE
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleGear
Loại đơn vị: N/A
Bản phát hành: Android 13
GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT
Yêu cầu tuân thủ Quy định chung về bảo mật của Liên minh Châu Âu. Trả về một giá trị cho biết liệu bạn có bắt buộc phải tuân thủ quy định chung về bảo mật hay không và nếu có thì loại yêu cầu đó là gì.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: GsrComplianceRequirementType
Loại đơn vị: N/A
Bản phát hành: Android 14
GLOVE_BOX_DOOR_POS
Thuộc tính đại diện cho vị trí hiện tại của cửa hộc đựng găng tay. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig.
Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết cửa hộp đựng găng tay đang đóng.
minInt32Value
phải là 0. maxInt32Value
cho biết cửa hộp đựng găng tay đang ở vị trí mở hoàn toàn. Các giá trị nằm giữa minInt32Value
và maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí đóng và vị trí mở hoàn toàn.
Thuộc tính này không nằm trong bất kỳ đơn vị cụ thể nào mà nằm trong một phạm vi vị trí tương đối được chỉ định.
Mã khu vực phải khớp với vị trí ghế mà người dùng dự định sử dụng hộp đựng găng tay. Ví dụ: nếu bảng điều khiển bên phải phía trước có hộp đựng găng tay được nhúng vào, thì mã nhận dạng khu vực phải là SEAT_1_RIGHT
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
GLOVE_BOX_LOCKED
Khoá hoặc mở khoá hộp đựng găng tay. Nếu là true, thì hộc đựng găng tay sẽ được khoá. Nếu giá trị là false, thì hộp đựng găng tay sẽ được mở khoá. Mã khu vực phải khớp với vị trí ghế mà người dùng dự định sử dụng hộp đựng găng tay. Ví dụ: nếu bảng điều khiển bên phải phía trước có hộp đựng găng tay được nhúng, thì mã nhận dạng khu vực phải là VehicleAreaSeat#ROW_1_RIGHT
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
H đến I
HANDS_ON_DETECTION_DRIVER_STATE
Trạng thái của người lái xe trong tính năng Phát hiện tay trên vô lăng (HOD). Trả về thông tin cho biết tay của người lái xe có đặt trên vô lăng hay không. Nhìn chung, thuộc tính này sẽ trả về một trạng thái hợp lệ được xác định trong HandsOnDetectionDriverState
hoặc ErrorState
. Ví dụ: nếu không có tính năng này do một số trạng thái tạm thời, thì thông tin đó phải được truyền qua ErrorState
. Nếu xe muốn gửi cảnh báo cho người dùng vì tay người lái xe đã rời khỏi vô lăng quá lâu, thì cảnh báo sẽ xuất hiện thông qua HANDS_ON_DETECTION_WARNING
. Đối với mã nhận dạng khu vực toàn cầu (0), bạn phải xác định mảng VehicleAreaConfig#supportedEnumValues
, trừ phi tất cả các trạng thái của cả HandsOnDetectionDriverState
(bao gồm cả OTHER, không nên dùng) và ErrorState
đều được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: HandsOnDetectionDriverState/ErrorState
Loại đơn vị: N/A
Bản phát hành: Android 14
HANDS_ON_DETECTION_ENABLED
Bật hoặc tắt tính năng Phát hiện người dùng cầm thiết bị (HOD). Đặt giá trị true để bật HOD và false để tắt HOD.
Khi bạn bật HOD, hệ thống bên trong xe sẽ theo dõi sự hiện diện của tay người lái trên vô lăng và gửi cảnh báo nếu phát hiện tay người lái không còn trên vô lăng. Nhìn chung, HANDS_ON_DETECTION_ENABLED
phải luôn trả về giá trị true hoặc false.
Nếu không có tính năng này do một số trạng thái tạm thời, thì thông tin đó phải được truyền thông qua các giá trị ErrorState
trong thuộc tính HANDS_ON_DETECTION_STATE
.
Thuộc tính này được xác định là minInt32Value
VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này là VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
HANDS_ON_DETECTION_WARNING
Cảnh báo phát hiện người dùng chạm vào thiết bị (HOD). Trả về thông tin về việc hệ thống có gửi cảnh báo cho người lái xe vì họ rời tay khỏi vô lăng trong thời gian quá lâu hay không. Nhìn chung, thuộc tính này sẽ trả về một trạng thái hợp lệ được xác định trong HandsOnDetectionWarning
hoặc ErrorState
. Ví dụ: nếu không có tính năng này do một số trạng thái tạm thời, thì thông tin đó phải được truyền qua ErrorState
. Đối với mã khu vực toàn cầu (0), bạn phải xác định mảng VehicleAreaConfig#supportedEnumValues
trừ phi tất cả trạng thái của cả HandsOnDetectionWarning
(bao gồm cả OTHER, không nên dùng) và ErrorState
đều được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: HandsOnDetectionWarning/ErrorState
Loại đơn vị: N/A
Bản phát hành: Android 14
HAZARD_LIGHTS_STATE
Trạng thái của đèn cảnh báo. Trả về trạng thái hiện tại của đèn báo nguy hiểm.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleLightState
Loại đơn vị: N/A
Bản phát hành: Android 13
HAZARD_LIGHTS_SWITCH
Công tắc đèn báo nguy hiểm. Chế độ cài đặt mà người dùng muốn. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: VehicleLightSwitch
Loại đơn vị: N/A
Bản phát hành: Android 13
HEADLIGHTS_STATE
Trạng thái đèn pha. Trả về trạng thái hiện tại của đèn pha.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleLightState
Loại đơn vị: N/A
Bản phát hành: Android 13
HEADLIGHTS_SWITCH
Công tắc đèn pha. Chế độ cài đặt mà người dùng muốn. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: VehicleLightSwitch
Loại đơn vị: N/A
Bản phát hành: Android 13
HIGH_BEAM_LIGHTS_STATE
Trạng thái đèn pha. Trả về trạng thái hiện tại của đèn pha.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleLightState
Loại đơn vị: N/A
Bản phát hành: Android 13
HIGH_BEAM_LIGHTS_SWITCH
Công tắc đèn pha. Chế độ cài đặt mà người dùng muốn. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: VehicleLightSwitch
Loại đơn vị: N/A
Bản phát hành: Android 13
HVAC_AC_ON
Bật và tắt điều hòa cho areaId được chỉ định. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_ACTUAL_FAN_SPEED_RPM
Tốc độ quạt thực tế.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_AUTO_ON
Bật và tắt chế độ kiểm soát khí hậu tự động.
Nếu đúng, chế độ kiểm soát khí hậu tự động sẽ bật. Nếu giá trị là false, thì tính năng điều khiển khí hậu tự động sẽ tắt. Nếu xe không hỗ trợ tắt trực tiếp tính năng điều khiển khí hậu tự động, thì nhà sản xuất thiết bị gốc (OEM) nên thêm logic trong quá trình triển khai VHAL để đặt HVAC_AUTO_ON
thành false. Thao tác này sẽ thay đổi các chế độ cài đặt HVAC cần thiết để gián tiếp tắt HVAC_AUTO_ON
. Lý tưởng nhất là thao tác này sẽ không làm gián đoạn người dùng. Nhà sản xuất thiết bị gốc (OEM) phải khôi phục về trạng thái trước đó đối với mọi chế độ cài đặt đã được sửa đổi khi chế độ điều khiển khí hậu tự động tắt. Bằng cách này, kết quả duy nhất sẽ là HVAC_AUTO_ON
tắt. Nếu không thể khôi phục chế độ cài đặt HVAC về chế độ cài đặt trước đó, thì OEM phải triển khai thay đổi ít gây gián đoạn nhất.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_AUTO_RECIRC_ON
Bật hoặc tắt chế độ tuần hoàn không khí tự động. Khi chế độ tuần hoàn không khí tự động đang bật, hệ thống HVAC có thể tự động chuyển sang chế độ tuần hoàn không khí nếu phát hiện chất lượng không khí vào kém.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_DEFROSTER
Làm tan băng bằng quạt cho cửa sổ được chỉ định. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
nhưng OEM có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_DUAL_ON
Bật tính năng ghép nối nhiệt độ giữa các khu vực. AreaIDs
cho thuộc tính HVAC_DUAL_ON
phải chứa tổ hợp HVAC_TEMPERATURE_SET
AreaIDs
có thể ghép nối với nhau. Nếu HVAC_TEMPERATURE_SET
được liên kết với AreaIDs
[a_1, a_2, ..., a_n] và nếu có thể bật HVAC_DUAL_ON
để ghép nối a_i và a_j, thì thuộc tính HVAC_DUAL_ON
phải được liên kết với [a_i | a_j]. Hơn nữa, nếu a_k và a_l cũng có thể được ghép nối riêng biệt, thì HVAC_DUAL_ON
phải được ánh xạ đến [a_i | a_j, a_k | a_l].
Ví dụ: một chiếc ô tô có hai ghế trước (ROW_1_LEFT
và ROW_1_RIGHT
) và ba ghế sau (ROW_2_LEFT, ROW_2_CENTER và ROW_2_RIGHT).
Có hai bộ điều khiển nhiệt độ, phía người lái và phía người ngồi cùng, có thể được đồng bộ hoá tuỳ ý. Bạn có thể biểu thị điều này trong AreaIDs
như sau:
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]
Khi thuộc tính này được bật, ECU phải đồng bộ hoá nhiệt độ cho các khu vực bị ảnh hưởng.
Mọi tham số được sửa đổi do hiệu ứng phụ của việc bật hoặc tắt tham số DUAL_ON sẽ tạo lệnh gọi lại onPropertyEvent()
đến VHAL. Ngoài ra, nếu việc đặt nhiệt độ (ví dụ: nhiệt độ người lái) thay đổi nhiệt độ khác (chẳng hạn như nhiệt độ người ngồi trước), thì bạn phải tạo lệnh gọi lại onPropertyEvent()
thích hợp.
Nếu người dùng thay đổi nhiệt độ làm gián đoạn mối ghép nối (ví dụ: đặt nhiệt độ của hành khách một cách độc lập), thì VHAL phải gửi lệnh gọi lại onPropertyEvent()
thích hợp (bao gồm cả HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx
). Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
nhưng OEM có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_ELECTRIC_DEFROSTER_ON
Trạng thái của bộ sưởi kính bằng điện.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_FAN_DIRECTION
Chế độ cài đặt hướng quạt. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: VehicleHvacFanDirection
Loại đơn vị: N/A
Bản phát hành: Android 13
HVAC_FAN_DIRECTION_AVAILABLE
Có vị trí dành cho người hâm mộ. Đây là mặt nạ bit của các vị trí quạt có sẵn cho vùng. Mỗi hướng quạt có sẵn được biểu thị bằng một mục riêng biệt trong vectơ. Một hướng quạt có thể có nhiều bit từ tập hợp vehicle_hvac_fan_direction
. Ví dụ: một chiếc ô tô thông thường có thể có các vị trí quạt sau:
- 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)
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: VehicleHvacFanDirection
Loại đơn vị: N/A
Bản phát hành: Android 13
HVAC_FAN_SPEED
Chế độ cài đặt tốc độ quạt. Bạn phải xác định maxInt32Value
và minInt32Value
trong
VehicleAreaConfig. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
đều phải được hỗ trợ.
minInt32Value
tốc độ quạt thấp nhấtmaxInt32Value
tốc độ quạt cao nhất
Thuộc tính này không ở bất kỳ đơn vị cụ thể nào mà ở một phạm vi tốc độ tương đối được chỉ định. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) có thể chọn chỉ triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_MAX_AC_ON
Bật hoặc tắt MAX AC. Khi MAX AC bật, ECU có thể điều chỉnh các mục như vị trí lỗ thông gió, tốc độ quạt và nhiệt độ nếu cần để làm mát xe nhanh nhất có thể. Mọi tham số được sửa đổi dưới dạng tác dụng phụ của việc bật hoặc tắt tham số MAX AC sẽ tạo lệnh gọi lại onPropertyEvent()
đến VHAL. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
nhưng OEM có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_MAX_DEFROST_ON
Bật và tắt chế độ MAX DEFROST (LÀM ĐÔNG KÍNH). Khi chế độ MAX DEFROST đang bật, ECU có thể điều chỉnh các mục như vị trí cửa sổ thông gió, tốc độ quạt và nhiệt độ nếu cần để làm tan băng cửa sổ nhanh nhất có thể.
Bất kỳ tham số nào được sửa đổi dưới dạng hiệu ứng phụ của việc bật hoặc tắt tham số MAX DEFROST đều tạo ra lệnh gọi lại onPropertyEvent()
đến VHAL. AreaIDs
cho HVAC_MAX_DEFROST_ON
cho biết có thể điều khiển chế độ LÀM ĐÔNG TỐI ĐA trong khu vực. Ví dụ: areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT}
cho biết rằng bạn chỉ có thể điều khiển HVAC_MAX_DEFROST_ON
cho các hàng trước. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
nhưng OEM có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_POWER_ON
Biểu thị trạng thái nguồn điện chung cho hệ thống sưởi, thông gió và điều hoà. Việc đặt thuộc tính này thành false CÓ THỂ đánh dấu một số thuộc tính kiểm soát các tính năng và hệ thống con HVAC riêng lẻ ở trạng thái KHÔNG CÓ. Việc đặt thuộc tính này thành true CÓ THỂ đánh dấu một số thuộc tính kiểm soát các tính năng và hệ thống con HVAC riêng lẻ thành trạng thái CÓ (trừ phi bất kỳ hoặc tất cả các thuộc tính đều ở trạng thái KHÔNG CÓ theo giá trị riêng của chúng).
HvacPower_DependentProperties
là những thuộc tính yêu cầu phải bật HVAC để bật chức năng. Ví dụ: trong một số ô tô, để bật điều hòa, trước tiên, bạn phải bật hệ thống điều hòa không khí. Bạn phải đặt danh sách HvacPower_DependentProperties
trong VehiclePropConfig.configArray
HvacPower_DependentProperties
chỉ được chứa các thuộc tính liên kết với VehicleArea:SEAT
Mối liên kết AreaID cho thuộc tính HVAC_POWER_ON
phải chứa tất cả AreaIDs
mà HvacPower_DependentProperties
được liên kết đến. Ví dụ: một chiếc ô tô có hai:
- Ghế trước (
ROW_1_LEFT
,ROW_1_RIGHT
) và 3 ghế sau (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). Nếu các tính năng HVAC (điều hòa không khí, nhiệt độ, v.v.) trên toàn bộ ô tô phụ thuộc vào một bộ điều khiển nguồn HVAC, thì bạn phải liên kếtHVAC_POWER_ON
với [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
- Ghế ở hàng trước (
ROW_1_LEFT
,ROW_1_RIGHT
) và 3 ghế ở hàng sau (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT
) và hàng thứ ba (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT
). Nếu ô tô có bộ điều khiển nhiệt độ ở hàng trước có thể hoạt động hoàn toàn độc lập với bộ điều khiển nhiệt độ ở phía sau xe, thìHVAC_POWER_ON
phải được liên kết với một mảng gồm 2 phần tử:- ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể chỉ triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_RECIRC_ON
Bật và tắt chế độ tuần hoàn. Kiểm soát việc cung cấp không khí bên ngoài vào cabin. Recirc (Hoạt động tuần hoàn) bật nghĩa là hầu hết luồng không khí vào cabin đều bắt nguồn từ cabin. Chế độ tuần hoàn tắt nghĩa là phần lớn luồng không khí vào cabin đến từ bên ngoài xe. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
nhưng OEM có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_SEAT_TEMPERATURE
Hệ thống sưởi và làm mát ghế. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig
. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
đều phải được hỗ trợ.
maxInt32Value
cho biết chế độ sưởi nhiệt độ ghế tối đa.
minInt32Value
phải là 0, trừ phi xe hỗ trợ tính năng làm mát ghế. Trong trường hợp này, minInt32Value
cho biết chế độ làm mát nhiệt độ ghế tối đa.
Thuộc tính này không ở bất kỳ đơn vị cụ thể nào, mà ở một phạm vi cài đặt nhiệt độ tương đối được chỉ định. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_SEAT_VENTILATION
Hệ thống thông gió cho ghế. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig
. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
đều phải được hỗ trợ. minInt32Value
phải là 0. maxInt32Value
cho biết chế độ thông gió tối đa có sẵn cho ghế.
Thuộc tính này không nằm trong bất kỳ đơn vị cụ thể nào mà nằm trong phạm vi cài đặt thông gió được chỉ định.
Được các ứng dụng HVAC và Trợ lý sử dụng để bật, thay đổi hoặc đọc trạng thái thông gió của ghế. Điều này khác với chế độ làm mát ghế. Chế độ này có thể bật cùng lúc với chế độ làm mát hoặc không.
Thuộc tính này được xác định là >VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_SIDE_MIRROR_HEAT
Hệ thống sưởi gương chiếu hậu. Giá trị tăng lên biểu thị mức sưởi ấm cao hơn cho gương chiếu hậu.
Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig
. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
đều phải được hỗ trợ. Trong dữ liệu cấu hình:
maxInt32Value
thể hiện mức sưởi ấm tối đa.minInt32Value
PHẢI bằng 0 và cho biết không có hiện tượng nóng.
Thuộc tính này không ở bất kỳ đơn vị cụ thể nào mà ở một phạm vi cài đặt sưởi tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_STEERING_WHEEL_HEAT
Đặt mức sưởi ấm và làm mát cho vô lăng. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig
. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
đều phải được hỗ trợ.
maxInt32Value
cho biết chế độ cài đặt sưởi ấm vô lăng tối đa. minInt32Value
phải là 0, trừ phi xe cũng hỗ trợ tính năng làm mát vô lăng. Trong trường hợp này, minInt32Value
cho biết chế độ làm mát vô lăng tối đa. Thuộc tính này không nằm trong bất kỳ đơn vị cụ thể nào mà nằm trong một phạm vi cài đặt sưởi ấm được chỉ định. Thuộc tính này được xác định là VehiclePropertyAccess.READ
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HVAC_TEMPERATURE_CURRENT
Nhiệt độ hiện tại của hệ thống sưởi, thông gió và điều hoà (HVAC).
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:CELSIUS
Bản phát hành: Android 13
HVAC_TEMPERATURE_DISPLAY_UNITS
Đơn vị nhiệt độ để hiển thị. Cho biết nhiệt độ được hiển thị theo độ C hay độ F.
VehiclePropConfig.configArray
cho biết các đơn vị hiển thị nhiệt độ được hỗ trợ. Ví dụ: configArray[0] = CELSIUS configArray[1] = FAHRENHEIT
Bạn CÓ THỂ sử dụng thông số này để hiển thị bất kỳ nhiệt độ HVAC nào trong hệ thống. Giá trị phải là một trong hai giá trị VehicleUnit.CELSIUS
hoặc VehicleUnit.FAHRENHEIT
Nếu việc cập nhật HVAC_TEMPERATURE_DISPLAY_UNITS ảnh hưởng đến giá trị của các thuộc tính *_DISPLAY_UNITS
khác, thì bạn phải cập nhật và thông báo giá trị của các thuộc tính đó cho khung AAOS.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này là VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: VehicleUnit
Loại đơn vị: N/A
Bản phát hành: Android 13
HVAC_TEMPERATURE_SET
Nhiệt độ mục tiêu của hệ thống điều hòa không khí được đặt theo độ C.
Bạn phải xác định minFloatValue
và maxFloatValue
trong VehicleAreaConfig
:
- Chế độ cài đặt nhiệt độ tối thiểu
minFloatValue
theo độ C. - Chế độ cài đặt nhiệt độ tối đa
maxFloatValue
theo độ C.
Nếu không hỗ trợ tất cả các giá trị từ minFloatValue
đến maxFloatValue
, hãy sử dụng configArray
để liệt kê các giá trị nhiệt độ hợp lệ có thể đặt.
Phần này cũng mô tả bảng tra cứu để chuyển đổi nhiệt độ từ độ C sang độ F (và ngược lại) cho xe. Bạn phải xác định configArray
nếu xe không hỗ trợ chuyển đổi đơn vị tiêu chuẩn.
configArray
được đặt như sau:
configArray[0]
[giới hạn dưới của nhiệt độ được hỗ trợ theo độ C] * 10configArray[1]
[giới hạn trên của nhiệt độ được hỗ trợ tính theo độ C] * 10configArray[2]
[giá trị tăng theo độ C] * 10configArray[3]
[giới hạn dưới của nhiệt độ được hỗ trợ theo độ F] * 10configArray[4]
[giới hạn trên của nhiệt độ được hỗ trợ tính bằng độ F] * 10configArray[5]
[giá trị tăng theo độ F] * 10
minFloatValue
và maxFloatValue
trong VehicleAreaConfig
phải bằng configArray[0]
và configArray[1]
tương ứng. Ví dụ: nếu xe hỗ trợ các giá trị nhiệt độ là [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5]
theo độ F, thì configArray
phải là configArray = {160, 280, 5, 605, 845, 10}
Lý tưởng nhất là tỷ lệ giữa mức tăng theo độ C và mức tăng theo độ F phải gần với tỷ lệ thực tế là 1 độ C so với 1, 8 độ F. Phải có mối liên kết một với một giữa tất cả các giá trị độ C với các giá trị độ F do configArray
xác định. configArray
được ứng dụng sử dụng để chuyển đổi nhiệt độ của thuộc tính này từ độ C sang độ F. Ngoài ra, lớp này cho phép ứng dụng biết giá trị Celsius cần thiết để đặt thuộc tính nhằm đạt được giá trị Fahreneheit mong muốn cho hệ thống. Nếu ECU không có mối liên kết một với một giữa tất cả các giá trị bằng độ C với các giá trị bằng độ F, thì configArray
chỉ nên xác định danh sách các giá trị bằng độ C và độ F có mối liên kết một với một.
Ví dụ: nếu ECU hỗ trợ các giá trị theo độ C từ 16 đến 28 và các giá trị theo độ F từ 60 đến 85, mỗi giá trị tăng thêm 1, thì một configArray
có thể là mã>{160, 280, 10, 600, 840, 20}Trong trường hợp này, 85 không phải là nhiệt độ được hỗ trợ.
Mọi giá trị được đặt giữa một giá trị hợp lệ phải được làm tròn thành giá trị hợp lệ gần nhất. Nhà sản xuất thiết bị gốc (OEM) cũng nên triển khai thuộc tính xe HVAC_TEMPERATURE_VALUE_SUGGESTION
vì thuộc tính này cung cấp cho các ứng dụng một phương thức đơn giản để xác định các giá trị nhiệt độ có thể được đặt cho một xe và để chuyển đổi các giá trị giữa độ C và độ F.
Thuộc tính này được xác định là VehiclePropertyAccess.READ
, nhưng OEM có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:CELSIUS
Bản phát hành: Android 13
HVAC_TEMPERATURE_VALUE_SUGGESTION
Giá trị đề xuất để đặt nhiệt độ HVAC.
Triển khai thuộc tính này để giúp các ứng dụng hiểu được giá trị nhiệt độ được hỗ trợ gần nhất bằng độ C hoặc độ F.
floatValues[0]
Giá trị được yêu cầu mà ứng dụng muốn đặt nhiệt độ.- Đơn vị
floatValues[1]
chofloatValues[0]
và phải là một trong các{VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
floatValues[2]
Giá trị mà OEM đề xuất theo ĐỘ C (giá trị này không có trong yêu cầu).floatValues[3]
Giá trị mà nhà sản xuất thiết bị gốc đề xuất theo FAHRENHEIT (giá trị này không có trong yêu cầu).
Ứng dụng gọi set(VehiclePropValue propValue)
với giá trị và đơn vị được yêu cầu cho giá trị đó. OEM cần trả về các giá trị đề xuất trong floatValues[2]
và floatValues[3]
bằng lệnh gọi lại onPropertyEvent()
.
Các giá trị đề xuất phải tuân thủ các giá trị có thể bắt nguồn từ HVAC_TEMPERATURE_SET
configArray
Nói cách khác, các giá trị đề xuất và bảng giá trị từ configArray
phải giống nhau.
Nhà sản xuất thiết bị gốc (OEM) nên thêm logic tuỳ chỉnh trong quá trình triển khai VHAL để tránh gửi yêu cầu đến ECU HVAC. Logic có thể như sau. Cách chuyển đổi nhiệt độ từ độ C sang độ F:
// 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;
Ví dụ: khi người lái xe sử dụng trợ lý thoại để đặt nhiệt độ HVAC thành 66, 2 độ theo thang Fahrenheit.
Trước tiên, một ứng dụng sẽ đặt thuộc tính này bằng giá trị [66.2, (float)VehicleUnit.FAHRENHEIT,0,0]
.Nếu nhà sản xuất thiết bị gốc đề xuất đặt 19,0 độ C hoặc 66,5 độ F theo yêu cầu của người dùng, thì VHAL phải tạo lệnh gọi lại có giá trị thuộc tính [66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5]
.Sau khi nhận được lệnh gọi lại, trợ lý giọng nói sẽ thông báo cho người dùng và đặt nhiệt độ HVAC thành giá trị được đề xuất.
Một ví dụ khác: một ứng dụng nhận được 21 độ C làm giá trị nhiệt độ hiện tại bằng cách truy vấn HVC_TEMPERATURE_SET
, nhưng ứng dụng cần biết giá trị nào được hiển thị trên giao diện người dùng của ô tô theo độ F. Để thực hiện việc này, ứng dụng sẽ đặt thuộc tính thành [21, (float)VehicleUnit.CELSIUS, 0, 0]
. Nếu giá trị do nhà sản xuất thiết bị gốc đề xuất cho 21 độ C là 70 độ F, thì VHAL phải tạo lệnh gọi lại có giá trị thuộc tính [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]
. Trong trường hợp này, ứng dụng có thể biết rằng giá trị là 70 độ F trong giao diện người dùng của ô tô.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HW_CUSTOM_INPUT
Xác định sự kiện đầu vào tuỳ chỉnh của đối tác OEM. Đối tác OEM muốn truyền các sự kiện không được Android hỗ trợ phải sử dụng sự kiện đầu vào này. Lớp này chỉ bao gồm một mảng các giá trị int32. Các thuộc tính Android là:
int32Values[0]
Mã đầu vào xác định hàm đại diện cho sự kiện này. Các loại sự kiện hợp lệ được xác định bởiCustomInputType.CUSTOM_EVENT_F1
lên đếnCustomInputType.CUSTOM_EVENT_F10
. Các loại sự kiện này đại diện cho sự kiện tuỳ chỉnh do các đối tác OEM xác định.int32Values[1]
Loại màn hình mục tiêu được xác định trongVehicleDisplay
Các sự kiện không liên kết với một màn hình cụ thể phải được gửi đếnVehicleDisplay#MAIN
int32Values[2]
Bộ đếm lặp lại, nếu 0 thì sự kiện không được lặp lại. Giá trị từ 1 trở lên cho biết số lần sự kiện này được lặp lại.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: CustomInputType
Loại đơn vị: N/A
Bản phát hành: Android 13
HW_KEY_INPUT
Thuộc tính để cung cấp sự kiện đầu vào phần cứng cho Android.
int32Values[0]
Hành động do VehicleHwKeyInputAction xác địnhint32Values[1]
Mã khoá, phải sử dụng mã khoá Android chuẩnint32Values[2]
Màn hình mục tiêu được xác định trongVehicleDisplay
Các sự kiện không liên kết với màn hình cụ thể phải được gửi đếnVehicleDisplay#MAIN
int32Values[3]
(Không bắt buộc) Số lần đánh dấu nhịp độ khung hình. Giá trị phải bằng hoặc lớn hơn 1. Nếu bạn bỏ qua thuộc tính này, Android sẽ mặc định là 1.
Thay đổi chế độ: .ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
HW_KEY_INPUT_V2
Thuộc tính để cung cấp sự kiện đầu vào phần cứng cho Android.
int32array[0]
Màn hình mục tiêu doVehicleDisplay
xác định, chẳng hạn như:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
- Mã khoá
int32array[1]
, phải sử dụng mã khoá Android tiêu chuẩn, chẳng hạn nhưKEYCODE_HOME
vàKEYCODE_BACK
- Thao tác
int32array[2]
được xác định trong VehicleHwKeyInputAction, chẳng hạn như:
VehicleHwKeyInputAction::ACTION_UP
,VehicleHwKeyInputAction::ACTION_UP
int32array[3]
Số lần lặp lại của sự kiện. Đối với các sự kiện nhấn phím, đây là số lần lặp lại với lần nhấn đầu tiên bắt đầu từ 0 và tính từ đó trở đi. Đối với sự kiện nhấn phím, giá trị này luôn bằng 0.int64array[0]
Thời gian ngừng hoạt động tính bằng nano giây đã trôi qua kể từ lần khởi động gần đây nhất. Cho biết thời gian của sự kiện nhấn phím gần đây nhất. Đối với sự kiện nhấn, đây là thời gian diễn ra sự kiện nhấn.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
HW_MOTION_INPUT
Thuộc tính để cung cấp sự kiện đầu vào phần cứng cho Android.
int32array[0]
Màn hình mục tiêu doVehicleDisplay
xác định, chẳng hạn như:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER
,VehicleDisplay::AUX
int32array[1]
Loại dữ liệu đầu vào được xác định trong VehicleHwMotionInputSource, chẳng hạn như:
VehicleHwMotionInputSource::SOURCE_KEYBOARD
,VehicleHwMotionInputSource::SOURCE_DPAD
int32array[2]
Mã hành động được xác định trong VehicleHwMotionInputAction, chẳng hạn như:
VehicleHwMotionInputAction::ACTION_UP
,VehicleHwMotionInputAction::ACTION_DOWN
- Cờ trạng thái nút
int32array[3]
được xác định trong VehicleHwMotionButtonStateFlag, chẳng hạn như:
VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY
,VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
int32array[4]
Số sự kiện con trỏ, N. N phải là số nguyên dương.int32array[5:5+N-1]
Mã con trỏ, độ dài Nint32array[5+N:5+2*N-1]
Loại công cụ, độ dài N. Như được xác định trongVehicleHwMotionToolType
, chẳng hạn như:
VehicleHwMotionToolType::TOOL_TYPE_FINGER
,VehicleHwMotionToolType::TOOL_TYPE_STYLUS
floatArray[0:N-1]
x dữ liệu, độ dài NfloatArray[N:2*N-1]
dữ liệu y, độ dài N- Dữ liệu áp suất
floatArray[2*N:3*N-1]
, chiều dài N - Dữ liệu kích thước
floatArray[3*N:4*N-1]
, chiều dài N int64array[0]
Thời gian ngừng hoạt động, số nano giây đã trôi qua kể từ khi khởi động. Cho biết thời điểm người dùng ban đầu nhấn xuống để bắt đầu một luồng sự kiện vị trí. Đối với sự kiện nhấn, đó là thời gian diễn ra sự kiện nhấn.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
HW_ROTARY_INPUT
Thuộc tính để cung cấp các sự kiện xoay phần cứng cho Android.
int32Values[0]
RotaryInputType để xác định nút xoay nào được xoay.int32Values[1]
Số điểm dừng (lượt nhấp), dương cho chiều kim đồng hồ, âm cho ngược chiều kim đồng hồ.int32Values[2]
Màn hình mục tiêu được xác định trongVehicleDisplay
Các sự kiện không liên kết với một màn hình cụ thể phải được gửi đếnVehicleDisplay#MAIN
int32values[3 .. 3 + abs(number of detents) - 2]
Delta nano giây giữa các cặp điểm dừng liên tiếp khi số điểm dừng lớn hơn 1 hoặc nhỏ hơn -1.VehiclePropValue.timestamp
Thời điểm xoay. Nếu số điểm chặn lớn hơn 1 hoặc nhỏ hơn -1, khi điểm chặn đầu tiên của vòng quay diễn ra.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: RotaryInputType
Loại đơn vị: N/A
Bản phát hành: Android 13
IGNITION_STATE
Biểu thị trạng thái đánh lửa.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleIgnitionState
Loại đơn vị: N/A
Bản phát hành: Android 13
INFO_DRIVER_SEAT
Việc triển khai VHAL cho vị trí ghế lái phải bỏ qua areaId. Sử dụng VehicleArea:GLOBAL
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: VehicleAreaSeat
Loại đơn vị: N/A
Bản phát hành: Android 13
INFO_EV_BATTERY_CAPACITY
Dung lượng pin danh nghĩa của xe điện hoặc xe lai. Trả về dung lượng pin danh nghĩa, xe điện hoặc xe lai. Đây là tổng dung lượng pin có thể sử dụng khi xe còn mới. Giá trị này có thể khác với EV_CURRENT_BATTERY_CAPACITY
vì EV_CURRENT_BATTERY_CAPACITY
trả về dung lượng pin có thể sử dụng theo thời gian thực, có tính đến các yếu tố như tuổi thọ pin và độ phụ thuộc vào nhiệt độ.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:WH
Bản phát hành: Android 13
INFO_EV_CONNECTOR_TYPE
Danh sách các đầu nối mà xe điện này có thể sử dụng. Nếu xe có nhiều cổng sạc, thì thuộc tính này phải trả về tất cả các loại đầu nối có thể sử dụng được cho ít nhất một cổng sạc trên xe.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: EvConnectorType
Loại đơn vị: N/A
Bản phát hành: Android 13
INFO_EV_PORT_LOCATION
Thuộc tính này phải thông báo vị trí của cổng sạc trên xe điện bằng cách sử dụng enum PortLocationType. Nếu một xe có nhiều cổng, thì thuộc tính này phải trả về cổng cho phép sạc nhanh nhất. Để thông báo tất cả vị trí cổng, hãy sử dụng INFO_MULTI_EV_PORT_LOCATIONS
Chế độ truy cập: ĐỌC
Loại enum:
PortLocationType
Loại đơn vị: N/A
Bản phát hành: Android 13
INFO_EXTERIOR_DIMENSIONS
Kích thước bên ngoài của xe:
- Chiều cao:
int32Values[0]
- Độ dài:
int32Values[1]
- Chiều rộng:
int32Values[2]
- Chiều rộng, bao gồm cả màn hình phản chiếu:
int32Values[3]
- Chiều dài cơ sở, bao gồm cả gương:
int32Values[4]
- Chiều rộng của kênh ở mặt trước:
int32Values[5]
- Chiều rộng của đường ray sau:
int32Values[6]
- Đường kính quay từ lề đường này sang lề đường kia:
int32Values[7]
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:MILLIMETER
Bản phát hành: Android 13
INFO_FUEL_CAPACITY
Dung tích nhiên liệu của xe tính bằng mililit. Thuộc tính này phải cho biết lượng nhiên liệu tối đa có thể lưu trữ trong xe tính bằng mililit. Thuộc tính này không áp dụng cho xe điện. Tức là nếu INFO_FUEL_TYPE
chỉ chứa FuelType::FUEL_TYPE_ELECTRIC
, thì bạn không được triển khai INFO_FUEL_CAPACITY.
Đối với ô tô điện, hãy triển khai INFO_EV_BATTERY_CAPACITY.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:MILLILITER
Bản phát hành: Android 13
INFO_FUEL_DOOR_LOCATION
Vị trí nắp bình xăng. Thuộc tính này phải cho biết vị trí của nắp bình nhiên liệu trên xe.
Thuộc tính này không áp dụng cho xe điện. Tức là nếu INFO_FUEL_TYPE
chỉ chứa FuelType::FUEL_TYPE_ELECTRIC
, thì bạn không được triển khai thuộc tính này. Đối với ô tô điện, hãy triển khai INFO_EV_PORT_LOCATION
hoặc INFO_MULTI_LOCATIONS
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: PortLocationType
Loại đơn vị: N/A
Bản phát hành: Android 13
INFO_FUEL_TYPE
Danh sách nhiên liệu mà xe có thể sử dụng. Bạn chỉ được thêm FuelType::FUEL_TYPE_ELECTRIC
nếu xe có thể sạc pin. Ví dụ: Xe điện lai hoàn toàn (FHEV) không được bao gồm FuelType::FUEL_TYPE_ELECTRIC
vì giá trị INT32_VEC cho INFO_FUEL_TYPE
INFO_FUEL_TYPE
có thể được điền như vậy.
int32Values = { FuelType::FUEL_TYPE_UNLEADED }
FuelType::FUEL_TYPE_ELECTRIC
dưới dạng giá trị INT32_VEC cho
INFO_FUEL_TYPE
INFO_FUEL_TYPE
có thể được điền như vậy,
int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: FuelType
Loại đơn vị: N/A
Bản phát hành: Android 13
INFO_MAKE
Nhà sản xuất xe. Thuộc tính này phải truyền đạt tên thương hiệu công khai của xe.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: N/A
Bản phát hành: Android 13
INFO_MODEL
Mẫu xe. Thuộc tính này phải cho biết tên công khai của mẫu xe.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: N/A
Bản phát hành: Android 13
INFO_MODEL_YEAR
Năm sản xuất xe theo định dạng "YYYY" dựa trên lịch Gregory.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:YEAR
Bản phát hành: Android 13
INFO_MULTI_EV_PORT_LOCATIONS
Nhiều vị trí cổng sạc xe điện. Triển khai thuộc tính này nếu xe có nhiều cổng sạc xe điện. Vị trí của cổng được xác định trong PortLocationType. Ví dụ: một chiếc ô tô có một cổng ở bên trái phía trước và một cổng ở bên trái phía sau:
int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT
Nếu một xe chỉ có một cổng, thì giá trị của thuộc tính này phải liệt kê một phần tử. Để mô tả một vị trí sạc, hãy xem INFO-EV-PORT-LOCATION
.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: PortLocationType
Loại đơn vị: N/A
Bản phát hành: Android 13
INFO_VIN
Mã nhận dạng xe (VIN).
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: N/A
Bản phát hành: Android 13
INITIAL_USER_INFO
Xác định người dùng Android sẽ được sử dụng trong quá trình khởi chạy. Thuộc tính này được hệ thống Android gọi khi khởi động và cho phép HAL xác định người dùng Android nào sẽ được khởi động. Yêu cầu này được thực hiện bằng cách đặt VehiclePropValue (do InitialUserInfoRequest
xác định) và HAL phải phản hồi bằng một sự kiện thay đổi thuộc tính (do InitialUserInfoResponse xác định).
Nếu HAL không phản hồi sau một khoảng thời gian do hệ thống Android xác định, thì hệ thống Android sẽ tiếp tục như thể HAL đã trả về phản hồi của hành động InitialUserInfoResponseAction:DEFAULT.
Ví dụ: trong lần khởi động đầu tiên, yêu cầu có thể là:
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
InitialUserInfoResponseAction:CREATE
). Ví dụ: để tạo
cùng một người dùng Chủ sở hữu bằng ngôn ngữ en-US và pt-BR, giá trị chuỗi của phản hồi là
en-US,pt-BR||Owner. Do đó, ngôn ngữ cũng như tên không được chứa hai thanh dọc (||
) trong giá trị, mặc dù bạn có thể sử dụng một thanh dọc (|
).
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
J đến R
LANE_CENTERING_ASSIST_COMMAND
Lệnh của tính năng Hỗ trợ giữ làn đường (LCA). Các lệnh để kích hoạt và tạm ngưng LCA.
Khi lệnh ACTIVATE
từ LaneCenteringAssistCommand
được gửi, bạn phải đặt LANE_CENTERING_ASSIST_STATE
thành LaneCenteringAssistState#ACTIVATION_REQUESTED
. Khi lệnh ACTIVATE
thành công, bạn phải đặt LANE_CENTERING_ASSIST_STATE
thành LaneCenteringAssistState#ACTIVATED
. Khi lệnh DEACTIVATE
từ LaneCenteringAssistCommand
thành công, bạn phải đặt LANE_CENTERING_ASSIST_STATE
thành LaneCenteringAssistState#ENABLED
Đối với mã khu vực toàn cầu (0), bạn phải xác định VehicleAreaConfig#supportedEnumValues
trừ phi tất cả giá trị enum của LaneCenteringAssistCommand
đều được hỗ trợ. Khi thuộc tính này không có sẵn vì LCA bị tắt (ví dụ: LANE_CENTERING_ASSIST_ENABLED
là sai), thuộc tính này phải trả về StatusCode#NOT_AVAILABLE_DISABLED
. Nếu LANE_CENTERING_ASSIST_STATE
được triển khai và trạng thái được đặt thành giá trị ErrorState
, thì thuộc tính này phải trả về StatusCode
phù hợp với giá trị ErrorState
. Ví dụ: nếu LANE_CENTERING_ASSIST_STATE
được đặt thành ErrorState#NOT_AVAILABLE_SPEED_LOW
, thì thuộc tính này phải trả về StatusCode#NOT_AVAILABLE_SPEED_LOW
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: LaneCenteringAssistCommand
Loại đơn vị: N/A
Bản phát hành: Android 14
LANE_CENTERING_ASSIST_ENABLED
Bật hoặc tắt tính năng Hỗ trợ căn giữa làn đường (LCA). Đặt true để bật LCA và false để tắt LCA. Khi LCA được bật, hệ thống ADAS trong xe phải được bật và chờ tín hiệu kích hoạt từ người lái xe. Sau khi tính năng này được kích hoạt, hệ thống ADAS sẽ điều khiển xe để giữ cho xe ở giữa làn đường hiện tại.
Tính năng này khác với tính năng Hỗ trợ giữ làn đường (LKA) – theo dõi xem người lái xe có vô tình trượt sang hoặc vượt qua vạch kẻ đường hay không. Nếu phát hiện thấy xe vô tình rời khỏi làn đường, hệ thống sẽ áp dụng chức năng điều khiển tay lái để đưa xe trở lại làn đường hiện tại.
Nhìn chung, LANE_CENTERING_ASSIST_ENABLED
phải luôn trả về true hoặc false. Nếu tính năng này không hoạt động do một số trạng thái tạm thời, chẳng hạn như tốc độ xe quá thấp hoặc quá cao, thì thông tin đó phải được truyền qua các giá trị ErrorState
trong thuộc tính LANE_CENTERING_ASSIST_STATE
.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
LANE_CENTERING_ASSIST_STATE
Trạng thái của tính năng Hỗ trợ căn giữa làn đường (LCA). Trả về trạng thái hiện tại của LCA. Thuộc tính này phải luôn trả về một trạng thái hợp lệ được xác định trong LaneCenteringAssistState
hoặc ErrorState
. Thuộc tính này không được hiển thị lỗi thông qua StatusCode
và phải sử dụng các trạng thái lỗi được hỗ trợ.
Nếu LCA bao gồm cảnh báo chệch làn đường, thì các cảnh báo đó phải xuất hiện thông qua thuộc tính Cảnh báo chệch làn đường (LDW).
Đối với mã khu vực chung (0), bạn phải xác định mảng VehicleAreaConfig#supportedEnumValues
trừ phi tất cả các trạng thái của cả LaneCenteringAssistState
(bao gồm cả OTHER, không nên dùng) và ErrorState
đều được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: LaneCenteringAssistState/ErrorState
Loại đơn vị: N/A
Bản phát hành: Android 14
LANE_DEPARTURE_WARNING_ENABLED
Bật hoặc tắt tính năng Cảnh báo chệch làn đường (LDW). Đặt thành true để bật LDW và false để tắt LDW. Khi LDW được bật, hệ thống ADAS trong xe sẽ được bật và theo dõi xem xe có đang tiến gần hoặc băng qua các vạch làn đường hay không. Trong trường hợp này, hệ thống sẽ đưa ra cảnh báo.
Nhìn chung, LANE_DEPARTURE_WARNING_ENABLED
phải luôn trả về true hoặc false. Nếu tính năng này không hoạt động do một số trạng thái tạm thời, chẳng hạn như tốc độ xe quá thấp hoặc quá cao, thì thông tin đó phải được truyền qua các giá trị ErrorState
trong thuộc tính LANE_DEPARTURE_WARNING_STATE
.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
LANE_DEPARTURE_WARNING_STATE
Trạng thái Cảnh báo chệch làn đường (LDW). Trả về trạng thái hiện tại của LDW. Thuộc tính này phải luôn trả về một trạng thái hợp lệ được xác định trong LaneDepartureWarningState
hoặc ErrorState
. Thuộc tính này không được hiển thị lỗi thông qua StatusCode
và phải sử dụng các trạng thái lỗi được hỗ trợ.
Đối với mã khu vực chung (0), bạn phải xác định mảng VehicleAreaConfig#supportedEnumValues
trừ phi tất cả các trạng thái của cả LaneDepartureWarningState
(bao gồm cả OTHER, không nên dùng) và ErrorState
đều được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: LaneDepartureWarningState/ErrorState
Loại đơn vị: N/A
Bản phát hành: Android 14
LANE_KEEP_ASSIST_ENABLED
Bật hoặc tắt tính năng Hỗ trợ giữ làn đường (LKA). Đặt thành true để bật LKA và false để tắt LKA. Khi bật LKA, hệ thống ADAS trong xe phải được bật và theo dõi xem người lái xe có vô tình trôi về phía hoặc vượt qua vạch kẻ đường hay không. Nếu phát hiện thấy xe vô tình rời khỏi làn đường, hệ thống sẽ áp dụng chức năng điều khiển tay lái để đưa xe trở lại làn đường hiện tại. Tính năng này khác với tính năng Hỗ trợ giữ làn đường (LCA). Khi được kích hoạt, tính năng này sẽ áp dụng chế độ điều khiển tay lái liên tục để giữ cho xe ở giữa làn đường hiện tại.
Nhìn chung, LANE_KEEP_ASSIST_ENABLED
phải luôn trả về true hoặc false. Nếu tính năng này không hoạt động do một số trạng thái tạm thời, chẳng hạn như tốc độ xe quá thấp hoặc quá cao, thì thông tin đó phải được truyền qua các giá trị ErrorState
trong thuộc tính LANE_KEEP_ASSIST_STATE
.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
LANE_KEEP_ASSIST_STATE
Trạng thái của tính năng Hỗ trợ giữ làn đường (LKA). Trả về trạng thái hiện tại của LKA. Thuộc tính này phải luôn trả về một trạng thái hợp lệ được xác định trong LaneKeepAssistState
hoặc ErrorState
. Thuộc tính này không được hiển thị lỗi thông qua StatusCode
và phải sử dụng các trạng thái lỗi được hỗ trợ
Nếu LKA bao gồm cảnh báo chệch làn đường trước khi áp dụng biện pháp điều chỉnh tay lái, thì các cảnh báo đó phải xuất hiện thông qua các thuộc tính Cảnh báo chệch làn đường (LDW).
Đối với mã khu vực chung (0), bạn phải xác định mảng VehicleAreaConfig#supportedEnumValues
trừ phi tất cả các trạng thái của cả LaneKeepAssistState
(bao gồm cả OTHER, không nên dùng) và ErrorState
đều được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: LaneKeepAssistState/ErrorState
Loại đơn vị: N/A
Bản phát hành: Android 14
LOCATION_CHARACTERIZATION
Đặc điểm của dữ liệu đầu vào dùng để tính toán vị trí. Thuộc tính này phải cho biết dữ liệu và đầu vào cảm biến nào (nếu có) mà hệ thống xem xét khi tính toán vị trí của xe được chia sẻ với Android thông qua HAL GNSS.
Giá trị phải trả về một tập hợp cờ bit. Cờ bit được xác định trong
LocationCharacterization. Giá trị này cũng phải bao gồm đúng một trong hai giá trị DEAD_RECKONED
hoặc RAW_GNSS_ONLY
trong tập hợp cờ bit.
Khi thuộc tính này không được hỗ trợ, giả định là không có đầu vào cảm biến nào khác được hợp nhất vào thông tin cập nhật GNSS được cung cấp thông qua HAL GNSS. Trừ phi có quy định khác thông qua giao diện HAL GNSS.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
MIRROR_AUTO_FOLD_ENABLED
Biểu thị thuộc tính cho tính năng Tự động gập gương. Thuộc tính này có giá trị true khi tính năng tự động gập gương chiếu hậu bên của xe được bật (ví dụ: khi gương tự động gập vào khi người dùng rời khỏi và khoá xe).
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
MIRROR_AUTO_TILT_ENABLED
Biểu thị thuộc tính cho tính năng Tự động nghiêng của gương. Thuộc tính này có giá trị true khi tính năng tự động nghiêng gương chiếu hậu của xe (ví dụ: khi gương tự động nghiêng xuống khi người lái xe lùi) được bật.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
MIRROR_FOLD
Gấp theo kiểu gương. True cho biết gương đang gập lại. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
MIRROR_LOCK
Khoá gương. True cho biết vị trí gương được khoá và không thể thay đổi.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
MIRROR_Y_MOVE
Di chuyển theo trục Y phản chiếu. Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig
.
Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
thể hiện tốc độ di chuyển tối đa của gương trong khi nghiêng sang phải. minInt32Value
thể hiện tốc độ di chuyển tối đa của gương trong khi nghiêng sang trái.
Giá trị tuyệt đối lớn hơn, dương hoặc âm, cho biết tốc độ di chuyển nhanh hơn. Khi gương đạt đến giới hạn vị trí, giá trị phải được đặt lại thành 0. Nếu giá trị của MIRROR_Y_MOVE hiện là 0, thì tức là không có chuyển động nào đang diễn ra.
Thuộc tính này không ở bất kỳ đơn vị cụ thể nào mà ở một phạm vi tốc độ chuyển động tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
MIRROR_Y_POS
Phản chiếu vị trí Y. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig
.
Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết gương được nghiêng hoàn toàn sang trái.
Đây phải là một giá trị không dương. maxInt32Value
cho biết gương được nghiêng hoàn toàn sang bên phải. Đây phải là giá trị không âm. 0 cho biết gương không bị nghiêng theo hướng nào.
Các giá trị nằm giữa minInt32Value
và maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí cực trái và cực phải.
Thuộc tính này không nằm trong bất kỳ đơn vị cụ thể nào mà nằm trong một phạm vi vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
MIRROR_Z_MOVE
Di chuyển theo hướng phản chiếu Z. Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig
.
Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
thể hiện tốc độ di chuyển tối đa của gương trong khi nghiêng lên trên.
minInt32Value
thể hiện tốc độ di chuyển tối đa của gương trong khi nghiêng xuống dưới.
Giá trị tuyệt đối lớn hơn, dương hoặc âm, cho biết tốc độ di chuyển nhanh hơn. Khi gương đạt đến giới hạn vị trí, giá trị phải được đặt lại thành 0. Nếu giá trị của MIRROR_Z_MOVE hiện là 0, thì tức là không có chuyển động nào đang diễn ra.
Thuộc tính này không ở bất kỳ đơn vị cụ thể nào mà ở một phạm vi tốc độ chuyển động tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
MIRROR_Z_POS
Phản chiếu vị trí Z. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig
. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
đều phải được hỗ trợ. minInt32Value
cho biết gương nghiêng hoàn toàn xuống dưới. Đây phải là một giá trị không dương. maxInt32Value
cho biết gương được nghiêng hoàn toàn lên trên. Đây phải là giá trị không âm. 0 cho biết gương không bị nghiêng theo hướng nào.
Các giá trị nằm giữa minInt32Value
và maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí hoàn toàn hướng xuống và hoàn toàn hướng lên.
Thuộc tính này không nằm trong bất kỳ đơn vị cụ thể nào mà nằm trong một phạm vi vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
NIGHT_MODE
True cho biết cảm biến chế độ ban đêm đã phát hiện môi trường trong xe có ánh sáng yếu. Ví dụ: nền tảng có thể sử dụng thông tin này để bật giao diện người dùng phù hợp nhằm giúp người dùng xem tốt hơn trong môi trường tối hoặc có ánh sáng yếu.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
OBD2_FREEZE_FRAME
Báo cáo thông tin tổng quan nhanh về giá trị của các cảm biến OBD2 có sẵn tại thời điểm lỗi xảy ra và được phát hiện. Bạn phải cung cấp configArray có cùng ý nghĩa như đã xác định cho OBD2_LIVE_FRAME
Các giá trị của thuộc tính này được diễn giải theo cách tương tự như các giá trị của OBD2_LIVE_FRAME
, ngoại trừ trường stringValue có thể chứa mã khắc phục sự cố chẩn đoán không trống (DTC).
Yêu cầu IVehicle#get của thuộc tính này phải cung cấp giá trị cho int64Values[0]. Giá trị này được diễn giải là dấu thời gian của khung hình tĩnh cần truy xuất. Bạn có thể lấy danh sách dấu thời gian bằng IVehicle#get của OBD2_FREEZE_FRAME_INFO
Nếu không có khung hình cố định tại dấu thời gian đã cho, thì quá trình triển khai phải trả về phản hồi là NOT_AVAILABLE
. Vì các phương tiện có thể có bộ nhớ giới hạn cho ảnh tĩnh, nên yêu cầu khung hình có thể phản hồi bằng NOT_AVAILABLE
ngay cả khi dấu thời gian liên kết đã được lấy gần đây thông qua OBD2_FREEZE_FRAME_INFO
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
OBD2_FREEZE_FRAME_CLEAR
Xoá khung hình dừng. Báo cáo thông tin tổng quan nhanh về giá trị của các cảm biến OBD2 có sẵn tại thời điểm lỗi xảy ra và được phát hiện. Bạn phải cung cấp configArray có cùng ý nghĩa như được xác định cho OBD2_LIVE_FRAME
Các giá trị của thuộc tính này được diễn giải theo cách tương tự như các giá trị của OBD2_LIVE_FRAME
, ngoại trừ trường stringValue có thể chứa mã khắc phục sự cố chẩn đoán không trống (DTC).
Yêu cầu IVehicle#get của thuộc tính này phải cung cấp giá trị cho int64Values[0]. Giá trị này sẽ được diễn giải là dấu thời gian của khung hình dừng để truy xuất. Bạn có thể lấy danh sách dấu thời gian bằng IVehicle#get của OBD2_FREEZE_FRAME_INFO
Nếu không có khung hình cố định tại dấu thời gian đã cho, thì quá trình triển khai phải trả về phản hồi là NOT_AVAILABLE
. Vì các phương tiện có thể có bộ nhớ hạn chế cho ảnh tĩnh, nên yêu cầu khung hình có thể phản hồi bằng NOT_AVAILABLE
ngay cả khi dấu thời gian liên kết gần đây đã được lấy qua OBD2_FREEZE_FRAME_INFO
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
OBD2_FREEZE_FRAME_INFO
Thuộc tính này mô tả các khung hình tĩnh hiện tại được lưu trữ trong bộ nhớ của xe và có thể truy xuất thông qua OBD2_FREEZE_FRAME
. Các giá trị sẽ được diễn giải như sau. Mỗi phần tử của int64Values phải là dấu thời gian tại thời điểm phát hiện mã lỗi và khung hình tĩnh tương ứng được lưu trữ. Bạn có thể dùng mỗi phần tử như vậy làm khoá cho OBD2_FREEZE_FRAME
để truy xuất khung hình tĩnh tương ứng.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
OBD2_LIVE_FRAME
Báo cáo thông tin tổng quan nhanh về các giá trị hiện tại (trực tiếp) của các cảm biến OBD2 hiện có. Bạn có thể đặt configArray như sau:
configArray[0]
Số lượng cảm biến có giá trị số nguyên dành riêng cho nhà cung cấpconfigArray[1]
Số lượng cảm biến có giá trị float dành riêng cho nhà cung cấp
Giá trị của thuộc tính này được diễn giải như trong ví dụ sau. Xem xét configArray = {2,3} int32Values
phải là một vectơ chứa Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX
cộng với hai phần tử (hoặc 33 phần tử).
floatValues
phải là một vectơ chứa Obd2FloatSensorIndex.LAST_SYSTEM_INDEX
cộng với 3 phần tử (hoặc 73 phần tử).
Mỗi khung hình có thể chứa một tập hợp con khác nhau của các giá trị cảm biến, cả cảm biến do hệ thống cung cấp và cảm biến dành riêng cho nhà cung cấp. Để hỗ trợ việc này, phần tử byte của giá trị thuộc tính được dùng làm mặt nạ bit. Số byte phải đủ để biểu thị tổng số cảm biến có thể có (trong trường hợp này là 14 byte để biểu thị 106 giá trị có thể có).
Giá trị này được đọc dưới dạng mặt nạ bit liền nhau, trong đó mỗi bit cho biết có hay không có cảm biến trong khung, bắt đầu bằng số bit bằng kích thước của int32Values
, ngay sau đó là số bit bằng kích thước của floatValues.
Ví dụ: nếu bytes[0] = 0x4C (0b01001100)
thì có nghĩa là:
int32Values[0 and 1]
không phải là giá trị cảm biến hợp lệint32Values[2 and 3]
là các giá trị cảm biến hợp lệint32Values[4 and 5]
không phải là giá trị cảm biến hợp lệint32Values[6]
là giá trị cảm biến hợp lệint32Values[7]
không phải là giá trị cảm biến hợp lệint32Values[0 and 1]
không phải là giá trị cảm biến hợp lệint32Values[2 and 3]
là các giá trị cảm biến hợp lệint32Values[4 and 5]
không phải là giá trị cảm biến hợp lệint32Values[6]
là giá trị cảm biến hợp lệint32Values[7]
không phải là giá trị cảm biến hợp lệ
Nếu bytes[5] = 0x61 (0b01100001)
, thì:
int32Values[32]
là giá trị cảm biến hợp lệfloatValues[0 thru 3]
là các giá trị cảm biến không hợp lệfloatValues[4 and 5]
là các giá trị cảm biến hợp lệfloatValues[6]
không phải là giá trị cảm biến hợp lệ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
ON_CHANGE
Chế độ thay đổi:
Chế độ truy cập: READ_WRITE/READ
Loại enum:
VehicleLightSwitch
Loại đơn vị:N/A
Bản phát hành: Android 13
PARKING_BRAKE_AUTO_APPLY
Tự động áp dụng phanh đỗ xe. Khi có giá trị true, thuộc tính này cho biết phanh đỗ xe tự động của ô tô đang bật. Giá trị False cho biết tính năng phanh tự động khi đỗ xe của ô tô đang tắt. Thuộc tính này thường bị nhầm lẫn với PARKING_BRAKE_ON
. Điểm khác biệt là PARKING_BRAKE_ON
cho biết phanh tay thực tế đang bật hay tắt, còn PARKING_BRAKE_AUTO_APPLY
cho biết tính năng phanh tay tự động đang bật hay tắt và không mô tả trạng thái hiện tại của phanh tay thực tế.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
PARKING_BRAKE_ON
Trạng thái phanh đỗ xe. Khi có giá trị true, thuộc tính này cho biết phanh đỗ xe của ô tô đang được kích hoạt. Giá trị sai cho biết phanh đỗ xe của ô tô đang ở trạng thái ngắt.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
PER_DISPLAY_BRIGHTNESS
Thuộc tính thể hiện độ sáng của màn hình được kiểm soát riêng biệt.
Một số ô tô có một hoặc nhiều màn hình được kiểm soát độ sáng riêng biệt và thuộc tính này là để thông báo độ sáng của từng màn hình dành cho hành khách. Trong ô tô, nơi tất cả độ sáng của màn hình được kiểm soát cùng nhau, chúng phải sử dụng DISPLAY_BRIGHTNESS
Bạn chỉ nên triển khai một trong hai PER_DISPLAY_BRIGHTNESS
vàPER_DISPLAY_BRIGHTNESS
. Nếu có cả hai, AAOS sẽ sử dụng PER_DISPLAY_BRIGHTNESS
.
Cổng hiển thị xác định duy nhất một đầu nối thực trên thiết bị để xuất ra màn hình, dao động từ 0 đến 255.
int32Values[0]
Cổng hiển thịint32Values[1]
Độ sáng
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
PERF_ODOMETER
Giá trị hiện tại trên công tơ mét của xe.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:KILOMETER
Bản phát hành: Android 13
PERF_REAR_STEERING_ANGLE
Góc lái của mô hình xe đạp phía sau. Góc được đo bằng độ. Trái là âm. Thuộc tính này không phụ thuộc vào góc của vô lăng. Thuộc tính này phải thông báo góc của bánh sau so với xe, chứ không phải góc của vô lăng.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:DEGREES
Bản phát hành: Android 13
PERF_STEERING_ANGLE
Góc lái của mô hình xe đạp trước cho xe. Góc được đo bằng độ. Trái là âm. Thuộc tính này không phụ thuộc vào góc của vô lăng. Thuộc tính này phải thông báo góc của bánh xe trước so với xe, chứ không phải góc của vô lăng.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:DEGREES
Bản phát hành: Android 13
PERF_VEHICLE_SPEED
Tốc độ của xe, Giá trị phải là số dương khi xe đang di chuyển về phía trước và âm khi xe đang lùi. Giá trị này độc lập với giá trị bánh răng (CURRENT_GEAR
hoặc GEAR_SELECTION
). Ví dụ: nếu GEAR_SELECTION
là GEAR_NEUTRAL
, thì PERF_VEHICLE_SPEED
sẽ dương khi xe đang di chuyển về phía trước, âm khi lùi và bằng 0 khi không di chuyển.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại đơn vị: Không áp dụng
Loại đơn vị: VehicleUnit:METER_PER_SEC
Bản phát hành: Android 13
PERF_VEHICLE_SPEED_DISPLAY
Tốc độ của xe để hiển thị, Một số ô tô hiển thị tốc độ trên đồng hồ tốc độ chậm hơn một chút so với tốc độ thực tế.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:METER_PER_SEC
Bản phát hành: Android 13
POWER_POLICY_GROUP_REQ
Xác định một yêu cầu để đặt nhóm chính sách nguồn điện dùng để quyết định chính sách nguồn điện mặc định cho mỗi quá trình chuyển đổi trạng thái nguồn điện.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
POWER_POLICY_REQ
Xác định yêu cầu áp dụng chính sách nguồn. VHAL đặt thuộc tính này để thay đổi chính sách về nguồn điện của ô tô.
Dịch vụ chính sách về nguồn điện của ô tô sẽ đăng ký tài sản này và thực sự thay đổi chính sách về nguồn điện. Yêu cầu được thực hiện bằng cách đặt VehiclePropValue bằng mã nhận dạng của chính sách nguồn điện được xác định tại /vendor/etc/automotive/power_policy.xml
. Nếu mã nhận dạng đã cho không được xác định, thì dịch vụ chính sách nguồn điện của ô tô sẽ bỏ qua yêu cầu và duy trì chính sách nguồn điện hiện tại.
string: "sample_policy_id" // power policy ID
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
POWER_POLICY_GROUP_REQ
Xác định một yêu cầu để đặt nhóm chính sách nguồn điện dùng để quyết định chính sách nguồn điện mặc định cho mỗi quá trình chuyển đổi trạng thái nguồn điện. VHAL đặt thuộc tính này bằng mã nhận dạng của một nhóm chính sách nguồn để đặt chính sách nguồn mặc định được áp dụng khi chuyển đổi trạng thái nguồn. Các nhóm chính sách về nguồn điện được xác định tại /vendor/etc/power_policy.xml. Nếu mã nhận dạng đã cho không được xác định, thì dịch vụ chính sách về nguồn điện của ô tô sẽ bỏ qua yêu cầu. Dịch vụ chính sách sử dụng điện của ô tô sẽ đăng ký thuộc tính này và đặt nhóm chính sách sử dụng điện. Việc áp dụng chính sách nguồn thực tế diễn ra khi trạng thái nguồn của hệ thống thay đổi và có một chính sách nguồn được liên kết hợp lệ cho trạng thái nguồn mới.
string: "sample_policy_group_id" // power policy group ID
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
RANGE_REMAINING
Quãng đường còn lại. Đồng hồ đo lượng nhiên liệu và pin còn lại. Phạm vi còn lại phải tính đến tất cả nguồn năng lượng trong xe. Ví dụ: phạm vi của xe lai là tổng phạm vi dựa trên nhiên liệu và pin. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
vì ứng dụng chỉ đường có thể cập nhật phạm vi nếu ứng dụng có thông tin ước tính chính xác hơn dựa trên tuyến đường sắp tới. Nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
theo ý mình.
Chế độ thay đổi: CONTINUOUS
Chế độ truy cập: READ_WRITE
Loại enum: N/A
Loại đơn vị: VehicleUnit:METER
Bản phát hành: Android 13
READING_LIGHTS_STATE
Trả về trạng thái hiện tại của đèn đọc sách.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleLightState
Loại đơn vị: N/A
Bản phát hành: Android 13
READING_LIGHTS_SWITCH
Công tắc điều khiển đèn đọc sách. Điều này có thể khác với READING_LIGHTS_STATE
nếu đèn bật do cửa đang mở hoặc do lệnh thoại. Ví dụ: khi nút chuyển ở vị trí tắt hoặc tự động. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
REAR_FOG_LIGHTS_STATE
Trả về trạng thái hiện tại của đèn sương mù sau. Bạn chỉ có thể triển khai một trong hai FOG_LIGHTS_STATE
hoặc REAR_FOG_LIGHTS_STATE
. Xem FOG_LIGHTS_STATE
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleLightState
Loại đơn vị: N/A
Bản phát hành: Android 13
REAR_FOG_LIGHTS_SWITCH
Chế độ cài đặt mà người dùng muốn. Bạn chỉ được triển khai một trong hai FOG_LIGHTS_SWITCH
hoặc REAR_FOG_LIGHTS_SWITCH
. Hãy xem FOG_LIGHTS_SWITCH
để tìm hiểu thêm. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE/READ
Loại enum: VehicleLightSwitch
Loại đơn vị: N/A
Bản phát hành: Android 13
REMOVE_USER
Được Hệ thống Android gọi sau khi người dùng Android bị xoá. HAL có thể sử dụng thuộc tính này để xoá người dùng tương đương. Đây là lịch chỉ có thể ghi. Hệ thống Android không mong đợi phản hồi từ HAL. Do đó, yêu cầu này sẽ không bị từ chối. Nếu không thể xoá người dùng HAL tương đương, thì HAL sẽ đánh dấu người dùng đó là không hoạt động hoặc khôi phục theo cách khác.
Yêu cầu được thực hiện bằng cách đặt VehiclePropValue bằng nội dung do RemoveUserRequest
xác định. Ví dụ: nếu hệ thống có 3 người dùng (0, 10 và 11) và người dùng 11 đã bị xoá, thì yêu cầu sẽ là:
int32[0]
42 // mã yêu cầuint32[1]
11 // (Mã nhận dạng người dùng Android của người dùng đã bị xoá)int32[2]
0 // (Cờ người dùng Android của người dùng đã bị xoá)int32[3]
10 // người dùng hiện tạiint32[4]
0 // cờ người dùng hiện tại (không có)int32[5]
2 // số người dùngint32[6]
0 // người dùng đầu tiên (người dùng 0)int32[7]
0 // cờ người dùng đầu tiên (không có)int32[8]
10 // người dùng thứ hai (người dùng 10)int32[9
] 0 // cờ người dùng thứ hai (không có)
Chế độ thay đổi: STATIC
Chế độ truy cập: WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
Từ S đến Z
ĐÃ BẬT GHẾ NGỪNG_AIRBAG
Biểu thị tính năng bật và tắt khả năng của ghế để triển khai (các) túi khí khi được kích hoạt (ví dụ: trong trường hợp va chạm). Nếu true
, điều đó có nghĩa là túi khí của ghế đang bật và:
nếu được kích hoạt, chúng sẽ triển khai. Nếu là true
, túi khí của ghế sẽ bị tắt và không bung ra trong bất kỳ trường hợp nào. Thuộc tính này không cho biết túi khí có được triển khai hay không.
Bạn có thể thiết lập thuộc tính này thành VehiclePropertyAccess.READ
chỉ có thể đọc để
các mối lo ngại về quy định hoặc sự an toàn.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
SEAT_BACKREST_ANGLE_1_MOVE
Góc tựa lưng ghế 1 lần di chuyển. maxInt32Value
và minInt32Value
trong
mỗi VehicleAreaConfig
phải được xác định. Tất cả các số nguyên trong khoảng
minInt32Value
và maxInt32Value
phải được hỗ trợ.
maxInt32Value
biểu thị tốc độ di chuyển tối đa của tựa lưng ghế ngồi trong khi
câu cá về phía trước. minInt32Value
thể hiện tốc độ di chuyển tối đa của tựa lưng khi ngả.
Giá trị tuyệt đối lớn hơn, dù là dương hay âm, đều cho biết tốc độ di chuyển nhanh hơn. Khi tựa lưng ghế đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu giá trị của SEAT_BACKREST_ANGLE_1_MOVE
là 0, thì không có chuyển động nào xảy ra.
Thuộc tính này được biểu thị trong phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_BACKREST_ANGLE_1_POS
Góc tựa lưng ghế 1 vị trí. Góc tựa lưng 1 là bộ truyền động gần nhất với đáy của
ghế. maxInt32Value
và minInt32Value
trong
Bạn phải định nghĩa VehicleAreaConfig
. Tất cả số nguyên nằm trong khoảng minInt32Value
và maxInt32Value
phải được hỗ trợ. minInt32Value
cho biết
vị trí ngả hoàn toàn của tựa lưng ghế so với bộ truyền động ở cuối ghế. maxInt32Value
cho biết vị trí thẳng đứng hoặc hướng về phía trước nhất của tựa lưng ghế liên quan đến bộ truyền động ở đáy ghế.
Các giá trị trong khoảng từ minInt32Value
đến maxInt32Value
cho biết quá trình chuyển đổi
trạng thái nằm giữa chỗ ngả hoàn toàn cũng như vị trí thẳng đứng và tiến lên.
Thuộc tính này được biểu diễn dưới dạng dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_BACKREST_ANGLE_2_MOVE
Di chuyển góc tựa lưng ghế 2. maxInt32Value
và minInt32Value
trong mỗi đường dẫn
Bạn phải định nghĩa VehicleAreaConfig
. Tất cả số nguyên nằm trong khoảng minInt32Value
và maxInt32Value
phải được hỗ trợ.
maxInt32Value
thể hiện tốc độ di chuyển tối đa của tựa lưng ghế trong khi nghiêng về phía trước. minInt32Value
biểu thị tốc độ di chuyển tối đa của ghế
tựa lưng trong khi ngả lưng.
Giá trị tuyệt đối lớn hơn (là số dương hoặc âm) cho biết tốc độ di chuyển nhanh hơn. Khi tựa lưng ghế đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu giá trị cho
SEAT_BACKREST_ANGLE_2_MOVE
hiện ở mức 0 và không có chuyển động nào đang diễn ra.
Thuộc tính này được biểu thị dưới dạng phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_BACKREST_ANGLE_2_POS
Vị trí góc 2 của tựa lưng ghế. Góc tựa lưng 2 là bộ truyền động tiếp theo hướng lên từ đáy người dùng.
Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig
. Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết vị trí ngả lưng ghế hoàn toàn so với bộ truyền động tiếp theo trong lưng ghế từ bộ truyền động ở cuối ghế (xem SEAT_BACKREST_ANGLE_1_POS
để biết thông tin chi tiết). maxInt32Value
cho biết vị trí thẳng đứng và phía trước nhất của tựa lưng ghế so với bộ truyền động tiếp theo trong tựa lưng từ bộ truyền động ở cuối ghế (xem SEAT_BACKREST_ANGLE_1_POS
để biết thông tin chi tiết).
Các giá trị trong khoảng từ minInt32Value
đến maxInt32Value
cho biết quá trình chuyển đổi
trạng thái nằm giữa vị trí ngả hoàn toàn cũng như vị trí thẳng đứng và tiến lên.
Thuộc tính này được biểu diễn dưới dạng dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SELT_BELT_BUCKLED
Đã thắt dây an toàn. "True" cho biết dây đai đã bị khóa. Quyền ghi cho biết trạng thái tự động của ghế bị giật
các chức năng khác nhau. Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM (Nhà sản xuất thiết bị gốc)
chỉ có thể triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SELT_BELT_HEIGHT_MOVE
Di chuyển chiều cao dây đai an toàn. maxInt32Value
và minInt32Value
trong mỗi đường dẫn
Bạn phải định nghĩa VehicleAreaConfig
. Tất cả số nguyên nằm trong khoảng minInt32Value
và maxInt32Value
phải được hỗ trợ.
maxInt32Value
thể hiện tốc độ di chuyển tối đa của điểm neo vai của dây an toàn khi di chuyển lên. minInt32Value
biểu thị tốc độ di chuyển tối đa của
neo sau của dây an toàn trong khi di chuyển xuống.
Giá trị tuyệt đối lớn hơn, dù là dương hay âm, đều cho biết tốc độ di chuyển nhanh hơn. Khi
dây an toàn đạt đến giới hạn vị trí, thì giá trị phải được đặt lại về 0. Nếu giá trị của
SEAT_BELT_HEIGHT_MOVE
là 0, không có chuyển động nào đang diễn ra.
Thuộc tính này được biểu thị dưới dạng phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_BELT_HEIGHT_POS
Vị trí chiều cao dây an toàn. Điều chỉnh điểm neo của dây đai vai.
maxInt32Value
và minInt32Value
trong VehicleAreaConfig phải được
xác định. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
đều phải là
được hỗ trợ.
minInt32Value
cho biết điểm neo vai của dây đai an toàn ở vị trí thấp nhất. maxInt32Value
cho biết điểm neo vai của dây đai an toàn ở vị trí cao nhất.
Các giá trị từ minInt32Value
đến maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí thấp nhất và cao nhất.
Thuộc tính này được biểu thị dưới dạng một dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_CUSHION_SIDE_SUPPORT_MOVE
Biểu thị thuộc tính về hướng di chuyển và tốc độ của tấm đỡ bên đệm ngồi.
Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig. Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
thể hiện tốc độ di chuyển tối đa của phần đỡ bên đệm ghế khi tăng rộng (ví dụ: phần đỡ đang giảm). minInt32Value
đại diện cho tốc độ di chuyển tối đa của phần đỡ bên đệm ghế khi trở nên hẹp hơn (ví dụ: phần đỡ đang tăng lên).
Giá trị tuyệt đối lớn hơn (dù dương hoặc âm) cho biết tốc độ di chuyển nhanh hơn. Khi giá đỡ bên đệm ghế đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu giá trị của
SEAT_CUSHION_SIDE_SUPPORT_MOVE
là 0 thì không có chuyển động nào xảy ra.
Thuộc tính này được biểu thị dưới dạng một phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
SEAT_CUSHION_SIDE_SUPPORT_POS
Đại diện cho thuộc tính của vị trí tựa hông của ghế (phía đệm dưới cùng).
Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
cho biết tấm đỡ bên đệm ngồi nằm ở vị trí rộng nhất (ví dụ:
mức hỗ trợ thấp nhất). minInt32Value
cho biết phần đỡ bên của đệm ghế ở vị trí mỏng nhất (ví dụ: phần đỡ nhiều nhất).
Các giá trị nằm giữa minInt32Value
và maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí mỏng nhất và rộng nhất.
Thuộc tính này được biểu thị dưới dạng một dải vị trí tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
triển khai dưới dạng <covehiclepropertyaccess.read< mã=""> .</covehiclepropertyaccess.read<>
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
SEAT_DEPTH_MOVE
Di chuyển theo chiều sâu của ghế.
maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig phải được
xác định. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
đều phải là
được hỗ trợ.
maxInt32Value
thể hiện tốc độ di chuyển tối đa của ghế trong khi đi sâu hơn. minInt32Value
thể hiện tốc độ di chuyển tối đa của ghế trong khi đi nông hơn.
Giá trị tuyệt đối lớn hơn, dù là dương hay âm, đều cho biết tốc độ di chuyển nhanh hơn. Khi
tựa lưng của ghế đạt giới hạn về vị trí, thì giá trị phải được đặt lại về 0. Nếu giá trị cho
SEAT_DEPTH_MOVE
hiện ở mức 0 và không có chuyển động nào đang diễn ra.
Thuộc tính này được biểu thị dưới dạng phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_DEPTH_POS
Vị trí chiều sâu của ghế. Đặt chiều sâu ghế, khoảng cách từ tựa lưng đến cạnh trước của ghế.
Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết ghế đang ở vị trí thấp nhất (ví dụ: vị trí có khoảng cách nhỏ nhất giữa mép trước của đệm ghế và cuối ghế).
maxInt32Value
cho biết ghế nằm ở vị trí sâu nhất (ví dụ: vị trí có
khoảng cách lớn nhất giữa mép trước của đệm ngồi và mặt sau của ghế).
Các giá trị nằm giữa minInt32Value
và maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí nông nhất và sâu nhất.
Thuộc tính này được biểu diễn dưới dạng dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể triển khai thuộc tính này dưới dạng <covehiclepropertyaccess.read< code=""> only..</covehiclepropertyaccess.read<>
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_EASY_ACCESS_ENABLED
Đại diện cho thuộc tính cho tính năng truy cập dễ dàng của Chỗ ngồi. Nếu đặt là true, ghế sẽ tự động được điều chỉnh
để giúp người ngồi trên xe dễ dàng ra vào xe. Mỗi mã khu vực phải ánh xạ đến
vị trí mà người dùng đang cố gắng truy cập/thoát với sự trợ giúp của tính năng truy cập dễ dàng.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
triển khai dưới dạng <covehiclepropertyaccess.read< mã=""> .</covehiclepropertyaccess.read<>
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
SEAT_FOOTWELL_LIGHTS_THOÁT_KHOẢNH
Biểu thị thuộc tính cho trạng thái đèn chân ghế. SEAT_FOOTWELL_LIGHTS_STATE
phản ánh trạng thái hiện tại của đèn tại bất kỳ thời điểm nào. Điều này khác với chức năng của
SEAT_FOOTWELL_LIGHTS_SWITCH
biểu thị vị trí của công tắc điều khiển đèn.
Do đó, SEAT_FOOTWELL_LIGHTS_STATE
có thể không khớp với giá trị của SEAT_FOOTWELL_LIGHTS_SWITCH
(ví dụ: SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
và SEAT_FOOTWELL_LIGHTS_SWITCH=ON
).
Bạn chỉ nên triển khai thuộc tính này nếu giá trị của SEAT_FOOTWELL_LIGHTS_STATE
có thể khác với giá trị của CABIN_LIGHTS_STATE.
Đối với mỗi mã khu vực được hỗ trợ, bạn phải xác định VehicleAreaConfig#supportedEnumValues trừ khi tất cả giá trị enum của VehicleLightState đều được hỗ trợ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleLightState
Loại đơn vị: N/A
Bản phát hành: Android 14
SEAT_FOOTWELL_LIGHTS_SWITCH
Đại diện cho thuộc tính của công tắc đèn ở chân ghế. SEAT_FOOTWELL_LIGHTS_SWITCH
biểu thị vị trí của nút chuyển điều khiển đèn. Điều này khác với chức năng của
SEAT_FOOTWELL_LIGHTS_STATE phản ánh trạng thái hiện tại của đèn tại bất kỳ thời điểm nào.
Do đó, SEAT_FOOTWELL_LIGHTS_SWITCH
có thể không khớp với giá trị của SEAT_FOOTWELL_LIGHTS_STATE (ví dụ: SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
và SEAT_FOOTWELL_LIGHTS_SWITCH=ON
).
Bạn chỉ nên triển khai thuộc tính này nếu giá trị của SEAT_FOOTWELL_LIGHTS_SWITCH có thể khác từ CABIN_LIGHTS_SWITCH.
Đối với mỗi mã khu vực được hỗ trợ, bạn phải xác định xeAreaConfig#supportedEnumValues trừ phi tất cả Hỗ trợ giá trị enum của VehicleLightSwitch.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: VehicleLightSwitch
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_FORE_AFT_MOVE
Di chuyển chỗ ngồi phía trước và phía sau. Thuộc tính này di chuyển toàn bộ ghế về phía trước/sau theo hướng mà ghế đang hướng đến.
Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig. Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
thể hiện tốc độ di chuyển tối đa của ghế khi di chuyển вперед. minInt32Value
biểu thị tốc độ di chuyển tối đa của ghế khi
lùi lại phía sau.
Giá trị tuyệt đối lớn hơn (dù dương hoặc âm) cho biết tốc độ di chuyển nhanh hơn. Khi
giấy phép đạt đến giới hạn vị trí, thì giá trị phải được đặt lại về 0. Nếu giá trị của SEAT_FORE_AFT_MOVE
là 0, thì không có chuyển động nào xảy ra.
Thuộc tính này được biểu thị dưới dạng phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_FORE_AFT_POS
Vị trí phía trước và phía sau. Đặt vị trí ghế ngồi về phía trước và phía sau.
Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig.
Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết ghế đang ở vị trí tuyến tính phía sau cùng.
maxInt32Value
cho biết ghế đang ở vị trí tuyến tính phía trước nhất. Các giá trị từ minInt32Value
đến maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí gần nhất và vị trí xa nhất.
Thuộc tính này được biểu thị dưới dạng một dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_HEADREST_ANGLE_MOVE
Di chuyển góc tựa đầu. Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig
. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
biểu thị tốc độ di chuyển tối đa của tựa đầu ghế trong khi
di chuyển theo tư thế thẳng đứng hoặc tiến lên. minInt32Value
thể hiện tốc độ di chuyển tối đa của tựa đầu ghế khi di chuyển vào vị trí nông.
Giá trị tuyệt đối lớn hơn (dù dương hoặc âm) cho biết tốc độ di chuyển nhanh hơn. Khi đầu tựa của ghế đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu giá trị của SEAT_HEADREST_ANGLE_MOVE
là 0, thì không có chuyển động nào xảy ra.
Thuộc tính này được biểu thị dưới dạng phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
triển khai dưới dạng <covehiclepropertyaccess.read< mã=""> ..</covehiclepropertyaccess.read<>
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_HEADREST_ANGLE_POS
Vị trí góc tựa đầu. maxInt32Value
và minInt32Value
trong
Bạn phải định nghĩa VehicleAreaConfig
. Tất cả số nguyên nằm trong khoảng minInt32Value
và maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết tựa đầu đang ở vị trí ngả hết cỡ. Chiến lược phát hành đĩa đơn
maxInt32Value
cho biết tựa đầu đang ở vị trí thẳng đứng và phía trước nhất.
Các giá trị trong khoảng từ minInt32Value
đến maxInt32Value
cho biết
trạng thái chuyển đổi giữa vị trí ngả hoàn toàn và vị trí thẳng đứng và tiến lên nhất.
Thuộc tính này được biểu diễn dưới dạng dải vị trí tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_HEADREST_FORE_AFT_MOVE
Di chuyển phía trước và phía sau tựa đầu. Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig
. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
biểu thị tốc độ di chuyển tối đa của tựa đầu ghế
trong khi tiếp tục. minInt32Value
biểu thị tốc độ di chuyển tối đa của
tựa đầu của ghế trong khi lùi lại.
Giá trị tuyệt đối lớn hơn, dù là dương hay âm, đều cho biết tốc độ di chuyển nhanh hơn. Khi đầu tựa của ghế đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu giá trị của
SEAT_HEADREST_FORE_AFT_MOVE
là 0 thì không có chuyển động nào xảy ra.
Thuộc tính này được biểu thị dưới dạng một phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_HEADREST_FORE_AFT_POS
Vị trí đầu tựa trước và sau. maxInt32Value
và minInt32Value
trong VehicleAreaConfig
. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết tựa đầu ở vị trí tuyến tính phía sau cùng.
maxInt32Value
cho biết tựa đầu đang ở vị trí tuyến tính về phía trước.
Các giá trị từ minInt32Value
đến maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí tiến và lùi.
Thuộc tính này được biểu diễn dưới dạng dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_HEADREST_HEIGHT_MOVE
Di chuyển chiều cao tựa đầu. Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig
. Tất cả số nguyên nằm trong khoảng minInt32Value
và maxInt32Value
phải được hỗ trợ.
maxInt32Value
biểu thị tốc độ di chuyển tối đa của tựa đầu ghế trong khi
di chuyển lên. minInt32Value
thể hiện tốc độ di chuyển tối đa của tựa đầu trong khi di chuyển xuống.
Giá trị tuyệt đối lớn hơn (dù dương hoặc âm) cho biết tốc độ di chuyển nhanh hơn. Một lần
tựa đầu của ghế đạt đến giới hạn về vị trí, thì giá trị phải được đặt lại về 0. Nếu giá trị của SEAT_HEADREST_HEIGHT_MOVE
là 0, thì không có chuyển động nào xảy ra.
Thuộc tính này được biểu thị dưới dạng một phạm vi tốc độ chuyển động tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_HEADREST_HEIGHT_POS
(Không dùng nữa) Vị trí chiều cao tựa đầu.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_HEADREST_HEIGHT_POS_V2
Vị trí chiều cao tựa đầu. Đặt chiều cao tựa đầu cho các ghế được hỗ trợ. VehiclePropConfig.areaConfigs chỉ định những ghế ngồi được hỗ trợ.
maxInt32Value
và minInt32Value
trong VehicleAreaConfig phải được
xác định. Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết tựa đầu đang ở vị trí thấp nhất. Chiến lược phát hành đĩa đơn
maxInt32Value
cho biết tựa đầu đang ở vị trí cao nhất.
Các giá trị nằm giữa minInt32Value
và maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí thấp nhất và cao nhất.
Thuộc tính này được biểu thị dưới dạng một dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
SEAT_HEIGHT_MOVE
Di chuyển chiều cao ghế. maxInt32Value
và minInt32Value
trong mỗi đường dẫn
Bạn phải xác định VehicleAreaConfig. Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
biểu thị tốc độ di chuyển tối đa của ghế khi di chuyển lên.
minInt32Value
thể hiện tốc độ di chuyển tối đa của ghế khi di chuyển xuống.
Giá trị tuyệt đối lớn hơn (dù dương hoặc âm) cho biết tốc độ di chuyển nhanh hơn. Khi chỗ ngồi đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu giá trị của
Giá trị của SEAT_HEIGHT_MOVE
là 0 và không có chuyển động nào.
Thuộc tính này được biểu thị dưới dạng một phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_HEIGHT_POS
Vị trí chiều cao ghế ngồi. maxInt32Value
và minInt32Value
trong
Bạn phải xác định VehicleAreaConfig. Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết ghế đang ở vị trí thấp nhất. Chiến lược phát hành đĩa đơn
maxInt32Value
cho biết ghế đang ở vị trí cao nhất.
Các giá trị nằm giữa minInt32Value
và maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí thấp nhất và cao nhất.
Thuộc tính này được biểu thị dưới dạng một dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_LUMBAR_FORE_AFT_MOVE
Cử động tạt trước và sau. maxInt32Value
và minInt32Value
trong mỗi đường dẫn
Bạn phải xác định VehicleAreaConfig. Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
thể hiện tốc độ di chuyển tối đa của phần đỡ thắt lưng của ghế khi di chuyển về phía trước. minInt32Value
biểu thị tốc độ di chuyển tối đa của
tựa lưng của ghế trong khi di chuyển về phía sau.
Giá trị tuyệt đối lớn hơn (dù dương hoặc âm) cho biết tốc độ di chuyển nhanh hơn.
Khi giá đỡ vùng thắt lưng của ghế đạt đến giới hạn về vị trí, giá trị phải được đặt lại về 0.
Nếu giá trị của SEAT_LUMBAR_FORE_AFT_MOVE
là 0 thì không có chuyển động nào xảy ra.
Thuộc tính này được biểu thị dưới dạng một phạm vi tốc độ chuyển động tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_LUMBAR_FORE_AFT_POS
Vị trí trước và sau của gỗ. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig. Tất cả số nguyên từ minInt32Value
đến
maxInt32Value
phải được hỗ trợ.
minInt32Value
cho biết phần hỗ trợ thắt lưng ở vị trí phía sau nhất (ví dụ: vị trí ít hỗ trợ nhất). maxInt32Value
biểu thị phần thắt lưng
hỗ trợ nằm ở vị trí phía trước nhiều nhất (ví dụ: vị trí hỗ trợ cao nhất).
Các giá trị trong khoảng từ minInt32Value
đến maxInt32Value
cho biết quá trình chuyển đổi
giữa vị trí phía trước và phía sau.
Thuộc tính này được biểu thị dưới dạng dải vị trí tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Loại quyền truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
[SEAT_LUMBAR_SIDE]
Di chuyển điểm đỡ lưng dưới. Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig
. Tất cả số nguyên nằm trong khoảng minInt32Value
và maxInt32Value
phải được hỗ trợ.
maxInt32Value
thể hiện tốc độ di chuyển tối đa của phần hỗ trợ thắt lưng của ghế trong khi mở rộng. minInt32Value
biểu thị vận động tối đa
tốc độ của tấm đỡ lưng bên của ghế trong khi mỏng hơn.
Giá trị tuyệt đối lớn hơn (dù dương hoặc âm) cho biết tốc độ di chuyển nhanh hơn. Khi giá trị hỗ trợ thắt lưng của ghế đạt đến giới hạn vị trí, giá trị này phải được đặt lại về 0. Nếu giá trị của SEAT_LUMBAR_SIDE_SUPPORT_MOVE
là 0, thì không có chuyển động nào xảy ra.
Thuộc tính này được biểu thị dưới dạng một phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Loại quyền truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_LUMBAR_SIDE_SUPPORT_POS
Vị trí đỡ lưng bên hông. maxInt32Value
và minInt32Value
trong
Bạn phải xác định xeAreaConfig. Tất cả số nguyên từ minInt32Value
đến
maxInt32Value
phải được hỗ trợ. minInt32Value
cho biết phần hỗ trợ thắt lưng ở vị trí mỏng nhất (ví dụ: hỗ trợ nhiều nhất). Chiến lược phát hành đĩa đơn
maxInt32Value
cho biết tấm đỡ phía thắt lưng đang ở vị trí rộng nhất (đối với
chẳng hạn như hỗ trợ ít nhất).
Các giá trị trong khoảng từ minInt32Value
đến maxInt32Value
cho biết quá trình chuyển đổi
trạng thái giữa vị trí mỏng nhất và rộng nhất.
Thuộc tính này được biểu diễn dưới dạng dải vị trí tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Loại quyền truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
SEAT_LUMBAR_ANGLE_MOVE
Biểu thị thuộc tính cho hướng và tốc độ di chuyển dọc của phần hỗ trợ thắt lưng của ghế.
maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig phải được
xác định. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
đều phải là
được hỗ trợ. maxInt32Value
cho biết tấm đỡ thắt lưng đang di chuyển với tốc độ nhanh nhất
tốc độ tăng lên. minInt32Value
cho biết phần hỗ trợ thắt lưng đang di chuyển với tốc độ xuống nhanh nhất.
Giá trị tuyệt đối lớn hơn (dù dương hoặc âm) cho biết tốc độ di chuyển nhanh hơn. Khi giá đỡ bên đệm ngồi đạt giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu giá trị của SEAT_LUMBAR_VERTICAL_MOVE là 0, thì không có chuyển động nào xảy ra.
Thuộc tính này được biểu thị dưới dạng phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
SEAT_LUMBAR_VERTICAL_POS
Biểu thị thuộc tính cho vị trí dọc của đệm đỡ thắt lưng của ghế. Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig. Tất cả các số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
cho biết vị trí cao nhất của phần đỡ thắt lưng.
minInt32Value
cho biết vị trí thấp nhất của giá đỡ thắt lưng.
Các giá trị trong khoảng từ minInt32Value
đến maxInt32Value
cho biết quá trình chuyển đổi
trạng thái giữa vị trí thấp nhất và cao nhất.
Thuộc tính này được biểu thị dưới dạng một dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_MEMORY_SELECT
Tham số này chọn giá trị đặt trước của bộ nhớ để dùng cho việc chọn vị trí ghế ngồi. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig.
Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
minInt32Value
luôn bằng 0 và maxInt32Value
xác định
số khe thẻ nhớ đặt trước sẵn có của ghế (ví dụ: numSeatPresets - 1). Ví dụ: nếu ghế lái có ba chế độ cài đặt trước bộ nhớ, thì maxInt32Value
là hai. Khi người dùng chọn một giá trị đặt trước, số giá trị đặt trước mong muốn (0, 1 hoặc 2) sẽ được đặt.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_MEMORY_SET
Chế độ cài đặt này cho phép người dùng lưu chế độ cài đặt vị trí ghế ngồi hiện tại vào giá trị đặt trước đã chọn
vị trí. maxInt32Value
và minInt32Value
trong
Bạn phải định nghĩa VehicleAreaConfig
. minInt32Value
phải là 0 và
maxInt32Value
cho mỗi vị trí chỗ ngồi phải khớp với maxInt32Value
cho
SEAT_MEMORY_SELECT
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SET_OCCUPANCY
Cho biết có người ngồi tại một chỗ cụ thể hay không, dựa trên khả năng xác định tốt nhất của ô tô. Hợp lệ
các giá trị đều nằm trong enum VehicleSeatOccupancyState
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleSeatOccupancyState
Loại đơn vị: N/A
Bản phát hành: Android 13
SEAT_TILT_MOVE
Di chuyển độ nghiêng của ghế. Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig. Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ. maxInt32Value
thể hiện tốc độ di chuyển tối đa của cạnh trước của ghế trong khi di chuyển lên. minInt32Value
thể hiện tốc độ di chuyển tối đa của cạnh trước của ghế khi di chuyển xuống.
Giá trị tuyệt đối lớn hơn, dù là dương hay âm, đều cho biết tốc độ di chuyển nhanh hơn. Khi phần đáy ghế đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu là SEAT_TILT_MOVE giá trị hiện đang là 0, không có chuyển động nào đang diễn ra.
Thuộc tính này được biểu thị dưới dạng một phạm vi tốc độ di chuyển tương đối được chỉ định.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SEAT_TILT_POS
Vị trí nghiêng ghế. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig. Tất cả số nguyên từ minInt32Value
đến
maxInt32Value
phải được hỗ trợ. minInt32Value
cho biết đáy ghế được nghiêng ở vị trí góc thấp nhất. Vị trí này tương ứng với cạnh trước của ghế ở vị trí thấp nhất có thể so với phần cuối của ghế.
maxInt32Value
cho biết đáy ghế được đặt ở vị trí góc cao nhất.
Vị trí này tương ứng với cạnh trước của ghế ở vị trí cao nhất có thể so với phần cuối của ghế.
Các giá trị nằm giữa minInt32Value
và maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí thấp nhất và cao nhất.
Thuộc tính này được biểu thị dưới dạng một dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
SEI_WALK_IN_POS
Biểu thị thuộc tính cho biết vị trí đi bộ hiện tại của ghế. minInt32Value
cho biết vị trí ghế thông thường. minInt32Value
phải là 0. maxInt32Value
cho biết ghế ở vị trí không cần bước chân.
Các giá trị trong khoảng từ minInt32Value
đến maxInt32Value
cho biết quá trình chuyển đổi
trạng thái giữa vị trí bình thường và vị trí bước vào.
Thuộc tính này được biểu diễn dưới dạng dải vị trí tương đối được chỉ định.
Mã khu vực phải khớp với chỗ ngồi thực sự di chuyển khi tính năng tự động kích hoạt, chứ không phải chỗ ngồi dự kiến mà hành khách sẽ ngồi.
Thuộc tính này được định nghĩa là xePropertyAccess.READ_READ, nhưng nhà sản xuất thiết bị gốc (OEM) có thể
triển khai quyền này dưới dạng VehiclePropertyAccess.READ.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SHUTDOWN_REQUEST
Yêu cầu đầu phát trung tâm dừng lại.
Đây là yêu cầu cần thiết để thực hiện một nhiệm vụ khi đầu phát trung tâm bị tắt nguồn (tính năng nhiệm vụ từ xa). Sau khi bật đầu phát trung tâm để thực thi tác vụ, đầu phát trung tâm sẽ tắt. Đơn vị đầu phát sẽ gửi thông báo này sau khi tác vụ hoàn tất.
Thuộc tính này không áp dụng khi người dùng muốn tắt đầu phát trung tâm.
Quá trình này thường bao gồm việc thông báo cho một hệ thống riêng bên ngoài đầu phát trung tâm (chẳng hạn như nguồn điện bộ điều khiển) để chuẩn bị tắt đầu phát trung tâm.
Hệ thống bên ngoài phải xác thực rằng yêu cầu này hợp lệ bằng cách kiểm tra xem xe có đang ở sử dụng. Nếu người dùng vào xe sau khi hệ thống gửi SHUTDOWN_REQUEST, thì hệ thống phải bỏ qua yêu cầu này. Bạn nên lưu trữ thuộc tính VehicleInUse trong bộ điều khiển nguồn và hiển thị giao diện đó thông qua thuộc tính VEHICLE_IN_USE. Bạn phải bỏ qua yêu cầu tắt nguồn nếu VehicleInUse là đúng.
Nếu được cho phép, hệ thống bên ngoài sẽ gửi tín hiệu tắt máy đến đầu phát trung tâm, khiến VHAL gửi thông báo SHUTDOWN_PREPARE đến Android. Sau đó, Android sẽ bắt đầu quá trình tắt bằng cách xử lý tin nhắn.
Thuộc tính này chỉ dùng để đưa ra yêu cầu và chỉ hỗ trợ ghi. Mỗi khi giá trị thuộc tính này được đặt, yêu cầu tắt sẽ được đưa ra bất kể giá trị thuộc tính hiện tại là gì. Giá trị thuộc tính hiện tại không có ý nghĩa.
Vì thuộc tính này chỉ có thể ghi nên bạn không được phép đăng ký và không có sự kiện thay đổi thuộc tính nào được tạo.
Giá trị cần đặt cho biết tuỳ chọn tắt máy, giá trị này phải là một trong các giá trị {@code VehicleApPowerStateShutdownParam}
. Ví dụ: VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY
. Tuỳ chọn tắt máy này có thể không được thực hiện nếu hệ thống không hỗ trợ tuỳ chọn đó. Trong trường hợp này, hệ thống sẽ không trả về lỗi.
Đối với thông tin cấu hình, VehiclePropConfig.configArray
phải có cờ bit
kết hợp các giá trị trong {@code VehicleApPowerStateConfigFlag}
để cho biết tắt máy nào
được hỗ trợ.
Trả về lỗi nếu không gửi được yêu cầu tắt máy cho hệ thống khác.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: VehicleApPowerStateShutdownParam
>
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
Hàm STEELING_WHEEL_DEPTH_MOVE
Độ sâu di chuyển của vô lăng. maxInt32Value
và minInt32Value
phải xác định trong VehicleAreaConfig. Tất cả giá trị từ minInt32Value
đến maxInt32Value
phải được hỗ trợ.
maxInt32Value
cho biết vô lăng đang di chuyển ra khỏi người lái. Chiến lược phát hành đĩa đơn
minInt32Value
cho biết vô lăng đang di chuyển về phía người lái.
Số nguyên lớn hơn, dương hoặc âm, cho biết tốc độ di chuyển nhanh hơn. Khi vô lăng đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu giá trị của STEERING_WHEEL_DEPTH_MOVE
hiện là 0, thì không có chuyển động nào đang diễn ra.
Thuộc tính này được biểu thị dưới dạng một dải ô tương đối được chỉ định tốc độ di chuyển.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
Hàm STEESTEP_WHEEL_DEPTH_POS
Vị trí chiều sâu của vô lăng. Tất cả mã nhận dạng duy nhất của các thuộc tính vô lăng đều bắt đầu từ 0x0BE0.
Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig. Tất cả giá trị từ minInt32Value
đến maxInt32Value
đều phải được hỗ trợ. maxInt32Value
cho biết vị trí vô lăng xa người lái xe nhất. minInt32Value
cho biết vị trí vô lăng gần với
trình điều khiển.
Các giá trị nằm giữa minInt32Value
và maxInt32Value
cho biết trạng thái chuyển đổi giữa
Thuộc tính này được biểu thị dưới dạng dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
ĐÃ_BẬT_CÁCH_BÁO_TĂNG_Hàm_EASY_ACCESS_ENABLED
Đã bật tính năng dễ dàng truy cập bằng vô lăng. Nếu đúng, vô lăng của người lái sẽ tự động được điều chỉnh để giúp người lái dễ dàng lên và xuống xe hơn.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
Hàm STEELING_WHEEL_HEIGHT_MOVE
Di chuyển chiều cao của vô lăng. Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig. Tất cả các giá trị từ minInt32Value
đến
maxInt32Value
phải được hỗ trợ.
maxInt32Value
cho biết vô lăng đang di chuyển lên. minInt32Value
cho biết vô lăng đang di chuyển xuống.
Số nguyên lớn hơn, dương hoặc âm, cho biết tốc độ di chuyển nhanh hơn. Khi vô lăng đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu
Giá trị của STEERING_WHEEL_HEIGHT_MOVE
hiện là 0, tức là không có chuyển động nào
hiện đang diễn ra.
Thuộc tính này được biểu thị dưới dạng một dải ô tương đối được chỉ định tốc độ di chuyển.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
THÉP_WHEEL_HEIGHT_POS
Vị trí chiều cao của vô lăng.
maxInt32Value
và minInt32Value
trong VehicleAreaConfig phải được
xác định. Tất cả các giá trị trong khoảng từ minInt32Value
đến maxInt32Value
phải là
được hỗ trợ. maxInt32Value
cho biết vô lăng đang ở mức cao nhất
vị trí. minInt32Value
cho biết vô lăng ở vị trí thấp nhất.
Các giá trị trong khoảng từ minInt32Value
đến maxInt32Value
cho biết
trạng thái chuyển đổi giữa vị trí thấp nhất và cao nhất.
Thuộc tính này được biểu diễn dưới dạng dải vị trí tương đối được chỉ định.
Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
STEERING_WHEEL_LIGHTS_STATE
Trạng thái đèn vô lăng. Biểu thị trạng thái hiện tại của đèn trên vô lăng. Đây là
khác với STEERING_WHEEL_LIGHTS_SWITCH
biểu thị vị trí của nút chuyển
đang điều khiển đèn. Do đó, STEERING_WHEEL_LIGHTS_STATE
có thể không khớp với giá trị của
STEERING_WHEEL_LIGHTS_SWITCH
(ví dụ:
và
STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
STEERING_WHEEL_LIGHTS_STATE=ON
).
Bạn chỉ nên triển khai thuộc tính này nếu giá trị của STEERING_WHEEL_LIGHTS_STATE
có thể khác với giá trị của CABIN_LIGHTS_STATE.
Đối với mã khu vực toàn cầu (0), bạn phải xác định VehicleAreaConfig#supportedEnumValues trừ phi tất cả Hỗ trợ giá trị enum của VehicleLightState.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleLightState
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
Hàm STEEANCE_WHEEL_LIGHTS_SWITCH
Công tắc đèn trên vô lăng. Biểu thị vị trí của công tắc điều khiển chế độ lái
đèn bánh xe. Tham số này khác với , biểu thị trạng thái hiện tại
của đèn trên vô lăng. Do đó, STEERING_WHEEL_LIGHTS_SWITCH
có thể không khớp
giá trị của STEERING_WHEEL_LIGHTS_STATE
. Ví dụ:
STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
và
STEERING_WHEEL_LIGHTS_STATE=ON
.
Bạn chỉ nên triển khai thuộc tính này nếu giá trị của STEERING_WHEEL_LIGHTS_SWITCH
có thể khác với giá trị của CABIN_LIGHTS_SWITCH
.
Đối với mã khu vực chung (0), VehicleAreaConfig#supportedEnumValues
phải là
xác định trừ khi hỗ trợ tất cả giá trị enum của VehicleLightSwitch.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: VehicleLightSwitch
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
THÉP_KHOE_HÀNG
Đã khoá vô lăng. Nếu đúng, vị trí của vô lăng sẽ bị khoá và không thể thay đổi.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
triển khai dưới dạng <covehiclepropertyaccess.read< mã=""> ./p>
</covehiclepropertyaccess.read<>
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
Hàm STEE Vương_WHEEL_THEFT_LOCK_ENABLED
Đã bật tính năng khoá chống trộm vô lăng. Nếu đúng, vô lăng sẽ tự động khoá để ngăn chặn hành vi trộm cắp trong một số trường hợp. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE, nhưng OEM chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
STORAGE_ENCRYPTION_BINDING_ nhịp
Số ngẫu nhiên liên kết mã hoá bên ngoài. Giá trị này được kết hợp với khoá mã hoá bộ nhớ khoá cục bộ. Thuộc tính này chứa 16 byte và dự kiến sẽ được duy trì trên một ECU riêng biệt với IVI. Ban đầu, thuộc tính do AAOS đặt. Người này tạo thuộc tính bằng CSRNG. AAOS sau đó sẽ đọc thuộc tính này vào các lần khởi động tiếp theo. Hạt liên kết dự kiến sẽ được duy trì một cách đáng tin cậy. Mọi tổn thất về hạt giống đều dẫn đến việc đặt lại IVI về trạng thái ban đầu.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SUPPORT_CUSTOMIZE_VENDOR_PERMISSION
Hỗ trợ tuỳ chỉnh quyền cho tài sản của nhà cung cấp.
Triển khai thuộc tính này nếu VHAL hỗ trợ tính năng tuỳ chỉnh quyền của nhà cung cấp.
VehiclePropConfig.configArray được dùng để cho biết các thuộc tính và quyền của nhà cung cấp được chọn cho thuộc tính nhà cung cấp này. Quyền này phải là một trong các enum trong VehicleVendorPermission.
configArray được đặt như sau, configArray[n]: propId : property ID
cho
thuộc tính của nhà cung cấp trong đó configArray[n+1] là một enum trong VehicleVendorPermission và cho biết
quyền đọc giá trị của thuộc tính.
configArray[n+2] là một enum trong VehicleVendorPermission và cho biết quyền ghi giá trị của thuộc tính. Ví dụ:
configArray: { vendor_prop_1, PERMISSION_VENDOR_SEAT_READ, PERMISSION_VENDOR_SEAT_WRITE, vendor_prop_2, PERMISSION_VENDOR_INFO, PERMISSION_NOT_ACCESSIBLE, }
Nếu thuộc tính của nhà cung cấp không nằm trong mảng này, thì chúng sẽ có quyền mặc định của nhà cung cấp. Nếu nhà cung cấp đã chọn PERMISSION_NOT_ACCESSIBLE, Android không có quyền truy cập vào thuộc tính này. Trong ví dụ này, Android không thể ghi giá trị cho provider_prop_2.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
SUPPORTED_PROPERTY_IDS
(Không dùng nữa) Danh sách tất cả mã tài sản được hỗ trợ.
Thay đổi chế độ: STATIC
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
NGƯỜI DÙNG CHUYỂN ĐỔI
Xác định yêu cầu chuyển đổi người dùng Android trên nền trước.
Hệ thống Android chủ yếu sử dụng thuộc tính này để thông báo cho HAL rằng người dùng Android ở nền trước hiện tại đang chuyển đổi, nhưng HAL cũng có thể sử dụng thuộc tính này để yêu cầu hệ thống Android chuyển đổi người dùng. Khi Android đưa ra yêu cầu, hệ thống sẽ đặt một VehiclePropValue và HAL phải phản hồi bằng sự kiện thay đổi thuộc tính. Khi HAL đưa ra yêu cầu, nó phải đồng thời thực hiện điều đó thông qua sự kiện thay đổi thuộc tính (sự khác biệt chính là id yêu cầu được tích cực ở trường hợp trước và âm ở trường hợp sau). SwitchUserMessageType cũng khác.
Định dạng của cả hai yêu cầu đều được xác định bằng SwitchUserRequest và định dạng của phản hồi (khi cần thiết) được xác định bởi SwitchUserResponse. Cách HAL (hoặc hệ thống Android) nên tiến hành phụ thuộc cho loại thông báo (được xác định bằng thông số SwitchUserMessageType), như định nghĩa dưới đây.LEGACY_ANDROID_SWITCH
Do hệ thống Android gọi để cho biết người dùng Android sắp thay đổi, khi yêu cầu thay đổi được thực hiện theo cách không được tích hợp với HAL (ví dụ: thông qua adb shell am chuyển đổi người dùng). HAL có thể chuyển đổi người dùng nội bộ một lần ứng dụng sẽ nhận được yêu cầu này nhưng không cần trả lời hệ thống Android. Nếu Không thể thay đổi người dùng nội bộ vì một lý do nào đó thì người dùng phải đợi Lệnh gọiSWITCH_USER(type=ANDROID_POST_SWITCH)
để khôi phục (ví dụ: lệnh gọi này có thể gây ra sự cốSWITCH_USER(type=VEHICLE_REQUEST)
để chuyển về người dùng trước đó). Lý tưởng nhất thì gói thuê bao đó sẽ không bao giờ bị lỗi (vì việc chuyển về có thể khiến người dùng cuối nhầm lẫn).
Ví dụ: nếu hệ thống có người dùng (0, 10, 11) và nó đang chuyển từ 0 sang 11 (không có cờ nào trong số họ có cờ đặc biệt), yêu cầu sẽ là:
int32[0]
42 // mã yêu cầuint32[1]
1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCHint32[2]
11 // mã nhận dạng người dùng mục tiêuint32[3]
0 // nhắm mục tiêu cờ người dùng (không có)int32[4]
10 // người dùng hiện tạiint32[5]
0 // cờ người dùng hiện tại (không có)int32[6]
3 // số người dùngint32[7]
0 // user #0 (mã nhận dạng người dùng Android 0)int32[8]
0 // cờ của người dùng #0 (không có)int32[9]
10 // người dùng 1 (Mã người dùng Android 10)int32[10]
0 // cờ của người dùng #1 (không có)int32[11]
11 // user #2 (Android user id 11)int32[12]
0 // cờ của người dùng #2 (không có)
ANDROID_SWITCH
Do hệ thống Android gọi để cho biết người dùng Android sắp thay đổi, nhưng Android sẽ chờ phản hồi của HAL (tối đa một khoảng thời gian) trước khi tiếp tục. HAL phải chuyển đổi người dùng nội bộ sau khi nhận được yêu cầu này, sau đó phản hồi lại Android bằngSWITCH_USER(type=VEHICLE_RESPONSE)
cho biết liệu người dùng nội bộ đã được chuyển đổi hay chưa (thông qua enum SwitchUserStatus). Ví dụ: nếu Android có người dùng (0, 10, 11) và đang chuyển từ 10 sang 11 (trong đó không có người dùng nào có cờ đặc biệt), thì yêu cầu sẽ là:int32[0]
42 // mã yêu cầuint32[1]
2 // SwitchUserMessageType::ANDROID_SWITCHint32[2]
11 // mã nhận dạng người dùng mục tiêuint32[3]
0 // nhắm mục tiêu cờ người dùng (không có)int32[4]
10 // người dùng hiện tạiint32[5]
0 // cờ người dùng hiện tại (không có)int32[6]
3 // số lượng người dùngint32[7]
0 // người dùng đầu tiên (người dùng 0)int32[8]
1 // cờ người dùng đầu tiên (HỆ THỐNG)int32[9]
10 // người dùng thứ hai (người dùng 10)int32[10]
0 // cờ người dùng thứ hai (không có)int32[11]
11 // Người dùng thứ 3 (người dùng 11)int32[12]
0 // Cờ người dùng thứ 3 (không có)
Nếu yêu cầu thành công, HAL phải cập nhật thuộc tính bằng:
int32[0]
42 // mã yêu cầuint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
1 // status: SwitchUserStatus::SUCCESS
Nếu yêu cầu không thành công, phản hồi sẽ có dạng như sau:
int32[0]
42 // mã yêu cầuint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_REVIEWSint32[2]
2 // trạng thái: SwitchUserStatus::FAILURE string: "108-D'OH!"- Thông báo lỗi cụ thể của OEM
VEHICLE_RESPONSE
Được HAL gọi để cho biết liệu một yêu cầu thuộc loại ANDROID_SWITCH có tiếp tục hay huỷ. Xem thêm ANDROID_SWITCH.VEHICLE_REQUEST
Do HAL (Lớp trừu tượng phần cứng) gọi để yêu cầu người dùng Android trên nền trước hiện tại là đã chuyển. Điều này hữu ích trong trường hợp Android khởi động dưới dạng một người dùng, nhưng xe lại xác định người lái xe là một người dùng khác. Ví dụ: Người dùng A đã mở khoá ô tô bằng thiết bị điều khiển từ xa cầm tay của người dùng B. Yêu cầu INITIAL_USER_INFO trả về người dùng B, nhưng sau đó nhận dạng khuôn mặt hệ thống con con đã xác định người dùng là A. HAL đưa ra yêu cầu này thông qua sự kiện thay đổi thuộc tính (chuyển mã yêu cầu phủ định) và phản hồi của hệ thống Android là đưa ra Lệnh gọi ANDROID_POST_SWITCH có cùng mã yêu cầu. Ví dụ: nếu nền trước hiện tại Người dùng Android là 10 và HAL được yêu cầu chuyển sang 11, yêu cầu sẽ là:int32[0]
-108 // mã yêu cầuint32[1]
4 // messageType: SwitchUserMessageType::VEHICLE_REQUESTint32[2]
11 // Mã nhận dạng người dùng Android
Nếu yêu cầu thành công và Android có 3 người dùng (0, 10 và 11), thì phản hồi sẽ là:
int32[0]
-108 // mã yêu cầuint32[1]
5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCHint32[2]
11 // mã nhận dạng người dùng mục tiêuint32[3]
0 // nhắm mục tiêu cờ mã nhận dạng người dùng (không có)int32[4]
11 // người dùng hiện tạiint32[5]
0 // cờ người dùng hiện tại (không có)int32[6]
3 // số lượng người dùngint32[7]
0 // người dùng đầu tiên (người dùng 0)int32[8]
0 // cờ của người dùng lần đầu (không có)int32[9]
10 // người dùng giây (người dùng 10)int32[10]
4 // cờ người dùng thứ hai (không có)int32[11]
11 // người dùng thứ ba (người dùng 11)int32[12]
3 // cờ của người dùng thứ ba (không có)
Mã người dùng hiện tại và mã người dùng mục tiêu giống nhau. Nếu yêu cầu không thành công, thì hai giá trị này sẽ khác nhau. Ví dụ: người dùng mục tiêu sẽ là 11 và người dùng hiện tại sẽ vẫn là 10.
ANDROID_POST_SWITCH
Được hệ thống Android gọi sau khi yêu cầu chuyển đổi người dùng được thực hiện. Thuộc tính này được gọi sau các yêu cầu chuyển đổi thuộc bất kỳ loại nào (ví dụ: >code>LEGACY_ANDROID_SWITCH, >code>ANDROID_SWITCH hoặcVEHICLE_REQUEST
) và có thể dùng để xác định xem yêu cầu thành công hay không thành công.- Khi thành công, phương thức này sẽ được gọi khi người dùng Android ở trạng thái mở khoá và giá trị của mã nhận dạng người dùng hiện tại và người dùng mục tiêu trong phản hồi giống nhau. Đây là tương đương với việc nhận một Intent.ACTION_USER_UNLOCKED trong ứng dụng Android.
- Khi không thành công, hàm này sẽ được gọi ngay lập tức và giá trị của mã nhận dạng người dùng hiện tại và người dùng mục tiêu trong phản hồi sẽ khác nhau (vì người dùng hiện tại không thay đổi thành mục tiêu).
- Nếu một yêu cầu chuyển đổi mới được đưa ra trước khi HAL phản hồi yêu cầu trước đó hoặc trước đó người dùng đã được mở khóa, thì yêu cầu ANDROID_POST_SWITCH không được thực hiện. Ví dụ: trình điều khiển có thể vô tình chuyển sang người dùng không chính xác (có thông tin xác thực khoá), sau đó chuyển sang người dùng chính xác trước khi nhập thông tin xác thực.
HAL có thể cập nhật trạng thái nội bộ sau khi nhận được yêu cầu này, nhưng không cần trả lời hệ thống Android.
- Yêu cầu. N giá trị đầu tiên do
INITIAL_USER_INFO
xác định (trong đó giá trị yêu cầu cụ thể giá trị tại chỉ mục 1 làSwitchUserMessageType::ANDROID_POST_SWITCH
), sau đó là 2 giá trị khác cho mã nhận dạng người dùng mục tiêu (ví dụ: mã nhận dạng người dùng Android đã được yêu cầu chuyển sang) và cờ của tổ chức đó (như được xác định bởi Userflags). - Phản hồi: không có. Ví dụ: xem
VEHICLE_REQUEST
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
TIRE_PRESSURE
Áp suất lốp. Mỗi lốp xe được xác định theo cấu hình areaConfig.areaId. minFloatValue và maxFloatValue tương ứng được dùng để lưu trữ phạm vi áp lực do OEM đề xuất. Giá trị cho minFloatValue và maxFloatValue bạn phải xác định trong VehicleAreaConfig.
minFloatValue trong dữ liệu areaConfig thể hiện giới hạn dưới của lốp xe được đề xuất áp lực. maxFloatValue trong dữ liệu areaConfig thể hiện giới hạn trên của áp suất lốp được đề xuất. Ví dụ: AreaConfig cho biết áp suất của lốp trước bên trái từ 200.0kPa đến 240.0kPa.
.areaConfigs: { VehicleAreaConfig { .areaId: VehicleAreaWheel::LEFT_FRONT, .minFloatValue: 200.0, .maxFloatValue: 240.0, } }
Thay đổi chế độ: CONTINUOUS
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: VehicleUnit:KILOPASCAL
Bản phát hành: Android 13
TIRE_PRESSURE_DISPLAY_UNITS
Đơn vị áp suất lốp để hiển thị. Cho biết đơn vị mà ô tô đang sử dụng để hiển thị áp suất lốp cho người dùng. Ví dụ: PSI, Bar hoặc Kilopascal. VehiclePropConfig.configArray được dùng để cho biết các đơn vị hiển thị áp suất được hỗ trợ. Đơn vị áp suất được xác định trong VehicleUnit. Ví dụ: configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR
Nếu việc cập nhật TIRE_PRESSURE_DISPLAY_UNITS ảnh hưởng đến giá trị của các thuộc tính *_DISPLAY_UNITS khác,
thì các giá trị đó cũng phải được cập nhật và truyền đến khung AAOS.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
triển khai dưới dạng <covehiclepropertyaccess.read< mã=""> ./p>
</covehiclepropertyaccess.read<>
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: VehicleUnit
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
TRACTION_CONTROL_ACTIVE
Đặt thành true khi tính năng kiểm soát độ bám đường (TC) đang hoạt động và đặt lại thành false khi TC tắt. Chiến dịch này có thể được đặt không liên tục (xung) dựa trên trạng thái thời gian thực của hệ thống TC.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
TRAILER_PRESENT
Trả về trạng thái của xe kéo.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: TrailerState
Loại đơn vị: N/A
Bản phát hành: Android 13
Trạng thái
Trạng thái của tín hiệu rẽ của xe.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ
Loại enum: VehicleTurnSignal
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
NGƯỜI DÙNG_IDENTIFICATION_ASSOCIATION
Thuộc tính dùng để liên kết (hoặc truy vấn mối liên kết) người dùng hiện tại với các cơ chế nhận dạng dành riêng cho xe (chẳng hạn như chìa khoá thông minh).
Đây là một thuộc tính quản lý người dùng không bắt buộc. OEM vẫn có thể hỗ trợ quản lý người dùng mà không cần xác định thời gian đó. Trên thực tế, bạn có thể sử dụng thuộc tính này mà không cần hỗ trợ các thuộc tính cốt lõi liên quan đến người dùng các hàm được mô tả trên INITIAL_USER_INFO.
Để truy vấn mối liên kết, hệ thống Android sẽ lấy thuộc tính, truyền một VehiclePropValue chứa các loại mối liên kết đang được truy vấn, như được xác định bởi UserIdentificationGetRequest. HAL phải trả lại ngay lập tức, trả về VehiclePropValue kèm theo UserIdentificationResponse.
Lưu ý rằng việc nhận dạng người dùng diễn ra trong khi hệ thống khởi động. Việc triển khai VHAL Takehe chỉ nên trả về liên kết đã được xác định (chẳng hạn như khoá FOB dùng để mở khoá ô tô), thay vì bắt đầu một liên kết mới từ .
Để liên kết các loại, hệ thống Android sẽ đặt thuộc tính, truyền một VehiclePropValue chứa loại và giá trị của các mối liên kết đang được đặt, như được UserIdentificationSetRequest xác định.
Sau đó, HAL sử dụng sự kiện thay đổi thuộc tính (có VehiclePropValue được xác định bằng UserIdentificationResponse) cho biết trạng thái hiện tại của các loại sau yêu cầu.
Ví dụ: để truy vấn xem người dùng hiện tại (10) có liên kết với FOB đã mở khoá ô tô và cơ chế tuỳ chỉnh do OEM cung cấp hay không, yêu cầu sẽ là:
int32[0]
42 // mã yêu cầuint32[1]
10 (Mã nhận dạng người dùng Android)int32[2]
0 (Cờ người dùng Android)int32[3]
2 (số loại được truy vấn)int32[4]
1 (loại đầu tiên được truy vấn, UserIdentificationAssociationType::KEY_FOB)int32[5]
101 (loại thứ hai được truy vấn, UserIdentificationAssociationType::CUSTOM_1)
Nếu người dùng được liên kết với FOB nhưng không liên kết với cơ chế tuỳ chỉnh, thì phản hồi sẽ là:
int32[0]
42 // mã yêu cầuint32[1]
2 (số lượng liên kết trong phản hồi)int32[2]
1 (loại đầu tiên: UserIdentificationAssociationType::KEY_FOB)int32[3]
2 (giá trị đầu tiên: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)int32[4]
101 (loại đầu tiên: UserIdentificationAssociationType::CUSTOM_1)int32[5]
4 (giá trị thứ hai: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)
Sau đó, để liên kết người dùng với cơ chế tuỳ chỉnh, một yêu cầu đặt được thực hiện:
int32[0]
43 // mã yêu cầuint32[1]
10 (Mã nhận dạng người dùng Android)int32[2]
0 (Cờ người dùng Android)int32[3]
1 (số lượng mối liên kết đang được thiết lập)int32[4]
101 (loại đầu tiên: UserIdentificationAssociationType::CUSTOM_1)
Nếu yêu cầu thành công, phản hồi sẽ là:
int32[0]
43 // mã yêu cầuint32[1]
1 (số lượng liên kết trong phản hồi)int32[2]
101 (loại đầu tiên: UserIdentificationAssociationType::CUSTOM_1)int32[3]
1 (giá trị đầu tiên: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
Yêu cầu đặt thêm các mối liên kết nhưng không xoá các mối liên kết hiện có. Trong ví dụ trước, trạng thái kết thúc sẽ là hai mối liên kết (FOB và CUSTOM_1). Để liên kết người dùng với chỉ CUSTOM_1 chứ không phải FOB, thì yêu cầu sẽ là:
int32[0]
43 // mã yêu cầuint32[1]
10 (Mã nhận dạng người dùng Android)int32[2]
2 (số loại được đặt)int32[3]
1 (loại đầu tiên: UserIdentificationAssociationType::KEY_FOB)int32[4]
2 (giá trị đầu tiên: UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)int32[5]
101 (loại thứ hai: UserIdentificationAssociationType::CUSTOM_1)int32[6]
1 (giá trị thứ hai: UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
VEHICLE_CURB_WEIGHT
Trả về trọng lượng lề đường của xe tính bằng kilogam. Trọng lượng lề đường là tổng trọng lượng của xe kèm theo thiết bị tiêu chuẩn và tất cả vật tư tiêu hao cần thiết cho việc vận hành như dầu động cơ, hộp số dầu, dầu phanh, chất làm mát, môi chất làm lạnh điều hoà không khí và trọng lượng của nhiên liệu ở thùng danh nghĩa sức chứa khi không chở hành khách hoặc hàng hóa.
configArray[0] được dùng để chỉ định tổng trọng lượng của xe tính bằng kilogam. Tổng giá trị của xe trọng lượng là trọng lượng vận hành tối đa của chiếc xe theo quy định của nhà sản xuất bao gồm khung gầm, thân, động cơ, dung dịch động cơ, nhiên liệu, phụ kiện, người lái, hành khách và hàng hoá nhưng không bao gồm xe kéo.
Chế độ thay đổi: STATIC
Chế độ truy cập: READ
Loại enum: N/A
Loại đơn vị: VehicleUnit:KILOGRAM
Bản phát hành: Android 13
VEHICLE_IN_SỬ DỤNG
Cho biết liệu xe có đang được sử dụng hay không. Đang sử dụng có nghĩa là có người dùng và người dùng đó có ý định sử dụng xe. Điều này không nhất thiết có nghĩa là người dùng đang ở trong xe. Ví dụ: nếu người dùng mở khoá xe từ xa, thì xe được coi là đang sử dụng. Nếu tài sản này được hỗ trợ:
- Mỗi khi người dùng bật xe hoặc hệ thống phát hiện người dùng đang ở đó, bạn phải đặt
VEHICLE_IN_USE
thành true. Mỗi khi người dùng tắt nguồn xe hoặc hệ thống phát hiện người dùng không có mặt, bạn phải đặtVEHICLE_IN_USE
thành false. - Nếu người dùng tắt máy xe hoặc hệ thống phát hiện người dùng không có mặt, thì bạn phải đặt
VEHICLE_IN_USE
thành false. - Nếu người dùng bật nguồn xe hoặc hệ thống phát hiện thấy người dùng đang có mặt,
VEHICLE_IN_USE
phải được đặt thành true.
Thuộc tính này khác với AP_POWER_BOOTUP_REASON
ở chỗ AP_POWER_BOOTUP_REASON
chỉ được đặt một lần trong quá trình khởi động hệ thống. Tuy nhiên, thuộc tính này có thể thay đổi nhiều lần trong một chu kỳ khởi động hệ thống. Ví dụ: một thiết bị hiện không
đang sử dụng. Khởi động hệ thống để thực thi một tác vụ từ xa. VEHICLE_IN_USE
là false. Trong khi
nhiệm vụ từ xa đang thực hiện, người dùng bước vào xe và bật nguồn cho xe.
VEHICLE_IN_USE
được đặt thành true. Sau một phiên lái xe, người dùng tắt xe, VEHICLE_IN_USE
được đặt thành false.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
DỊCH VỤ_MAP_XE
Thông báo của Dịch vụ bản đồ dành cho xe (VMS). Tài sản này dùng dữ liệu MIXED để truyền các thông báo VMS.
Nội dung của tệp này được diễn giải như sau. Các chỉ mục được xác định trong VmsMessageIntegerValuesInde được dùng để đọc từ int32Values. bytes là một thông báo VMS được chuyển đổi tuần tự như được xác định trong giao thức VMS, không rõ ràng đối với khung. IXe#get phải luôn trả lại
StatusCode::NOT_AVAILABLE
.
Thay đổi chế độ: ON_CHANGEREAD_READ
Chế độ truy cập: READ_WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
VEHICLE_speed_DISPLAY_UNITS
Đơn vị tốc độ để hiển thị. Cho biết loại đơn vị dùng để hiển thị tốc độ cho người dùng. Ví dụ: m/giây, km/giờ hoặc dặm/giờ. VehiclePropConfig.configArray cho biết các đơn vị hiển thị tốc độ được hỗ trợ. Đơn vị áp suất được xác định trong VehicleUnit. Ví dụ:
.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
Nếu việc cập nhật VEHICLE_SPEED_DISPLAY_UNITS
ảnh hưởng đến giá trị của các biến
*_DISPLAY_UNITS properties
, thì các giá trị đó phải được cập nhật và thông báo với
khung AAOS.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
VHAL_HEARTBEAT
Xác định một sự kiện mà VHAL báo hiệu Tính năng Giám sát ô tô làm nhịp tim. Nếu VHAL hỗ trợ thuộc tính này, VHAL sẽ ghi thời gian hoạt động của hệ thống vào thuộc tính này sau mỗi 3 giây. Car Watchdog đăng ký thuộc tính này và kiểm tra xem thuộc tính này có được cập nhật sau mỗi 3 giây hay không. Với thời gian đệm là 3 giây, Car Watchdog sẽ chờ tín hiệu nhịp tim trong tối đa 6 giây kể từ nhịp tim gần nhất. Nếu không, tính năng Giám sát ô tô sẽ xem xét VHAL không tốt và chấm dứt nó. Nếu VHAL không hỗ trợ thuộc tính này, thì Trình giám sát ô tô sẽ không kiểm tra trạng thái của VHAL.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
WATCHDOG_ALIVE
Xác định một sự kiện mà tính năng Giám sát ô tô cập nhật để cho biết sự kiện đó đang hoạt động. Car Watchdog đặt thuộc tính này thành thời gian hoạt động của hệ thống tính bằng mili giây mỗi 3 giây. Trong khi khởi động, bản cập nhật có thể mất nhiều thời gian hơn.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
XỬ LÝ WATCHDOG_TERMINATED_
Xác định một quy trình do Car Watchdog chấm dứt và lý do chấm dứt.
int32Values[0] 1 // ProcessTerminationReason showing why a process is terminated. string: "/system/bin/log" // Process execution command
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: WRITE
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
WHEEL_TICK
Báo cáo tích tắc của bánh xe. Phần tử đầu tiên trong vectơ là số lần đặt lại. Đặt lại cho biết số lần kiểm tra trước đó không thể so sánh với lần kiểm tra này và các lần kiểm tra trong tương lai. Đã xảy ra một số sự cố không liên tục trong việc tính số lần đánh dấu nhịp độ khung hình.
Bốn phần tử tiếp theo biểu thị kim đánh dấu nhịp độ khung hình cho từng bánh xe theo thứ tự sau:
- Đằng trước bên trái
- Đằng trước bên phải
- Phía sau bên phải
- Phía sau bên trái
Tất cả số kim đánh dấu nhịp độ khung hình đều là số tích luỹ. Số lượng kim đánh dấu nhịp độ khung hình sẽ tăng lên khi xe di chuyển về phía trước và giảm khi xe lùi lại phía sau. Bạn phải đặt lại kim đánh dấu nhịp độ khung hình về 0 khi xe đang đầu.
int64Values[0]
Đặt lại số lượngint64Values[1]
Đánh dấu phía trước bên tráiint64Values[2]
Đánh dấu phía trước bên phảiint64Values[3]
Nấc đánh dấu phía sau bên phảiint64Values[4]
Dấu kim đánh dấu vị trí bên trái phía sau
configArray
được dùng để cho biết giá trị micromet trên mỗi kim đánh dấu vòng quay và những bánh xe được hỗ trợ configArray được đặt như sau:
configArray[0], bits [0:3] Supported wheels
Sử dụng enum Wheel. Ví dụ: nếu tất cả các bánh xe đều được hỗ trợ, thì:
configArray[0]
XeAreaWheel::LEFT_FRONT | XeAreaWheel::RIGHT_FRONT | XeAreaWheel::LEFT_REAR | Khu vực xe::RIGHT_REARconfigArray[1]
Micromet cho mỗi dấu kim đánh dấu trên bánh xe trước bên tráiconfigArray[2]
micromet trên mỗi kim đánh dấu nhịp độ khung hình của bánh trước bên phảiconfigArray[3]
Micromet trên mỗi dấu kim đánh dấu vị trí bánh xe sau bên phảiconfigArray[4]
micromet trên mỗi kim đánh dấu nhịp độ khung hình của bánh sau bên trái.
Nếu bánh xe không được hỗ trợ, giá trị của bánh xe sẽ luôn được đặt thành 0.
Phải điền VehiclePropValue.timestamp
.
Thay đổi chế độ: CONTINUOUS
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
WINDOW_LOCK
Khoá cửa sổ dành cho trẻ em. True cho biết cửa sổ đang bị khoá con. Thuộc tính này được xác định là VehiclePropertyAccess.READ_WRITE
, nhưng nhà sản xuất thiết bị gốc (OEM) chỉ có thể triển khai thuộc tính này dưới dạng VehiclePropertyAccess.READ
.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
WINDOW_MOVE (Di chuyển WINDOWS)
Di chuyển cửa sổ. Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig. Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ. maxInt32Value
biểu thị cửa sổ đang mở theo mặt phẳng/đóng theo hướng ngoài mặt phẳng với tốc độ nhanh nhất
tốc độ. minInt32Value
cho biết cửa sổ đang đóng trong mặt phẳng/mở theo hướng ra khỏi mặt phẳng ở tốc độ nhanh nhất.
Giá trị tuyệt đối lớn hơn, dù là dương hay âm, đều cho biết tốc độ di chuyển nhanh hơn. Khi
cửa sổ đạt đến giới hạn vị trí, giá trị phải được đặt lại về 0. Nếu giá trị của
WINDOW_MOVE
là 0, không có chuyển động nào đang diễn ra. Thuộc tính này được thể hiện bằng
phạm vi tốc độ di chuyển tương đối được chỉ định.
Đối với cửa sổ có thể mở ra ngoài mặt phẳng (chế độ thông gió của cửa sổ trời), tham số này hoạt động như sau. Nếu:
- Cửa sổ trời đang mở:
Max
Mở thêm cửa sổ trời, tự động dừng khi mở hết cỡ.Min
Đóng cửa sổ trời, tự động dừng khi cửa sổ trời đóng lại.
- Ống thông gió đang mở:
Max
Đóng cửa thông khí, tự động dừng khi lỗ thông khí đóng lại.Min
Mở thêm lỗ thông khí, tự động dừng khi lỗ thông khí đã mở hết.
- Cửa sổ trời đã đóng:
Max
Mở cửa sổ trời, tự động dừng khi cửa sổ trời đã mở hết.Min
Mở thông khí, tự động dừng khi lỗ thông khí đã mở hết.
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
WINDOW_POS
Vị trí cửa sổ. Bạn phải xác định maxInt32Value
và minInt32Value
trong mỗi VehicleAreaConfig. Tất cả số nguyên từ minInt32Value
đến maxInt32Value
phải được hỗ trợ. minInt32Value
cho biết cửa sổ đóng hoặc mở hoàn toàn ra khỏi mặt phẳng. Nếu cửa sổ không thể mở ra khỏi mặt phẳng, thì
minInt32Value
là vị trí của cửa sổ khi đóng hoàn toàn và phải bằng 0. Nếu
cửa sổ có thể mở ra ngoài một mặt phẳng, minInt32Value
cho biết cửa sổ đang mở hoàn toàn
ở vị trí của nó nằm ngoài mặt phẳng và là một giá trị âm. Hãy xem ví dụ bên dưới để biết thêm chi tiết
nội dung giải thích. maxInt32Value
cho biết cửa sổ đang mở hoàn toàn.
Các giá trị nằm giữa minInt32Value
và maxInt32Value
cho biết trạng thái chuyển đổi giữa vị trí đóng/mở hoàn toàn ngoài mặt phẳng và vị trí mở hoàn toàn. Thuộc tính này không
ở bất kỳ đơn vị cụ thể nào nhưng trong một phạm vi các vị trí tương đối được chỉ định. Ví dụ: đây là cách
thuộc tính nên hoạt động đối với cửa sổ có thể di chuyển ra khỏi mặt phẳng: Đối với cửa sổ có thể mở ra
mặt phẳng (chế độ thông khí của cửa sổ trời) tham số này hoạt động với các giá trị âm như sau:
Max
Cửa sổ trời đang mở hoàn toàn (0 nếu cửa sổ trời đã đóng).Min
Lỗ thông khí cửa sổ trời hoàn toàn mở (0 khi cửa sổ trời đã đóng).
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
.
Chế độ thay đổi: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: Không áp dụng
Loại đơn vị: Không áp dụng
Bản phát hành: Android 13
WINDSHIELD_WIPERS_PERIOD
Chu kỳ của cần gạt nước (mili giây). Trả về khoảng thời gian tức thì cho một chu kỳ đầy đủ của cần gạt nước kính chắn gió tính bằng mili giây. Một chu kỳ đầy đủ được xác định là một cần gạt nước di chuyển từ vị trí nghỉ và trở về vị trí nghỉ. Khi bạn chọn chế độ cài đặt cần gạt nước không liên tục, bạn phải đặt giá trị thuộc tính này thành 0 trong khoảng thời gian tạm dừng của chế độ gạt nước không liên tục. Chiến lược phát hành đĩa đơn
Bạn phải xác định maxInt32Value
và minInt32Value
trong VehicleAreaConfig.
maxInt32Value
cho mỗi mã khu vực phải chỉ định khoảng thời gian gạt nước dài nhất. Chiến lược phát hành đĩa đơn
Bạn phải đặt minInt32Value
thành 0 cho từng mã khu vực.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ
Loại enum: Không áp dụng
Loại đơn vị: VehicleUnit:MILLI_SECS
Bản phát hành: Android 14
TRƯỚC_THOÁT_GIÓ
Trạng thái của cần gạt nước. Trả về trạng thái hiện tại của cần gạt nước. Giá trị của
WINDSHIELD_WIPERS_STATE
có thể không khớp với giá trị của
WINDSHIELD_WIPERS_SWITCH
Ví dụ: WINDSHIELD_WIPERS_STATE: ON
và
WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO
Nếu WINDSHIELD_WIPERS_STATE: ON
và WINDSHIELD_WIPERS_PERIOD
là
thì WINDSHIELD_WIPERS_PERIOD
phải phản ánh khoảng thời gian một lần
chu kỳ của cần gạt nước.
Đối với mỗi mã khu vực được hỗ trợ, bạn phải xác định mảng VehicleAreaConfig#supportedEnumValues
, trừ phi tất cả các trạng thái trong WindshieldWipersState
đều được hỗ trợ (bao gồm cả OTHER, không nên dùng).
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ
Loại enum: WindshieldWipersState
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14
WINDSHIELD_WIPERS_SWITCH
Công tắc cần gạt nước. Biểu thị vị trí của nút chuyển điều khiển cần gạt nước kính chắn gió. Giá trị của WINDSHIELD_WIPERS_SWITCH
có thể không khớp với giá trị của
WINDSHIELD_WIPERS_STATE
Ví dụ: WINDSHIELD_WIPERS_SWITCH: AUTO
và
WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON
Đối với mỗi mã khu vực được hỗ trợ,
Mảng VehicleAreaConfig#supportedEnumValues
phải được định nghĩa trừ phi tất cả các trạng thái trong
WindshieldWipersSwitch
được hỗ trợ (bao gồm cả OTHER, không nên dùng).
Thuộc tính này được định nghĩa là VehiclePropertyAccess.READ_WRITE
, nhưng OEM có thể
chỉ triển khai dưới dạng VehiclePropertyAccess.READ
. Nếu thuộc tính này được triển khai dưới dạng
VehiclePropertyAccess.READ_WRITE
và tiểu bang KHÁC được liệt kê trong
Mảng VehicleAreaConfig#supportedEnumValues
, thì OTHER không phải là giá trị được hỗ trợ
để viết. Đây chỉ là một giá trị được hỗ trợ để đọc.
Thay đổi chế độ: ON_CHANGE
Chế độ truy cập: READ_WRITE
/READ
Loại enum: WindshieldWipersSwitch
Loại đơn vị: Không áp dụng
Bản phát hành: Android 14