ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

พร็อพเพอร์ตี้ของระบบที่รองรับ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

หน้านี้จะแสดงรายการพร็อพเพอร์ตี้ของระบบที่รองรับใน VHAL พร็อพเพอร์ตี้ที่ VHAL รองรับต้องมาจากรายการด้านล่างหรือเป็นพร็อพเพอร์ตี้ของผู้ให้บริการ ใน Android 14 ขึ้นไป ระบบจะกำหนดคำจำกัดความของพร็อพเพอร์ตี้ที่ hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl

การกำหนดพร็อพเพอร์ตี้จะกำหนดไว้ในอินเทอร์เฟซ AIDL ซึ่งอยู่แยกจากอินเทอร์เฟซ VHAL (android.hardware.automotive.vehicle) การใช้งาน VHAL และไคลเอ็นต์ VHAL ต้องอาศัยทั้ง 2 อินเทอร์เฟซandroid.hardware.automotive.vehicle.property

โหมดการเข้าถึงและโหมดการเปลี่ยนแปลงที่สร้างขึ้นโดยอัตโนมัติ

ใน Android 14 ขึ้นไป เรามีไฟล์ส่วนหัว C++ และไฟล์คลาส Java ที่สร้างขึ้นโดยอัตโนมัติพร้อมโหมดการเปลี่ยนแปลงหรือโหมดการเข้าถึงที่อนุญาตสำหรับพร็อพเพอร์ตี้ของระบบเพื่อรองรับการใช้งาน VHAL การติดตั้งใช้งาน VHAL ของผู้ให้บริการจะใช้ข้อมูลเหล่านี้เพื่อให้การกำหนดค่าพร็อพเพอร์ตี้เป็นไปตามข้อกำหนดได้

ก ถึง ง

ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE

ระยะทางที่วัดได้จากยานพาหนะนำหน้าเมื่อใช้ระบบควบคุมความเร็วอัตโนมัติแบบแปรผัน (Adaptive Cruise Control หรือ ACC) หรือระบบควบคุมความเร็วอัตโนมัติตามคาดการณ์ (Predictive Cruise Control หรือ PCC) แสดงผลระยะทางที่วัดเป็นมิลลิเมตรระหว่างจุดด้านหลังสุดของรถคันหน้ากับจุดด้านหน้าสุดของรถที่มี ACC ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig minInt32Value ควรเป็น 0 maxInt32Value ควรป้อนข้อมูลเป็นระยะทางสูงสุดที่เซ็นเซอร์ตรวจจับระยะทางรองรับ ค่านี้ไม่ควรเป็นค่าลบ

เมื่อไม่พบยานพาหนะนำหน้า (กล่าวคือ เมื่อไม่มียานพาหนะนำหน้าหรือยานพาหนะนำหน้าอยู่ไกลเกินกว่าที่เซ็นเซอร์จะตรวจจับได้) พร็อพเพอร์ตี้นี้จะแสดงผลเป็น StatusCode.NOT_AVAILABLE

เมื่อพร็อพเพอร์ตี้นี้ไม่พร้อมใช้งานเนื่องจาก CC ถูกปิดใช้ (เช่น StatusCode#NOT_AVAILABLE_DISABLED เป็นเท็จ) พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#NOT_AVAILABLE_DISABLED หากมีการใช้ CRUISE_CONTROL_STATE และตั้งค่าสถานะเป็นค่า ErrorState พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode ที่สอดคล้องกับค่า ErrorState เช่น หากตั้งค่า CRUISE_CONTROL_STATE เป็น ErrorState#NOT_AVAILABLE_SPEED_LOW พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#NOT_AVAILABLE_SPEED_LOW

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:MILLIMETER
รุ่น: Android 14

ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP

ช่วงเวลาเป้าหมายปัจจุบันสําหรับ ACC หรือ PCC เป็นมิลลิวินาที พร็อพเพอร์ตี้นี้ควรระบุเวลาตามเป้าหมายที่ห่างกันระหว่างยานพาหนะนำหน้า โดยช่องว่างนี้หมายถึงเวลาที่ใช้ในการเดินทางจากจุดด้านหลังสุดของรถคันหน้าไปจนถึงจุดด้านหน้าสุดของรถที่มี ACC ระยะห่างจริงจากยานพาหนะนำหน้าอาจสูงกว่าหรือต่ำกว่าค่านี้

ค่าที่เป็นไปได้ในการตั้งค่าช่วงเวลาเป้าหมายควรระบุไว้ใน configArray โดยเรียงจากน้อยไปมาก ค่าทั้งหมดต้องเป็นค่าบวก หากพร็อพเพอร์ตี้เขียนได้ ค่าทั้งหมดต้องเขียนได้ เมื่อพร็อพเพอร์ตี้นี้ไม่พร้อมใช้งานเนื่องจากปิดใช้คำบรรยายแทนเสียง (เช่น CRUISE_CONTROL_ENABLED เป็นเท็จ) พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#NOT_AVAILABLE_DISABLED

หากมีการใช้ CRUISE_CONTROL_STATE และตั้งค่าสถานะเป็นค่า ErrorState พร็อพเพอร์ตี้นี้ต้องแสดงผล StatusCode ที่สอดคล้องกับค่า ErrorState เช่น หากตั้งค่า CRUISE_CONTROL_STATE เป็น ErrorState#NOT_AVAILABLE_SPEED_LOW พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#NOT_AVAILABLE_SPEED_LOW

พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้เป็น VehiclePropertyAccess.READ เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:MILLI_SECS
รุ่น: Android 14

ABS_ACTIVE

ระบบเบรกอัตโนมัติ (ABS) เปิดใช้งานอยู่ มีการตั้งค่าเป็น "จริง" เมื่อ ABS ทำงานอยู่ และรีเซ็ตเป็น "เท็จ" เมื่อ ABS ปิดอยู่ พร็อพเพอร์ตี้นี้สามารถตั้งค่าเป็นช่วงๆ (พัลส์) ตามสถานะแบบเรียลไทม์ของระบบ ABS

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

ANDROID_EPOCH_TIME

วันที่และเวลาปัจจุบันที่เข้ารหัสเป็นเวลา Epoch (มิลลิวินาที) ค่านี้หมายถึงจํานวนวินาทีมิลลิวินาทีที่ผ่านไปนับตั้งแต่วันที่ 1/1/1970 UTC

ค่านี้หมายถึงจํานวนวินาทีมิลลิวินาทีที่ผ่านไปตั้งแต่วันที่ 1/1/1970 UTC CarServices WRITE เป็นค่านี้เพื่อระบุเวลาของระบบ Android ให้กับ VHAL หาก VHAL รองรับพร็อพเพอร์ตี้นี้ ซึ่งอาจมีประโยชน์ในการซิงค์ระบบอื่นๆ ของรถ (นาฬิกาหน้าปัด) กับเวลาของ Android

AAOS WRITE ไปยังพร็อพเพอร์ตี้นี้ 1 ครั้งระหว่างการบูต และหลังจากนั้นWRITE เฉพาะเมื่อมีการเปลี่ยนแปลงแหล่งที่มาของเวลา AAOS จะกรอกข้อมูลใน VehiclePropValue.timestamp ให้ถูกต้อง AAOS จะไม่ส่งการอัปเดตสำหรับเวลาที่ผ่านไปตามปกติ int64Values[0] = เวลา Unix ที่ระบุ (เป็นมิลลิวินาที)

พร็อพเพอร์ตี้อาจใช้เวลามากกว่า 0 มิลลิวินาทีในการนำไปใช้กับสแต็ก และพร็อพเพอร์ตี้ที่มีการประทับเวลาจะช่วยลดความคลาดเคลื่อนของเวลา ดังนั้นสําหรับ WRITE ทั้งหมดในพร็อพเพอร์ตี้ คุณสามารถใช้การประทับเวลาเพื่อหักลบความคลาดเคลื่อนนี้

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

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: WRITE
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:MILLI_SECS
รุ่น: Android 13

AP_POWER_BOOTUP_REASON

พร็อพเพอร์ตี้สำหรับรายงานเหตุผลในการบูตเครื่องสำหรับการเปิดเครื่องปัจจุบัน นี่เป็นพร็อพเพอร์ตี้ STATIC ที่จะไม่เปลี่ยนแปลงตลอดระยะเวลาจนกว่าจะปิดเครื่อง เช่น แม้ว่าผู้ใช้จะกดปุ่มเปิด/ปิดหลังจากเปิดเครื่องโดยอัตโนมัติด้วยการปลดล็อกประตู เหตุผลในการบูตจะต้องเป็น VehicleApPowerBootupReason#USER_UNLOCK int32Values[0] ต้องเป็น VehicleApPowerBootupReason

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

AP_POWER_STATE_REPORT

พร็อพเพอร์ตี้สำหรับรายงานสถานะพลังงานของโปรเซสเซอร์แอป ระบบจะถือว่าสถานะพลังงานของ AP ควบคุมโดยตัวควบคุมพลังงานแยกต่างหาก

int32Values[0] ค่า enum ของ VehicleApPowerStateReport
int32Values[1] เวลาในการตื่นขึ้นเป็นมิลลิวินาที หากจำเป็น (มิเช่นนั้นจะเป็น 0)

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

AP_POWER_STATE_REQ

พร็อพเพอร์ตี้สำหรับควบคุมสถานะพลังงานของตัวประมวลผลแอป ระบบจะถือว่าสถานะพลังงานของ AP ควบคุมโดยตัวควบคุมพลังงานแยกต่างหาก สำหรับข้อมูลการกําหนดค่า VehiclePropConfig.configArray ต้องมี Flag แบบบิตที่รวมค่าไว้ใน VehicleApPowerStateConfigFlag

int32Values[0] ค่า enum VehicleApPowerStateReq
int32Values[1] พารามิเตอร์เพิ่มเติมที่เกี่ยวข้องกับแต่ละสถานะ 0 หากไม่ได้ใช้

AUTOMATIC_EMERGENCY_BRAKING_ENABLED

เปิดหรือปิดใช้ระบบเบรกฉุกเฉินอัตโนมัติ (AEB) ตั้งค่าเป็น "จริง" เพื่อเปิดใช้ AEB และ "เท็จ" เพื่อปิดใช้ AEB เมื่อเปิดใช้ AEB ระบบ ADAS ในรถควรเปิดอยู่และตรวจสอบเพื่อหลีกเลี่ยงการชนที่อาจเกิดขึ้น พร็อพเพอร์ตี้นี้ควรใช้กับแอปพลิเคชันที่มีความเร็วสูงกว่าเท่านั้น หากต้องการเปิดใช้ระบบเบรกฉุกเฉินอัตโนมัติที่ความเร็วต่ำ ให้ใช้ LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED

โดยทั่วไป AUTOMATIC_EMERGENCY_BRAKING_ENABLED ควรแสดงผลลัพธ์เป็น "จริง" หรือ "เท็จ" เสมอ หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราว เช่น ความเร็วของยานพาหนะต่ำเกินไป ข้อมูลดังกล่าวจะต้องส่งผ่านค่า ErrorState ในพร็อพเพอร์ตี้ AUTOMATIC_EMERGENCY_BRAKING_STATE

พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

AUTOMATIC_EMERGENCY_BRAKING_STATE

สถานะระบบเบรกฉุกเฉินอัตโนมัติ (AEB) แสดงสถานะปัจจุบันของ AEB พร็อพเพอร์ตี้นี้ต้องแสดงสถานะที่ถูกต้องที่กําหนดไว้ใน AutomaticEmergencyBrakingState หรือ ErrorState เสมอ และต้องไม่แสดงข้อผิดพลาดผ่าน StatusCode และใช้สถานะข้อผิดพลาดที่รองรับแทน พร็อพเพอร์ตี้นี้ควรใช้กับแอปพลิเคชันที่มีความเร็วสูงกว่าเท่านั้น หากต้องการแสดงสถานะของระบบเบรกฉุกเฉินอัตโนมัติที่ความเร็วต่ำ ให้ใช้ LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE

หาก AEB มีคำเตือนการชนด้านหน้าก่อนที่จะเปิดใช้งานเบรก คำเตือนเหล่านั้นต้องแสดงผ่านพร็อพเพอร์ตี้คำเตือนการชนด้านหน้า (FCW)

สําหรับรหัสพื้นที่ส่วนกลาง (0) คุณต้องกําหนดอาร์เรย์ StatusCode#VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของทั้ง AutomaticEmergencyBrakingState (รวมถึง OTHER ซึ่งไม่แนะนํา) และ ErrorState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภทการออกเสียง: ForwardCollisionWarningState/ErrorState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

BLIND_SPOT_WARNING_ENABLED

เปิดและปิดใช้ระบบเตือนจุดอับสายตา (BSW) ตั้งค่าเป็น "จริง" เพื่อเปิดใช้ BSW และ "เท็จ" เพื่อปิดใช้ BSW เมื่อเปิดใช้ BSW ระบบ ADAS ในรถควรเปิดอยู่และตรวจสอบวัตถุในจุดบอดสนิทของรถ

โดยทั่วไป BLIND_SPOT_WARNING_ENABLED ควรแสดงผลลัพธ์เป็น "จริง" หรือ "เท็จ" เสมอ หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราวบางอย่าง เช่น ความเร็วของยานพาหนะต่ำเกินไป ข้อมูลดังกล่าวจะต้องส่งผ่านค่า ErrorState ในพร็อพเพอร์ตี้ BLIND_SPOT_WARNING_STATE

BLIND_SPOT_WARNING_STATE

สถานะการเตือนจุดอับสายตา (BSW) แสดงสถานะปัจจุบันของ BSW พร็อพเพอร์ตี้นี้ต้องแสดงสถานะที่ถูกต้องที่กําหนดไว้ใน BlindSpotWarningState หรือ ErrorState เสมอ ต้องไม่แสดงข้อผิดพลาดผ่าน StatusCode และต้องใช้สถานะข้อผิดพลาดที่รองรับแทน

สําหรับรหัสพื้นที่ที่รองรับแต่ละรหัส คุณต้องกําหนดอาร์เรย์ StatusCode#VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของทั้ง BlindSpotWarningState (รวมถึง OTHER ซึ่งไม่แนะนํา) และ ErrorState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: BlindSpotWarningState/ErrorState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

CABIN_LIGHTS_STATE

แสดงสถานะไฟในห้องโดยสาร

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: VehicleLightState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

CABIN_LIGHTS_SWITCH

สวิตช์ไฟในห้องโดยสาร ตำแหน่งของสวิตช์จริงที่ควบคุมไฟในห้องโดยสาร ซึ่งอาจแตกต่างจาก CABIN_LIGHTS_STATE หากไฟเปิดอยู่เนื่องจากประตูเปิดอยู่หรือคำสั่งเสียง เช่น เมื่อสวิตช์อยู่ในตำแหน่งปิดหรืออัตโนมัติ

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: VehicleLightSwitch
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

CLUSTER_DISPLAY_STATE

เปลี่ยนสถานะของการแสดงผลคลัสเตอร์

ขอบเขต: พื้นที่ที่จะแสดงผลกิจกรรมของคลัสเตอร์
ส่วนที่แทรก: พื้นที่ที่ Activity ไม่ควรวางข้อมูลสำคัญ

ค่าที่เป็นไปได้:

int32[0] เปิด ปิด: 0 - ปิด, 1 - เปิด, -1 - ไม่สนใจ
int32[1] Bounds - left: positive number - left position in pixels -1 - don't care (ควรตั้งค่าช่อง Bounds ทั้งหมด)
int32[2] Bounds - top: รูปแบบเดียวกับ "left"
int32[3] ขอบเขต - ขวา: รูปแบบเดียวกับ "ซ้าย"
int32[4] Bounds - bottom: รูปแบบเดียวกับ "left"
int32[5] ระยะห่างจากขอบ - ซ้าย: ตัวเลขบวก - ค่าระยะห่างจากขอบซ้ายจริงเป็นพิกเซล -1 - ไม่สนใจ (ควรตั้งค่า "ไม่สนใจ" ในช่องระยะห่างจากขอบทั้งหมด)
int32[6] ระยะห่างจากขอบ - ด้านบน: รูปแบบเดียวกับ "ซ้าย"
int32[7] แทรก - ขวา: รูปแบบเดียวกับ "ซ้าย"
int32[8] ระยะห่างจากขอบ - ด้านล่าง: รูปแบบเดียวกับ "ซ้าย"

CLUSTER_NAVIGATION_STATE

แจ้งสถานะการนำทางปัจจุบัน bytes: ข้อความที่แปลงเป็นอนุกรมของ NavigationStateProto

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: WRITE
ประเภท Enum:
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

CLUSTER_REPORT_STATE

รายงานสถานะการแสดงผลปัจจุบันและสถานะ ClusterUI ClusterHome ส่งข้อความนี้เมื่อจัดการ CLUSTER_SWITCH_UI CLUSTER_DISPLAY_STATE นอกจากนี้ ClusterHome ควรส่งข้อความนี้เมื่อเริ่มต้นใช้งานเป็นครั้งแรก เมื่อ ClusterOS ได้รับข้อความนี้และหากความคาดหวังภายในแตกต่างจากข้อความที่ได้รับ ระบบควรส่ง CLUSTER_SWITCH_UI, CLUSTER_DISPLAY_STATE อีกครั้งเพื่อให้ตรงกับสถานะ

int32[0] เปิด/ปิด: 0 - ปิด, 1 - เปิด
int32[1] ขอบเขต - ซ้าย
int32[2] ขอบเขต - ด้านบน
int32[3] ขอบเขต - ขวา
int32[4] ขอบเขต - ด้านล่าง
int32[5] ระยะห่างจากขอบ - ซ้าย
int32[6] ระยะห่างจากขอบ - ด้านบน
int32[7] ข้างใน - ขวา
int32[8] ระยะห่างจากขอบ - ด้านล่าง
int32[9] ประเภท ClusterUI ในหน้าจอหลักหรือแบบเต็มหน้าจอ 0 หมายถึง ClusterHome ค่าอื่นๆ จะตามด้วยคําจํากัดความของ OEM
int32[10] ประเภท ClusterUI ในหน้าจอย่อย หากมีการแสดง UI 2 รายการในขณะนี้ -1 บ่งบอกว่าพื้นที่นี้ไม่มีการใช้งานแล้ว bytes: อาร์เรย์ที่แสดงความพร้อมใช้งานของ ClusterUI 0 หมายถึงไม่พร้อมใช้งาน และ 1 หมายถึงพร้อมใช้งาน ตัวอย่างเช่น หากรถยนต์รองรับ ClusterUI ที่ OEM กำหนด 3 รายการ เช่น HOME, MAPS และ CALL และรองรับ UI การโทรเฉพาะเมื่อมีเครือข่ายมือถือเท่านั้น จากนั้น หากมีเครือข่าย ก็จะส่ง [1 1 1] และหากไม่มีเครือข่าย ก็จะส่ง [1 1 0]

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: WRITE
ประเภท Enum: VehicleLightSwitch
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

CLUSTER_REQUEST_DISPLAY

คำขอเปลี่ยนสถานะการแสดงคลัสเตอร์เพื่อแสดง ClusterUI บางรายการ เมื่อสถานะจอแสดงผลปัจจุบันปิดอยู่และ ClusterHome ส่งข้อความนี้ไปยัง ClusterOS เพื่อขอให้เปิดจอแสดงผลเพื่อแสดง ClusterUI ที่เฉพาะเจาะจง ClusterOS ควรตอบกลับด้วย CLUSTER_DISPLAY_STATE

int32 ประเภท ClusterUI ที่จะแสดง

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: WRITE
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

CLUSTER_SWITCH_UI

เริ่ม ClusterUI ในจอแผงหน้าปัด

int32 ประเภท ClusterUI ที่แสดง 0 หมายถึง ClusterHome ซึ่งเป็นหน้าจอหลักของจอแสดงผลคลัสเตอร์ รวมถึงมี UI เริ่มต้นและฟังก์ชันการทำงานประเภทหนึ่งสำหรับตัวเปิดใช้งานของจอแสดงผลคลัสเตอร์ ค่าอื่นๆ เป็นไปตามคำจำกัดความของ OEM

CREATE_USER

ระบบ Android เรียกใช้หลังจากสร้างผู้ใช้ Android แล้ว HAL สามารถใช้พร็อพเพอร์ตี้นี้เพื่อสร้างผู้ใช้ที่เทียบเท่าได้ นี่เป็นคําขอแบบแอซิงค์: Android จะส่งคําขอโดยการตั้งค่า VehiclePropValue และ HAL ต้องตอบกลับด้วยการเปลี่ยนแปลงพร็อพเพอร์ตี้ที่ระบุว่าคําขอสําเร็จหรือไม่ หากดำเนินการไม่สำเร็จ ระบบ Android จะนำผู้ใช้ออก

รูปแบบของคำขอจะกำหนดโดย CreateUserRequest และรูปแบบของการตอบกลับจะกำหนดโดย CreateUserResponse เช่น หากระบบมีผู้ใช้ 2 ราย (0 และ 10) และมีการสร้างผู้ใช้คนที่ 3 (ซึ่งเป็นผู้ใช้ชั่วคราว) คำขอจะเป็นดังนี้

int32[0] 42 // request id
int32[1] 11 // รหัส Android ของผู้ใช้ที่สร้าง
int32[2] 6 // Android flags (ephemeral guest) of the created user
int32[3] 10 // ผู้ใช้ปัจจุบัน
int32[4] 0 // current user flags (none)
int32[5] 3 // number of users
int32[6] 0 // ผู้ใช้ครั้งแรก (ผู้ใช้ 0)
int32[7] 0 // ธงผู้ใช้แรก (ไม่มี)
int32[8] 10 // ผู้ใช้ที่ 2 (ผู้ใช้ 10)
int32[9] 0 // flag ผู้ใช้ที่ 2 (ไม่มี)
int32[10] 11 // ผู้ใช้ที่ 3 (ผู้ใช้ 11)
int32[11] 6 // สตริง Flag ผู้ใช้ที่ 3 (ผู้มาเยือนชั่วคราว): "ElGuesto" // ชื่อของผู้ใช้ใหม่

หากคำขอสำเร็จ HAL จะแสดงผลดังนี้

int32[0] 42 // request id
int32[1] 1 // CreateUserStatus::SUCCESS

แต่หากดำเนินการไม่สำเร็จ ให้ทำดังนี้

int32[0] 42 // request id
int32[1] 2 // CreateUserStatus::FAILURE string: "D'OH!" //

ความหมายคือกล่องดำและส่งไปยังผู้เรียก (เช่น UI การตั้งค่า) ซึ่งจะดําเนินการที่เหมาะสม

CRITICALLY_LOW_TIRE_PRESSURE

พร็อพเพอร์ตี้นี้ระบุเกณฑ์ความดันต่ำมากสำหรับยางแต่ละเส้น ซึ่งจะระบุเวลาที่ควรเปลี่ยนหรือซ่อมยาง ค่าต้องน้อยกว่าหรือเท่ากับ minFloatValue ใน TIRE_PRESSURE ค่าพร็อพเพอร์ตี้ขั้นต่ำและสูงสุด (minFloatValue และ maxFloatValue) ใช้กับพร็อพเพอร์ตี้นี้ไม่ได้

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:KILOPASCAL
รุ่น: Android 13

CRUISE_CONTROL_COMMAND

WRITE คำสั่งระบบควบคุมความเร็วคงที่ (CC) ดูรายละเอียดเกี่ยวกับคําสั่งที่รองรับแต่ละรายการได้ที่ CruiseControlCommand สำหรับรหัสพื้นที่ส่วนกลาง (0) ต้องกำหนดอาร์เรย์ StatusCode#VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของ CruiseControlState คำสั่งที่ไม่รองรับซึ่งส่งผ่านพร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#INVALID_ARG เมื่อพร็อพเพอร์ตี้นี้ไม่พร้อมใช้งานเนื่องจาก CC ถูกปิดใช้ (เช่น CRUISE_CONTROL_ENABLED เป็นเท็จ) พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#NOT_AVAILABLE_DISABLED หากมีการใช้ CRUISE_CONTROL_STATE และตั้งค่าสถานะเป็นค่า ErrorState พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode ที่สอดคล้องกับค่า ErrorState เช่น หากตั้งค่า CRUISE_CONTROL_STATE เป็น ErrorState#NOT_AVAILABLE_SPEED_LOW พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#NOT_AVAILABLE_SPEED_LOW

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: WRITE
ประเภท Enum: CruiseControlCommand
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

CRUISE_CONTROL_ENABLED

เปิดหรือปิดใช้ระบบควบคุมความเร็วคงที่ (CC) ตั้งค่าเป็น "จริง" เพื่อเปิดใช้สำเนา และ "เท็จ" เพื่อปิดใช้สำเนา พร็อพเพอร์ตี้นี้ใช้ร่วมกันโดย CruiseControlType ในรูปแบบต่างๆ ทั้งหมด เมื่อเปิดใช้ CC ระบบ ADAS ในรถควรเปิดอยู่และตอบสนองต่อคำสั่ง โดยทั่วไปแล้ว CRUISE_CONTROL_ENABLED ควรแสดงผลลัพธ์เป็น "จริง" หรือ "เท็จ" เสมอ หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราว เช่น ความเร็วของยานพาหนะต่ำเกินไป ข้อมูลดังกล่าวจะต้องส่งผ่านค่า ErrorState ในพร็อพเพอร์ตี้ CRUISE_CONTROL_STATE พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

CRUISE_CONTROL_STATE

สถานะปัจจุบันของระบบควบคุมความเร็วคงที่ (CC) พร็อพเพอร์ตี้นี้จะแสดงสถานะปัจจุบันของ CC โดยทั่วไปแล้ว พร็อพเพอร์ตี้นี้ควรแสดงสถานะที่ถูกต้องซึ่งกำหนดไว้ใน CruiseControlState หรือ ErrorState ตัวอย่างเช่น หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราวบางอย่าง ข้อมูลดังกล่าวควรส่งผ่าน ErrorState สำหรับรหัสพื้นที่ส่วนกลาง (0) คุณต้องกำหนดอาร์เรย์ VehicleAreaConfig#supportedEnumValue เว้นแต่ระบบจะรองรับสถานะทั้งหมดของ CruiseControlState (รวมถึง OTHER ซึ่งไม่แนะนำ) และ ErrorState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: CruiseControlState/ErrorState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

CRUISE_CONTROL_TARGET_SPEED

ความเร็วเป้าหมายปัจจุบันของระบบควบคุมความเร็วคงที่ (CC) OEM ควรตั้งค่า minFloatValue และ maxFloatValue สำหรับพร็อพเพอร์ตี้นี้เพื่อกำหนดค่าความเร็วเป้าหมายต่ำสุดและสูงสุด ค่าเหล่านี้ต้องไม่เป็นค่าลบ maxFloatValue แสดงถึงขีดจำกัดบนของความเร็วเป้าหมาย minFloatValue แสดงถึงขอบเขตล่างของความเร็วเป้าหมาย เมื่อพร็อพเพอร์ตี้นี้ไม่พร้อมใช้งานเนื่องจาก CC ถูกปิดใช้ (เช่น CRUISE_CONTROL_ENABLED เป็นเท็จ) พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#NOT_AVAILABLE_DISABLED หากมีการใช้ CRUISE_CONTROL_STATE และตั้งค่าสถานะเป็นค่า ErrorState พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode ที่สอดคล้องกับค่า ErrorState เช่น หากตั้งค่า CRUISE_CONTROL_STATE เป็น ErrorState#NOT_AVAILABLE_SPEED_LOW พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#NOT_AVAILABLE_SPEED_LOW

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:METER_PER_SEC
รุ่น: Android 14

CRUISE_CONTROL_TYPE

ประเภทระบบควบคุมความเร็วคงที่ (CC) ปัจจุบัน เมื่อ CRUISE_CONTROL_ENABLED เป็นจริง พร็อพเพอร์ตี้นี้จะแสดงผลประเภท CC ที่เปิดใช้อยู่ในปัจจุบัน (เช่น CC มาตรฐานและ CC แบบปรับเปลี่ยนได้ CC แบบคาดการณ์) โดยทั่วไปแล้ว พร็อพเพอร์ตี้นี้ควรแสดงสถานะที่ถูกต้องซึ่งกำหนดไว้ใน CruiseControlType หรือ ErrorState ตัวอย่างเช่น หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราวบางอย่าง ระบบควรส่งข้อมูลผ่าน ErrorState สำหรับรหัสพื้นที่ส่วนกลาง (0) คุณต้องกำหนดอาร์เรย์ StatusCode#VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของ CruiseControlType (รวมถึง OTHER ซึ่งไม่แนะนำ) และ ErrorState การพยายามWRITE CruiseControlType#OTHER หรือ ErrorState กับพร็อพเพอร์ตี้นี้จะทำให้ระบบแสดง IllegalArgumentException พร็อพเพอร์ตี้นี้กําหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM จะใช้เป็น VehiclePropertyAccess.READ เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: CruiseControlType ErrorState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

CURRENT_GEAR

เกียร์ปัจจุบัน ในกรณีที่ไม่ใช่เกียร์ธรรมดา เกียร์ที่เลือกอาจไม่ตรงกับเกียร์ปัจจุบัน เช่น หากเกียร์ที่เลือกคือ GEAR_DRIVE เกียร์ปัจจุบันจะเป็น GEAR_1, GEAR_2 และอื่นๆ ซึ่งแสดงถึงเกียร์จริงที่ระบบเกียร์ทำงานอยู่ ค่าในข้อมูลการกําหนดค่าต้องแสดงรายการเกียร์ที่รองรับสําหรับยานพาหนะนี้ เช่น ข้อมูลการกําหนดค่าสําหรับระบบเกียร์อัตโนมัติต้องมี {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_1, GEAR_2,...} และสำหรับระบบเกียร์ธรรมดา รายการต้องเป็น {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...} รายการนี้ไม่จำเป็นต้องเหมือนกับรายการเกียร์ที่รองรับซึ่งรายงานใน GEAR_SELECTION

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: VehicleGear
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

CURRENT_POWER_POLICY

แจ้งนโยบายพลังงานปัจจุบันไปยังเลเยอร์ VHAL บริการนโยบายการใช้พลังงานของรถยนต์จะตั้งค่าพร็อพเพอร์ตี้นี้เมื่อมีการแก้ไขนโยบายการใช้พลังงานปัจจุบัน

string: "sample_policy_id" // power policy ID

DISABLED_OPTIONAL_FEATURES

อนุญาตให้ปิดใช้ฟีเจอร์ที่ไม่บังคับใน VHAL พร็อพเพอร์ตี้นี้จะรายงานฟีเจอร์ที่ไม่บังคับซึ่งควรปิดใช้ ฟีเจอร์ที่ไม่บังคับทั้งหมดที่อนุญาตสำหรับระบบจะประกาศไว้ในการวางซ้อนบริการรถยนต์ config_allowed_optional_car_features พร็อพเพอร์ตี้นี้ช่วยให้ปิดใช้ฟีเจอร์ที่กําหนดไว้ในการวางซ้อนได้ หากไม่มีพร็อพเพอร์ตี้นี้ ระบบจะเปิดใช้ฟีเจอร์ทั้งหมดที่ประกาศไว้ในการวางซ้อน ค่า READ ควรรวมฟีเจอร์ทั้งหมดที่ปิดใช้โดยคั่นด้วยคอมมา (,) เช่น com.android.car.user.CarUserNoticeService,storage_monitoring

DISPLAY_BRIGHTNESS

พร็อพเพอร์ตี้แสดงความสว่างของจอแสดงผล รถบางรุ่นมีการควบคุมความสว่างของจอแสดงผลทั้งหมดด้วยตัวควบคุมเดียว พร็อพเพอร์ตี้นี้มีไว้เพื่อแชร์การเปลี่ยนแปลงในการควบคุมนั้น ในรถยนต์ที่มีจอแสดงผลที่ควบคุมความสว่างแยกต่างหาก จะต้องใช้ PER_DISPLAY_BRIGHTNESS ควรติดตั้ง DISPLAY_BRIGHTNESS หรือ PER_DISPLAY_BRIGHTNESS เพียงรายการเดียว หากมีทั้ง 2 รายการ AAOS จะใช้ PER_DISPLAY_BRIGHTNESS หากเขียนค่านี้ได้ Android จะตั้งค่านี้ได้เมื่อผู้ใช้เปลี่ยนความสว่างของจอแสดงผลจากการตั้งค่า หากเป็น READ เท่านั้น ผู้ใช้จะยังคงเปลี่ยนความสว่างของจอแสดงผลได้จากการตั้งค่า แต่การเปลี่ยนแปลงต้องไม่แสดงในจอแสดงผลอื่นๆ

DISTANCE_DISPLAY_UNITS

หน่วยวัดระยะทางสำหรับการแสดงผล ระบุหน่วยที่รถใช้เพื่อแสดงระยะทางต่อผู้ใช้ เช่น ไมล์ เมตร หรือกิโลเมตร หน่วยวัดระยะทางจะกำหนดไว้ใน VehicleUnit VehiclePropConfig.configArray ใช้เพื่อระบุหน่วยการแสดงระยะทางที่รองรับ ตัวอย่างเช่น configArray[0] = METER configArray[1] = KILOMETER configArray[2] = MILE หากการอัปเดต DISTANCE_DISPLAY_UNITS ส่งผลต่อค่าของพร็อพเพอร์ตี้ *_DISPLAY_UNITS อื่นๆ ก็จะต้องอัปเดตค่าเหล่านั้นและแจ้งให้เฟรมเวิร์ก AAOS ทราบด้วย พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้เป็น VehiclePropertyAccess.READ เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: VehicleUnit
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

DOOR_CHILD_LOCK_ENABLED

เปิดใช้ฟีเจอร์ล็อกสำหรับเด็กที่ประตู แสดงค่า "จริง" หากเปิดใช้ฟีเจอร์ล็อกสำหรับเด็กที่ประตู และแสดงค่า "เท็จ" หากปิดใช้ หากเปิดใช้ ประตูจะเปิดจากด้านในไม่ได้ พร็อพเพอร์ตี้นี้กําหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ เท่านั้น

DOOR_LOCK

สถานะล็อกประตูเป็น "จริง" บ่งบอกว่าประตูล็อกอยู่ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

DOOR_MOVE

ต้องกําหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ ระบบต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value maxInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของประตูขณะเปิด minInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของประตูขณะปิด

ค่าสัมบูรณ์ที่มากขึ้น ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น เมื่อประตูถึงขีดจำกัดตำแหน่ง ค่าต้องรีเซ็ตเป็น 0 หากค่าของ DOOR_MOVE เป็น 0 แสดงว่าไม่มีการเคลื่อนไหวเกิดขึ้นในขณะนี้

พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดหน่วยหนึ่ง แต่อยู่ในช่วงความเร็วสัมพัทธ์ที่ระบุ

DOOR_POS

ตำแหน่งประตู ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value minInt32Value บ่งบอกว่าประตูปิดอยู่ minInt32Value ต้องเท่ากับ 0 maxInt32Value แสดงว่าประตูเปิดจนสุด ค่าระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกสถานะการเปลี่ยนผ่านระหว่างสถานะปิดและสถานะเปิด

พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดหน่วยหนึ่ง แต่อยู่ในช่วงตำแหน่งสัมพัทธ์ที่ระบุ ยานพาหนะบางรุ่น (มินิแวน) สามารถเปิดประตูด้วยระบบไฟฟ้า จึงสามารถ WRITE พร็อพเพอร์ตี้นี้ได้ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

จาก ง ถึง ช

ELECTRONIC_TOLL_COLLECTION_CARD_STATUS

สถานะบัตรของระบบเก็บค่าผ่านทางอัตโนมัติ พร็อพเพอร์ตี้นี้ระบุสถานะของบัตร ETC ในยานพาหนะนี้ หากเครื่องเล่นวิทยุทราบว่ามีบัตร ETC ติดอยู่กับรถ ELECTRONIC_TOLL_COLLECTION_CARD_TYPE จะแสดงสถานะของบัตรนั้น มิเช่นนั้นพร็อพเพอร์ตี้นี้ควรเป็น UNAVAILABLE

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: ElectronicTollCollectionCardStatus
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

ประเภทบัตรของระบบเก็บค่าผ่านทางอัตโนมัติ (ETC) พร็อพเพอร์ตี้นี้ระบุประเภทของบัตร ETC ในรถคันนี้ หากส่วนหัวทราบว่ามีบัตร ETC ติดอยู่กับยานพาหนะ พร็อพเพอร์ตี้นี้ควรแสดงผลประเภทของบัตรที่แนบอยู่ มิเช่นนั้นพร็อพเพอร์ตี้นี้ควรเป็น UNAVAILABLE

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: ElectronicTollCollectionCardType
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

EMERGENCY_LANE_KEEP_ASSIST_ENABLED

เปิดหรือปิดใช้ระบบช่วยเลนฉุกเฉิน (ELKA) ตั้งค่าเป็น "จริง" เพื่อเปิดใช้ ELKA และ "เท็จ" เพื่อปิดใช้ ELKA เมื่อเปิดใช้ ELKA ระบบ ADAS ในรถควรเปิดอยู่และตรวจสอบการเปลี่ยนเลนที่ไม่ปลอดภัยโดยคนขับ เมื่อตรวจพบการขับขี่ที่ไม่ปลอดภัย ELKA จะแจ้งเตือนคนขับและใช้การแก้ไขการบังคับเลี้ยวเพื่อรักษาให้รถอยู่ในเลนเดิม โดยทั่วไป EMERGENCY_LANE_KEEP_ASSIST_ENABLED ควรแสดงผลลัพธ์เป็น "จริง" หรือ "เท็จ" เสมอ หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราว เช่น ความเร็วของยานพาหนะต่ำเกินไป ข้อมูลดังกล่าวจะต้องส่งผ่านค่า ErrorState ในพร็อพเพอร์ตี้ EMERGENCY_LANE_KEEP_ASSIST_STATE พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

EMERGENCY_LANE_KEEP_ASSIST_STATE

สถานะระบบช่วยเลนฉุกเฉิน (ELKA) แสดงสถานะปัจจุบันของ ELKA โดยทั่วไปแล้ว พร็อพเพอร์ตี้นี้ควรแสดงสถานะที่ถูกต้องซึ่งกำหนดไว้ใน EmergencyLaneKeepAssistState หรือ ErrorState ตัวอย่างเช่น หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราวบางอย่าง ระบบควรส่งข้อมูลผ่าน ErrorState สำหรับรหัสพื้นที่ส่วนกลาง (0) คุณต้องกำหนดอาร์เรย์ VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของ EmergencyLaneKeepAssistState (รวมถึง OTHER ซึ่งไม่แนะนำ) และ ErrorState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: EmergencyLaneKeepAssistState/ErrorState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

ENGINE_COOLANT_TEMP

อุณหภูมิของสารหล่อเย็นเครื่องยนต์

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:CELSIUS
รุ่น: Android 13

ENGINE_IDLE_AUTO_STOP_ENABLED

แสดงถึงฟีเจอร์สำหรับการหยุดเครื่องยนต์อัตโนมัติขณะเดินเบา หากเป็น "จริง" ยานพาหนะอาจปิดเครื่องยนต์โดยอัตโนมัติเมื่อไม่จำเป็น แล้วจึงสตาร์ทเครื่องยนต์อีกครั้งโดยอัตโนมัติเมื่อจำเป็น พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้เป็น VehiclePropertyAccess.READ เท่านั้น

ENGINE_OIL_LEVEL

ระดับน้ำมันเครื่อง

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: VehicleOilLevel
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

ENGINE_OIL_TEMP

อุณหภูมิของน้ำมันเครื่อง

ENGINE_RPM

รอบต่อนาทีของเครื่องยนต์ (RPM)

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:RPM
รุ่น: Android 13

ENV_OUTSIDE_TEMPERATURE

อุณหภูมิภายนอก พร็อพเพอร์ตี้นี้ต้องแสดงค่าอุณหภูมิของสภาพแวดล้อมภายนอกยานพาหนะ หากมีเซ็นเซอร์หลายตัวสำหรับวัดอุณหภูมิภายนอก ควรป้อนข้อมูลพร็อพเพอร์ตี้นี้ด้วยค่าเฉลี่ยหรือค่าเฉลี่ยถ่วงน้ำหนักที่สื่อความหมายของการอ่านค่า ซึ่งแสดงถึงอุณหภูมิของสภาพแวดล้อมภายนอกได้ดีที่สุด

EV_BATTERY_DISPLAY_UNITS

หน่วยแบตเตอรี่ EV สำหรับแสดงผล ระบุหน่วยที่รถใช้เพื่อแสดงข้อมูลแบตเตอรี่ EV ต่อผู้ใช้ เช่น วัตต์ชั่วโมง (Wh), กิโลวัตต์ชั่วโมง (kWh) หรือแอมป์ชั่วโมง (Ah) VehiclePropConfig.configArray ใช้เพื่อระบุพลังงานไฟฟ้าที่รองรับ หน่วย หน่วยพลังงานไฟฟ้าจะกำหนดไว้ใน VehicleUnit ตัวอย่างเช่น

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

หากการอัปเดต EV_BATTERY_DISPLAY_UNITS ส่งผลต่อค่าของพร็อพเพอร์ตี้ *_DISPLAY_UNITS อื่นๆ คุณต้องอัปเดตค่าของพร็อพเพอร์ตี้เหล่านั้นและแจ้งให้เฟรมเวิร์ก AAOS ทราบด้วย พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้เป็น VehiclePropertyAccess.READ เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: VehicleUnit
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

อัตราการชาร์จ EV ทันทีเป็นมิลลิวัตต์ ค่าบวกบ่งบอกว่าแบตเตอรี่กำลังชาร์จ ค่าลบแสดงว่าแบตเตอรี่กำลังหมด

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:MW
รุ่น: Android 13

EV_BATTERY_LEVEL

แสดงผลระดับแบตเตอรี่ปัจจุบัน ไม่ว่าจะใช้ EV หรือไฮบริด ค่านี้จะไม่เกิน EV_CURRENT_BATTERY_CAPACITY หากต้องการคำนวณเปอร์เซ็นต์แบตเตอรี่ ให้ใช้ (EV_BATTERY_LEVEL, EV_CURRENT_BATTERY_CAPACITY)*100

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:WH
รุ่น: Android 13

EV_BRAKE_REGENERATION_LEVEL

ระดับการเบรกแบบรีเจนเนอเรทีฟของยานพาหนะไฟฟ้า ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับค่าทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value minInt32Value ต้องเท่ากับ 0 maxInt32Value บ่งบอกถึงการตั้งค่าปริมาณพลังงานสูงสุดที่สร้างขึ้นจากการเบรก minInt32Value บ่งบอกการตั้งค่าสำหรับการไม่ใช้ระบบเบรกแบบใช้พลังงานจากแบตเตอรี่ พร็อพเพอร์ตี้นี้เป็นรูปแบบที่ละเอียดยิ่งขึ้นของ EV_REGENERATIVE_BRAKING_STATE ซึ่งช่วยให้ผู้ใช้ตั้งค่าระดับการเบรกแบบใช้พลังงานจากแบตเตอรี่ที่เฉพาะเจาะจงมากขึ้นได้หากสถานะใน EvRegenerativeBrakingState ไม่ละเอียดพอสำหรับ OEM พร็อพเพอร์ตี้นี้มีการกําหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

EV_CHARGE_CURRENT_DRAW_LIMIT

บ่งบอกเกณฑ์การดึงกระแสไฟฟ้าสูงสุดสำหรับการชาร์จที่ผู้ใช้ตั้งไว้ EvChargeState::configArray[0] ใช้เพื่อระบุปริมาณกระแสไฟฟ้าสูงสุดที่ยานพาหนะอนุญาตเป็นแอมป์ พร็อพเพอร์ตี้นี้กําหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITEREAD
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:AMPERE
รุ่น: Android 13

EV_CHARGE_PERCENT_LIMIT

ระบุเกณฑ์เปอร์เซ็นต์การเรียกเก็บเงินสูงสุดที่ผู้ใช้กำหนด ระบุเกณฑ์เปอร์เซ็นต์การเรียกเก็บเงินสูงสุดที่ผู้ใช้กำหนด แสดงผลค่าตัวเลขทศนิยมระหว่าง 0 ถึง 100 configArray ใช้เพื่อระบุค่าที่ถูกต้อง ตัวอย่างเช่น หากยานพาหนะรองรับค่าขีดจำกัดเปอร์เซ็นต์การชาร์จต่อไปนี้ [20, 40, 60, 80, 100] นั้น configArray ควรเป็น {20, 40, 60, 80, 100} หาก configArray ว่างเปล่า ค่าทั้งหมดตั้งแต่ 0 ถึง 100 ต้องเป็นค่าที่ถูกต้อง พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้เป็น VehiclePropertyAccess.READ เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE,, READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

EV_CHARGE_PORT_CONNECTED

เชื่อมต่อพอร์ตชาร์จ EV แล้ว หากยานพาหนะมีพอร์ตชาร์จหลายพอร์ต พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็นจริงเมื่อพอร์ตชาร์จใดพอร์ตหนึ่งเชื่อมต่ออยู่

EV_CHARGE_PORT_OPEN

พอร์ตชาร์จ EV เปิดอยู่ หากยานพาหนะมีพอร์ตชาร์จหลายพอร์ต พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น "จริง" หากพอร์ตชาร์จเปิดอยู่ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITEREAD
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

EV_CHARGE_STATE

สถานะการชาร์จของรถยนต์ แสดงสถานะการชาร์จปัจจุบันของรถยนต์ หากยานพาหนะมีเปอร์เซ็นต์การชาร์จเป้าหมายที่ไม่ใช่ 100 พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น EvChargeState::STATE_FULLY_CHARGED เมื่อระดับการชาร์จแบตเตอรี่ถึงระดับเป้าหมาย ดูบริบทเพิ่มเติมที่ EvChargeState::EV_CHARGE_PERCENT_LIMIT

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: EvChargeState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

EV_CHARGE_SWITCH

เริ่มหรือหยุดชาร์จแบตเตอรี่ EV การตั้งค่าที่ผู้ใช้ต้องการ การตั้งค่าพร็อพเพอร์ตี้นี้เป็น "จริง" จะเป็นการเริ่มชาร์จแบตเตอรี่ และการตั้งค่าเป็น "เท็จ" จะเป็นการหยุดชาร์จ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

EV_CHARGE_TIME_REMAINING

เวลาที่เหลือโดยประมาณในการชาร์จเป็นวินาที แสดงผลเป็น 0 หากรถไม่ได้ชาร์จ

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:SECS
รุ่น: Android 13

EV_CURRENT_BATTERY_CAPACITY

ความจุแบตเตอรี่ที่ใช้งานได้ในปัจจุบันสำหรับรถยนต์ไฟฟ้าหรือไฮบริด แสดงผลค่าจริงของความจุแบตเตอรี่เมื่อเป็น EV หรือไฮบริด พร็อพเพอร์ตี้นี้จะบันทึกความจุแบตเตอรี่ที่ใช้งานได้แบบเรียลไทม์ โดยพิจารณาจากปัจจัยต่างๆ เช่น อายุของแบตเตอรี่และอุณหภูมิ ค่านี้อาจแตกต่างจาก INFO_EV_BATTERY_CAPACITY เนื่องจาก INFO_EV_BATTERY_CAPACITY จะแสดงผลความจุแบตเตอรี่ที่ระบุตั้งแต่ตอนที่รถยังใหม่

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:WH
รุ่น: Android 14

EV_REGENERATIVE_BRAKING_STATE

การตั้งค่าการเบรกแบบใช้พลังงานจากแบตเตอรี่หรือระบบขับเคลื่อนด้วยคันเร่งเดียวของรถยนต์ แสดงผลการตั้งค่าปัจจุบันซึ่งเชื่อมโยงกับการตั้งค่าการเบรกแบบใช้พลังงานจากแบตเตอรี่ในรถยนต์ หาก OEM ต้องการการตั้งค่ามากกว่าที่ระบุไว้ใน EvRegenerativeBrakingState ให้ใช้พร็อพเพอร์ตี้ EV_BRAKE_REGENERATION_LEVEL แทน ซึ่งจะให้ข้อมูลที่ละเอียดยิ่งขึ้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: EvRegenerativeBrakingState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

EV_STOPPING_MODE

แสดงพร็อพเพอร์ตี้สำหรับโหมดการหยุดรถปัจจุบันของยานพาหนะ สำหรับรหัสพื้นที่ส่วนกลาง (0) ต้องกำหนด VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับค่า enum ทั้งหมดของ EvStoppingMode ในอนาคตเราอาจขยาย EvStoppingMode enum ให้รวมสถานะอื่นๆ เพิ่มเติม พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM มีตัวเลือกในการใช้งานเป็น VehiclePropertyAccess.READ เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: EvStoppingMode
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

EVS_SERVICE_REQUEST

เปิดใช้และขอใช้บริการ EVS ที่พักมีวิธีเรียกใช้บริการ EVS VHAL ควรใช้พร็อพเพอร์ตี้นี้เพื่อขอให้ Android เริ่มหรือหยุดบริการ EVS

int32Values[0] ประเภทบริการ EVS ค่าต้องเป็น enum ใน EvsServiceType
int32Values[1] สถานะของบริการ EVS ค่าต้องเป็นอย่างใดอย่างหนึ่งในรายการ EvsServiceState

เช่น หากต้องการเปิดใช้บริการ EVS มุมมองด้านหลัง Android สามารถตั้งค่าพร็อพเพอร์ตี้เป็น

[EvsServiceType::REAR_VIEW, EvsServiceState::ON]

EXTERNAL_CAR_TIME

คําแนะนําวันที่และเวลาปัจจุบันสําหรับ cr ซึ่งเข้ารหัสเป็นเวลา Epoch (เป็นมิลลิวินาที) ค่านี้หมายถึงจํานวนวินาทีมิลลิวินาทีที่ผ่านไปนับตั้งแต่วันที่ 1/1/1970 UTC พร็อพเพอร์ตี้นี้บ่งบอกถึงการเปลี่ยนแปลง CarTime เป็น Android หากระบบรองรับพร็อพเพอร์ตี้ VHAL ต้องรายงาน CarTime ปัจจุบันที่แม่นยำที่สุดเมื่ออ่านพร็อพเพอร์ตี้นี้ และเผยแพร่การเปลี่ยนแปลงในพร็อพเพอร์ตี้นี้เมื่อค่า CarTime มีการเปลี่ยนแปลง

คุณต้องเผยแพร่เหตุการณ์ "เมื่อเปลี่ยนแปลง" ของพร็อพเพอร์ตี้นี้เมื่อ CarTime เปลี่ยนแปลงด้วยเหตุผลอื่นนอกเหนือจากเวลาที่ผ่านไปตามปกติ (ค่าต่างของเวลาน้อยกว่า 500 มิลลิวินาทีไม่ควรทริกเกอร์เหตุการณ์ "เมื่อเปลี่ยนแปลง") Android จะอ่านและติดตามพร็อพเพอร์ตี้นี้เพื่อดึงข้อมูลเวลาจาก VHAL การดำเนินการนี้มีประโยชน์ในการซิงค์เวลาของ Android กับระบบอื่นๆ ของยานพาหนะ (นาฬิกาหน้าปัด) int64Values[0] = เวลาตามเขตเวลาของต้นฉบับที่ระบุ (เป็นมิลลิวินาที) ทุกครั้งที่ได้รับค่าใหม่สำหรับพร็อพเพอร์ตี้ AAOS จะสร้างและส่ง ExternalTimeSuggestion ไปยัง TimeDetectorService

หากแหล่งข้อมูลอื่นๆ ไม่มีลำดับความสำคัญสูงกว่า Android จะใช้ข้อมูลนี้เพื่อตั้งค่าเวลาของระบบ ดูข้อมูลเกี่ยวกับวิธีปรับลำดับความสำคัญของแหล่งข้อมูลเวลาและวิธีจัดการการแนะนำเวลา (รวมถึงวิธีที่ Android จัดการการกระวนกระวาย ความคลาดเคลื่อน และการแก้ไขขั้นต่ำ) ได้ที่เอกสารประกอบของบริการตรวจจับเวลา

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

เราขอแนะนำอย่างยิ่งว่าอย่าใช้พร็อพเพอร์ตี้นี้เพื่อดึงข้อมูลเวลาจาก ECU โดยใช้โปรโตคอล (เช่น GNSS, NTP และโทรศัพท์) เนื่องจาก Android รองรับโปรโตคอลเหล่านี้อยู่แล้ว เราขอแนะนำให้คุณใช้ระบบ Android แทนการเดินสายผ่าน VHAL ด้วยพร็อพเพอร์ตี้นี้

คำเตือน: ค่าที่ใช้ได้ผ่านพร็อพเพอร์ตี้นี้ไม่ควรขึ้นอยู่กับค่าที่ Android เขียนลงในพร็อพเพอร์ตี้ ANDROID_EPOCH_TIME

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:MILLI_SECS
รุ่น: Android 13

FOG_LIGHTS_STATE

สถานะไฟตัดหมอก แสดงสถานะปัจจุบันของไฟตัดหมอก ในกรณีต่อไปนี้

รถยนต์มีไฟตัดหมอกหน้าและหลัง ไฟตัดหมอกหน้าและหลังจะควบคุมร่วมกันได้เท่านั้น ต้องติดตั้งใช้งาน FOG_LIGHTS_STATE FRONT_FOG_LIGHTS_STATE และ REAR_FOG_LIGHTS_STATE ต้องไม่มีการใช้งาน
ไฟตัดหมอกหน้าและหลังจะควบคุมแยกกันได้เท่านั้น ต้องไม่ติดตั้งใช้งาน FOG_LIGHTS_STATE และติดตั้งใช้งาน FRONT_FOG_LIGHTS_STATE และ REAR_FOG_LIGHTS_STATE
รถมีเฉพาะไฟตัดหมอกหน้า ต้องติดตั้งใช้งาน FOG_LIGHTS_STATE หรือ FRONT_FOG_LIGHTS_STATE อย่างใดอย่างหนึ่งเท่านั้น (ไม่ใช่ทั้ง 2 อย่าง) ต้องไม่ติดตั้งใช้งาน REAR_FOG_LIGHTS_STATE
รถมีไฟตัดหมอกหลังเท่านั้น ต้องติดตั้งใช้งาน FOG_LIGHTS_STATE หรือ REAR_FOG_LIGHTS_STATE อย่างใดอย่างหนึ่งเท่านั้น (ไม่ใช่ทั้ง 2 อย่าง) ต้องไม่ติดตั้งใช้งาน FRONT_FOG_LIGHTS_STATE

FOG_LIGHTS_SWITCH

สวิตช์ไฟตัดหมอก การตั้งค่าที่ผู้ใช้ต้องการ ในกรณีต่อไปนี้

รถยนต์มีไฟตัดหมอกทั้งด้านหน้าและด้านหลัง หากไฟตัดหมอกหน้าและหลังควบคุมร่วมกันได้เท่านั้น ต้องใช้ FOG_LIGHTS_SWITCH ต้องไม่มีFRONT_FOG_LIGHTS_SWITCH และ REAR_FOG_LIGHTS_SWITCH
ไฟตัดหมอกหน้าและหลังจะควบคุมแยกกันได้เท่านั้น FOG_LIGHTS_SWITCH ต้องไม่ติดตั้งใช้งาน ต้องติดตั้งใช้งาน FRONT_FOG_LIGHTS_SWITCH และ REAR_FOG_LIGHTS_SWITCH
รถมีเฉพาะไฟตัดหมอกหน้า ต้องติดตั้งใช้งาน FOG_LIGHTS_SWITCH หรือ FRONT_FOG_LIGHTS_SWITCH อย่างใดอย่างหนึ่งเท่านั้น (ไม่ใช่ทั้ง 2 อย่าง) ต้องไม่ติดตั้งใช้งาน REAR_FOG_LIGHTS_SWITCH
รถมีไฟตัดหมอกหลังเท่านั้น ต้องติดตั้งใช้งาน FOG_LIGHTS_SWITCH หรือ REAR_FOG_LIGHTS_SWITCH เพียงอย่างใดอย่างหนึ่งเท่านั้น (ไม่ใช่ทั้ง 2 อย่าง) ต้องไม่ติดตั้งใช้งาน FRONT_FOG_LIGHTS_SWITCH

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: VehicleLightSwitch
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

FORWARD_COLLISION_WARNING_ENABLED

เปิดหรือปิดใช้ระบบเตือนการชนด้านหน้า (FCW) ตั้งค่าเป็น "จริง" เพื่อเปิดใช้ FCW และ "เท็จ" เพื่อปิดใช้ FCW เมื่อเปิดใช้ FCW ระบบ ADAS ในรถควรเปิดอยู่และตรวจสอบการชนที่อาจเกิดขึ้น โดยทั่วไป FORWARD_COLLISION_WARNING_ENABLED ควรแสดงผลลัพธ์เป็น "จริง" หรือ "เท็จ" เสมอ หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราว เช่น ความเร็วของยานพาหนะต่ำเกินไป ข้อมูลดังกล่าวจะต้องส่งผ่านค่า ErrorState ในพร็อพเพอร์ตี้ FORWARD_COLLISION_WARNING_STATE

FORWARD_COLLISION_WARNING_STATE

สถานะระบบเตือนการชนด้านหน้า (FCW) แสดงสถานะปัจจุบันของ FCW พร็อพเพอร์ตี้นี้ต้องแสดงสถานะที่ถูกต้องซึ่งกำหนดไว้ใน ForwardCollisionWarningState หรือ ErrorState เสมอ และต้องไม่แสดงข้อผิดพลาดผ่าน StatusCode และต้องใช้สถานะข้อผิดพลาดที่รองรับแทน สำหรับรหัสพื้นที่ส่วนกลาง (0) จะต้องกำหนดอาร์เรย์ VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของทั้ง ForwardCollisionWarningState (รวมถึง OTHER ซึ่งไม่แนะนำ) และ ErrorState

FRONT_FOG_LIGHTS_STATE

สถานะไฟตัดหมอกหน้า แสดงสถานะปัจจุบันของไฟตัดหมอกหน้า ต้องติดตั้งใช้งาน FOG_LIGHTS_STATE หรือ FRONT_FOG_LIGHTS_STATE อย่างใดอย่างหนึ่งเท่านั้น ดูข้อมูลเพิ่มเติมในเอกสารประกอบของ FOG_LIGHTS_STATE

FRONT_FOG_LIGHTS_SWITCH

สวิตช์ไฟตัดหมอกหน้า การตั้งค่าที่ผู้ใช้ต้องการ ต้องติดตั้งใช้งาน FOG_LIGHTS_SWITCH หรือ FRONT_FOG_LIGHTS_SWITCH อย่างใดอย่างหนึ่งเท่านั้น ดูข้อมูลเพิ่มเติมในเอกสารประกอบของ FOG_LIGHTS_SWITCH

FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

หน่วยการบริโภคเชื้อเพลิงสำหรับการแสดงผล ระบุประเภทหน่วยที่รถใช้เพื่อแสดงข้อมูลการบริโภคเชื้อเพลิงต่อผู้ใช้ True ระบุว่าหน่วยเป็นระยะทางต่อปริมาณ เช่น MPG เท็จ หมายถึงหน่วยเป็นปริมาตรต่อระยะทาง เช่น ลิตร/100 กม. พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM จะใช้เป็น VehiclePropertyAccess.READ เท่านั้น

FUEL_DOOR_OPEN

ประตูถังน้ำมันเปิดอยู่ พร็อพเพอร์ตี้นี้ต้องสื่อสารว่าประตูถังน้ำมันของยานพาหนะเปิดอยู่หรือไม่ พร็อพเพอร์ตี้นี้ใช้กับ EV ไม่ได้ กล่าวคือ หาก INFO_FUEL_TYPE มีเฉพาะ FuelType::FUEL_TYPE_ELECTRIC จะต้องไม่ใช้พร็อพเพอร์ตี้นี้ สำหรับ EV ให้ติดตั้ง EV_CHARGE_PORT_OPEN พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้เป็น VehiclePropertyAccess.READ เท่านั้น

FUEL_LEVEL

ปริมาณน้ำมันที่เหลืออยู่ในรถเป็นหน่วยมิลลิลิตร พร็อพเพอร์ตี้นี้ต้องระบุปริมาณน้ำมันที่เหลืออยู่ในรถเป็นมิลลิลิตร พร็อพเพอร์ตี้นี้ใช้กับยานพาหนะไฟฟ้าไม่ได้ กล่าวคือ หาก INFO_FUEL_TYPE มีเฉพาะ FuelType::FUEL_TYPE_ELECTRIC จะต้องไม่ใช้พร็อพเพอร์ตี้นี้ สําหรับ EV ให้ใช้ EV_BATTERY_LEVEL ค่าต้องไม่เกิน INFO_FUEL_CAPACITY

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:MILLILITER
รุ่น: Android 13

FUEL_LEVEL_LOW

คำเตือนระดับน้ำมันเชื้อเพลิงต่ำ พร็อพเพอร์ตี้นี้สอดคล้องกับคำเตือนน้ำมันเชื้อเพลิงเหลือน้อยบนหน้าแดชบอร์ด เมื่อตั้งค่า FUEL_LEVEL_LOW แล้ว ไม่ควรล้างค่าจนกว่าจะมีการเติมน้ำมันลงในรถ พร็อพเพอร์ตี้นี้สามารถพิจารณาแหล่งเชื้อเพลิงทั้งหมดในยานพาหนะ เช่น ใน

ยานพาหนะที่ใช้น้ำมัน พร็อพเพอร์ตี้นี้อิงตามระดับน้ำมันเท่านั้น
ยานพาหนะที่ขับเคลื่อนด้วยแบตเตอรี่ พร็อพเพอร์ตี้นี้อิงตามระดับแบตเตอรี่เท่านั้น
ยานพาหนะไฮบริด พร็อพเพอร์ตี้นี้อาจอิงตามระดับน้ำมันและแบตเตอรี่รวมกัน โดยขึ้นอยู่กับการพิจารณาของ OEM

FUEL_VOLUME_DISPLAY_UNITS

หน่วยปริมาณเชื้อเพลิงสำหรับการแสดงผล ระบุหน่วยที่รถใช้เพื่อแสดงปริมาณเชื้อเพลิงต่อผู้ใช้ เช่น ลิตรหรือแกลลอน VehiclePropConfig.configArray ใช้เพื่อระบุหน่วยการแสดงปริมาณเชื้อเพลิงที่รองรับ ระบบจะกำหนดหน่วยปริมาณใน VehicleUnit เช่น configArray[0] = LITER configArray[1] = GALLON หากการอัปเดต FUEL_VOLUME_DISPLAY_UNITS ส่งผลต่อค่าของพร็อพเพอร์ตี้ *_DISPLAY_UNITS อื่นๆ ก็ต้องอัปเดตค่าเหล่านั้นและสื่อสารกับเฟรมเวิร์ก AAOS ด้วย พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้เป็น VehiclePropertyAccess.READ เท่านั้น

GEAR_SELECTION

อุปกรณ์ที่ผู้ใช้เลือก ค่าในข้อมูลการกําหนดค่าต้องแสดงรายการเกียร์ที่รองรับสําหรับยานพาหนะนี้ ตัวอย่างเช่น ข้อมูลการกําหนดค่าสําหรับระบบเกียร์อัตโนมัติต้องมี {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_DRIVE, GEAR_1, GEAR_2,...} และสำหรับระบบเกียร์ธรรมดา รายการต้องเป็น {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...} สําหรับยานพาหนะที่ใช้ระบบเกียร์อัตโนมัติซึ่งอนุญาตให้ผู้ขับขี่เลือกเกียร์ที่ต้องการได้ (เช่น โหมดแมนวล) คุณต้องตั้งค่า GEAR_SELECTION เป็นเกียร์ที่ผู้ขับขี่เลือกแทน GEAR_DRIVE

GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT

ข้อกำหนดการปฏิบัติตามกฎระเบียบด้านความปลอดภัยทั่วไปของสหภาพยุโรป แสดงผลค่าเพื่อระบุว่าจำเป็นต้องปฏิบัติตามกฎระเบียบด้านความปลอดภัยทั่วไปหรือไม่ และหากจำเป็น ประเภทของข้อกำหนด

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: GsrComplianceRequirementType
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

GLOVE_BOX_DOOR_POS

พร็อพเพอร์ตี้ที่แสดงตำแหน่งปัจจุบันของประตูช่องเก็บของ ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value minInt32Value บ่งบอกว่าประตูกล่องเก็บถุงมือปิดอยู่ minInt32Value ต้องเท่ากับ 0 maxInt32Value บ่งบอกว่าประตูกล่องเก็บของอยู่ในตำแหน่งเปิดสุด ค่าระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกสถานะการเปลี่ยนระหว่างตำแหน่งปิดและเปิดจนสุด

พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดหน่วยหนึ่ง แต่อยู่ในช่วงตำแหน่งสัมพัทธ์ที่ระบุ รหัสพื้นที่ต้องตรงกับที่นั่งที่ตั้งใจจะใช้กล่องเก็บถุงมือ เช่น หากแดชบอร์ดด้านขวาด้านหน้ามีกล่องเก็บถุงมือฝังอยู่ รหัสพื้นที่ควรเป็น SEAT_1_RIGHT

GLOVE_BOX_LOCKED

ล็อกหรือปลดล็อกกล่องเก็บเอกสาร หากเป็นจริง กล่องเก็บถุงมือจะล็อกอยู่ หากเป็น "เท็จ" กล่องถุงมือจะปลดล็อกอยู่ รหัสพื้นที่ต้องตรงกับที่นั่งที่ตั้งใจจะใช้กล่องเก็บถุงมือ เช่น หากหน้าแดชบอร์ดด้านขวามีกล่องเก็บถุงมือแบบฝัง รหัสพื้นที่ควรเป็น VehicleAreaSeat#ROW_1_RIGHT

H ถึง I

HANDS_ON_DETECTION_DRIVER_STATE

สถานะผู้ขับขี่ของการตรวจจับมือจับพวงมาลัย (HOD) แสดงผลว่ามือของคนขับอยู่บนพวงมาลัยหรือไม่ โดยทั่วไปแล้ว พร็อพเพอร์ตี้นี้ควรแสดงผลสถานะที่ถูกต้องซึ่งกำหนดไว้ใน HandsOnDetectionDriverState หรือ ErrorState เช่น หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราวบางอย่าง ระบบควรแสดงข้อมูลผ่าน ErrorState หากยานพาหนะต้องการส่งคำเตือนไปยังผู้ใช้เนื่องจากมือของผู้ขับขี่ไม่ได้จับพวงมาลัยเป็นเวลานานเกินไป ระบบควรแสดงคำเตือนผ่าน HANDS_ON_DETECTION_WARNING สำหรับรหัสพื้นที่ส่วนกลาง (0) คุณต้องกำหนดอาร์เรย์ VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของทั้ง HandsOnDetectionDriverState (รวมถึง OTHER ซึ่งไม่แนะนำ) และ ErrorState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: HandsOnDetectionDriverState/ErrorState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

HANDS_ON_DETECTION_ENABLED

เปิดหรือปิดใช้การตรวจจับมือจับ (HOD) ตั้งค่าเป็น "จริง" เพื่อเปิดใช้ HOD และ "เท็จ" เพื่อปิดใช้ HOD เมื่อเปิดใช้ HOD ระบบภายในรถควรตรวจสอบว่ามือของผู้ขับขี่อยู่บนพวงมาลัยหรือไม่ และจะส่งคำเตือนหากตรวจพบว่ามือของผู้ขับขี่ไม่ได้อยู่บนพวงมาลัยแล้ว โดยทั่วไป HANDS_ON_DETECTION_ENABLED ควรแสดงผลลัพธ์เป็น "จริง" หรือ "เท็จ" เสมอ

หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราวบางอย่าง คุณต้องส่งข้อมูลผ่านค่า ErrorState ในพร็อพเพอร์ตี้ HANDS_ON_DETECTION_STATE พร็อพเพอร์ตี้นี้กำหนดเป็น minInt32Value VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้ใน VehiclePropertyAccess.READ เท่านั้น

HANDS_ON_DETECTION_WARNING

คำเตือนการตรวจจับมือจับ (HOD) แสดงผลว่าระบบส่งคำเตือนไปยังคนขับหรือไม่เนื่องจากมือไม่ได้จับพวงมาลัยเป็นเวลานานเกินไป โดยทั่วไป พร็อพเพอร์ตี้นี้ควรแสดงผลสถานะที่ถูกต้องซึ่งกำหนดไว้ใน HandsOnDetectionWarning หรือ ErrorState เช่น หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราวบางอย่าง ข้อมูลดังกล่าวควรส่งผ่าน ErrorState สำหรับรหัสพื้นที่ส่วนกลาง (0) คุณต้องกำหนดอาร์เรย์ VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของทั้ง HandsOnDetectionWarning (รวมถึง OTHER ซึ่งไม่แนะนำ) และ ErrorState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: HandsOnDetectionWarning/ErrorState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

HAZARD_LIGHTS_STATE

สถานะไฟฉุกเฉิน แสดงสถานะปัจจุบันของไฟฉุกเฉิน

HAZARD_LIGHTS_SWITCH

สวิตช์ไฟฉุกเฉิน การตั้งค่าที่ผู้ใช้ต้องการ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

HEADLIGHTS_STATE

สถานะไฟหน้า แสดงสถานะปัจจุบันของไฟหน้า

HEADLIGHTS_SWITCH

สวิตช์ไฟหน้า การตั้งค่าที่ผู้ใช้ต้องการ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

HIGH_BEAM_LIGHTS_STATE

สถานะไฟสูง แสดงสถานะปัจจุบันของไฟสูง

HIGH_BEAM_LIGHTS_SWITCH

สวิตช์ไฟสูง การตั้งค่าที่ผู้ใช้ต้องการ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

HVAC_AC_ON

เปิดและปิดแอร์สำหรับ areaId ที่ระบุ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ ได้

HVAC_ACTUAL_FAN_SPEED_RPM

ความเร็วพัดลมจริง

HVAC_AUTO_ON

เปิดและปิดระบบควบคุมอุณหภูมิอัตโนมัติ หากเป็น "จริง" แสดงว่าระบบควบคุมอุณหภูมิอัตโนมัติเปิดอยู่ หากเป็นเท็จ ระบบปรับอากาศอัตโนมัติจะปิดอยู่ หากรถไม่รองรับการปิดระบบปรับอากาศอัตโนมัติโดยตรง OEM ควรเพิ่มตรรกะในการใช้งาน VHAL เพื่อตั้งค่า HVAC_AUTO_ON เป็นเท็จ ซึ่งจะเปลี่ยนการตั้งค่า HVAC ที่จำเป็นเพื่อปิด HVAC_AUTO_ON โดยอ้อม โดยหลักการแล้ว การดำเนินการนี้ไม่ควรรบกวนผู้ใช้ OEM ควรเปลี่ยนการตั้งค่าที่แก้ไขเมื่อระบบปรับอากาศอัตโนมัติปิดอยู่กลับเป็นสถานะก่อนหน้า วิธีนี้จะทำให้ผลลัพธ์เพียงอย่างเดียวคือ HVAC_AUTO_ON จะปิดอยู่ หากกู้คืนการตั้งค่า HVAC เป็นการตั้งค่าก่อนหน้าไม่ได้ OEM ควรทำการเปลี่ยนแปลงที่รบกวนน้อยที่สุด

HVAC_AUTO_RECIRC_ON

เปิดหรือปิดการไหลเวียนอากาศอัตโนมัติ เมื่อการไหลเวียนอากาศอัตโนมัติเปิดอยู่ ระบบ HVAC อาจเปลี่ยนไปใช้โหมดการไหลเวียนอากาศโดยอัตโนมัติหากยานพาหนะตรวจพบคุณภาพอากาศที่ไม่ดี พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้เป็น VehiclePropertyAccess.READ เท่านั้น

HVAC_DEFROSTER

ละลายน้ำแข็งด้วยพัดลมสำหรับหน้าต่างที่ระบุ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ ได้

HVAC_DUAL_ON

เปิดใช้การเชื่อมโยงอุณหภูมิระหว่างพื้นที่ AreaIDs สำหรับพร็อพเพอร์ตี้ HVAC_DUAL_ON จะต้องมีชุดค่าผสมของ HVAC_TEMPERATURE_SET AreaIDs ที่จับคู่กันได้ หาก HVAC_TEMPERATURE_SET แมปกับ AreaIDs[a_1, a_2, ..., a_n] และหากเปิดใช้ HVAC_DUAL_ON เพื่อจับคู่ a_i กับ a_j ได้ พร็อพเพอร์ตี้ HVAC_DUAL_ON จะต้องแมปกับ [a_i | a_j] นอกจากนี้ หาก a_k และ a_l จับคู่กันแยกกันได้เช่นกัน HVAC_DUAL_ON จะต้องแมปกับ [a_i | a_j, a_k | a_l] เช่น รถยนต์มีเบาะหน้า 2 ที่นั่ง (ROW_1_LEFT และ ROW_1_RIGHT) และเบาะหลัง 3 ที่นั่ง (ROW_2_LEFT, ROW_2_CENTER และ ROW_2_RIGHT) มีชุดควบคุมอุณหภูมิ 2 ชุด ได้แก่ ฝั่งคนขับและฝั่งผู้โดยสาร ซึ่งสามารถซิงค์กันได้ ซึ่งสามารถเขียนเป็นรูปแบบนี้ใน AreaIDs

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

เมื่อเปิดใช้พร็อพเพอร์ตี้ ECU ต้องซิงค์อุณหภูมิของพื้นที่ที่ได้รับผลกระทบ พารามิเตอร์ใดๆ ที่แก้ไขเป็นผลข้างเคียงของการเปิดหรือปิดพารามิเตอร์ DUAL_ON จะสร้าง onPropertyEvent() การเรียกกลับไปยัง VHAL นอกจากนี้ หากการตั้งค่าอุณหภูมิ (เช่น อุณหภูมิฝั่งคนขับ) เปลี่ยนอุณหภูมิอื่น (เช่น อุณหภูมิผู้โดยสารด้านหน้า) จะต้องสร้าง onPropertyEvent() callback ที่เหมาะสม

หากผู้ใช้เปลี่ยนอุณหภูมิที่ทำลายการเชื่อมโยง (เช่น ตั้งค่าอุณหภูมิสำหรับผู้โดยสารอิสระ) VHAL จะต้องส่ง onPropertyEvent() callback ที่เหมาะสม (รวมถึง HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx) พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ ได้

HVAC_ELECTRIC_DEFROSTER_ON

สถานะของเครื่องทำละลายน้ำแข็งไฟฟ้า

พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ ได้

HVAC_FAN_DIRECTION

การตั้งค่าทิศทางพัดลม พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: VehicleHvacFanDirection
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

HVAC_FAN_DIRECTION_AVAILABLE

ตำแหน่งพัดลมที่ใช้ได้ นี่คือบิตมาสก์ของตำแหน่งพัดลมที่ใช้ได้สำหรับโซน ทิศทางพัดลมแต่ละทิศทางที่พร้อมใช้งานจะแสดงด้วยรายการแยกกันในเวกเตอร์ ทิศทางของพัดลมอาจมีบิตหลายรายการจากชุด vehicle_hvac_fan_direction ตัวอย่างเช่น รถทั่วไปอาจมีตำแหน่งพัดลมดังนี้

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

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: VehicleHvacFanDirection
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

HVAC_FAN_SPEED

การตั้งค่าความเร็วพัดลม ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

minInt32Value ความเร็วพัดลมต่ำสุด
maxInt32Value ความเร็วพัดลมสูงสุด

พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดโดยเฉพาะ แต่อยู่ในช่วงความเร็วสัมพัทธ์ที่ระบุ พร็อพเพอร์ตี้นี้กําหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถเลือกที่จะติดตั้งใช้งานเป็น VehiclePropertyAccess.READ เท่านั้น

HVAC_MAX_AC_ON

เปิดหรือปิด MAX AC เมื่อเปิด MAX AC อยู่ ECU จะปรับรายการต่างๆ เช่น ตำแหน่งช่องระบายอากาศ ความเร็วพัดลม และอุณหภูมิได้ตามต้องการเพื่อทำให้รถเย็นลงอย่างรวดเร็วที่สุด พารามิเตอร์ใดๆ ที่แก้ไขเป็นผลข้างเคียงของการเปิดหรือปิดพารามิเตอร์ MAX AC จะสร้างonPropertyEvent()การเรียกกลับไปยัง VHAL พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ ได้

HVAC_MAX_DEFROST_ON

เปิดและปิด MAX DEFROST เมื่อเปิด MAX DEFROST อยู่ ECU จะปรับรายการต่างๆ เช่น ตำแหน่งช่องระบายอากาศ ความเร็วพัดลม และอุณหภูมิได้ตามต้องการเพื่อละลายน้ำแข็งบนกระจกอย่างรวดเร็วที่สุด พารามิเตอร์ใดๆ ที่แก้ไขเป็นผลข้างเคียงของการเปิดหรือปิดพารามิเตอร์ MAX DEFROST จะสร้างonPropertyEvent()การเรียกกลับไปยัง VHAL AreaIDs สำหรับ HVAC_MAX_DEFROST_ON บ่งบอกว่าสามารถควบคุมระบบหรี่ไฟสูงสุดได้ในพื้นที่ ตัวอย่างเช่น areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT} บ่งบอกว่า HVAC_MAX_DEFROST_ON ควบคุมได้เฉพาะแถวหน้า พร็อพเพอร์ตี้นี้มีการกําหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ ได้

HVAC_POWER_ON

แสดงสถานะพลังงานส่วนกลางสำหรับระบบปรับอากาศ (HVAC) การตั้งค่าพร็อพเพอร์ตี้นี้เป็น "เท็จ" อาจทําให้ระบบทําเครื่องหมายพร็อพเพอร์ตี้บางอย่างที่ควบคุมฟีเจอร์และระบบย่อยของ HVAC แต่ละรายการเป็น "ไม่พร้อมใช้งาน" การตั้งค่าพร็อพเพอร์ตี้นี้เป็น "จริง" อาจทําให้พร็อพเพอร์ตี้บางรายการที่ควบคุมฟีเจอร์และระบบย่อย HVAC แต่ละรายการมีสถานะเป็น "พร้อมใช้งาน" (เว้นแต่ว่าพร็อพเพอร์ตี้บางรายการหรือทั้งหมดจะ "ไม่พร้อมใช้งาน" อยู่แล้ว)

HvacPower_DependentProperties คือที่พักที่ต้องเปิดระบบ HVAC เพื่อเปิดใช้ฟังก์ชันการทำงาน ตัวอย่างเช่น ในรถบางรุ่น หากต้องการเปิดแอร์ คุณต้องเปิดระบบปรับอากาศ (HVAC) ก่อน รายการ HvacPower_DependentProperties ต้องตั้งค่าใน VehiclePropConfig.configArray HvacPower_DependentProperties ต้องมีเฉพาะพร็อพเพอร์ตี้ที่เชื่อมโยงกับ VehicleArea:SEAT

หมายเหตุ: พร็อพเพอร์ตี้ที่ไม่ได้เชื่อมโยงกับ VehicleArea:SEAT (เช่น HVAC_DEFROSTER) ต้องไม่ใช้พร็อพเพอร์ตี้ HVAC_POWER_ON และต้องไม่อยู่ในรายการ HvacPower_DependentProperties

การแมป AreaID สําหรับพร็อพเพอร์ตี้ HVAC_POWER_ON ต้องมี AreaIDs ทั้งหมดที่ HvacPower_DependentProperties แมปไว้ เช่น รถยนต์มี 2 รายการ ได้แก่

เบาะหน้า (ROW_1_LEFT, ROW_1_RIGHT) และเบาะหลัง 3 ที่นั่ง (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) หากฟีเจอร์ HVAC (แอร์ อุณหภูมิ ฯลฯ) ทั่วทั้งรถขึ้นอยู่กับตัวควบคุมกำลังไฟฟ้า HVAC ตัวเดียว HVAC_POWER_ON จะต้องแมปกับ [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
ที่นั่งแถวหน้า (ROW_1_LEFT, ROW_1_RIGHT) และที่นั่ง 3 ตัวแถวที่ 2 (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) และแถวที่ 3 (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT) หากรถมีตัวควบคุมอุณหภูมิแถวหน้าที่สามารถทำงานได้โดยไม่เกี่ยวข้องกับตัวควบคุมอุณหภูมิด้านหลังของรถเลย HVAC_POWER_ON จะต้องแมปกับอาร์เรย์ 2 องค์ประกอบ ดังนี้
```
- ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
```

พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM มีตัวเลือกในการใช้งานเป็น VehiclePropertyAccess.READ เท่านั้น

HVAC_RECIRC_ON

เปิดและปิดการไหลเวียนอากาศภายใน ควบคุมการจ่ายอากาศภายนอกไปยังห้องโดยสาร การหมุนเวียนอากาศ เปิดหมายความว่าอากาศส่วนใหญ่ที่เข้าสู่ห้องโดยสารมาจากห้องโดยสาร การหมุนเวียนอากาศ ปิด หมายความว่าอากาศส่วนใหญ่ที่เข้าสู่ห้องโดยสารมาจากภายนอกรถ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ ได้

HVAC_SEAT_TEMPERATURE

ระบบทำความร้อนและความเย็นของเบาะนั่ง ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value maxInt32Value แสดงการตั้งค่าการทำความร้อนสูงสุดของอุณหภูมิเบาะ minInt32Value ต้องเท่ากับ 0 เว้นแต่ว่ายานพาหนะจะรองรับการทำความเย็นเบาะ ในกรณีนี้ minInt32Value หมายถึงการตั้งค่าความเย็นสูงสุดของอุณหภูมิเบาะ พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดหน่วยหนึ่ง แต่อยู่ในการตั้งค่าอุณหภูมิสัมพัทธ์ในช่วงที่ระบุ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM จะใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

HVAC_SEAT_VENTILATION

ระบบระบายอากาศเบาะนั่ง ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value minInt32Value ต้องเท่ากับ 0 maxInt32Value บ่งบอกถึงการตั้งค่าการระบายอากาศสูงสุดที่ใช้ได้กับเบาะ

พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดหน่วยหนึ่ง แต่อยู่ในช่วงการตั้งค่าการระบายอากาศที่ระบุ

แอป HVAC และ Assistant ใช้เพื่อเปิดใช้ เปลี่ยน หรืออ่านสถานะการระบายอากาศของที่นั่ง ซึ่งแตกต่างจากการทำความเย็นเบาะนั่ง โดยอาจเปิดอยู่ขณะที่ระบบทำความเย็นทำงานหรือไม่ก็ได้

พร็อพเพอร์ตี้นี้กำหนดเป็น >VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้เป็น VehiclePropertyAccess.READ เท่านั้น

HVAC_SIDE_MIRROR_HEAT

ความร้อนจากกระจกมองข้าง ค่าที่เพิ่มขึ้นหมายถึงระดับการทำความร้อนที่สูงขึ้นสำหรับกระจกมองข้าง คุณต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig โดยต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value ในข้อมูลการกําหนดค่า

maxInt32Value แสดงถึงระดับการทำความร้อนสูงสุด
minInt32Value ต้องเท่ากับ 0 และระบุว่าไม่มีการทำความร้อน

พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดหน่วยหนึ่ง แต่อยู่ในช่วงการตั้งค่าการทำความร้อนแบบสัมพัทธ์ที่ระบุ พร็อพเพอร์ตี้นี้กําหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM มีตัวเลือกในการใช้งานเป็น VehiclePropertyAccess.READ

HVAC_STEERING_WHEEL_HEAT

ตั้งค่าระดับการทำความร้อนและความเย็นสำหรับพวงมาลัย ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ระบบต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value maxInt32Value แสดงการตั้งค่าการทำความร้อนของพวงมาลัยสูงสุด minInt32Value ควรเป็น 0 เว้นแต่ว่ารถจะรองรับการทำความเย็นพวงมาลัยด้วย ในกรณีนี้ minInt32Value หมายถึงการตั้งค่าความเย็นของพวงมาลัยสูงสุด พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดหน่วยหนึ่งโดยเฉพาะ แต่อยู่ในช่วงการตั้งค่าการทำความร้อนที่ระบุ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ แต่ OEM จะใช้เป็น VehiclePropertyAccess.READ เท่านั้น

HVAC_TEMPERATURE_CURRENT

อุณหภูมิปัจจุบันของระบบปรับอากาศ (HVAC)

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:CELSIUS
รุ่น: Android 13

HVAC_TEMPERATURE_DISPLAY_UNITS

หน่วยอุณหภูมิสำหรับการแสดงผล ระบุว่าอุณหภูมิจะแสดงเป็นเซลเซียสหรือฟาเรนไฮต์ VehiclePropConfig.configArray หมายถึงหน่วยการแสดงอุณหภูมิที่รองรับ เช่น configArray[0] = CELSIUS configArray[1] = FAHRENHEIT พารามิเตอร์นี้อาจใช้เพื่อแสดงอุณหภูมิของระบบปรับอากาศ (HVAC) ในระบบ ค่าต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ VehicleUnit.CELSIUS หรือ VehicleUnit.FAHRENHEIT

หากการอัปเดต HVAC_TEMPERATURE_DISPLAY_UNITS ส่งผลต่อค่าของ*_DISPLAY_UNITSพร็อพเพอร์ตี้อื่นๆ ก็จะต้องอัปเดตค่าเหล่านั้นและสื่อสารกับเฟรมเวิร์ก AAOS

พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ เท่านั้น

HVAC_TEMPERATURE_SET

อุณหภูมิเป้าหมายของระบบปรับอากาศ (HVAC) ที่กําหนดเป็นหน่วยเซลเซียส

ต้องกำหนด minFloatValue และ maxFloatValue ใน VehicleAreaConfig ดังนี้

minFloatValue การตั้งค่าอุณหภูมิต่ำสุดเป็นหน่วยเซลเซียส
การตั้งค่าอุณหภูมิสูงสุด maxFloatValue ในหน่วยเซลเซียส

หากระบบไม่รองรับค่าทั้งหมดระหว่าง minFloatValue ถึง maxFloatValue ให้ใช้ configArray เพื่อแสดงค่าอุณหภูมิที่ถูกต้องซึ่งตั้งค่าได้ ข้อมูลนี้ยังอธิบายตารางการค้นหาเพื่อแปลงอุณหภูมิจากเซลเซียสเป็นฟาเรนไฮต์ (และในทางกลับกัน) สำหรับยานพาหนะด้วย ต้องกำหนด configArray หากรถไม่รองรับการแปลงหน่วยมาตรฐาน

configArray มีการตั้งค่าดังนี้

configArray[0] [lower bound of supported temperature in Celsius] * 10
configArray[1] [ขีดจำกัดบนของอุณหภูมิที่รองรับเป็นองศาเซลเซียส] * 10
configArray[2] [การเพิ่มขึ้นเป็นองศาเซลเซียส] * 10
configArray[3] [ขอบเขตล่างของอุณหภูมิที่รองรับเป็นฟาเรนไฮต์] * 10
configArray[4] [ขีดจำกัดบนของอุณหภูมิที่รองรับในหน่วยฟาเรนไฮต์] * 10
configArray[5] [การเพิ่มขึ้นเป็นฟาเรนไฮต์] * 10

minFloatValue และ maxFloatValue ใน VehicleAreaConfig ต้องเท่ากับ configArray[0] และ configArray[1] ตามลำดับ เช่น หากยานพาหนะรองรับค่าอุณหภูมิเป็น [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5] ในฟาเรนไฮต์ configArray ควรเป็น configArray = {160, 280, 5, 605, 845, 10}

โดยหลักการแล้ว อัตราส่วนของการเพิ่มค่าองศาเซลเซียสต่อการเพิ่มค่าองศาฟาเรนไฮต์ควรใกล้เคียงกับอัตราส่วนจริงของ 1 องศาเซลเซียสต่อ 1.8 องศาฟาเรนไฮต์ ต้องมีการแมปแบบ 1:1 ของค่าเซลเซียสทั้งหมดกับค่าฟาเรนไฮต์ที่ระบุโดย configArray ลูกค้าจะใช้ configArray เพื่อแปลงอุณหภูมิของพร็อพเพอร์ตี้นี้จากเซลเซียสเป็นฟาเรนไฮต์ นอกจากนี้ ยังช่วยให้ลูกค้าทราบค่าเซลเซียสที่จะตั้งค่าพร็อพเพอร์ตี้เพื่อให้ได้ค่าฟาเรนไฮต์ที่ต้องการสำหรับระบบ หาก ECU ไม่มีการแมปค่าองศาเซลเซียสทั้งหมดกับค่าองศาฟาเรนไฮต์แบบ 1:1 configArray ควรกำหนดเฉพาะรายการค่าองศาเซลเซียสและองศาฟาเรนไฮต์ที่มีการแมปแบบ 1:1

ตัวอย่างเช่น หาก ECU รองรับค่าองศาเซลเซียสตั้งแต่ 16 ถึง 28 และค่าองศาฟาเรนไฮต์ตั้งแต่ 60 ถึง 85 โดยแต่ละค่าเพิ่มขึ้นทีละ 1 configArray ที่เป็นไปได้รูปแบบหนึ่งคือ รหัส>{160, 280, 10, 600, 840, 20} ในกรณีนี้ 85 ไม่ใช่อุณหภูมิที่รองรับ

ค่าที่ตั้งไว้ระหว่างค่าที่ถูกต้องควรปัดเศษเป็นค่าที่ถูกต้องซึ่งใกล้เคียงที่สุด เราขอแนะนําอย่างยิ่งให้ OEM ใช้พร็อพเพอร์ตี้ยานพาหนะ HVAC_TEMPERATURE_VALUE_SUGGESTION ด้วย เนื่องจากพร็อพเพอร์ตี้นี้ช่วยให้แอปพลิเคชันมีวิธีการง่ายๆ ในการพิจารณาค่าอุณหภูมิที่ตั้งค่าสําหรับยานพาหนะได้ และแปลงค่าระหว่างองศาเซลเซียสและองศาฟาเรนไฮต์

พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ ได้

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:CELSIUS
รุ่น: Android 13

HVAC_TEMPERATURE_VALUE_SUGGESTION

ค่าที่แนะนำสำหรับการตั้งค่าอุณหภูมิ HVAC

ใช้พร็อพเพอร์ตี้นี้เพื่อช่วยแอปพลิเคชันเข้าใจค่าอุณหภูมิที่รองรับซึ่งใกล้เคียงที่สุดเป็นองศาเซลเซียสหรือฟาเรนไฮต์

floatValues[0] ค่าที่ขอซึ่งแอปต้องการตั้งอุณหภูมิ
floatValues[1] หน่วยสำหรับ floatValues[0] และควรเป็นหนึ่งใน {VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
floatValues[2] ค่าที่ OEM แนะนำเป็น CELSIUS (ค่านี้ไม่รวมอยู่ในคำขอ)
floatValues[3] ค่าที่ OEM แนะนำเป็นฟาเรนไฮต์ (ค่านี้ไม่รวมอยู่ในคำขอ)

แอปพลิเคชันเรียกใช้ set(VehiclePropValue propValue) ด้วยค่าที่ขอ และหน่วยของค่า OEM ต้องแสดงค่าที่แนะนำใน floatValues[2] และ floatValues[3] โดย onPropertyEvent() callbacks ค่าที่แนะนำต้องสอดคล้องกับค่าที่ดึงมาจาก HVAC_TEMPERATURE_SET configArray กล่าวคือ ค่าที่แนะนำและตารางค่าจาก configArray ควรเหมือนกัน

เราขอแนะนำให้ OEM เพิ่มตรรกะที่กำหนดเองในการใช้งาน VHAL เพื่อหลีกเลี่ยงการส่งคำขอไปยัง ECU ของระบบปรับอากาศ ตรรกะอาจเป็นดังนี้ วิธีแปลงอุณหภูมิจากเซลเซียสเป็นฟาเรนไฮต์

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

เช่น เมื่อผู้ขับขี่ใช้ผู้ช่วยเสียงเพื่อตั้งค่าอุณหภูมิ HVAC เป็น 66.2 ในฟาเรนไฮต์ ก่อนอื่น แอปพลิเคชันจะตั้งค่าพร็อพเพอร์ตี้นี้ด้วยค่า [66.2, (float)VehicleUnit.FAHRENHEIT,0,0] หาก OEM แนะนำให้ตั้งค่าเป็น 19.0 องศาเซลเซียสหรือ 66.5 องศาฟาเรนไฮต์ตามคำขอของผู้ใช้ VHAL ต้องสร้างการเรียกกลับพร้อมค่าพร็อพเพอร์ตี้ [66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5] หลังจากผู้ช่วยเสียงได้รับการเรียกกลับแล้ว ก็จะแจ้งให้ผู้ใช้ทราบและตั้งค่าอุณหภูมิ HVAC เป็นค่าที่แนะนำ

อีกตัวอย่างหนึ่งคือ แอปได้รับค่าอุณหภูมิปัจจุบันเป็น 21 องศาเซลเซียสจากการค้นหา HVC_TEMPERATURE_SET แต่แอปจำเป็นต้องทราบว่าค่าใดแสดงใน UI ของรถเป็นฟาเรนไฮต์ ในกรณีนี้ แอปจะตั้งค่าพร็อพเพอร์ตี้เป็น [21, (float)VehicleUnit.CELSIUS, 0, 0] หากค่าที่ OEM แนะนำสำหรับ 21 องศาเซลเซียสคือ 70 องศาฟาเรนไฮต์ VHAL จะต้องสร้างการเรียกกลับที่มีค่าพร็อพเพอร์ตี้เป็น [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0] ในกรณีนี้ แอปจะทราบว่าค่าคือ 70.0 องศาฟาเรนไฮต์ใน UI ของรถยนต์

HW_CUSTOM_INPUT

กําหนดเหตุการณ์อินพุตของพาร์ทเนอร์ OEM ที่กําหนดเอง พาร์ทเนอร์ OEM ที่ต้องการเผยแพร่เหตุการณ์ที่ Android ไม่รองรับต้องใช้เหตุการณ์อินพุตนี้ โดยประกอบด้วยอาร์เรย์ของค่า int32 เท่านั้น พร็อพเพอร์ตี้ Android มีดังนี้

int32Values[0] ป้อนโค้ดที่ระบุฟังก์ชันที่แสดงถึงเหตุการณ์นี้ ประเภทเหตุการณ์ที่ถูกต้องจะกําหนดโดย CustomInputType.CUSTOM_EVENT_F1 สูงสุด CustomInputType.CUSTOM_EVENT_F10 ประเภท โดยเป็นเหตุการณ์ที่กําหนดเองซึ่งพาร์ทเนอร์ OEM จะกําหนด
int32Values[1] ประเภทการแสดงผลเป้าหมายที่กําหนดไว้ใน VehicleDisplay ต้องส่งเหตุการณ์ที่ไม่ได้เชื่อมโยงกับการแสดงผลที่เฉพาะเจาะจงไปยัง VehicleDisplay#MAIN
int32Values[2] ตัวนับการทําซ้ำ หากเป็น 0 เหตุการณ์จะไม่ซ้ำ ค่า 1 ขึ้นไปแสดงจํานวนครั้งที่เหตุการณ์นี้เกิดขึ้นซ้ำ

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: CustomInputType
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

HW_KEY_INPUT

พร็อพเพอร์ตี้สำหรับส่งเหตุการณ์การป้อนข้อมูลของฮาร์ดแวร์ไปยัง Android

int32Values[0] การดําเนินการที่กําหนดโดย VehicleHwKeyInputAction
int32Values[1] รหัสคีย์ ต้องใช้รหัสคีย์ Android มาตรฐาน
int32Values[2] การแสดงผลเป้าหมายที่กําหนดไว้ใน VehicleDisplay ต้องส่งเหตุการณ์ที่ไม่ได้เชื่อมโยงกับการแสดงผลที่เฉพาะเจาะจงไปยัง VehicleDisplay#MAIN
int32Values[3] (ไม่บังคับ) จำนวนเครื่องหมาย ค่าต้องเท่ากับหรือมากกว่า 1 หากไม่ระบุ Android จะมีค่าเริ่มต้นเป็น 1

เปลี่ยนโหมด:ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

HW_KEY_INPUT_V2

พร็อพเพอร์ตี้สำหรับส่งเหตุการณ์การป้อนข้อมูลของฮาร์ดแวร์ไปยัง Android

int32array[0] จอแสดงผลเป้าหมายที่กําหนดโดย VehicleDisplay เช่น
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
int32array[1] รหัสคีย์ ต้องใช้รหัสคีย์มาตรฐานของ Android เช่น KEYCODE_HOME และ KEYCODE_BACK
การดำเนินการ int32array[2] ที่กําหนดไว้ใน VehicleHwKeyInputAction เช่น
VehicleHwKeyInputAction::ACTION_UP, VehicleHwKeyInputAction::ACTION_UP
int32array[3] จํานวนการเกิดซ้ำของเหตุการณ์ สําหรับเหตุการณ์การกดแป้นลง ข้อมูลนี้คือจํานวนการกดซ้ำ โดยเริ่มจาก 0 สำหรับการกดแป้นลงครั้งแรก และนับจาก 0 ขึ้นไป สําหรับเหตุการณ์การกดแป้นขึ้น ค่านี้จะเท่ากับ 0 เสมอ
int64array[0] เวลาหยุดทำงานเป็นนาโนวินาทีนับตั้งแต่การบูตครั้งล่าสุด ระบุเวลาของเหตุการณ์การกดแป้นล่าสุด สําหรับเหตุการณ์ "ไม่ทำงาน" ข้อมูลนี้คือเวลาของเหตุการณ์ "ไม่ทำงาน"

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

HW_MOTION_INPUT

พร็อพเพอร์ตี้สำหรับส่งเหตุการณ์การป้อนข้อมูลของฮาร์ดแวร์ไปยัง Android

int32array[0] จอแสดงผลเป้าหมายที่กําหนดโดย VehicleDisplay เช่น
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
int32array[1] ประเภทอินพุตที่กําหนดไว้ใน VehicleHwMotionInputSource เช่น
VehicleHwMotionInputSource::SOURCE_KEYBOARD, VehicleHwMotionInputSource::SOURCE_DPAD
int32array[2] รหัสการดำเนินการที่กําหนดไว้ใน VehicleHwMotionInputAction เช่น
VehicleHwMotionInputAction::ACTION_UP, VehicleHwMotionInputAction::ACTION_DOWN
int32array[3] Flag สถานะปุ่มที่กําหนดไว้ใน VehicleHwMotionButtonStateFlag เช่น
VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY, VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
int32array[4] จํานวนเหตุการณ์เคอร์เซอร์ N N ต้องเป็นจำนวนเต็มบวก
int32array[5:5+N-1] รหัสเคอร์เซอร์ ความยาว N
int32array[5+N:5+2*N-1] ประเภทเครื่องมือ ความยาว N ตามที่กำหนดไว้ใน VehicleHwMotionToolType เช่น
VehicleHwMotionToolType::TOOL_TYPE_FINGER, VehicleHwMotionToolType::TOOL_TYPE_STYLUS
floatArray[0:N-1] ข้อมูล x, ความยาว N
floatArray[N:2*N-1] ข้อมูล y, ความยาว N
floatArray[2*N:3*N-1] ข้อมูลความดัน ความยาว N
floatArray[3*N:4*N-1] ข้อมูลขนาด ความยาว N
int64array[0] เวลาหยุดทำงานเป็นนาโนวินาทีนับตั้งแต่บูต ระบุเวลาที่ผู้ใช้กดลงครั้งแรกเพื่อเริ่มสตรีมเหตุการณ์ตำแหน่ง สําหรับเหตุการณ์ "ไม่ทำงาน" จะเป็นเวลาของเหตุการณ์ "ไม่ทำงาน"

HW_ROTARY_INPUT

พร็อพเพอร์ตี้สำหรับส่งเหตุการณ์การหมุนของฮาร์ดแวร์ไปยัง Android

int32Values[0] RotaryInputType เพื่อระบุปุ่มหมุนที่บิด
int32Values[1] จำนวนตำแหน่งหยุด (การคลิก) ค่าบวกสำหรับทํางานตามเข็มนาฬิกา ค่าลบสำหรับทํางานทวนเข็มนาฬิกา
int32Values[2] การแสดงผลเป้าหมายที่กําหนดไว้ใน VehicleDisplay เหตุการณ์ที่ไม่ได้เชื่อมโยงกับการแสดงผลที่เฉพาะเจาะจงต้องส่งไปยัง VehicleDisplay#MAIN
int32values[3 .. 3 + abs(number of detents) - 2] เดลต้านาโนวินาทีระหว่างคู่ของตำแหน่งหยุดที่ต่อเนื่องกันเมื่อจำนวนตำแหน่งหยุดมากกว่า 1 หรือน้อยกว่า -1
VehiclePropValue.timestamp เวลาที่เกิดการหมุนเวียน หากจำนวนตำแหน่งหยุดอยู่มากกว่า 1 หรือน้อยกว่า -1 เมื่อเกิดตำแหน่งหยุดการหมุนครั้งแรก

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: RotaryInputType
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

IGNITION_STATE

แสดงสถานะการจุดระเบิด

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: VehicleIgnitionState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

INFO_DRIVER_SEAT

การติดตั้งใช้งาน VHAL ตำแหน่งที่นั่งคนขับต้องละเว้น areaId ใช้ VehicleArea:GLOBAL

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: VehicleAreaSeat
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

INFO_EV_BATTERY_CAPACITY

ความจุแบตเตอรี่ที่ระบุสำหรับ EV หรือยานพาหนะไฮบริด แสดงผลความจุแบตเตอรี่ที่ระบุ รถยนต์ไฟฟ้า หรือไฮบริด ค่านี้คือความจุแบตเตอรี่ทั้งหมดที่ใช้งานได้เมื่อรถยังใหม่ ค่านี้อาจแตกต่างจาก EV_CURRENT_BATTERY_CAPACITY เนื่องจาก EV_CURRENT_BATTERY_CAPACITY จะแสดงความจุแบตเตอรี่ที่ใช้งานได้แบบเรียลไทม์โดยพิจารณาจากปัจจัยต่างๆ เช่น อายุของแบตเตอรี่และอุณหภูมิ

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:WH
รุ่น: Android 13

INFO_EV_CONNECTOR_TYPE

รายการหัวชาร์จที่ EV นี้อาจใช้ หากยานพาหนะมีพอร์ตชาร์จหลายพอร์ต พร็อพเพอร์ตี้นี้ต้องแสดงผลประเภทขั้วต่อทั้งหมดที่เป็นไปได้ซึ่งพอร์ตชาร์จอย่างน้อย 1 พอร์ตในยานพาหนะสามารถใช้ได้

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: EvConnectorType
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

INFO_EV_PORT_LOCATION

พร็อพเพอร์ตี้นี้ต้องระบุตำแหน่งของพอร์ตชาร์จใน EV โดยใช้ค่าแจกแจง PortLocationType หากยานพาหนะมีพอร์ตหลายพอร์ต พร็อพเพอร์ตี้นี้ต้องแสดงผลพอร์ตที่ชาร์จได้เร็วที่สุด หากต้องการสื่อสารตำแหน่งพอร์ตทั้งหมด ให้ใช้ INFO_MULTI_EV_PORT_LOCATIONS

ตำแหน่งพอร์ต EV: STATIC
โหมดการเข้าถึง: อ่าน
ประเภท Enum: PortLocationType
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

INFO_EXTERIOR_DIMENSIONS

ขนาดภายนอกของยานพาหนะ

ความสูง: int32Values[0]
ความยาว: int32Values[1]
ความกว้าง: int32Values[2]
ความกว้างรวมมิเรอร์: int32Values[3]
ฐานล้อรวมกระจก: int32Values[4]
ความกว้างของแทร็กด้านหน้า: int32Values[5]
ความกว้างของร่องล้อหลัง: int32Values[6]
เส้นผ่านศูนย์กลางการเลี้ยวจากขอบถนนถึงขอบถนน: int32Values[7]

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:MILLIMETER
รุ่น: Android 13

INFO_FUEL_CAPACITY

ความจุถังเชื้อเพลิงของยานพาหนะเป็นมิลลิลิตร พร็อพเพอร์ตี้นี้ต้องระบุปริมาณเชื้อเพลิงสูงสุดที่เก็บไว้ในยานพาหนะเป็นมิลลิลิตร พร็อพเพอร์ตี้นี้ใช้กับยานพาหนะไฟฟ้า (EV) ไม่ได้ กล่าวคือ หาก INFO_FUEL_TYPE มีเฉพาะ FuelType::FUEL_TYPE_ELECTRIC จะต้องไม่ติดตั้งใช้งาน INFO_FUEL_CAPACITY สำหรับ EV ให้ใช้ INFO_EV_BATTERY_CAPACITY

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:MILLILITER
รุ่น: Android 13

INFO_FUEL_DOOR_LOCATION

ตำแหน่งของประตูถังน้ำมัน พร็อพเพอร์ตี้นี้ต้องระบุตำแหน่งของประตูถังน้ำมันในยานพาหนะ พร็อพเพอร์ตี้นี้ใช้กับ EV ไม่ได้ กล่าวคือ หาก INFO_FUEL_TYPE มีเฉพาะ FuelType::FUEL_TYPE_ELECTRIC ก็ไม่ต้องใช้พร็อพเพอร์ตี้นี้ สำหรับ EV ให้ใช้ INFO_EV_PORT_LOCATION หรือ INFO_MULTI_LOCATIONS

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: PortLocationType
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

INFO_FUEL_TYPE

รายการเชื้อเพลิงที่ยานพาหนะอาจใช้ FuelType::FUEL_TYPE_ELECTRIC ต้องระบุก็ต่อเมื่อยานพาหนะชาร์จได้แบบเสียบปลั๊กเท่านั้น เช่น ยานพาหนะไฟฟ้าแบบไฮบริดเต็มรูปแบบ (FHEV) ต้องไม่มี FuelType::FUEL_TYPE_ELECTRIC เนื่องจากค่า INT32_VEC สำหรับ INFO_FUEL_TYPE สามารถป้อนข้อมูลได้ดังนี้INFO_FUEL_TYPE

int32Values = { FuelType::FUEL_TYPE_UNLEADED }

ในทางกลับกัน ยานพาหนะไฟฟ้าแบบปลั๊กอินไฮบริด (PHEV) เป็นแบบชาร์จได้แบบปลั๊กอิน และควรใส่ FuelType::FUEL_TYPE_ELECTRIC เป็นค่า INT32_VEC สำหรับ INFO_FUEL_TYPE INFO_FUEL_TYPE สามารถป้อนข้อมูลได้ดังนี้ int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: FuelType
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

INFO_MAKE

ผู้ผลิตยานพาหนะ พร็อพเพอร์ตี้นี้ต้องระบุชื่อแบรนด์สาธารณะของยานพาหนะ

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

INFO_MODEL

รุ่นของยานพาหนะ พร็อพเพอร์ตี้นี้ต้องระบุชื่อรุ่นสาธารณะของยานพาหนะ

INFO_MODEL_YEAR

ปีรุ่นของยานพาหนะในรูปแบบ `YYYY` ตามปฏิทินเกรโกเรียน

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:YEAR
รุ่น: Android 13

INFO_MULTI_EV_PORT_LOCATIONS

สถานีชาร์จ EV หลายแห่ง ใช้พร็อพเพอร์ตี้นี้หากยานพาหนะมีพอร์ต EV หลายพอร์ต ตำแหน่งของท่าเรือจะกำหนดไว้ใน PortLocationType เช่น รถยนต์มีพอร์ต 1 ช่องที่ด้านซ้ายด้านหน้าและ 1 ช่องที่ด้านซ้ายด้านหลัง

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

หากยานพาหนะมีพอร์ตเพียง 1 ช่อง ค่าของพร็อพเพอร์ตี้นี้ควรแสดงองค์ประกอบ 1 รายการ หากต้องการอธิบายตำแหน่งของพอร์ตเดียว โปรดดู INFO-EV-PORT-LOCATION

INFO_VIN

VIN ของยานพาหนะ

INITIAL_USER_INFO

กำหนดผู้ใช้ Android ที่จะใช้ในการเริ่มต้น ระบบ Android จะเรียกใช้พร็อพเพอร์ตี้นี้เมื่อเริ่มต้น และอนุญาตให้ HAL กำหนดผู้ใช้ Android ที่ควรเริ่มต้น คำขอนี้สร้างขึ้นโดยการตั้งค่า VehiclePropValue (กำหนดโดย InitialUserInfoRequest) และ HAL ต้องตอบกลับด้วยเหตุการณ์การเปลี่ยนแปลงพร็อพเพอร์ตี้ (กำหนดโดย InitialUserInfoResponse) หาก HAL ไม่ตอบกลับหลังจากเวลาที่ระบบ Android กำหนดไว้ ระบบ Android จะดำเนินการต่อราวกับว่า HAL ส่งการตอบกลับของการดำเนินการ InitialUserInfoResponseAction:DEFAULT ตัวอย่างเช่น เมื่อบูตเครื่องครั้งแรก คำขออาจเป็นดังนี้

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

หาก HAL ตอบกลับด้วยการสร้างผู้ใช้ที่ดูแลระบบชื่อ "เจ้าของ" การตอบกลับจะเป็นดังนี้

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

ค่าสตริงแสดงถึงหลายค่าที่คั่นด้วย || ค่าแรกคือภาษาของระบบ (ไม่บังคับ) สำหรับผู้ใช้ที่จะสร้าง (ในกรณีนี้ค่าว่างหมายความว่าใช้ค่าเริ่มต้นของ Android) ส่วนค่าที่ 2 คือชื่อของผู้ใช้ที่จะสร้าง (ไม่บังคับ) (เมื่อประเภทของคำตอบคือ InitialUserInfoResponseAction:CREATE) เช่น หากต้องการสร้างผู้ใช้ที่เป็นเจ้าของรายเดียวกันที่มีภาษาเป็น en-US และ pt-BR ค่าสตริงของคำตอบคือ en-US,pt-BR||Owner ดังนั้น ทั้งภาษาและชื่อจึงไม่มีแถบแนวตั้ง 2 แถบ (||) ในค่าได้ แม้ว่าคุณจะใช้แถบแนวตั้งเดียว (|) ได้ก็ตาม

หมายเหตุ:: หาก HAL ไม่รองรับการจัดการผู้ใช้ ก็ไม่ควรกำหนดพร็อพเพอร์ตี้นี้ ซึ่งจะปิดใช้พร็อพเพอร์ตี้อื่นๆ ที่เกี่ยวข้องกับผู้ใช้ เช่น ระบบ Android จะไม่ออกคำขอดังกล่าวและระบบ Android จะละเว้นคำขอที่เกี่ยวข้องกับผู้ใช้จากเลเยอร์ HAL อย่างไรก็ตาม หากรองรับการจัดการผู้ใช้ ก็ต้องรองรับพร็อพเพอร์ตี้หลักทั้งหมดที่เกี่ยวข้องกับผู้ใช้ ซึ่งรวมถึง INITIAL_USER_INFO, SWITCH_USER, CREATE_USER และ REMOVE_USER

จ ถึง ร

LANE_CENTERING_ASSIST_COMMAND

คำสั่งระบบช่วยเลน (LCA) คำสั่งเพื่อเปิดใช้งานและระงับ LCA เมื่อส่งคําสั่ง ACTIVATE จาก LaneCenteringAssistCommand ต้องตั้งค่า LANE_CENTERING_ASSIST_STATE เป็น LaneCenteringAssistState#ACTIVATION_REQUESTED เมื่อคําสั่ง ACTIVATE ดำเนินการสําเร็จ ต้องตั้งค่า LANE_CENTERING_ASSIST_STATE เป็น LaneCenteringAssistState#ACTIVATED เมื่อคําสั่ง DEACTIVATE จาก LaneCenteringAssistCommand ดําเนินการเสร็จสมบูรณ์ ต้องตั้งค่า LANE_CENTERING_ASSIST_STATE เป็น LaneCenteringAssistState#ENABLED

สำหรับรหัสพื้นที่ส่วนกลาง (0) คุณต้องกำหนด VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับค่า enum ทั้งหมดของ LaneCenteringAssistCommand เมื่อพร็อพเพอร์ตี้นี้ไม่พร้อมใช้งานเนื่องจาก LCA ถูกปิดใช้ (เช่น LANE_CENTERING_ASSIST_ENABLED เป็นเท็จ) พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#NOT_AVAILABLE_DISABLED หากมีการใช้ LANE_CENTERING_ASSIST_STATE และตั้งค่าสถานะเป็นค่า ErrorState พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode ที่สอดคล้องกับค่า ErrorState เช่น หากตั้งค่า LANE_CENTERING_ASSIST_STATE เป็น ErrorState#NOT_AVAILABLE_SPEED_LOW พร็อพเพอร์ตี้นี้ต้องแสดงผลเป็น StatusCode#NOT_AVAILABLE_SPEED_LOW

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: WRITE
ประเภท Enum: LaneCenteringAssistCommand
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

LANE_CENTERING_ASSIST_ENABLED

เปิดหรือปิดใช้ระบบช่วยเลน (LCA) ตั้งค่าเป็น "จริง" เพื่อเปิดใช้ LCA และ "เท็จ" เพื่อปิดใช้ LCA เมื่อเปิดใช้ LCA ระบบ ADAS ในรถควรเปิดอยู่และรอสัญญาณการเปิดใช้งานจากผู้ขับขี่ เมื่อเปิดใช้งานฟีเจอร์แล้ว ระบบ ADAS ควรบังคับเลี้ยวรถให้อยู่ตรงกลางเลนปัจจุบัน

ซึ่งแตกต่างจากระบบช่วยเลน (LKA) ที่คอยตรวจสอบว่าคนขับขับออกนอกหรือข้ามเส้นแบ่งเลนโดยไม่ตั้งใจหรือไม่ หากตรวจพบการออกจากเลนโดยไม่ตั้งใจ ระบบจะใช้การควบคุมพวงมาลัยเพื่อนำรถกลับเข้าเลนปัจจุบัน โดยทั่วไป LANE_CENTERING_ASSIST_ENABLED ควรแสดงผลลัพธ์เป็น "จริง" หรือ "เท็จ" เสมอ หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราวบางอย่าง เช่น ความเร็วของยานพาหนะต่ำหรือสูงเกินไป คุณต้องส่งข้อมูลผ่านค่า ErrorState ในพร็อพเพอร์ตี้ LANE_CENTERING_ASSIST_STATE

พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM จะใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

LANE_CENTERING_ASSIST_STATE

สถานะระบบช่วยเลน (LCA) แสดงสถานะปัจจุบันของ LCA พร็อพเพอร์ตี้นี้ต้องแสดงสถานะที่ถูกต้องที่กําหนดไว้ใน LaneCenteringAssistState หรือ ErrorState เสมอ และต้องไม่แสดงข้อผิดพลาดผ่าน StatusCode และต้องใช้สถานะข้อผิดพลาดที่รองรับแทน

หาก LCA มีคำเตือนการออกนอกเลน คำเตือนเหล่านั้นต้องแสดงผ่านพร็อพเพอร์ตี้คำเตือนการออกนอกเลน (LDW)

สำหรับรหัสพื้นที่ส่วนกลาง (0) คุณต้องกำหนดอาร์เรย์ VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของทั้ง LaneCenteringAssistState (รวมถึง OTHER ซึ่งไม่แนะนำ) และ ErrorState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: LaneCenteringAssistState/ErrorState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

LANE_DEPARTURE_WARNING_ENABLED

เปิดหรือปิดใช้ระบบเตือนการออกนอกเลน (LDW) ตั้งค่าเป็น "จริง" เพื่อเปิดใช้ LDW และ "เท็จ" เพื่อปิดใช้ LDW เมื่อเปิดใช้ LDW ระบบ ADAS ในรถควรเปิดอยู่และตรวจสอบว่ารถกำลังเข้าใกล้หรือข้ามเส้นเลนหรือไม่ ซึ่งในกรณีนี้ระบบจะส่งคำเตือน

โดยทั่วไป LANE_DEPARTURE_WARNING_ENABLED ควรแสดงผลลัพธ์เป็น "จริง" หรือ "เท็จ" เสมอ หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราว เช่น ความเร็วของยานพาหนะต่ำหรือสูงเกินไป คุณต้องส่งข้อมูลผ่านค่า ErrorState ในพร็อพเพอร์ตี้ LANE_DEPARTURE_WARNING_STATE

LANE_DEPARTURE_WARNING_STATE

สถานะระบบเตือนการออกนอกเลน (LDW) แสดงสถานะปัจจุบันของ LDW พร็อพเพอร์ตี้นี้ต้องแสดงสถานะที่ถูกต้องที่กําหนดไว้ใน LaneDepartureWarningState หรือ ErrorState เสมอ ต้องไม่แสดงข้อผิดพลาดผ่าน StatusCode และต้องใช้สถานะข้อผิดพลาดที่รองรับแทน

สำหรับรหัสพื้นที่ส่วนกลาง (0) คุณต้องกำหนดอาร์เรย์ VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของทั้ง LaneDepartureWarningState (รวมถึง OTHER ซึ่งไม่แนะนำ) และ ErrorState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: LaneDepartureWarningState/ErrorState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

LANE_KEEP_ASSIST_ENABLED

เปิดหรือปิดใช้ระบบช่วยเลน (LKA) ตั้งค่าเป็น "จริง" เพื่อเปิดใช้ LKA และ "เท็จ" เพื่อปิดใช้ LKA เมื่อเปิดใช้ LKA ระบบ ADAS ในรถควรเปิดอยู่และตรวจสอบว่าผู้ขับขี่ขับออกนอกหรือข้ามเส้นกั้นเลนโดยไม่ตั้งใจหรือไม่ หากตรวจพบการออกจากเลนโดยไม่ตั้งใจ ระบบจะใช้การควบคุมพวงมาลัยเพื่อนำรถกลับเข้าเลนปัจจุบัน ซึ่งแตกต่างจากระบบช่วยเลน (LCA) ที่เมื่อเปิดใช้งานจะใช้การควบคุมพวงมาลัยอย่างต่อเนื่องเพื่อรักษาให้รถอยู่ตรงกลางเลนปัจจุบัน

โดยทั่วไป LANE_KEEP_ASSIST_ENABLED ควรแสดงผลลัพธ์เป็น "จริง" หรือ "เท็จ" เสมอ หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราวบางอย่าง เช่น ความเร็วของยานพาหนะต่ำหรือสูงเกินไป คุณต้องส่งข้อมูลผ่านค่า ErrorState ในพร็อพเพอร์ตี้ LANE_KEEP_ASSIST_STATE

LANE_KEEP_ASSIST_STATE

สถานะระบบช่วยนำทางในเลน (LKA) แสดงสถานะปัจจุบันของ LKA พร็อพเพอร์ตี้นี้ต้องแสดงผลสถานะที่ถูกต้องซึ่งกำหนดไว้ใน LaneKeepAssistState หรือ ErrorState เสมอ และต้องไม่แสดงข้อผิดพลาดผ่าน StatusCode และต้องใช้สถานะข้อผิดพลาดที่รองรับแทน

หาก LKA มีคำเตือนการออกนอกเลนก่อนที่จะใช้การแก้ไขการบังคับเลี้ยว คำเตือนเหล่านั้นต้องแสดงผ่านพร็อพเพอร์ตี้คำเตือนการออกนอกเลน (LDW)

สำหรับรหัสพื้นที่ส่วนกลาง (0) คุณต้องกำหนดอาร์เรย์ VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับสถานะทั้งหมดของทั้ง LaneKeepAssistState (รวมถึง OTHER ซึ่งไม่แนะนำ) และ ErrorState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: LaneKeepAssistState/ErrorState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

LOCATION_CHARACTERIZATION

ลักษณะของอินพุตที่ใช้สำหรับคำนวณตำแหน่ง พร็อพเพอร์ตี้นี้ต้องระบุข้อมูลและอินพุตเซ็นเซอร์ (หากมี) ที่ระบบจะพิจารณาเมื่อคํานวณตําแหน่งของยานพาหนะที่แชร์กับ Android ผ่าน GNSS HAL

ค่าต้องแสดงผลคอลเล็กชัน Flag ของบิต กำหนด Flag ของบิตไว้ใน LocationCharacterization ค่าดังกล่าวต้องมี DEAD_RECKONED หรือ RAW_GNSS_ONLY เพียงค่าเดียวในคอลเล็กชัน Flag ของบิต

เมื่อระบบไม่รองรับพร็อพเพอร์ตี้นี้ ระบบจะถือว่าไม่มีการรวมอินพุตเซ็นเซอร์เพิ่มเติมในการอัปเดต GNSS ที่ได้จาก GNSS HAL เว้นแต่จะระบุไว้เป็นอย่างอื่นผ่านอินเทอร์เฟซ GNSS HAL

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

MIRROR_AUTO_FOLD_ENABLED

แสดงพร็อพเพอร์ตี้สำหรับฟีเจอร์การพับอัตโนมัติแบบมิเรอร์ พร็อพเพอร์ตี้นี้จะมีค่าเป็นจริงเมื่อเปิดใช้ฟีเจอร์การพับกระจกมองข้างของยานพาหนะโดยอัตโนมัติ (เช่น เมื่อกระจกพับเข้าด้านในโดยอัตโนมัติเมื่อมีคนออกจากและล็อกยานพาหนะ)

MIRROR_AUTO_TILT_ENABLED

แสดงพร็อพเพอร์ตี้สำหรับฟีเจอร์การเอียงกระจกมองหลังอัตโนมัติ พร็อพเพอร์ตี้นี้จะมีค่าเป็น "จริง" เมื่อเปิดใช้ฟีเจอร์การเอียงกระจกมองข้างของยานพาหนะโดยอัตโนมัติ (เช่น เมื่อกระจกเอียงลงโดยอัตโนมัติเมื่อมีการถอยรถ)

MIRROR_FOLD

พับแบบมิเรอร์ จริง หมายถึงกระจกพับอยู่ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

MIRROR_LOCK

การล็อกมิเรอร์ True บ่งชี้ว่าตำแหน่งกระจกล็อกอยู่และเปลี่ยนแปลงไม่ได้ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM จะใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

MIRROR_Y_MOVE

มิเรอร์การเคลื่อนไหวตามแกน Y ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงถึงความเร็วสูงสุดในการเคลื่อนที่ของกระจกขณะเอียงไปทางขวา minInt32Value แสดงความเร็วสูงสุดในการเคลื่อนที่ของกระจกขณะเอียงไปทางซ้าย

ค่าสัมบูรณ์ที่มากขึ้น ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น เมื่อกระจกถึงขีดจํากัดตําแหน่งแล้ว ค่าต้องรีเซ็ตเป็น 0 หากค่าของ MIRROR_Y_MOVE เท่ากับ 0 แสดงว่าไม่มีการเคลื่อนไหวเกิดขึ้น

พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดหน่วยหนึ่ง แต่อยู่ในช่วงความเร็วของการเคลื่อนไหวแบบสัมพัทธ์ที่ระบุ

MIRROR_Y_POS

ตำแหน่ง Y ของมิเรอร์ ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value minInt32Value บ่งบอกว่ากระจกเอียงไปทางซ้ายจนสุด

ค่านี้ต้องเป็นค่าที่ไม่ใช่ค่าบวก maxInt32Value บ่งบอกว่ากระจกเอียงไปทางขวาจนสุด ค่านี้ต้องเป็นค่าที่ไม่ใช่ค่าลบ 0 บ่งบอกว่ากระจกไม่ได้เอียงไปทางใดทางหนึ่ง

ค่าระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกสถานะการเปลี่ยนผ่านระหว่างตำแหน่งสุดโต่งด้านซ้ายและขวา

พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดหน่วยหนึ่ง แต่อยู่ในช่วงตำแหน่งสัมพัทธ์ที่ระบุ

MIRROR_Z_MOVE

ย้าย Z ในมิเรอร์ ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงความเร็วสูงสุดของกระจกขณะเอียงขึ้น minInt32Value แสดงความเร็วสูงสุดของกระจกขณะเอียงลง ค่าสัมบูรณ์ที่มากขึ้น ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น เมื่อกระจกถึงขีดจํากัดตําแหน่งแล้ว ค่าต้องรีเซ็ตเป็น 0 หากค่าของ MIRROR_Z_MOVE เท่ากับ 0 แสดงว่าไม่มีการเคลื่อนไหวเกิดขึ้น

พร็อพเพอร์ตี้นี้ไม่ได้อยู่ในหน่วยใดหน่วยหนึ่ง แต่อยู่ในช่วงความเร็วของการเคลื่อนไหวสัมพัทธ์ที่ระบุ

MIRROR_Z_POS

ตำแหน่ง Z ของมิเรอร์ ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value minInt32Value บ่งบอกว่ากระจกเอียงลงจนสุด ค่านี้ต้องเป็นค่าที่ไม่ใช่ค่าบวก maxInt32Value บ่งบอกว่ากระจกเอียงขึ้นจนสุด ค่านี้ต้องเป็นค่าบวก 0 บ่งบอกว่ากระจกไม่ได้เอียงไปทางใดทางหนึ่ง

ค่าระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกถึงสถานะการเปลี่ยนระหว่างตำแหน่งที่ลงสุดและขึ้นสุด

NIGHT_MODE

ค่า "จริง" บ่งชี้ว่าเซ็นเซอร์โหมดกลางคืนตรวจพบว่าภายในรถมีแสงน้อย แพลตฟอร์มอาจใช้ข้อมูลนี้เพื่อเปิดใช้ UI ที่เหมาะสมเพื่อให้ดูได้ง่ายขึ้นในสภาพแวดล้อมที่มีแสงน้อยหรือมืด

OBD2_FREEZE_FRAME

รายงานภาพรวมของค่าเซ็นเซอร์ OBD2 ที่พร้อมใช้งาน ณ เวลาที่เกิดข้อบกพร่องขึ้นและตรวจพบ ต้องระบุ configArray ที่มีความหมายเหมือนกับที่กําหนดไว้สําหรับ OBD2_LIVE_FRAME

ค่าของพร็อพเพอร์ตี้นี้จะตีความในลักษณะเดียวกับค่าของ OBD2_LIVE_FRAME ยกเว้นว่าช่อง stringValue อาจมีรหัสการวินิจฉัยการแก้ปัญหา (DTC) ที่ไม่ใช่ค่าว่าง

คำขอ IVehicle#get ของพร็อพเพอร์ตี้นี้ต้องระบุค่าสำหรับ int64Values[0] ระบบจะตีความค่านี้เป็นการประทับเวลาของเฟรมที่หยุดชั่วคราวเพื่อดึงข้อมูล คุณดูรายการการประทับเวลาได้จาก IVehicle#get ของ OBD2_FREEZE_FRAME_INFO

หากไม่มีเฟรมหยุดชั่วคราว ณ การประทับเวลาที่ระบุ การใช้งานจะต้องแสดงผลลัพธ์เป็น NOT_AVAILABLE เนื่องจากยานพาหนะอาจมีพื้นที่เก็บข้อมูลจํากัดสําหรับเฟรมหยุดชั่วคราว จึงเป็นไปได้ที่คำขอเฟรมจะตอบกลับด้วย NOT_AVAILABLE แม้ว่าจะได้รับการประทับเวลาที่เกี่ยวข้องผ่าน OBD2_FREEZE_FRAME_INFO ไปเมื่อเร็วๆ นี้ก็ตาม

OBD2_FREEZE_FRAME_CLEAR

ล้างเฟรมหยุดชั่วคราว รายงานภาพรวมของค่าเซ็นเซอร์ OBD2 ที่พร้อมใช้งาน ณ เวลาที่เกิดข้อบกพร่องและตรวจพบ ต้องระบุ configArray ที่มีความหมายเหมือนกับที่กําหนดไว้สําหรับ OBD2_LIVE_FRAME

ค่าของพร็อพเพอร์ตี้นี้จะตีความในลักษณะเดียวกับค่าของ OBD2_LIVE_FRAME ยกเว้นว่าช่อง stringValue อาจมีรหัสการวินิจฉัย (DTC) ที่ไม่ใช่ค่าว่าง

หากไม่มีเฟรมหยุดชั่วคราว ณ การประทับเวลาที่ระบุ การใช้งานต้องแสดงผลลัพธ์เป็น NOT_AVAILABLE เนื่องจากยานพาหนะอาจมีพื้นที่เก็บข้อมูลจํากัดสําหรับเฟรมหยุดชั่วคราว คำขอเฟรมจึงอาจตอบกลับด้วย NOT_AVAILABLE แม้ว่าจะได้รับการประทับเวลาที่เกี่ยวข้องผ่าน OBD2_FREEZE_FRAME_INFO เมื่อเร็วๆ นี้ก็ตาม

OBD2_FREEZE_FRAME_INFO

พร็อพเพอร์ตี้นี้อธิบายเฟรมที่หยุดชั่วคราวปัจจุบันที่จัดเก็บไว้ในหน่วยความจำของยานพาหนะและพร้อมให้เรียกดูผ่าน OBD2_FREEZE_FRAME ค่าต่างๆ ควรตีความดังนี้ องค์ประกอบแต่ละรายการของ int64Values ต้องเป็นการประทับเวลาที่ตรวจพบรหัสข้อบกพร่องและจัดเก็บเฟรมที่หยุดชั่วคราวที่เกี่ยวข้อง และสามารถใช้องค์ประกอบดังกล่าวเป็นคีย์สำหรับ OBD2_FREEZE_FRAME เพื่อเรียกข้อมูลเฟรมที่หยุดชั่วคราวที่เกี่ยวข้อง

OBD2_LIVE_FRAME

รายงานภาพรวมของค่าปัจจุบัน (แบบเรียลไทม์) ของเซ็นเซอร์ OBD2 ที่พร้อมใช้งาน การตั้งค่า configArray มีดังนี้

configArray[0] จํานวนเซ็นเซอร์ที่มีค่าเป็นจำนวนเต็มซึ่งเจาะจงผู้ให้บริการ
configArray[1] จํานวนเซ็นเซอร์ที่มีค่าเป็นทศนิยมซึ่งเจาะจงผู้ให้บริการ

ค่าของพร็อพเพอร์ตี้นี้จะตีความได้ดังตัวอย่างต่อไปนี้ เมื่อพิจารณา configArray = {2,3} int32Values ต้องเป็นเวกเตอร์ที่มี Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX บวกองค์ประกอบ 2 รายการ (หรือ 33 องค์ประกอบ) floatValues ต้องเป็นเวกเตอร์ที่มี Obd2FloatSensorIndex.LAST_SYSTEM_INDEX บวกองค์ประกอบ 3 รายการ (หรือ 73 องค์ประกอบ)

แต่ละเฟรมอาจมีชุดย่อยของค่าเซ็นเซอร์ที่แตกต่างกัน ทั้งเซ็นเซอร์ที่ระบบให้มาและเซ็นเซอร์เฉพาะของผู้ให้บริการ ระบบจะใช้องค์ประกอบไบต์ของค่าพร็อพเพอร์ตี้เป็นบิตมาสก์เพื่อรองรับการดำเนินการนี้ ไบต์ต้องมีจำนวนไบต์เพียงพอที่จะแสดงจำนวนเซ็นเซอร์ทั้งหมดที่เป็นไปได้ (ในกรณีนี้ 14 ไบต์เพื่อแสดงค่าที่เป็นไปได้ 106 ค่า) โดยระบบจะอ่านเป็นบิตมาสก์ต่อเนื่องกัน โดยแต่ละบิตจะระบุว่ามีหรือไม่มีเซ็นเซอร์จากเฟรม โดยเริ่มจากบิตที่มีจำนวนเท่ากับขนาดของ int32Values ตามด้วยบิตที่มีจำนวนเท่ากับขนาดของ floatValues

ตัวอย่างเช่น หากเป็น bytes[0] = 0x4C (0b01001100) หมายความว่า

int32Values[0 and 1] ไม่ใช่ค่าเซ็นเซอร์ที่ถูกต้อง
int32Values[2 and 3] คือค่าเซ็นเซอร์ที่ถูกต้อง
int32Values[4 and 5] ไม่ใช่ค่าเซ็นเซอร์ที่ถูกต้อง
int32Values[6] คือค่าเซ็นเซอร์ที่ถูกต้อง
int32Values[7] ไม่ใช่ค่าเซ็นเซอร์ที่ถูกต้อง
int32Values[0 and 1] ไม่ใช่ค่าเซ็นเซอร์ที่ถูกต้อง
int32Values[2 and 3] คือค่าเซ็นเซอร์ที่ถูกต้อง
int32Values[4 and 5] ไม่ใช่ค่าเซ็นเซอร์ที่ถูกต้อง
int32Values[6] คือค่าเซ็นเซอร์ที่ถูกต้อง
int32Values[7] ไม่ใช่ค่าเซ็นเซอร์ที่ถูกต้อง

ถ้า bytes[5] = 0x61 (0b01100001) ให้ทำดังนี้

int32Values[32] คือค่าเซ็นเซอร์ที่ถูกต้อง
floatValues[0 thru 3] คือค่าเซ็นเซอร์ที่ไม่ถูกต้อง
floatValues[4 and 5] คือค่าเซ็นเซอร์ที่ถูกต้อง
floatValues[6] ไม่ใช่ค่าเซ็นเซอร์ที่ถูกต้อง

ON_CHANGE

เปลี่ยนโหมด:
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: VehicleLightSwitch
ประเภทหน่วย:ไม่เกี่ยวข้อง
รุ่น: Android 13

PARKING_BRAKE_AUTO_APPLY

ใช้เบรกมือโดยอัตโนมัติ เมื่อเป็น "จริง" พร็อพเพอร์ตี้นี้จะระบุว่าระบบเปิดใช้เบรกมืออัตโนมัติของรถ ค่าเท็จบ่งบอกว่าระบบเบรกรถอัตโนมัติของรถปิดอยู่ พร็อพเพอร์ตี้นี้มักสับสนกับ PARKING_BRAKE_ON ความแตกต่างคือ PARKING_BRAKE_ON จะระบุว่าเบรกมือจริงเปิดหรือปิดอยู่ ส่วน PARKING_BRAKE_AUTO_APPLY จะระบุว่าฟีเจอร์เบรกมืออัตโนมัติเปิดหรือปิดอยู่ และไม่อธิบายสถานะปัจจุบันของเบรกมือจริง

PARKING_BRAKE_ON

สถานะเบรกมือ เมื่อเป็น "จริง" พร็อพเพอร์ตี้นี้จะระบุว่าเบรกมือของรถติดอยู่ ค่าเท็จบ่งบอกว่าเบรกมือของรถไม่ได้อยู่ในสถานะใช้งาน

PER_DISPLAY_BRIGHTNESS

พร็อพเพอร์ตี้แสดงความสว่างของจอแสดงผลที่ควบคุมแยกกัน รถยนต์บางรุ่นมีจอแสดงผลอย่างน้อย 1 จอที่ควบคุมความสว่างแยกกัน และพร็อพเพอร์ตี้นี้มีไว้เพื่อแจ้งความสว่างของจอแสดงผลสำหรับผู้โดยสารแต่ละจอ ในรถยนต์ที่ควบคุมความสว่างของจอแสดงผลทั้งหมดพร้อมกัน จะต้องใช้ DISPLAY_BRIGHTNESS

ควรติดตั้งใช้งาน PER_DISPLAY_BRIGHTNESS หรือ PER_DISPLAY_BRIGHTNESS อย่างใดอย่างหนึ่งเท่านั้น หากมีทั้ง 2 รายการ AAOS จะใช้ PER_DISPLAY_BRIGHTNESS

พอร์ตแสดงผลจะระบุขั้วต่อจริงบนอุปกรณ์สำหรับเอาต์พุตการแสดงผลที่ไม่ซ้ำกัน โดยมีค่าตั้งแต่ 0 ถึง 255

int32Values[0] พอร์ต Display
int32Values[1] ความสว่าง

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

PERF_ODOMETER

ค่าเครื่องวัดระยะทางปัจจุบันของยานพาหนะ

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:KILOMETER
รุ่น: Android 13

PERF_REAR_STEERING_ANGLE

องศาการเลี้ยวของพวงมาลัยจักรยานรุ่นหลังสำหรับยานพาหนะ มุมจะวัดเป็นองศา ซ้ายเป็นลบ พร็อพเพอร์ตี้นี้ไม่เกี่ยวข้องกับมุมของพวงมาลัย พร็อพเพอร์ตี้นี้ต้องระบุมุมของล้อหลังสัมพันธ์กับยานพาหนะ ไม่ใช่มุมของพวงมาลัย

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:DEGREES
รุ่น: Android 13

PERF_STEERING_ANGLE

องศาการเลี้ยวของพวงมาลัยจักรยานด้านหน้าสำหรับยานพาหนะ มุมจะวัดเป็นองศา ซ้ายเป็นลบ พร็อพเพอร์ตี้นี้ไม่เกี่ยวข้องกับมุมของพวงมาลัย พร็อพเพอร์ตี้นี้ต้องสื่อสารมุมของล้อหน้าสัมพันธ์กับยานพาหนะ ไม่ใช่มุมของพวงมาลัย

PERF_VEHICLE_SPEED

ความเร็วของยานพาหนะ ค่าต้องเป็นค่าบวกเมื่อยานพาหนะกำลังเคลื่อนที่ไปข้างหน้า และค่าลบเมื่อยานพาหนะกำลังถอยหลัง ค่านี้ไม่เกี่ยวข้องกับค่าเกียร์ (CURRENT_GEAR หรือ GEAR_SELECTION) เช่น หาก GEAR_SELECTION เป็น GEAR_NEUTRAL PERF_VEHICLE_SPEED จะมีค่าเป็นบวกเมื่อรถเคลื่อนที่ไปข้างหน้า มีค่าเป็นลบเมื่อรถถอยหลัง และมีค่าเป็น 0 เมื่อรถไม่เคลื่อนที่

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภทหน่วย: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:METER_PER_SEC
รุ่น: Android 13

PERF_VEHICLE_SPEED_DISPLAY

ความเร็วของยานพาหนะสำหรับจอแสดงผล รถบางรุ่นจะแสดงความเร็วบนมาตรวัดความเร็วช้ากว่าความเร็วจริงเล็กน้อย

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:METER_PER_SEC
รุ่น: Android 13

POWER_POLICY_GROUP_REQ

กำหนดคำขอเพื่อตั้งค่ากลุ่มนโยบายพลังงานที่ใช้ตัดสินใจนโยบายพลังงานเริ่มต้นตามการเปลี่ยนสถานะพลังงาน

POWER_POLICY_REQ

กำหนดคำขอใช้นโยบายพลังงาน VHAL ตั้งค่าพร็อพเพอร์ตี้นี้เพื่อเปลี่ยนนโยบายทางไฟฟ้าสำหรับรถยนต์ บริการนโยบายทางไฟฟ้าสำหรับรถยนต์จะสมัครใช้บริการพร็อพเพอร์ตี้นี้และเปลี่ยนนโยบายทางไฟฟ้า คำขอสร้างขึ้นโดยการตั้งค่า VehiclePropValue ด้วยรหัสของนโยบายพลังงานที่กำหนดไว้ที่ /vendor/etc/automotive/power_policy.xml หากไม่ได้กำหนดรหัสที่ระบุไว้ บริการนโยบายพลังงานของรถยนต์จะละเว้นคำขอและคงนโยบายพลังงานปัจจุบันไว้

string: "sample_policy_id" // power policy ID

POWER_POLICY_GROUP_REQ

กำหนดคำขอเพื่อตั้งค่ากลุ่มนโยบายพลังงานที่ใช้ตัดสินใจนโยบายพลังงานเริ่มต้นตามการเปลี่ยนสถานะพลังงาน VHAL จะตั้งค่าพร็อพเพอร์ตี้นี้ด้วยรหัสของกลุ่มนโยบายพลังงานเพื่อตั้งค่านโยบายพลังงานเริ่มต้นที่ใช้เมื่อสถานะพลังงานมีการเปลี่ยนแปลง กลุ่มนโยบายพลังงานจะกำหนดไว้ที่ /vendor/etc/power_policy.xml หากไม่ได้กำหนดรหัสที่ระบุไว้ บริการนโยบายพลังงานของรถยนต์จะละเว้นคำขอ บริการนโยบายทางไฟฟ้าสำหรับรถยนต์จะสมัครใช้บริการพร็อพเพอร์ตี้นี้และตั้งค่ากลุ่มนโยบายทางไฟฟ้า การใช้นโยบายพลังงานจริงจะเกิดขึ้นเมื่อสถานะพลังงานของระบบมีการเปลี่ยนแปลง และมีนโยบายพลังงานที่แมปไว้ซึ่งถูกต้องสำหรับสถานะพลังงานใหม่

string: "sample_policy_group_id" // power policy group ID

RANGE_REMAINING

ระยะทางที่เหลือ ปริมาณน้ำมันและระดับการชาร์จที่เหลือ ระยะทางที่เหลืออยู่ต้องพิจารณาแหล่งพลังงานทั้งหมดในยานพาหนะ เช่น ระยะทางที่ขับขี่ได้ของรถยนต์ไฮบริดคือผลรวมของระยะทางที่ขับขี่ได้โดยใช้เชื้อเพลิงและแบตเตอรี่ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE เนื่องจากแอปนำทางอาจอัปเดตช่วงได้หากมีข้อมูลโดยประมาณที่แม่นยำยิ่งขึ้นตามเส้นทางที่กําลังจะมาถึง พร็อพเพอร์ตี้นี้สามารถติดตั้งใช้งานเป็น VehiclePropertyAccess.READ ได้ก็ต่อเมื่อ OEM พิจารณาเท่านั้น

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ_WRITE
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:METER
รุ่น: Android 13

READING_LIGHTS_STATE

แสดงสถานะปัจจุบันของไฟอ่านหนังสือ

READING_LIGHTS_SWITCH

สวิตช์สำหรับควบคุมไฟอ่านหนังสือ ซึ่งอาจแตกต่างจาก READING_LIGHTS_STATE หากไฟเปิดอยู่เนื่องจากประตูเปิดอยู่หรือคำสั่งเสียง เช่น ขณะที่สวิตช์อยู่ในตำแหน่งปิดหรืออัตโนมัติ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

REAR_FOG_LIGHTS_STATE

แสดงสถานะปัจจุบันของไฟตัดหมอกหลัง คุณติดตั้งใช้งานได้เพียง FOG_LIGHTS_STATE หรือ REAR_FOG_LIGHTS_STATE อย่างใดอย่างหนึ่งเท่านั้น ดูFOG_LIGHTS_STATE

REAR_FOG_LIGHTS_SWITCH

การตั้งค่าที่ผู้ใช้ต้องการ ต้องติดตั้งใช้งาน FOG_LIGHTS_SWITCH หรือ REAR_FOG_LIGHTS_SWITCH เพียงรายการเดียวเท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ FOG_LIGHTS_SWITCH พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

REMOVE_USER

ระบบ Android เรียกใช้หลังจากที่นำผู้ใช้ Android ออก HAL สามารถใช้พร็อพเพอร์ตี้นี้เพื่อนำผู้ใช้ที่เทียบเท่าออก นี่เป็นคอลที่เขียนอย่างเดียว ระบบ Android ไม่ได้คาดหวังการตอบกลับจาก HAL ดังนั้น คำขอนี้จึงไม่ควรล้มเหลว หากนำผู้ใช้ HAL ที่เทียบเท่าออกไม่ได้ HAL ควรทำเครื่องหมายผู้ใช้ดังกล่าวว่าไม่ได้ใช้งานหรือกู้คืนด้วยวิธีอื่น

คำขอจะสร้างขึ้นโดยการตั้งค่า VehiclePropValue ด้วยเนื้อหาที่ระบุโดย RemoveUserRequest ตัวอย่างเช่น หากระบบมีผู้ใช้ 3 คน (0, 10 และ 11) และนําผู้ใช้ 11 ออกแล้ว คําขอจะเป็นดังนี้

int32[0] 42 // request id
int32[1] 11 // (Android user id of the removed user)
int32[2] 0 // (Android user flags of the removed user)
int32[3] 10 // ผู้ใช้ปัจจุบัน
int32[4] 0 // current user flags (none)
int32[5] 2 // number of users
int32[6] 0 // ผู้ใช้ครั้งแรก (ผู้ใช้ 0)
int32[7] 0 // ธงผู้ใช้แรก (ไม่มี)
int32[8] 10 // ผู้ใช้ที่ 2 (ผู้ใช้ 10)
int32[9] 0 // second user flags (none)

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: WRITE
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

S ถึง Z

SEAT_AIRBAG_ENABLED

แสดงฟีเจอร์สำหรับเปิดและปิดใช้ความสามารถในการใช้งานถุงลมนิรภัยของที่นั่งเมื่อมีการเรียกใช้ (ตัวอย่างเช่น เมื่อเกิดการชนกัน) หากเป็น true แสดงว่าถุงลมนิรภัยของที่นั่งเปิดใช้งานแล้ว และ หากมีการทริกเกอร์ ก็จะมีการทำให้ใช้งานได้ หากเป็น true แสดงว่าถุงลมนิรภัยของที่นั่งปิดอยู่และจะไม่ทำงานไม่ว่าในกรณีใดก็ตาม พร็อพเพอร์ตี้นี้ไม่ได้ระบุว่าใส่ถุงลมนิรภัยหรือไม่

พร็อพเพอร์ตี้นี้สามารถตั้งค่าเป็น VehiclePropertyAccess.READ แบบอ่านอย่างเดียวเพื่อวัตถุประสงค์ เกี่ยวกับกฎระเบียบหรือความกังวลด้านความปลอดภัย

SEAT_BACKREST_ANGLE_1_MOVE

ปรับเบาะหลัง 1 ระดับ maxInt32Value และ minInt32Value ใน ต้องระบุ VehicleAreaConfig แต่ละรายการ ระบบต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value maxInt32Value แสดงความเร็วการเคลื่อนไหวสูงสุดของพนักพิงที่นั่ง พุ่งไปข้างหน้า minInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของพนักพิงเมื่อปรับเอน

ค่าสัมบูรณ์ที่มากกว่า ไม่ว่าจะเป็นค่าบวกหรือลบ จะบ่งบอกถึงความเร็วในการเคลื่อนไหวที่เร็วกว่า เมื่อ พนักพิงเบาะนั่งถึงขีดจำกัดของตำแหน่งแล้ว ค่าต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_BACKREST_ANGLE_1_MOVE เท่ากับ 0 ไม่มีการเคลื่อนไหว

พร็อพเพอร์ตี้นี้แสดงเป็นช่วงความเร็วสัมพัทธ์ของการเคลื่อนไหวที่ระบุ

พร็อพเพอร์ตี้นี้ระบุเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM ทำได้ ให้ใช้เป็น VehiclePropertyAccess.READ เท่านั้น

SEAT_BACKREST_ANGLE_1_POS

ตำแหน่งพนักพิงที่นั่ง 1 ตำแหน่ง มุมพนักพิง 1 คือแอคชูเอเตอร์ที่อยู่ใกล้ด้านล่างของ ที่นั่ง maxInt32Value และ minInt32Value ใน ต้องระบุ VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value minInt32Value แสดงตำแหน่งพนักพิงหลังของเบาะที่นั่งที่ปรับเอนจนสุดเมื่อเทียบกับตัวกระตุ้นที่ด้านล่างของเบาะ maxInt32Value หมายถึงตำแหน่งที่ตรงหรือไปข้างหน้าที่สุดของพนักพิงหลังของเบาะ โดยสัมพันธ์กับตัวกระตุ้นที่ด้านล่างของเบาะ

ค่าระหว่าง minInt32Value ถึง maxInt32Value แสดงสถานะการเปลี่ยนระหว่างการเอนหลังจนสุดกับตำแหน่งตั้งตรงและเอียงไปข้างหน้า

พร็อพเพอร์ตี้นี้จะแสดงเป็นช่วงตำแหน่งสัมพัทธ์ที่ระบุ

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท enum: ไม่มี
ประเภทหน่วย: ไม่มี
รุ่น: Android 13

SEAT_BACKREST_ANGLE_2_MOVE

ขยับที่พนักพิงที่นั่ง มุมที่ 2 ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงความเร็วการเคลื่อนไหวสูงสุดของพนักพิงที่นั่ง พุ่งไปข้างหน้า minInt32Value แสดงความเร็วในการเคลื่อนไหวสูงสุดของที่นั่ง พนักพิงขณะเอนหลัง

ค่าสัมบูรณ์ที่มากกว่า ไม่ว่าจะเป็นบวกหรือลบ จะบ่งบอกถึงความเร็วในการเคลื่อนไหวที่เร็วกว่า เมื่อพนักพิงหลังของเบาะนั่งถึงขีดจำกัดตำแหน่ง ค่าต้องรีเซ็ตเป็น 0 หากค่าของ ขณะนี้ SEAT_BACKREST_ANGLE_2_MOVE อยู่ที่ 0 และไม่มีการเคลื่อนไหวใดๆ

พร็อพเพอร์ตี้นี้จะแสดงเป็นช่วงความเร็วสัมพัทธ์ของการเคลื่อนไหวที่ระบุ

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท enum: ไม่มี ประเภทหน่วย: ไม่มี
รุ่น: Android 13

SEAT_BACKREST_ANGLE_2_POS

มุมพนักพิงหลังของเบาะ 2 ตำแหน่ง มุมพนักพิง 2 คือแอคชูเอเตอร์ตัวถัดไปจากด้านล่างของ ที่นั่ง

maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องกำหนด จำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value ต้อง #0supported

สัญลักษณ์ minInt32Value จะระบุตำแหน่งพนักพิงหลังของที่นั่งจนสุด เข้ากับแอคชูเอเตอร์ตัวถัดไปในพนักพิงหลังจากด้านล่างของที่นั่ง (โปรดดู SEAT_BACKREST_ANGLE_1_POSเพื่อดูรายละเอียด) maxInt32Value หมายถึง ตำแหน่งหลังสุดของเบาะนั่งในแนวขวางและไปข้างหน้าโดยคำนึงถึงแอคชูเอเตอร์คนถัดไปที่พนักพิง จากด้านล่างของที่นั่ง (ดูรายละเอียดที่ SEAT_BACKREST_ANGLE_1_POS)

ค่าระหว่าง minInt32Value ถึง maxInt32Value แสดงถึงการเปลี่ยน ระหว่างตำแหน่งการปรับเอนนอนทั้งตำแหน่งกับตำแหน่งตั้งตรงและไปข้างหน้า

พร็อพเพอร์ตี้นี้แสดงเป็นช่วงที่ระบุของตำแหน่งสัมพัทธ์

เที่ยวบินที่ SEAT_BELT_BUCKLED

คาดเข็มขัดนิรภัย จริง หมายถึงมีการคาดเข็มขัด สิทธิ์การเขียนบ่งบอกถึงความสามารถในการคาดเข็มขัดนิรภัยอัตโนมัติ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM จะใช้เป็น VehiclePropertyAccess.READ ได้เท่านั้น

SEAT_BELT_HEIGHT_MOVE

ขยับความสูงของเข็มขัดนิรภัย maxInt32Value และ minInt32Value ในแต่ละกลุ่ม ต้องระบุ VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของจุดยึดไหล่ของเข็มขัดนิรภัยขณะเลื่อนขึ้น minInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของจุดยึดไหล่ของเข็มขัดนิรภัยขณะเลื่อนลง

ค่าสัมบูรณ์ที่มากขึ้น ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น เมื่อ เข็มขัดนิรภัยถึงขีดจำกัดของตำแหน่งแล้ว ค่าต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_BELT_HEIGHT_MOVE เป็น 0 แสดงว่าไม่มีการเคลื่อนไหว

SEAT_BELT_HEIGHT_POS

ตำแหน่งความสูงของเข็มขัดนิรภัย ปรับจุดยึดของเข็มขัดนิรภัยบริเวณไหล่

ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig จำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value ต้องเท่ากับ ที่รองรับ

minInt32Value บ่งบอกว่าจุดยึดที่ไหล่ของเข็มขัดนิรภัยอยู่ที่ต่ำสุด ตำแหน่ง maxInt32Value บ่งบอกว่าจุดยึดที่ไหล่ของเข็มขัดนิรภัยอยู่ที่ ตำแหน่งสูงสุด

ค่าระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกสถานะการเปลี่ยนผ่านระหว่างตําแหน่งต่ำสุดและสูงสุด

พร็อพเพอร์ตี้นี้แสดงเป็นช่วงที่ระบุของตำแหน่งสัมพัทธ์

SEAT_CUSHION_SIDE_SUPPORT_MOVE

แสดงพร็อพเพอร์ตี้สำหรับทิศทางการเคลื่อนไหวและความเร็วของการรองรับด้านข้างของเบาะนั่ง

ต้องกําหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ ระบบต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงความเร็วในการเคลื่อนไหวสูงสุดของด้านเบาะนั่ง รองรับเมื่อขยายบริการให้กว้างขึ้น (เช่น การรองรับจะลดลง) minInt32Value แสดงความเร็วในการเคลื่อนที่สูงสุดของการรองรับด้านข้างของเบาะนั่งเมื่อขยายแคบลง (เช่น มีการรองรับเพิ่มขึ้น)

ค่าสัมบูรณ์ที่มากขึ้น ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น เมื่อ ที่รองด้านของเบาะนั่งถึงขีดจํากัดตำแหน่งแล้ว ค่าต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_CUSHION_SIDE_SUPPORT_MOVE เป็น 0 แสดงว่าไม่มีการเคลื่อนไหวเกิดขึ้น

SEAT_CUSHION_SIDE_SUPPORT_POS

แสดงถึงคุณสมบัติของตำแหน่งการรองรับบริเวณสะโพกของที่นั่ง (ด้านของเบาะรองด้านล่าง)

ต้องกำหนด maxInt32Value และ minInt32Value ใน DeviceAreaConfig แต่ละรายการ จำนวนเต็มทั้งหมด ต้องรองรับระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value บ่งบอกว่าส่วนรองรับด้านข้างของเบาะนั่งอยู่ในตำแหน่งที่กว้างที่สุด (เช่น รองรับน้อยที่สุด) minInt32Value บ่งบอกว่าการรองรับด้านข้างของเบาะนั่งนั้นบางที่สุด ตำแหน่ง (เช่น การสนับสนุนส่วนใหญ่)

ค่าที่อยู่ระหว่าง minInt32Value ถึง maxInt32Value จะระบุสถานะการเปลี่ยนระหว่าง ตำแหน่งที่บางที่สุดและกว้างที่สุด

พร็อพเพอร์ตี้นี้แสดงเป็นช่วงที่ระบุของตำแหน่งสัมพัทธ์

พร็อพเพอร์ตี้นี้ระบุเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM ทำได้ นำไปใช้เป็น <covehiclepropertyaccess.read< รหัส=""> เท่านั้น</covehiclepropertyaccess.read<>

SEAT_DEPTH_MOVE

การเคลื่อนไหวของความลึกที่นั่ง

ต้องกําหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ จำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value ต้องเท่ากับ ที่รองรับ

maxInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของที่นั่งขณะที่น้ำลึกขึ้น ส่วน minInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของที่นั่งขณะที่น้ำตื้นลง

ค่าสัมบูรณ์ที่มากขึ้น ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น เมื่อ พนักพิงเบาะนั่งถึงขีดจำกัดของตำแหน่งแล้ว ค่าต้องรีเซ็ตเป็น 0 หากค่าของ ขณะนี้ SEAT_DEPTH_MOVE อยู่ที่ 0 และไม่มีการเคลื่อนไหวใดๆ

คุณสมบัตินี้จะแสดงเป็นช่วงความเร็วการเคลื่อนที่สัมพัทธ์ที่ระบุ

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE
ประเภท enum: ไม่มี
ประเภทหน่วย: ไม่มี
รุ่น: Android 13

SEAT_DEPTH_POS

ตำแหน่งความลึกที่นั่ง ตั้งค่าความลึกของที่นั่ง ระยะห่างจากพนักพิงหลังถึงขอบด้านหน้าของที่นั่ง

ต้องกำหนด maxInt32Value และ minInt32Value ใน DeviceAreaConfig จำนวนเต็มทั้งหมด ต้องมีการรองรับระหว่าง minInt32Value ถึง maxInt32Value

minInt32Value บ่งบอกว่าเบาะอยู่ในตำแหน่งที่ต่ำที่สุด (เช่น ตำแหน่งที่มีระยะห่างระหว่างขอบด้านหน้าของเบาะกับส่วนท้ายของเบาะน้อยที่สุด)

maxInt32Value บ่งบอกว่าเบาะอยู่ในตำแหน่งที่ลึกที่สุด (เช่น ตำแหน่งที่มีระยะห่างระหว่างขอบด้านหน้าของเบาะกับส่วนหลังของเบาะมากที่สุด)

ค่าที่อยู่ระหว่าง minInt32Value ถึง maxInt32Value จะระบุสถานะการเปลี่ยนระหว่าง ตำแหน่งที่ตื้นและลึกที่สุด

พร็อพเพอร์ตี้นี้แสดงเป็นช่วงที่ระบุของตำแหน่งสัมพัทธ์

พร็อพเพอร์ตี้นี้ระบุเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM ทำได้ นำไปใช้เป็น <covehiclepropertyaccess.read< รหัส=""> เท่านั้น..</covehiclepropertyaccess.read<>

SEAT_EASY_ACCESS_ENABLED

แสดงที่พักสำหรับฟีเจอร์การเข้าถึงที่นั่งได้ง่าย หากเป็น "จริง" ระบบจะปรับเบาะโดยอัตโนมัติเพื่อให้ผู้โดยสารเข้าและออกจากรถได้ง่ายขึ้น รหัสพื้นที่แต่ละรหัสต้องจับคู่กับ ที่นั่งที่ผู้ใช้พยายามเข้า/ออกโดยใช้ฟีเจอร์การเข้าถึงที่ง่ายดาย พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น <covehiclepropertyaccess.read< code=""> เท่านั้น</covehiclepropertyaccess.read<>

SEAT_FOOTWELL_LIGHTS_STATE

แสดงพร็อพเพอร์ตี้ของสถานะไฟทางเดินของที่นั่ง SEAT_FOOTWELL_LIGHTS_STATE แสดงถึง สถานะปัจจุบันของไฟ ณ เวลาใดก็ได้ ซึ่งแตกต่างจากฟังก์ชันของ SEAT_FOOTWELL_LIGHTS_SWITCH ที่แสดงตำแหน่งของสวิตช์ที่ควบคุมไฟ

ดังนั้น SEAT_FOOTWELL_LIGHTS_STATE จึงอาจไม่ตรงกับค่าของ SEAT_FOOTWELL_LIGHTS_SWITCH (เช่น SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC และ SEAT_FOOTWELL_LIGHTS_SWITCH=ON)

ควรติดตั้งใช้งานพร็อพเพอร์ตี้นี้เฉพาะในกรณีที่ค่าของ SEAT_FOOTWELL_LIGHTS_STATE อาจแตกต่างออกไปเท่านั้น จาก CABIN_LIGHTS_STATE

สำหรับรหัสพื้นที่ที่รองรับแต่ละรหัส ต้องกำหนด DeviceAreaConfig#supportedEnumValues ยกเว้น รองรับค่า enum ทั้งหมดของ DeviceLightState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท enum: ยานพาหนะแสงสถานะ
ประเภทหน่วย: ไม่มี
รุ่น: Android 14

SEAT_FOOTWELL_LIGHTS_SWITCH

แสดงพร็อพเพอร์ตี้สำหรับสวิตช์ไฟที่บริเวณส่วนเท้าของที่นั่ง SEAT_FOOTWELL_LIGHTS_SWITCH แสดงถึง ตำแหน่งของสวิตช์ที่ควบคุมไฟ ซึ่งแตกต่างจากฟังก์ชันของ SEAT_FOOTWELL_LIGHTS_STATE ที่แสดงสถานะปัจจุบันของไฟ ณ เวลาใดก็ตาม ดังนั้น SEAT_FOOTWELL_LIGHTS_SWITCH จึงอาจไม่ตรงกับค่าของ SEAT_FOOTWELL_LIGHTS_STATE (เช่น SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC และ SEAT_FOOTWELL_LIGHTS_SWITCH=ON)

ควรนำพร็อพเพอร์ตี้นี้มาใช้ในกรณีที่ค่าของ SEAT_FOOTWELL_LIGHTS_SWITCH อาจแตกต่างกันเท่านั้น จาก CABIN_LIGHTS_SWITCH

สำหรับรหัสพื้นที่ที่รองรับแต่ละรหัส ต้องกำหนด DeviceAreaConfig#supportedEnumValues เว้นแต่จะระบุทั้งหมด รองรับค่า enum ของ DeviceLightSwitch

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: VehicleLightSwitch
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

SEAT_FORE_AFT_MOVE

เบาะเลื่อนไปข้างหน้าและข้างหลัง พร็อพเพอร์ตี้นี้จะเลื่อนทั้งที่นั่งไปข้างหน้า/ข้างหลังในทิศทางที่หัน

maxInt32Value และ minInt32Value ใน DeviceAreaConfig แต่ละรายการต้องเป็น กำหนดไว้ ระบบต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของที่นั่งขณะเคลื่อนที่ไปข้างหน้า minInt32Value แสดงความเร็วในการเคลื่อนไหวสูงสุดของที่นั่ง ย้อนกลับ

ค่าสัมบูรณ์ที่มากกว่า ไม่ว่าจะเป็นค่าบวกหรือลบ จะบ่งบอกถึงความเร็วในการเคลื่อนไหวที่เร็วกว่า เมื่อที่นั่งถึงขีดจํากัดตําแหน่งแล้ว ค่าต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_FORE_AFT_MOVE เท่ากับ 0 ไม่มีการเคลื่อนไหว

คุณสมบัตินี้จะแสดงเป็นช่วงความเร็วการเคลื่อนที่สัมพัทธ์ที่ระบุ

SEAT_FORE_AFT_POS

ตำแหน่งหน้าและหลังของเบาะ กำหนดตำแหน่งที่นั่งไปข้างหน้าและข้างหลัง

ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดตั้งแต่ minInt32Value ถึง maxInt32Value

minInt32Value บ่งบอกว่าที่นั่งอยู่กึ่งกลางหน้าสุด maxInt32Value บ่งบอกว่าที่นั่งอยู่กึ่งกลางหน้าสุด ค่าระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกสถานะการเปลี่ยนผ่านระหว่างตำแหน่งที่ใกล้ที่สุดและไกลที่สุด

พร็อพเพอร์ตี้นี้จะแสดงเป็นช่วงตำแหน่งสัมพัทธ์ที่ระบุ

SEAT_HEADREST_ANGLE_MOVE

ปรับมุมของพนักพิงศีรษะ maxInt32Value และ minInt32Value ในแต่ละกลุ่ม ต้องระบุ VehicleAreaConfig จำนวนเต็มทั้งหมดระหว่าง minInt32Value และ maxInt32Value ต้องได้รับการรองรับ

maxInt32Value แสดงความเร็วสูงสุดในการเคลื่อนไหวของพนักพิงศีรษะของที่นั่ง ย้ายไปไว้ในตำแหน่งตั้งตรงหรือไปข้างหน้า minInt32Value แสดงถึงค่าสูงสุด ความเร็วในการเคลื่อนที่ของพนักพิงศีรษะของที่นั่งขณะเคลื่อนไปยังตำแหน่งที่ตื้น

ค่าสัมบูรณ์ที่มากกว่า ไม่ว่าจะเป็นค่าบวกหรือลบ จะบ่งบอกถึงความเร็วในการเคลื่อนไหวที่เร็วกว่า เมื่อพนักพิงของเบาะรถถึงขีดจำกัดตำแหน่งแล้ว ค่าจะต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_HEADREST_ANGLE_MOVE เท่ากับ 0 จึงไม่มีการเคลื่อนไหว

คุณสมบัตินี้จะแสดงเป็นช่วงความเร็วการเคลื่อนที่สัมพัทธ์ที่ระบุ

SEAT_HEADREST_ANGLE_POS

ตำแหน่งมุมของพนักพิงศีรษะ maxInt32Value และ minInt32Value ใน ต้องระบุ VehicleAreaConfig จำนวนเต็มทั้งหมดระหว่าง minInt32Value และ maxInt32Value ต้องได้รับการรองรับ

minInt32Value บ่งบอกว่าพนักพิงศีรษะอยู่ในตําแหน่งปรับเอนแบบเต็ม maxInt32Value บ่งบอกว่าพนักศีรษะอยู่ในตําแหน่งตั้งตรงและไปข้างหน้ามากที่สุด

ค่าที่อยู่ระหว่าง minInt32Value ถึง maxInt32Value แสดงถึง ระยะการเปลี่ยนไปมาระหว่างการเอนกลับอย่างเต็มที่ รวมถึงตำแหน่งตั้งตรงและไปข้างหน้ามากที่สุด

พร็อพเพอร์ตี้นี้แสดงเป็นช่วงที่ระบุของตำแหน่งสัมพัทธ์

SEAT_HEADREST_FORE_AFT_MOVE

ปรับเบาะศีรษะไปข้างหน้าและข้างหลังได้ maxInt32Value และ minInt32Value ใน ต้องระบุ VehicleAreaConfig แต่ละรายการ ระบบต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงความเร็วสูงสุดในการเคลื่อนไหวของพนักพิงศีรษะของที่นั่ง ในขณะที่ก้าวไปข้างหน้า minInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของพนักพิงศีรษะของเบาะขณะเลื่อนไปด้านหลัง

ค่าสัมบูรณ์ที่มากกว่า ไม่ว่าจะเป็นค่าบวกหรือลบ จะบ่งบอกถึงความเร็วในการเคลื่อนไหวที่เร็วกว่า ครั้งเดียว พนักพิงศีรษะของที่นั่งถึงขีดจํากัดของตําแหน่ง ค่าต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_HEADREST_FORE_AFT_MOVE เท่ากับ 0 จึงไม่มีการเคลื่อนไหวเกิดขึ้น

SEAT_HEADREST_FORE_AFT_POS

พนักพิงศีรษะอยู่ด้านหน้าและด้านหลัง maxInt32Value และ minInt32Value ต้องกำหนดใน VehicleAreaConfig จำนวนเต็มทั้งหมดระหว่าง minInt32Value และ maxInt32Value ต้องได้รับการรองรับ

minInt32Value บ่งบอกว่าพนักพิงศีรษะอยู่ในตำแหน่งแนวนอนที่ถอยหลังสุด maxInt32Value บ่งบอกว่าพนักพิงศีรษะอยู่ในตำแหน่งแนวนอนสุด

ค่าระหว่าง minInt32Value ถึง maxInt32Value แสดงสถานะการเปลี่ยนระหว่างตำแหน่งไปข้างหน้าและถอยหลัง

พร็อพเพอร์ตี้นี้แสดงเป็นช่วงที่ระบุของตำแหน่งสัมพัทธ์

SEAT_HEADREST_HEIGHT_MOVE

ปรับความสูงของพนักพิงศีรษะ ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ จำนวนเต็มทั้งหมดระหว่าง minInt32Value และ maxInt32Value ต้องได้รับการรองรับ

maxInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของพนักพิงศีรษะของที่นั่งขณะขยับขึ้น minInt32Value แสดงความเร็วการเคลื่อนไหวสูงสุดของที่นั่ง พนักพิงศีรษะขณะก้มลง

ค่าสัมบูรณ์ที่มากขึ้น ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น ครั้งเดียว พนักพิงศีรษะของที่นั่งถึงขีดจํากัดของตําแหน่ง ค่าต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_HEADREST_HEIGHT_MOVE เท่ากับ 0 จึงไม่มีการเคลื่อนไหวเกิดขึ้น

SEAT_HEADREST_HEIGHT_POS

(เลิกใช้งานแล้ว) ตำแหน่งความสูงของพนักพิงศีรษะ

SEAT_HEADREST_HEIGHT_POS_V2

ตำแหน่งความสูงของพนักพิงศีรษะ ตั้งค่าความสูงของพนักพิงศีรษะสำหรับที่นั่งที่รองรับ DevicePropConfig.areaConfigs จะระบุที่นั่งที่รองรับ

maxInt32Value และ minInt32Value ใน DeviceAreaConfig ต้องเป็น กำหนดไว้ ระบบต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

minInt32Value บ่งบอกว่าพนักพิงศีรษะอยู่ในตำแหน่งต่ำสุด maxInt32Value บ่งบอกว่าพนักศีรษะอยู่ในตำแหน่งสูงสุด

พร็อพเพอร์ตี้นี้จะแสดงเป็นช่วงตำแหน่งสัมพัทธ์ที่ระบุ

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท enum: ไม่มี
ประเภทหน่วย: ไม่มี
รุ่น: Android 14

SEAT_HEIGHT_MOVE

การปรับความสูงของที่นั่ง ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงถึงความเร็วในการเคลื่อนไหวสูงสุดของที่นั่งเมื่อเลื่อนขึ้น

minInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของเบาะเมื่อเลื่อนลง

ค่าสัมบูรณ์ที่มากกว่า ไม่ว่าจะเป็นค่าบวกหรือลบ จะบ่งบอกถึงความเร็วในการเคลื่อนไหวที่เร็วกว่า เมื่อ ที่นั่งถึงขีดจำกัดของตำแหน่ง ค่าต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_HEIGHT_MOVE เป็น 0 แสดงว่าไม่มีการเคลื่อนไหว

SEAT_HEIGHT_POS

ตำแหน่งความสูงที่นั่ง ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

minInt32Value บ่งบอกว่าเบาะอยู่ในตำแหน่งต่ำสุด maxInt32Value บ่งบอกว่าที่นั่งอยู่ในตำแหน่งสูงสุด

ค่าที่อยู่ระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกถึงการเปลี่ยน สถานะระหว่างตำแหน่งต่ำสุดและสูงสุดได้

พร็อพเพอร์ตี้นี้จะแสดงเป็นช่วงตำแหน่งสัมพัทธ์ที่ระบุ

SEAT_LUMBAR_FORE_AFT_MOVE

เอวต่ำด้านหน้าและด้านหลัง ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของส่วนรองรับหลังส่วนล่างของที่นั่งขณะเคลื่อนที่ไปข้างหน้า minInt32Value แสดงความเร็วการเคลื่อนไหวสูงสุดของ ที่รองเอวของที่นั่งขณะเคลื่อนไปด้านหลัง

ค่าสัมบูรณ์ที่มากขึ้น ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น เมื่อส่วนรองรับหลังส่วนล่างของเบาะถึงขีดจำกัดตำแหน่งแล้ว ค่าจะต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_LUMBAR_FORE_AFT_MOVE เป็น 0 หมายความว่าไม่มีการเคลื่อนไหวเกิดขึ้น

คุณสมบัตินี้จะแสดงเป็นช่วงความเร็วการเคลื่อนที่สัมพัทธ์ที่ระบุ

SEAT_LUMBAR_FORE_AFT_POS

ตำแหน่งด้านหน้าและหลังของไม้ maxInt32Value และ minInt32Value ใน ต้องกำหนด DeviceAreaConfig จำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง ต้องรองรับ maxInt32Value

minInt32Value บ่งบอกว่าส่วนรองรับเอวอยู่ในตำแหน่งที่ถอยหลังมากที่สุด (เช่น ตำแหน่งที่รองรับน้อยที่สุด) maxInt32Value บ่งบอกว่าส่วนรองรับหลังส่วนล่างอยู่ในตำแหน่งที่ดันไปข้างหน้ามากที่สุด (เช่น ตำแหน่งที่รองรับมากที่สุด)

ค่าระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกสถานะการเปลี่ยนระหว่างตำแหน่งเดินหน้าและถอยหลัง

พร็อพเพอร์ตี้นี้จะแสดงเป็นช่วงตำแหน่งสัมพัทธ์ที่ระบุ

เปลี่ยนโหมด: ON_CHANGE
ประเภทการเข้าถึง: READ_WRITE/READ
ประเภท enum: ไม่มี
ประเภทหน่วย: ไม่มี
รุ่น: Android 13

SEAT_LUMBAR_SIDE_SUPPORT_MOVE

ย้ายที่รองบริเวณเอว maxInt32Value และ minInt32Value ในแต่ละกลุ่ม ต้องระบุ VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงความเร็วในการเคลื่อนไหวสูงสุดสำหรับด้านเอวของที่นั่ง ขณะขยายการรองรับที่กว้างขึ้น minInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของส่วนรองรับเอวด้านข้างของเบาะขณะที่เบาะบางลง

ค่าสัมบูรณ์ที่มากขึ้น ไม่ว่าจะบวกหรือลบ บ่งบอกถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น ครั้งเดียว การรองรับส่วนเอวของเบาะนั่งถึงจุดสูงสุดของตำแหน่ง ค่าต้องรีเซ็ตเป็น 0 หาก เท่ากับ SEAT_LUMBAR_SIDE_SUPPORT_MOVE 0 ก็จะไม่เกิดการเคลื่อนไหวใดๆ

คุณสมบัตินี้จะแสดงเป็นช่วงความเร็วการเคลื่อนที่สัมพัทธ์ที่ระบุ

เปลี่ยนโหมด: ON_CHANGE
ประเภทการเข้าถึง: READ_WRITE/READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

SEAT_LUMBAR_SIDE_SUPPORT_POS

ตำแหน่งที่รองรับส่วนเอว maxInt32Value และ minInt32Value ใน ต้องกำหนด DeviceAreaConfig จำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง ต้องรองรับ maxInt32Value minInt32Value บ่งบอกว่าการรองรับบริเวณเอวอยู่ในตำแหน่งที่บางที่สุด (เช่น การรองรับส่วนใหญ่) maxInt32Value บ่งบอกว่าส่วนรองรับด้านข้างของหลังอยู่ในตำแหน่งที่กว้างที่สุด (เช่น รองรับน้อยที่สุด)

ค่าที่อยู่ระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกถึงการเปลี่ยน สถานะระหว่างตำแหน่งที่บางที่สุดกับตำแหน่งที่กว้างที่สุด

พร็อพเพอร์ตี้นี้จะแสดงเป็นช่วงตำแหน่งสัมพัทธ์ที่ระบุ

เปลี่ยนโหมด: ON_CHANGE
ประเภทการเข้าถึง: READ_WRITE/READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

SEAT_LUMBAR_VERTICAL_MOVE

แสดงพร็อพเพอร์ตี้สำหรับทิศทางการเคลื่อนไหวในแนวตั้งและความเร็วของการรองรับเอวเบาะ

maxInt32Value และ minInt32Value ใน DeviceAreaConfig แต่ละรายการต้องเป็น กำหนดไว้ จำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value ต้องเท่ากับ ที่รองรับ maxInt32Value บ่งบอกว่าการรองรับเอวเคลื่อนไหวเร็วที่สุด ให้เร็วขึ้น minInt32Value บ่งบอกว่าส่วนรองรับเอวกำลังเลื่อนลงด้วยความเร็วสูงสุด

ค่าสัมบูรณ์ที่มากกว่า ไม่ว่าจะเป็นค่าบวกหรือลบ จะบ่งบอกถึงความเร็วในการเคลื่อนไหวที่เร็วกว่า เมื่อตัวรองรับด้านข้างของเบาะนั่งถึงขีดจำกัดตำแหน่งแล้ว ค่าจะต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_LUMBAR_VERTICAL_MOVE มีค่า 0 หมายความว่าไม่มีการเคลื่อนไหว

SEAT_LUMBAR_VERTICAL_POS

แสดงคุณสมบัติของตำแหน่งรองรับเอวของเบาะนั่งในแนวตั้ง ต้องกําหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ จำนวนเต็มทั้งหมดระหว่าง ต้องรองรับ minInt32Value และ maxInt32Value maxInt32Value หมายถึงตำแหน่งสูงสุดของการรองรับเอว minInt32Value หมายถึงตำแหน่งต่ำสุดของการรองรับเอว

พร็อพเพอร์ตี้นี้จะแสดงเป็นช่วงตำแหน่งสัมพัทธ์ที่ระบุ

SEAT_MEMORY_SELECT

พารามิเตอร์นี้จะเลือกค่าหน่วยความจำที่กำหนดล่วงหน้าเพื่อใช้เลือกตำแหน่งที่นั่ง ต้องกำหนด maxInt32Value และ minInt32Value ใน DeviceAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดตั้งแต่ minInt32Value ถึง maxInt32Value minInt32Value จะมีค่าเป็น 0 เสมอ และ maxInt32Value จะระบุ จำนวนสล็อตหน่วยความจำที่กำหนดล่วงหน้าสำหรับใบอนุญาตที่มี (เช่น numSeatPresets - 1) ตัวอย่างเช่น หากที่นั่งคนขับมีการตั้งค่าหน่วยความจำล่วงหน้า 3 ค่า maxInt32Value จะเท่ากับ 2 เมื่อ ผู้ใช้เลือกค่าที่กำหนดล่วงหน้า มีการกำหนดตัวเลขค่าที่กำหนดล่วงหน้าที่ต้องการ (0, 1 หรือ 2)

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: WRITE
ประเภท enum: ไม่มี
ประเภทหน่วย: ไม่มี
รุ่น: Android 13

SEAT_MEMORY_SET

การตั้งค่านี้ช่วยให้ผู้ใช้บันทึกการตั้งค่าตำแหน่งที่นั่งปัจจุบันลงในช่องที่กำหนดล่วงหน้าได้ ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig minInt32Value ต้องเป็น 0 และ maxInt32Value สำหรับแต่ละตำแหน่งที่นั่งต้องตรงกับ maxInt32Value สำหรับ SEAT_MEMORY_SELECT

SEAT_OCCUPANCY

บ่งชี้ว่าเบาะใดมีผู้โดยสารอยู่หรือไม่ โดยอิงตามความสามารถของรถในการระบุ ค่าที่ถูกต้องมาจาก VehicleSeatOccupancyState enum

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท enum: VehicleSeatOccupancyState
ประเภทหน่วย: ไม่มี
รุ่น: Android 13

SEAT_TILT_MOVE

การย้ายการเอียงที่นั่ง ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value maxInt32Value แสดงความเร็วการเคลื่อนไหวสูงสุดของขอบด้านหน้าของที่นั่งขณะขยับขึ้น minInt32Value แสดงความเร็วสูงสุดของการเคลื่อนไหวของขอบด้านหน้าของเบาะขณะเลื่อนลง

ค่าสัมบูรณ์ที่มากขึ้น ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น เมื่อด้านล่างของเบาะถึงขีดจำกัดตำแหน่งแล้ว ค่าจะต้องรีเซ็ตเป็น 0 หากค่าของ SEAT_TILT_MOVE มีค่าเป็น 0 แสดงว่าไม่มีการเคลื่อนไหว

คุณสมบัตินี้จะแสดงเป็นช่วงความเร็วการเคลื่อนที่สัมพัทธ์ที่ระบุ

SEAT_TILT_POS

ตำแหน่งการเอียงของเบาะ ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value minInt32Value บ่งชี้ว่าก้นที่นั่งทำมุมในตำแหน่งมุมที่ต่ำที่สุด ซึ่งสอดคล้องกับ ขอบหน้าอยู่ในตำแหน่งต่ำสุดที่เป็นไปได้เมื่อเทียบกับด้านหลังของที่นั่ง maxInt32Value บ่งบอกว่าด้านล่างของเบาะเอียงอยู่ในตำแหน่งเชิงมุมที่สูงที่สุด ซึ่งสอดคล้องกับขอบด้านหน้าของเบาะที่อยู่ในตำแหน่งที่สูงที่สุดเมื่อเทียบกับส่วนท้ายของเบาะ

พร็อพเพอร์ตี้นี้จะแสดงเป็นช่วงตำแหน่งสัมพัทธ์ที่ระบุ

มูลค่า SEAT_WALK IN_POS

แสดงพร็อพเพอร์ตี้ที่ระบุตำแหน่งการเดินเข้าปัจจุบันของที่นั่ง minInt32Value จะระบุตำแหน่งที่นั่งปกติ minInt32Value ต้องเป็น 0 สัญลักษณ์ maxInt32Value จะระบุว่าที่นั่งอยู่ในตำแหน่งที่วอล์กอินเต็มแล้ว

ค่าระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกสถานะการเปลี่ยนผ่านระหว่างตำแหน่งปกติกับตำแหน่งที่ลูกค้าเดินเข้า

พร็อพเพอร์ตี้นี้จะแสดงเป็นช่วงตำแหน่งสัมพัทธ์ที่ระบุ

รหัสพื้นที่ต้องตรงกับที่นั่งที่เคลื่อนย้ายจริงเมื่อฟีเจอร์วอล์กอินเปิดใช้งาน ไม่ใช่ ที่นั่งที่ผู้โดยสารจะนั่งอยู่

พร็อพเพอร์ตี้นี้ระบุเป็นพาหนะPropertyAccess.READ_WRITE แต่ OEM ทำได้

ใช้เป็น VehiclePropertyAccess.READ เท่านั้น

SHUTDOWN_REQUEST

ขอให้ปิดเครื่องเล่นวิทยุ

จำเป็นต้องใช้เพื่อดำเนินการเมื่อปิดเครื่องส่วนหัว (ฟีเจอร์งานระยะไกล) หลังจากที่เปิดระบบเครื่องเสียงเพื่อทำงานแล้ว ควรปิดเครื่องเล่นวิทยุ หัว หน่วยจะส่งข้อความนี้เมื่องานเสร็จสิ้น

พร็อพเพอร์ตี้นี้จะไม่มีผลเมื่อผู้ใช้ต้องการปิดเครื่องส่วนหัว

ซึ่งโดยปกติจะรวมถึงการแจ้งระบบแยกต่างหากภายนอกระบบเครื่องเสียง (เช่น ช่องเสียบไฟ ) เพื่อเตรียมปิดระบบเครื่องเสียง

ระบบภายนอกต้องตรวจสอบว่าคำขอนี้ถูกต้องโดยดูว่ายานพาหนะมีการใช้งานอยู่หรือไม่ หากผู้ใช้เข้าไปในรถหลังจากที่ส่ง SHUTDOWN_REQUEST แล้ว ระบบต้องละเว้นคำขอนี้ ขอแนะนำให้จัดเก็บพร็อพเพอร์ตี้ TrafficInUse ไว้ในตัวควบคุมพลังงานและ ผ่านคุณสมบัติ VEHICLE_IN_USE ระบบต้องละเว้นคำขอปิดเครื่องหาก VehicleInUse เป็นจริง

หากได้รับอนุญาต ระบบภายนอกจะส่งสัญญาณปิดเครื่องไปยังจอภาพส่วนกลาง ซึ่งจะทำให้ VHAL ส่งข้อความ SHUTDOWN_PREPARE ไปยัง Android จากนั้น Android จะเริ่มกระบวนการปิดเครื่องโดยจัดการข้อความ

พร็อพเพอร์ตี้นี้ใช้สำหรับการออกคำขอเท่านั้นและรองรับการเขียนเท่านั้น ทุกครั้งที่มีการตั้งค่าพร็อพเพอร์ตี้นี้ ระบบจะส่งคําขอปิดระบบไม่ว่าค่าพร็อพเพอร์ตี้ปัจจุบันจะเป็นค่าใดก็ตาม ค่าพร็อพเพอร์ตี้ปัจจุบันจะไม่มีความหมาย

เนื่องจากพร็อพเพอร์ตี้นี้เป็นแบบเขียนเท่านั้น จึงไม่อนุญาตให้สมัครใช้บริการและไม่มีเหตุการณ์การเปลี่ยนแปลงพร็อพเพอร์ตี้ ที่สร้างขึ้น

ค่าที่ต้องตั้งค่าระบุถึงตัวเลือกการปิดเครื่อง ค่านี้ต้องเป็นหนึ่งในค่า {@code VehicleApPowerStateShutdownParam} ตัวอย่างเช่น VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY ระบบอาจไม่ใช้ตัวเลือกการปิดเครื่องนี้หากไม่รองรับตัวเลือกดังกล่าว ในกรณีดังกล่าว จะไม่มีการส่งกลับข้อผิดพลาด

VehiclePropConfig.configArray ต้องมีการแฟล็กบิตสำหรับข้อมูลการกำหนดค่า รวมค่าใน {@code VehicleApPowerStateConfigFlag} เพื่อระบุว่าหยุดให้บริการใด ตัวเลือกที่ใช้ได้

แสดงข้อผิดพลาดหากส่งคําขอปิดระบบไปยังระบบอื่นไม่สําเร็จ

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: WRITE
ประเภท enum: VehicleApPowerStateShutdownParam>
ประเภทหน่วย: ไม่มี
รุ่น: Android 14

STEERING_WHEEL_DEPTH_MOVE

การเคลื่อนไหวของพวงมาลัย ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับค่าทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value บ่งบอกว่าพวงมาลัยจะออกห่างจากคนขับ minInt32Value บ่งบอกว่าพวงมาลัยหมุนเข้าหาคนขับ

จำนวนเต็มที่มีค่ามากกว่า ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น เมื่อพวงมาลัยถึงขีดจำกัดตำแหน่ง ค่าต้องรีเซ็ตเป็น 0 หากค่าของ STEERING_WHEEL_DEPTH_MOVE เป็น 0 แสดงว่าไม่มีการเคลื่อนไหว

พร็อพเพอร์ตี้นี้แสดงเป็นช่วงที่ระบุของสัมพัทธ์ ความเร็วในการเคลื่อนที่

STEERING_WHEEL_DEPTH_POS

ตำแหน่งความลึกของพวงมาลัย คุณสมบัติทั้งหมดของพวงมาลัย รหัสที่ไม่ซ้ำกันจะเริ่มตั้งแต่ 0x0BE0

maxInt32Value และ minInt32Value ใน DeviceAreaConfig ต้องเป็น กำหนดไว้ ค่าทั้งหมดที่อยู่ระหว่าง minInt32Value ถึง maxInt32Value ต้องเป็น ที่รองรับ maxInt32Value บ่งชี้ถึงตำแหน่งพวงมาลัยที่ห่างจาก คนขับ minInt32Value ระบุตำแหน่งของพวงมาลัยที่ใกล้กับพวงมาลัยมากที่สุด คนขับ

ค่าระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกถึงสถานะการเปลี่ยนผ่านระหว่าง

พร็อพเพอร์ตี้นี้แสดงเป็นช่วงที่ระบุของตำแหน่งสัมพัทธ์

STEERING_WHEEL_EASY_ACCESS_Enabled

เปิดใช้ฟีเจอร์การเข้าถึงได้ง่ายจากพวงมาลัย หากเป็นจริง พวงมาลัยคนขับจะขับเคลื่อนโดยอัตโนมัติ ปรับเพื่อให้ผู้ขับเข้าและออกจากรถได้ง่ายขึ้น

STEERING_WHEEL_HEIGHT_MOVE

การเคลื่อนไหวความสูงของพวงมาลัย maxInt32Value และ minInt32Value ต้องกำหนดใน DeviceAreaConfig ต้องรองรับค่าทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

maxInt32Value แสดงว่าพวงมาลัยเลื่อนขึ้น minInt32Value บ่งบอกว่าพวงมาลัยเคลื่อนที่ลง

จำนวนเต็มที่มีค่ามากกว่า ไม่ว่าจะบวกหรือลบ แสดงถึงความเร็วในการเคลื่อนที่ที่เร็วขึ้น เมื่อ พวงมาลัยถึงตำแหน่งที่จำกัดไว้ ค่าต้องรีเซ็ตเป็น 0 ถ้า ตอนนี้ค่าของ STEERING_WHEEL_HEIGHT_MOVE เป็น 0 ซึ่งหมายความว่าไม่มีการเคลื่อนไหว ที่กำลังเกิดขึ้น

STEERING_WHEEL_HEIGHT_POS

ตำแหน่งความสูงของพวงมาลัย

ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับค่าทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value maxInt32Value บ่งบอกว่าพวงมาลัยอยู่ในจุดสูงสุด ตำแหน่ง minInt32Value บ่งบอกว่าพวงมาลัยอยู่ในระยะต่ำสุด ตำแหน่ง

ค่าระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกถึงสถานะการเปลี่ยนผ่านระหว่างตําแหน่งต่ำสุดและสูงสุด

พร็อพเพอร์ตี้นี้แสดงเป็นช่วงที่ระบุของตำแหน่งสัมพัทธ์

STEERING_WHEEL_LIGHTS_STATE

สถานะไฟพวงมาลัย แสดงสถานะปัจจุบันของไฟที่พวงมาลัย นี่คือ แตกต่างจาก STEERING_WHEEL_LIGHTS_SWITCH ซึ่งแสดงถึงตำแหน่งของสวิตช์ กำลังควบคุมแสงไฟ ดังนั้น STEERING_WHEEL_LIGHTS_STATE อาจไม่ตรงกับค่าของ STEERING_WHEEL_LIGHTS_SWITCH (เช่น STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC และ STEERING_WHEEL_LIGHTS_STATE=ON)

คุณควรใช้พร็อพเพอร์ตี้นี้เฉพาะในกรณีที่ค่าของ STEERING_WHEEL_LIGHTS_STATE อาจแตกต่างจากค่าของ CABIN_LIGHTS_STATE

สำหรับรหัสพื้นที่ส่วนกลาง (0) ต้องกำหนด DeviceAreaConfig#supportedEnumValues เว้นแต่จะระบุทั้งหมด รองรับค่า enum ของ DeviceLightState

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: VehicleLightState
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

STEERING_WHEEL_LIGHTS_SWITCH

สวิตช์ไฟที่พวงมาลัย แสดงตำแหน่งของสวิตช์ที่ควบคุมไฟของพวงมาลัย ซึ่งแตกต่างจาก ซึ่งแสดงถึงสถานะปัจจุบัน ของไฟพวงมาลัย ดังนั้น STEERING_WHEEL_LIGHTS_SWITCH จึงอาจไม่ตรงกับค่าของ STEERING_WHEEL_LIGHTS_STATE เช่น STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC และ STEERING_WHEEL_LIGHTS_STATE=ON

คุณควรใช้พร็อพเพอร์ตี้นี้เฉพาะในกรณีที่ค่าของ STEERING_WHEEL_LIGHTS_SWITCH แตกต่างจากค่าของ CABIN_LIGHTS_SWITCH

สำหรับรหัสพื้นที่ส่วนกลาง (0) จะต้องกำหนด VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับค่า Enum ทั้งหมดของ VehicleLightSwitch

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท Enum: VehicleLightSwitch
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 14

STEERING_WHEEL_LOCKED

ล็อกพวงมาลัยแล้ว หากเป็น "จริง" ตำแหน่งของพวงมาลัยจะล็อกไว้และไม่สามารถเปลี่ยนแปลงได้ พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น <covehiclepropertyaccess.read< code=""> เท่านั้น/p> </covehiclepropertyaccess.read<>

STEERING_WHEEL_THEFT_LOCK_ENABLED

เปิดใช้ฟีเจอร์ล็อกขโมยพวงมาลัยแล้ว หากเป็น "จริง" พวงมาลัยจะล็อกโดยอัตโนมัติเพื่อป้องกันการโจรกรรมในบางสถานการณ์ พร็อพเพอร์ตี้นี้ระบุเป็น DevicePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น DevicePropertyAccess.READ เท่านั้น

ENCRYPTION_BINDING_SEED

SEED การเชื่อมโยงการเข้ารหัสภายนอก ค่านี้จะรวมกับคีย์การเข้ารหัสพื้นที่เก็บข้อมูลคีย์ในเครื่อง พร็อพเพอร์ตี้นี้มีความยาว 16 ไบต์ และคาดว่าจะเก็บไว้ใน ECU แยกจาก IVI พร็อพเพอร์ตี้ได้รับการตั้งค่าเริ่มต้นโดย AAOS ซึ่งสร้างโดยใช้ CSRNG จากนั้น AAOS จะอ่าน ในการเปิดเครื่องครั้งต่อๆ ไป เมล็ดการเชื่อมโยงควรได้รับการเก็บรักษาอย่างน่าเชื่อถือ การสูญเสียข้อมูลเมล็ดพันธุ์จะส่งผลให้ IVI รีเซ็ตเป็นค่าเริ่มต้น

SUPPORT_CUSTOMIZE_VENDOR_PERMISSION

รองรับการปรับแต่งสิทธิ์สำหรับพร็อพเพอร์ตี้ของผู้ให้บริการ

ใช้พร็อพเพอร์ตี้นี้หาก VHAL รองรับฟีเจอร์ปรับแต่งสิทธิ์ของผู้ให้บริการ ใช้ยานพาหนะ PropConfig.configArray เพื่อระบุพร็อพเพอร์ตี้และสิทธิ์ของผู้ให้บริการ เลือกไว้สำหรับพร็อพเพอร์ตี้ของผู้ให้บริการนี้ สิทธิ์ต้องเป็นค่าใดค่าหนึ่งใน enum ใน VehicleVendorPermission การตั้งค่า configArray มีดังนี้ configArray[n]: propId : property ID สำหรับพร็อพเพอร์ตี้ของผู้ให้บริการ โดยที่ configArray[n+1] เป็นค่าแจกแจงใน VehicleVendorPermission และระบุสิทธิ์ในการอ่านค่าของพร็อพเพอร์ตี้

configArray[n+2] เป็น enum ใน DeviceVendorRight และระบุสิทธิ์ในการเขียน ค่าของพร็อพเพอร์ตี้ เช่น

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

หากพร็อพเพอร์ตี้ของผู้ให้บริการไม่ได้อยู่ในอาร์เรย์นี้ พร็อพเพอร์ตี้จะมีสิทธิ์ของผู้ให้บริการเริ่มต้น หากผู้ให้บริการเลือก PERMISSION_NOT_ACCESSIBLE ไว้ Android จะไม่มีสิทธิ์เข้าถึงพร็อพเพอร์ตี้ ในตัวอย่างนี้ Android ไม่สามารถเขียนค่าสำหรับ provider_prop_2 ได้

รองรับ

(เลิกใช้งานแล้ว) รายการรหัสพร็อพเพอร์ตี้ที่รองรับทั้งหมด

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท enum: ไม่มี
ประเภทหน่วย: ไม่มี
รุ่น: Android 14

เปลี่ยนผู้ใช้

กำหนดคำขอเพื่อสลับผู้ใช้ Android ที่ทำงานอยู่เบื้องหน้า

พร็อพเพอร์ตี้นี้ใช้โดยระบบ Android เป็นหลักเพื่อแจ้ง HAL ว่าพร็อพเพอร์ตี้ ผู้ใช้ Android ที่ทำงานอยู่เบื้องหน้ากำลังเปลี่ยนโหมด แต่ HAL อาจใช้บัญชีนี้เพื่อขอ ระบบ Android สำหรับสลับผู้ใช้ เมื่อ Android ส่งคำขอนี้ อุปกรณ์จะตั้งค่าพร้อมกับValuePropValue และ HAL ต้องตอบกลับด้วยเหตุการณ์การเปลี่ยนแปลงที่พัก เมื่อ HAL ส่งคำขอ จะต้องดำเนินการผ่านเหตุการณ์การเปลี่ยนแปลงพร็อพเพอร์ตี้ด้วย (ความแตกต่างหลักคือรหัสคำขอเป็นบวกในกรณีแรกและเป็นลบในกรณีหลัง) นอกจากนี้ SwitchUserMessageType ยังแตกต่างกันด้วย

รูปแบบของคำขอทั้ง 2 รายการจะกำหนดโดย SwitchUserRequest และรูปแบบการตอบกลับ (เมื่อ ) จะกำหนดโดย SwitchUserResponse วิธีที่ HAL (หรือระบบ Android) ควรดำเนินการต่อจะขึ้นอยู่กับประเภทข้อความ (ซึ่งกำหนดโดยพารามิเตอร์ SwitchUserMessageType) ตามที่ระบุไว้ด้านล่าง

LEGACY_ANDROID_SWITCH ระบบ Android โทรหาเพื่อระบุผู้ใช้ Android กำลังจะมีการเปลี่ยนแปลง เมื่อมีการส่งคำขอเปลี่ยนแปลงในลักษณะที่ไม่ผสานรวมกับ HAL (เช่น ผ่าน adb shell am Switch-user) HAL จะเปลี่ยนผู้ใช้ภายในได้ครั้งเดียว อุปกรณ์จะได้รับคำขอนี้ แต่ไม่จำเป็นต้องตอบกลับระบบ Android หาก ไม่สามารถเปลี่ยนผู้ใช้ภายในด้วยเหตุผลบางประการ จะต้องรอ มีการเรียกใช้ SWITCH_USER(type=ANDROID_POST_SWITCH) รายการเพื่อกู้คืน (เช่น อาจมีปัญหา SWITCH_USER(type=VEHICLE_REQUEST) เพื่อเปลี่ยนกลับไปเป็นผู้ใช้ก่อนหน้า) ตามหลัก ไม่ควรล้มเหลว (เพราะการเปลี่ยนกลับอาจทำให้ผู้ใช้ปลายทางสับสนได้)
เช่น หากระบบมีผู้ใช้ (0, 10, 11) และเปลี่ยนจาก 0 เป็น 11 (เมื่อไม่มีผู้ใดได้รับ Flag พิเศษ) คำขอจะเป็นดังนี้
- int32[0] 42 // รหัสคำขอ
- int32[1] 1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCH
- int32[2] 11 // รหัสผู้ใช้เป้าหมาย
- int32[3] 0 // target user flags (none)
- int32[4] 10 // ผู้ใช้ปัจจุบัน
- int32[5] 0 // การแจ้งผู้ใช้ปัจจุบัน (ไม่มี)
- int32[6] 3 // จำนวนผู้ใช้
- int32[7] 0 // user #0 (Android user id 0)
- int32[8] 0 // การแจ้งว่าไม่เหมาะสมของผู้ใช้ #0 (ไม่มี)
- int32[9] 10 // ผู้ใช้ #1 (รหัสผู้ใช้ Android 10)
- int32[10] 0 // การแจ้งว่าไม่เหมาะสมของผู้ใช้ #1 (ไม่มี)
- int32[11] 11 // ผู้ใช้ #2 (รหัสผู้ใช้ Android 11)
- int32[12] 0 // flags of user #2 (none)
ANDROID_SWITCH ระบบ Android เรียกใช้เพื่อระบุว่าผู้ใช้ Android กำลังจะเปลี่ยน แต่ Android จะรอการตอบกลับจาก HAL (สูงสุด 20 วินาที) ก่อนดำเนินการต่อ HAL ต้อง เปลี่ยนผู้ใช้ภายในเมื่อได้รับคำขอนี้ แล้วตอบกลับไปยัง Android ด้วย SWITCH_USER(type=VEHICLE_RESPONSE) ที่ระบุว่าผู้ใช้ภายในถูกเปลี่ยนหรือไม่ (ผ่าน enum SwitchUserStatus) เช่น หาก Android มีผู้ใช้ (0, 10, 11) และกำลังเปลี่ยนไปใช้ 11 (โดยไม่มีผู้ใช้รายใดมี Flag พิเศษ) คำขอจะเป็นดังนี้
- int32[0] 42 // รหัสคำขอ
- int32[1] 2 // SwitchUserMessageType::ANDROID_SWITCH
- int32[2] 11 // target user id
- int32[3] 0 // target user flags (none)
- int32[4] 10 // ผู้ใช้ปัจจุบัน
- int32[5] 0 // การแจ้งผู้ใช้ปัจจุบัน (ไม่มี)
- int32[6] 3 // number of users
- int32[7] 0 // ผู้ใช้ครั้งแรก (ผู้ใช้ 0)
- int32[8] 1 // การแจ้งผู้ใช้ครั้งแรก (ระบบ)
- int32[9] 10 // ผู้ใช้ที่ 2 (ผู้ใช้ 10)
- int32[10] 0 // การแจ้งผู้ใช้ครั้งที่ 2 (ไม่มี)
- int32[11] 11 // ผู้ใช้รายที่ 3 (ผู้ใช้ 11)
- int32[12] 0 // Flag ผู้ใช้ที่ 3 (ไม่มี)
หากคำขอสำเร็จ HAL จะต้องอัปเดตพร็อพเพอร์ตี้ด้วย
- int32[0] 42 // request id
- int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
- int32[2] 1 // สถานะ: SwitchUserStatus::SUCCESS
หากคำขอไม่สำเร็จ การตอบกลับจะมีลักษณะดังนี้
- int32[0] 42 // รหัสคำขอ
- int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
- int32[2] 2 // status: SwitchUserStatus::FAILURE string: "108-D'OH!"
- ข้อความแสดงข้อผิดพลาดเฉพาะ OEM
VEHICLE_RESPONSE HAL เรียกใช้เพื่อระบุว่าควรดำเนินการต่อหรือยกเลิกคำขอประเภท ANDROID_SWITCH โปรดดู ANDROID_SWITCH ด้วย
VEHICLE_REQUEST โทรจาก HAL เพื่อขอให้ผู้ใช้ Android ที่ทำงานอยู่เบื้องหน้าคนปัจจุบันคือ สลับแล้ว รูปแบบนี้มีประโยชน์ในกรณีที่ Android เริ่มต้นมาจากผู้ใช้คนเดียวแต่ใช้รถยนต์ ระบุว่าผู้ขับขี่เป็นผู้ใช้รายอื่น เช่น ผู้ใช้ A ปลดล็อกรถโดยใช้กุญแจรีโมต ของผู้ใช้ B คําขอ INITIAL_USER_INFO แสดงผลผู้ใช้ ข. แต่ระบบย่อยการจดจําใบหน้าระบุผู้ใช้เป็น ก. HAL ส่งคำขอนี้จากเหตุการณ์การเปลี่ยนแปลงที่พัก (ส่งผ่านรหัสคำขอเชิงลบ) และการตอบสนองของระบบ Android คือการออก ANDROID_POST_SWITCH การโทรที่มีรหัสคำขอเดียวกัน ตัวอย่างเช่น หากส่วนหน้าปัจจุบัน ผู้ใช้ Android อายุ 10 ปีและ HAL ขอให้เปลี่ยนเป็น 11 คำขอจะเป็นดังนี้
- int32[0] -108 // รหัสคำขอ
- int32[1] 4 // messageType: SwitchUserMessageType::VEHICLE_REQUEST
- int32[2] 11 // รหัสผู้ใช้ Android
หากคำขอประสบความสำเร็จและ Android มีผู้ใช้ 3 ราย (0, 10 และ 11) การตอบกลับจะเป็นดังนี้
- int32[0] -108 // รหัสคำขอ
- int32[1] 5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCH
- int32[2] 11 // target user id
- int32[3] 0 // แฟล็กรหัสผู้ใช้เป้าหมาย (ไม่มี)
- int32[4] 11 // current user
- int32[5] 0 // current user flags (none)
- int32[6] 3 // number of users
- int32[7] 0 // ผู้ใช้ครั้งแรก (ผู้ใช้ 0)
- int32[8] 0 // การรายงานปัญหาของผู้ใช้ครั้งแรก (ไม่มี)
- int32[9] 10 // ผู้ใช้คนที่ 2 (ผู้ใช้ 10)
- int32[10] 4 // second user flags (none)
- int32[11] 11 // ผู้ใช้บุคคลที่สาม (ผู้ใช้ 11)
- int32[12] 3 // ธงของผู้ใช้รายที่ 3 (ไม่มี)
รหัสผู้ใช้ปัจจุบันและรหัสผู้ใช้เป้าหมายเหมือนกัน หากคำขอไม่ประสบความสำเร็จ คำขอจะต่างออกไป เช่น ผู้ใช้เป้าหมายจะเป็น 11 และผู้ใช้ปัจจุบันจะยังคงเป็น 10
ANDROID_POST_SWITCH ระบบ Android จะเรียกใช้หลังจากมีคำขอเปลี่ยนผู้ใช้ ระบบจะเรียกพร็อพเพอร์ตี้นี้หลังจากคำขอเปลี่ยนทุกประเภท (เช่น >code>LEGACY_ANDROID_SWITCH, >code>ANDROID_SWITCH หรือ VEHICLE_REQUEST) และสามารถใช้เพื่อระบุว่าคำขอสำเร็จหรือไม่ หรือ ล้มเหลว
- เมื่อสําเร็จ ระบบจะเรียกใช้เมื่อผู้ใช้ Android อยู่ในสถานะปลดล็อกและ ของรหัสผู้ใช้ปัจจุบันและรหัสเป้าหมายในคำตอบจะเหมือนกัน ซึ่งเทียบเท่ากับการรับ Intent.ACTION_USER_UNLOCKED ในแอป Android
- เมื่อไม่สำเร็จ ระบบจะเรียกใช้ทันที พร้อมทั้งค่าของรหัสผู้ใช้ปัจจุบันและของผู้ใช้เป้าหมาย ในคำตอบแตกต่างกัน (เนื่องจากผู้ใช้ปัจจุบันไม่ได้เปลี่ยนเป็นเป้าหมาย)
- หากมีคำขอเปลี่ยนใหม่ก่อนที่ HAL จะตอบกลับคำขอก่อนหน้าหรือก่อนที่ผู้ใช้จะปลดล็อก ระบบจะไม่ส่งคำขอ ANDROID_POST_SWITCH เช่น คนขับอาจเปลี่ยนเป็นผู้ใช้ที่ไม่ถูกต้องโดยไม่ได้ตั้งใจ ซึ่งมีการล็อกข้อมูลเข้าสู่ระบบ จากนั้นจึงเปลี่ยนเป็นผู้ใช้ที่ถูกต้องก่อนป้อนข้อมูลเข้าสู่ระบบ
HAL สามารถอัปเดตสถานะภายในเมื่อได้รับคำขอนี้ แต่ไม่จำเป็นต้อง ตอบกลับระบบ Android
- ส่งคำขอ ค่า N รายการแรกตามที่กำหนดโดย INITIAL_USER_INFO (โดยค่าเฉพาะคำขอที่อินเด็กซ์ 1 คือ SwitchUserMessageType::ANDROID_POST_SWITCH) จากนั้นให้เพิ่มอีก 2 ค่าสำหรับรหัสผู้ใช้เป้าหมาย (เช่น รหัสผู้ใช้ Android ที่ขอเปลี่ยน) และ Flag ของรหัสผู้ใช้ (ตามที่ UserFlags กำหนด)
- คำตอบ: ไม่มี ตัวอย่างเช่น โปรดดู VEHICLE_REQUEST

TIRE_PRESSURE

แรงดันลมยาง ยางรถยนต์แต่ละรายการจะระบุโดยการกำหนดค่า AreaConfig.areaId ระบบจะใช้ minFloatValue และ maxFloatValue ที่เกี่ยวข้องเพื่อจัดเก็บช่วงแรงดันที่ OEM แนะนำ ค่าสำหรับ minFloatValue และ maxFloatValue ต้องกำหนดใน DeviceAreaConfig

minFloatValue ในข้อมูล areaConfig แสดงถึงขอบเขตล่างของแรงดันลมยางที่แนะนำ maxFloatValue ในข้อมูล areaConfig แสดงถึงขีดจำกัดบนของแรงดันลมยางที่แนะนำ ตัวอย่างเช่น AreaConfig นี้จะแนะนำ แรงดันลมยาง left_front ตั้งแต่ 200.0kPa ถึง 240.0kPa

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

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:KILOPASCAL
รุ่น: Android 13

TIRE_PRESSURE_DISPLAY_UNITS

หน่วยวัดแรงดันลมยางสำหรับแสดงผล ระบุหน่วยที่รถใช้เพื่อแสดงแรงดันลมยางต่อผู้ใช้ เช่น PSI, Bar หรือกิโลปาสกาล VehiclePropConfig.configArray ใช้เพื่อระบุหน่วยการแสดงความดันที่รองรับ หน่วยแรงดันกำหนดเป็นยานพาหนะ เช่น configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR

หากการอัปเดต TIRE_PRESSURE_DISPLAY_UNITS ส่งผลต่อค่าของพร็อพเพอร์ตี้ *_DISPLAY_UNITS อื่นๆ ก็จะต้องอัปเดตค่าเหล่านั้นและแจ้งให้เฟรมเวิร์ก AAOS ทราบด้วย พร็อพเพอร์ตี้นี้ระบุเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM ทำได้ นำไปใช้เป็น <covehiclepropertyaccess.read< รหัส=""> เท่านั้น/p> </covehiclepropertyaccess.read<>

TRACTION_CONTROL_ใช้งานอยู่

ตั้งค่าเป็น "จริง" เมื่อ TC ทำงานอยู่ และรีเซ็ตเป็น "เท็จ" เมื่อ TC ปิดอยู่ ช่วงเวลานี้ คุณสมบัติอยู่อาจมีการตั้งค่าเป็นระยะๆ (ชีพจร) ตามสถานะแบบเรียลไทม์ของระบบ TC

TRAILER_PRESENT

แสดงสถานะพ่วงของรถ

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท enum: TrailerState
ประเภทหน่วย: ไม่มี
รุ่น: Android 13

สถานะ

สถานะของยานพาหนะเลี้ยว

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท Enum: VehicleTurnSignal
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

USER_IDENTIFICATION_ASSOCIATION

พร็อพเพอร์ตี้ที่ใช้เชื่อมโยง (หรือค้นหาการเชื่อมโยง) ผู้ใช้ปัจจุบันกับกลไกการระบุตัวตนเฉพาะยานพาหนะ (เช่น กุญแจรีโมต)

พร็อพเพอร์ตี้การจัดการผู้ใช้ที่ไม่บังคับ OEM จะยังคงรองรับการจัดการผู้ใช้ได้โดยไม่ต้องกำหนด อันที่จริงแล้ว คุณสามารถใช้พร็อพเพอร์ตี้นี้โดยไม่รองรับฟังก์ชันหลักที่เกี่ยวข้องกับผู้ใช้ตามที่อธิบายไว้ใน INITIAL_USER_INFO ได้

หากต้องการค้นหาการเชื่อมโยง ระบบ Android จะได้รับพร็อพเพอร์ตี้ โดยส่ง VehiclePropValue ที่มีประเภทการเชื่อมโยงที่กําลังค้นหาตามที่ระบุโดย UserIdentificationGetRequest HAL จะต้องแสดงผลทันที โดยแสดงผลพร้อมกับพารามิเตอร์ UserIdentificationResponse

โปรดทราบว่าการระบุตัวตนของผู้ใช้จะเกิดขึ้นขณะที่ระบบ การเปิดเครื่อง การใช้ VHAL ของ Takehe ควรส่งคืนการเชื่อมโยงที่ระบุอยู่แล้วเท่านั้น (เช่น กุญแจ FOB ที่ใช้ปลดล็อกรถ) แทนที่จะเริ่มการเชื่อมโยงใหม่จากการรับ การโทร

หากต้องการเชื่อมโยงประเภท ระบบ Android จะตั้งค่าพร็อพเพอร์ตี้โดยส่ง VehiclePropValue ที่มีประเภทและค่าของการเชื่อมโยงที่กำหนดไว้ตาม UserIdentificationSetRequest

จากนั้น HAL จะใช้เหตุการณ์การเปลี่ยนแปลงพร็อพเพอร์ตี้ (ซึ่ง VehiclePropValue กำหนดโดย UserIdentificationResponse) เพื่อระบุสถานะปัจจุบันของประเภทหลังจากคำขอ

เช่น ในการค้นหาว่าผู้ใช้ปัจจุบัน (10) เชื่อมโยงกับ FOB ที่ปลดล็อกรถหรือไม่ และกลไกที่กำหนดเองซึ่ง OEM ให้บริการคือ

int32[0] 42 // รหัสคำขอ
int32[1] 10 (รหัสผู้ใช้ Android)
int32[2] 0 (Flag ผู้ใช้ Android)
int32[3] 2 (จำนวนประเภทที่ค้นหา)
int32[4] 1 (ประเภทแรกที่ค้นหา UserIdentificationAssociationType::KEY_FOB)
int32[5] 101 (ค้นหาประเภทที่ 2, UserIdentificationAssociationType::CUSTOM_1)

ถ้าผู้ใช้เชื่อมโยงกับ FOB แต่ไม่ได้เชื่อมโยงกับกลไกที่กำหนดเอง การตอบกลับจะเป็นดังนี้

int32[0] 42 // รหัสคำขอ
int32[1] 2 (จำนวนการเชื่อมโยงในคำตอบ)
int32[2] 1 (ประเภทแรก: UserIdentificationAssociationType::KEY_FOB)
int32[3] 2 (ค่าแรก: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
int32[4] 101 (ประเภทแรก: UserIdentificationAssociationType::CUSTOM_1)
int32[5] 4 (ค่าที่สอง: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)

จากนั้นเพื่อเชื่อมโยงผู้ใช้กับกลไกที่กำหนดเอง จะมีการสร้างคำขอชุดดังนี้

int32[0] 43 // request id
int32[1] 10 (รหัสผู้ใช้ Android)
int32[2] 0 (การแจ้งว่าไม่เหมาะสมจากผู้ใช้ Android)
int32[3] 1 (จำนวนการเชื่อมโยงที่ตั้งค่าไว้)
int32[4] 101 (ประเภทแรก: UserIdentificationAssociationType::CUSTOM_1)

หากคำขอสำเร็จ การตอบกลับจะเป็นดังนี้

int32[0] 43 // request id
int32[1] 1 (จำนวนการเชื่อมโยงในคำตอบ)
int32[2] 101 (ประเภทแรก: UserIdentificationAssociationType::CUSTOM_1)
int32[3] 1 (ค่าแรก: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)

คำขอชุดจะเพิ่มการเชื่อมโยง แต่ไม่นำการเชื่อมโยงที่มีอยู่ออก ก่อนหน้านี้ ตัวอย่างเช่น สถานะสิ้นสุดจะเป็นการเชื่อมโยง 2 รายการ (FOB และ CUSTOM_1) หากต้องการเชื่อมโยงผู้ใช้กับ CUSTOM_1 เท่านั้น แต่ไม่ใช่ FOB คำขอจะเป็นดังนี้

int32[0] 43 // รหัสคำขอ
int32[1] 10 (รหัสผู้ใช้ Android)
int32[2] 2 (จํานวนประเภทที่ตั้งค่า)
int32[3] 1 (ประเภทแรก: UserIdentificationAssociationType::KEY_FOB)
int32[4] 2 (ค่าแรก: UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)
int32[5] 101 (ประเภทที่ 2: UserIdentificationAssociationType::CUSTOM_1)
int32[6] 1 (ค่าที่ 2 คือ UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)

VEHICLE_CURB_WEIGHT

แสดงน้ำหนักรถที่บรรทุกน้ำหนักบรรทุกได้สูงสุดเป็นกิโลกรัม น้ำหนักรถเปล่าคือน้ำหนักรวมของยานพาหนะ พร้อมอุปกรณ์มาตรฐานและอุปกรณ์สิ้นเปลืองที่จำเป็นทั้งหมด เช่น น้ำมันเครื่อง ระบบเกียร์ น้ำมัน น้ำมันเบรก น้ำหล่อเย็น สารทำความเย็นสำหรับเครื่องปรับอากาศ และน้ำหนักของเชื้อเพลิงที่ถังเก็บค่าน้อย ขณะที่ไม่ได้โหลดผู้โดยสารหรือสินค้าลำเลียง

configArray[0] ใช้เพื่อระบุน้ำหนักรวมของยานพาหนะเป็นกิโลกรัม น้ำหนักรวมของยานพาหนะคือน้ำหนักการปฏิบัติงานสูงสุดของยานพาหนะที่ผู้ผลิตระบุ ซึ่งรวมถึงแชสซี ตัวถัง เครื่องยนต์ ของเหลวในเครื่องยนต์ เชื้อเพลิง อุปกรณ์เสริม คนขับ ผู้โดยสาร และน้ำหนักของสัมภาระ แต่ยกเว้นน้ำหนักของรถพ่วง

เปลี่ยนโหมด: STATIC
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: VehicleUnit:KILOGRAM
รุ่น: Android 13

กำลังใช้ยานพาหนะ

ระบุว่ายานพาหนะมีการใช้งานอยู่หรือไม่ การใช้งานหมายถึงผู้ใช้ที่เป็นมนุษย์อยู่และมีเจตนาที่จะใช้ ยานพาหนะ ซึ่งไม่ได้หมายความว่าผู้ใช้ที่เป็นมนุษย์อยู่ในยานพาหนะเสมอไป เช่น หากผู้ใช้ที่เป็นบุคคลปลดล็อกรถจากระยะไกล ระบบจะถือว่ารถมีการใช้งาน หากระบบรองรับพร็อพเพอร์ตี้นี้ ให้ทำดังนี้

ทุกครั้งที่ผู้ใช้เปิดรถหรือระบบตรวจพบว่ามีผู้ใช้อยู่ VEHICLE_IN_USE ต้องตั้งค่าเป็น "จริง" ทุกครั้งที่ผู้ใช้ปิดรถหรือระบบตรวจพบว่าผู้ใช้ไม่อยู่ในรถ VEHICLE_IN_USE ต้องตั้งค่าเป็น "เท็จ"
หากผู้ใช้ปิดรถหรือระบบตรวจพบว่าไม่มีผู้ใช้อยู่ คุณต้องตั้งค่า VEHICLE_IN_USE เป็น "เท็จ"
หากผู้ใช้เปิดรถหรือระบบตรวจพบว่ามีผู้ใช้อยู่ ต้องตั้งค่า VEHICLE_IN_USE เป็น "จริง"

พร็อพเพอร์ตี้นี้แตกต่างจาก AP_POWER_BOOTUP_REASON ตรงที่ AP_POWER_BOOTUP_REASON จะตั้งค่าเพียงครั้งเดียวระหว่างการบูตระบบ อย่างไรก็ตาม พร็อพเพอร์ตี้นี้อาจเปลี่ยนแปลงหลายครั้งในระหว่างรอบการบูตระบบ เช่น อุปกรณ์ไม่ได้ใช้งานอยู่ การเริ่มต้นระบบเพื่อทำงานระยะไกล VEHICLE_IN_USE เป็นเท็จ ขณะที่งานระยะไกลกำลังดำเนินการ ผู้ใช้เข้าไปในรถและเปิดเครื่อง ตั้งค่า VEHICLE_IN_USE เป็น "true" หลังจากเซสชันการขับขี่ ผู้ใช้ปิดรถ ระบบจะตั้งค่า VEHICLE_IN_USE เป็นเท็จ

VEHICLE_MAP_SERVICE

ข้อความบริการแผนที่ในรถยนต์ (VMS) พร็อพเพอร์ตี้นี้ใช้ข้อมูล MIXED เพื่อสื่อสารข้อความ VMS โดยมีการตีความดังต่อไปนี้ ดัชนีที่กำหนดไว้ใน VmsMessageIntegerValuesInde จะใช้ในการอ่านจาก int32Values ไบต์คือข้อความ VMS ที่ทำให้เป็นอนุกรมตามที่กำหนดไว้ใน VMS ซึ่งไม่ชัดเจนจนเกินไป IVehicle#get ต้องแสดงผลเสมอ StatusCode::NOT_AVAILABLE

เปลี่ยนโหมด: ON_CHANGEREAD_WRITE
โหมดการเข้าถึง: READ_WRITE
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

VEHICLE_SPEED_DISPLAY_UNITS

หน่วยความเร็วสำหรับการแสดงผล ระบุประเภทของหน่วยที่ใช้เพื่อแสดงความเร็วต่อผู้ใช้ เช่น m/s, km/h หรือ mph DevicePropConfig.configArray ระบุความเร็วที่รองรับ หน่วยแสดงผล หน่วยแรงดันจะกำหนดไว้ใน VehicleUnit เช่น

.configArray: { VehicleUnit::METER_PER_SEC, VehicleUnit::KILOMETERS_PER_HOUR, VehicleUnit::MILES_PER_HOUR }

configArray[0] METER_PER_SEC
configArray[1] MILES_PER_HOUR
configArray[2] KILOMETERS_PER_HOUR

หากการอัปเดต VEHICLE_SPEED_DISPLAY_UNITS ส่งผลต่อค่าของ *_DISPLAY_UNITS properties อื่นๆ ก็จะต้องอัปเดตค่าเหล่านั้นและแจ้งให้เฟรมเวิร์ก AAOS ทราบ

VHAL_HEARTBEAT

กำหนดเหตุการณ์ที่ VHAL ส่งสัญญาณ เฝ้าระวังรถยนต์ เหมือนจังหวะการเต้นของหัวใจ หาก VHAL รองรับพร็อพเพอร์ตี้นี้ VHAL ควรเขียนเวลาทำงานของระบบลงในพร็อพเพอร์ตี้นี้ทุก 3 วินาที ผู้เฝ้าระวังรถยนต์ (Car Watchdog) สมัครใช้บริการพร็อพเพอร์ตี้นี้และตรวจสอบว่าพร็อพเพอร์ตี้นั้น โดยจะอัปเดตทุก 3 วินาที ด้วยระยะเวลาบัฟเฟอร์ 3 วินาที ผู้เฝ้าระวังรถยนต์จะรอ ฮาร์ตบีตจะได้รับสัญญาณสูงสุด 6 วินาทีจากฮาร์ตบีตล่าสุด หากไม่ Watchdog ของรถยนต์จะถือว่า VHAL ไม่เสถียรและจะสิ้นสุดการทำงาน หาก VHAL ไม่รองรับพร็อพเพอร์ตี้นี้ โปรแกรมตรวจสอบรถยนต์จะไม่ตรวจสอบสถานะความสมบูรณ์ของ VHAL

รับชมการถ่ายทอดสด

กำหนดเหตุการณ์ที่ Car Watchdog จะอัปเดตเพื่อระบุว่าแอปทำงานอยู่ Watchdog ของรถยนต์จะตั้งค่าพร็อพเพอร์ตี้นี้เป็นเวลาทำงานของระบบเป็นมิลลิวินาทีทุก 3 วินาที การอัปเดตอาจใช้เวลานานขึ้นขณะบูต

ประมวลผลคำขอ

กำหนดกระบวนการที่ Car Watchdog สิ้นสุดและเหตุผลของการสิ้นสุด

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

WHEEL_TICK

รายงานการคลิกล้อ องค์ประกอบแรกในเวกเตอร์คือจํานวนการรีเซ็ต การรีเซ็ตหมายถึง จำนวนเครื่องหมายถูกก่อนหน้านี้ไม่สามารถเปรียบเทียบกับเครื่องหมายถูกนี้และในอนาคตได้ มีความไม่ต่อเนื่องใน เกิดการนับเครื่องหมายถูก

องค์ประกอบ 4 รายการถัดไปแสดงเครื่องหมายสำหรับล้อแต่ละล้อตามลำดับต่อไปนี้

ซ้ายหน้า
ขวาหน้า
ด้านหลังขวา
ด้านซ้ายหลัง

จำนวนเครื่องหมายถูกทั้งหมดเป็นแบบสะสมไปเรื่อยๆ เครื่องหมายถูกจะนับเพิ่มเมื่อรถวิ่งไปข้างหน้า และ การลดลงเมื่อยานพาหนะเคลื่อนที่ถอยหลัง ควรรีเซ็ตจุดยึดเป็น 0 เมื่อรถอยู่ เลย

int64Values[0] รีเซ็ตจำนวน
int64Values[1] เสียงกริ่งด้านซ้ายหน้า
int64Values[2] ขีดขวาหน้า
int64Values[3] จุดแสดงตำแหน่งด้านขวาหลัง
int64Values[4] จุดแสดงตำแหน่งซ้ายด้านหลัง

configArray ใช้เพื่อระบุค่าไมโครเมตรต่อล้อจักรยาน และ Wheels จะได้รับการตั้งค่า configArray ที่รองรับดังนี้

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

ใช้วงล้อ enum ตัวอย่างเช่น หากรองรับล้อทุกประเภท ระบบจะดำเนินการดังนี้

configArray[0] พื้นที่ล้อ::LEFT_FRONT | พื้นที่ล้อยานพาหนะ::RIGHT_FRONT | ล้อรถ::LEFT_REAR | ล้อยานพาหนะ::RIGHT_REAR
configArray[1] ไมโครเมตรต่อเครื่องหมายถูกที่ล้อหน้าซ้าย
configArray[2] ไมโครเมตรต่อเครื่องหมายถูกที่ล้อหน้าขวา
configArray[3] ไมโครเมตรต่อเครื่องหมายบนล้อหลังขวา
configArray[4] ไมโครเมตรต่อเครื่องหมายถูกที่ล้อซ้ายหลัง

หากระบบไม่รองรับวงล้อ ค่าจะต้องตั้งเป็น 0 เสมอ

ต้องกรอกข้อมูล VehiclePropValue.timestamp

เปลี่ยนโหมด: CONTINUOUS
โหมดการเข้าถึง: READ
ประเภท Enum: ไม่เกี่ยวข้อง
ประเภทหน่วย: ไม่เกี่ยวข้อง
รุ่น: Android 13

WINDOW_LOCK

การล็อกหน้าต่างย่อย จริง ระบุว่าหน้าต่างล็อกอยู่ พร็อพเพอร์ตี้นี้ระบุเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ เท่านั้น

การขยับหน้าต่าง

ย้ายหน้าต่าง maxInt32Value และ minInt32Value ในแต่ละกลุ่ม ต้องกำหนด DeviceAreaConfig จำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง ต้องรองรับ maxInt32Value maxInt32Value ระบุว่าหน้าต่างเปิดในระนาบ/ปิดในทิศทางที่ออกนอกระนาบเร็วที่สุด อย่างรวดเร็ว minInt32Value บ่งชี้ว่าหน้าต่างกำลังจะปิดในระนาบ/เปิดใน ออกจากทิศทางเครื่องบินด้วยความเร็วที่เร็วที่สุด

ค่าสัมบูรณ์ที่มากกว่า ไม่ว่าจะเป็นค่าบวกหรือลบ จะบ่งบอกถึงความเร็วในการเคลื่อนไหวที่เร็วกว่า เมื่อ ถึงขีดจำกัดตำแหน่งแล้ว ค่าต้องรีเซ็ตเป็น 0 หากค่าของ WINDOW_MOVE เท่ากับ 0 และไม่มีการเคลื่อนไหวใดๆ พร็อพเพอร์ตี้นี้แสดงในช่วงความเร็วการเคลื่อนไหวสัมพัทธ์ที่ระบุ

สําหรับหน้าต่างที่อาจเปิดออกนอกระนาบ (โหมดช่องระบายอากาศของซันรูฟ) พารามิเตอร์นี้จะทํางานดังนี้ หาก:

ซันรูฟเปิด:
- Max เปิดซันรูฟเพิ่มเติม โดยระบบจะหยุดโดยอัตโนมัติเมื่อเปิดจนสุด
- Min ปิดซันรูฟ โดยระบบจะหยุดทำงานโดยอัตโนมัติเมื่อซันรูฟปิด
ช่องระบายอากาศเปิดอยู่:
- Max ปิดระบบระบายอากาศ หยุดหยุดโดยอัตโนมัติเมื่อปิดระบบระบายอากาศ
- Min เปิดช่องระบายอากาศให้มากขึ้น โดยจะหยุดโดยอัตโนมัติเมื่อช่องระบายอากาศเปิดจนสุด
ซันรูฟปิดอยู่ ให้ทำดังนี้
- Max เปิดซันรูฟ หยุดโดยอัตโนมัติเมื่อซันรูฟเปิดโดยสมบูรณ์
- Min เปิดช่องระบายอากาศ โดยจะหยุดโดยอัตโนมัติเมื่อช่องระบายอากาศเปิดจนสุด

WINDOW_POS

ตำแหน่งหน้าต่าง maxInt32Value และ minInt32Value ในแต่ละกลุ่ม ต้องกำหนด DeviceAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value minInt32Value บ่งบอกว่าหน้าต่างปิดอยู่หรือเปิดออกจนสุด ถ้าหน้าต่างเปิดออกจากระนาบไม่ได้ minInt32Value คือตำแหน่งของหน้าต่างเมื่อปิดหน้าต่างโดยสมบูรณ์และต้องเป็น 0 หากหน้าต่างเปิดออกนอกระนาบได้ minInt32Value จะระบุว่าหน้าต่างเปิดออกจนสุดในตำแหน่งนอกระนาบและเป็นค่าลบ ดูคำอธิบายโดยละเอียดได้ที่ตัวอย่างด้านล่าง สัญลักษณ์ maxInt32Value บ่งชี้ว่าหน้าต่างเปิดเต็มแล้ว

ค่าที่อยู่ระหว่าง minInt32Value ถึง maxInt32Value บ่งบอกถึงการเปลี่ยน สถานะระหว่างตำแหน่งที่ปิด/เปิดนอกระนาบโดยสมบูรณ์กับตำแหน่งเปิดทั้งหมด พร็อพเพอร์ตี้นี้ไม่ใช่ ในหน่วยใดหน่วยหนึ่ง แต่ในช่วงที่ระบุของตำแหน่งที่เกี่ยวข้อง ตัวอย่างเช่น พร็อพเพอร์ตี้นี้ควรทํางานอย่างไรสําหรับหน้าต่างที่เลื่อนออกนอกระนาบ สำหรับหน้าต่างที่อาจเปิดออกนอกระนาบ (โหมดระบายอากาศของซันรูฟ) พารามิเตอร์นี้จะทํางานกับค่าลบดังนี้

Max ซันรูฟเปิดทั้งหมด (0 สำหรับซันรูฟแบบปิด)
Min ช่องระบายอากาศซันรูฟเปิดทั้งหมด (0 สำหรับซันรูฟแบบปิด)

ในโหมดนี้ 0 หมายความว่าหน้าต่างปิดอยู่

WINDSHIELD_WIPERS_PERIOD

ระยะเวลาปัดน้ำฝน (มิลลิวินาที) แสดงระยะเวลาทันทีสำหรับช่วงเวลาหนึ่งเต็มจำนวน รอบของที่ปัดน้ำฝนในหน่วยมิลลิวินาที 1 รอบเต็มหมายถึงที่ปัดน้ำฝนเลื่อนจากด้านหนึ่งแล้วกลับไปยังตำแหน่งพัก เมื่อเลือกการตั้งค่าที่ปัดน้ำฝนเป็นระยะๆ คุณสมบัตินี้ ต้องตั้งค่าเป็น 0 ระหว่างระยะเวลาการหยุดชั่วคราวที่มีการล้างข้อมูลเป็นพักๆ ต้องกำหนด maxInt32Value และ minInt32Value ใน DeviceAreaConfig maxInt32Value สำหรับรหัสพื้นที่แต่ละรหัสต้องระบุระยะเวลาปัดน้ำฝนที่ยาวที่สุด ต้องตั้งค่า minInt32Value เป็น 0 สำหรับรหัสพื้นที่แต่ละรหัส

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท enum: ไม่มี
ประเภทหน่วย: VehicleUnit:MILLI_SECS
รุ่น: Android 14

WINDSHIELD_WIPERS_STATE

สถานะที่ปัดน้ำฝน แสดงสถานะปัจจุบันของที่ปัดน้ำฝน ค่าของ WINDSHIELD_WIPERS_STATE อาจไม่ตรงกับค่าของ WINDSHIELD_WIPERS_SWITCH เช่น WINDSHIELD_WIPERS_STATE: ON และ WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO หากมีการใช้ WINDSHIELD_WIPERS_STATE: ON และ WINDSHIELD_WIPERS_PERIOD WINDSHIELD_WIPERS_PERIOD จะต้องแสดงระยะเวลาของรอบที่ทำงาน 1 รอบของที่ปัดน้ำฝน

สําหรับรหัสพื้นที่ที่รองรับแต่ละรหัส คุณต้องกําหนดอาร์เรย์ VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับรัฐทั้งหมดใน WindshieldWipersState (รวมถึง OTHER ซึ่งไม่แนะนํา)

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ
ประเภท enum: WindshieldWipersState
ประเภทหน่วย: ไม่มี
รุ่น: Android 14

เปลี่ยนWINDSHIELD_WIPERS

สวิตช์ที่ปัดน้ำฝน แสดงตำแหน่งของสวิตช์ที่ควบคุมกระจกหน้า ที่ปัดน้ำฝน ค่าของ WINDSHIELD_WIPERS_SWITCH อาจไม่ตรงกับค่าของ WINDSHIELD_WIPERS_STATE เช่น WINDSHIELD_WIPERS_SWITCH: AUTO และ WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON สำหรับรหัสพื้นที่ที่รองรับแต่ละรหัส คุณต้องกำหนดอาร์เรย์ VehicleAreaConfig#supportedEnumValues เว้นแต่ว่าระบบจะรองรับรัฐทั้งหมดใน WindshieldWipersSwitch (รวมถึง OTHER ซึ่งไม่แนะนำ)

พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM นำไปใช้ได้เป็น VehiclePropertyAccess.READ เท่านั้น หากติดตั้งใช้งานพร็อพเพอร์ตี้นี้เป็น VehiclePropertyAccess.READ_WRITE และสถานะอื่นๆ จะแสดงอยู่ในฟิลด์ VehicleAreaConfig#supportedEnumValues อาร์เรย์ OTHER จะไม่ใช่ค่าที่รองรับ การเขียนเท่านั้น ซึ่งเป็นค่าที่รองรับสำหรับการอ่านเท่านั้น

เปลี่ยนโหมด: ON_CHANGE
โหมดการเข้าถึง: READ_WRITE/READ
ประเภท enum: WindshieldWipersSwitch
ประเภทหน่วย: ไม่มี
รุ่น: Android 14