ตั้งแต่วันที่ 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 แสดงว่าไม่มีการเคลื่อนไหวเกิดขึ้น

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

SEAT_BACKREST_ANGLE_1_POS

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

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

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

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 ใน VehicleAreaConfig แต่ละรายการ ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value

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

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

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

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

SEAT_DEPTH_MOVE

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

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

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

SEAT_DEPTH_POS

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

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

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

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

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

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

พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น <covehiclepropertyaccess.read< code=""> เท่านั้น..</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

สําหรับรหัสพื้นที่ที่รองรับแต่ละรหัส คุณต้องกําหนด VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับค่า Enum ทั้งหมดของ VehicleLightState

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

SEAT_FOOTWELL_LIGHTS_SWITCH

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

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

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

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

SEAT_FORE_AFT_MOVE

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

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

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

SEAT_FORE_AFT_POS

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

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

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

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

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

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 บ่งบอกว่าเบาะอยู่ในตำแหน่งที่สูงที่สุด

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

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 ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง 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 แสดงว่าไม่มีการเคลื่อนไหวเกิดขึ้น

SEAT_LUMBAR_SIDE_SUPPORT_POS

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

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

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

SEAT_LUMBAR_VERTICAL_MOVE

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

ต้องกําหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig แต่ละรายการ ระบบต้องรองรับจำนวนเต็มทั้งหมดระหว่าง 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 ใน VehicleAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value minInt32Value จะเท่ากับ 0 เสมอ และ maxInt32Value จะกำหนดจำนวนช่องหน่วยความจำที่กำหนดค่าล่วงหน้าสำหรับที่นั่งที่มีอยู่ (เช่น numSeatPresets - 1) ตัวอย่างเช่น หากเบาะคนขับมีหน่วยความจำที่ตั้งล่วงหน้า 3 รายการ maxInt32Value จะเป็น 2 เมื่อผู้ใช้เลือกค่าที่กำหนดล่วงหน้า ระบบจะตั้งค่าหมายเลขที่กำหนดล่วงหน้าที่ต้องการ (0, 1 หรือ 2)

SEAT_MEMORY_SET

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

SEAT_OCCUPANCY

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

เปลี่ยนโหมด: 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 บ่งบอกสถานะการเปลี่ยนผ่านระหว่างตำแหน่งปกติกับตำแหน่งที่ลูกค้าเดินเข้า

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

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

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

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

SHUTDOWN_REQUEST

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

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

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

ซึ่งโดยปกติจะเกี่ยวข้องกับการบอกระบบแยกต่างหากนอกส่วนหัว (เช่น ตัวควบคุมพลังงาน) ให้เตรียมปิดส่วนหัว

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

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

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

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

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

สำหรับข้อมูลการกําหนดค่า VehiclePropConfig.configArray ต้องมี Flag แบบบิตซึ่งรวมค่าใน {@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 ใน VehicleAreaConfig ต้องรองรับค่าทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value maxInt32Value หมายถึงตำแหน่งพวงมาลัยที่อยู่ห่างจากคนขับมากที่สุด minInt32Value แสดงตำแหน่งพวงมาลัยที่อยู่ใกล้คนขับมากที่สุด

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

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

STEERING_WHEEL_EASY_ACCESS_ENABLED

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

STEERING_WHEEL_HEIGHT_MOVE

การเคลื่อนไหวความสูงของพวงมาลัย ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig ต้องรองรับค่าทั้งหมดระหว่าง 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) คุณต้องกำหนด VehicleAreaConfig#supportedEnumValues เว้นแต่ระบบจะรองรับค่า Enum ทั้งหมดของ VehicleLightState

เปลี่ยนโหมด: 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

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

STORAGE_ENCRYPTION_BINDING_SEED

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

SUPPORT_CUSTOMIZE_VENDOR_PERMISSION

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

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

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

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

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

SUPPORTED_PROPERTY_IDS

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

SWITCH_USER

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

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

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 หรือ Kilopascal VehiclePropConfig.configArray ใช้เพื่อบ่งบอกหน่วยการแสดงความดันที่รองรับ หน่วยแรงดันจะกำหนดไว้ใน VehicleUnit เช่น configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR

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

TRACTION_CONTROL_ACTIVE

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

TRAILER_PRESENT

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

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

TURN_SIGNAL_STATE

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

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

USER_IDENTIFICATION_ASSOCIATION

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

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

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

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

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

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

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

int32[0] 42 // request id
int32[1] 10 (Android user id)
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 // request id
int32[1] 2 (จํานวนการเชื่อมโยงในการตอบกลับ)
int32[2] 1 (ประเภทแรก: UserIdentificationAssociationType::KEY_FOB)
int32[3] 2 (ค่าแรก: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
int32[4] 101 (ประเภทแรก: UserIdentificationAssociationType::CUSTOM_1)
int32[5] 4 (ค่าที่ 2: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)

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

int32[0] 43 // request id
int32[1] 10 (Android user id)
int32[2] 0 (Flag ผู้ใช้ 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 // request id
int32[1] 10 (Android user id)
int32[2] 2 (จํานวนประเภทที่ตั้งค่า)
int32[3] 1 (ประเภทแรก: UserIdentificationAssociationType::KEY_FOB)
int32[4] 2 (ค่าแรก: UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)
int32[5] 101 (ประเภทที่ 2: UserIdentificationAssociationType::CUSTOM_1)
int32[6] 1 (ค่าที่ 2: UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)

VEHICLE_CURB_WEIGHT

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

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

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

VEHICLE_IN_USE

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

ทุกครั้งที่ผู้ใช้เปิดรถหรือระบบตรวจพบว่ามีผู้ใช้อยู่ 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) พร็อพเพอร์ตี้นี้ใช้ข้อมูลแบบผสมเพื่อสื่อสารข้อความ 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 VehiclePropConfig.configArray ระบุหน่วยแสดงผลความเร็วที่รองรับ หน่วยแรงดันจะกำหนดไว้ใน VehicleUnit เช่น

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

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

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

VHAL_HEARTBEAT

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

WATCHDOG_ALIVE

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

WATCHDOG_TERMINATED_PROCESS

กำหนดกระบวนการที่ 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 ใช้เพื่อระบุค่าไมโครเมตรต่อเครื่องหมายบนล้อและล้อที่รองรับ กำหนด configArray ดังนี้

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

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

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

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

คุณต้องกรอกข้อมูลใน VehiclePropValue.timestamp

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

WINDOW_LOCK

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

WINDOW_MOVE

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

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

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

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

WINDOW_POS

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

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

Max ซันรูฟเปิดสุด (0 สำหรับซันรูฟปิด)
Min ช่องลมของซันรูฟเปิดสุด (0 สำหรับซันรูฟปิด)

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

WINDSHIELD_WIPERS_PERIOD

ระยะเวลาของที่ปัดน้ำฝน (มิลลิวินาที) แสดงผลระยะเวลาทันทีของรอบที่สมบูรณ์ 1 รอบของที่ปัดน้ำฝนเป็นมิลลิวินาที 1 รอบเต็มหมายถึงที่ปัดน้ำฝนเลื่อนจากด้านหนึ่งแล้วกลับไปยังตำแหน่งพัก เมื่อเลือกการตั้งค่าที่ปัดน้ำฝนเป็นช่วงๆ ค่าของพร็อพเพอร์ตี้นี้ต้องตั้งเป็น 0 ในช่วงหยุดพักของการปัดน้ำฝนเป็นช่วงๆ ต้องกำหนด maxInt32Value และ minInt32Value ใน VehicleAreaConfig 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_SWITCH

สวิตช์ที่ปัดน้ำฝน แสดงตำแหน่งของสวิตช์ที่ควบคุมที่ปัดน้ำฝน ค่าของ 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 และสถานะ OTHER แสดงอยู่ในอาร์เรย์ VehicleAreaConfig#supportedEnumValues ระบบจะไม่รองรับค่า OTHER สำหรับการเขียน แต่จะรองรับเฉพาะค่าสำหรับการอ่าน

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