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

พร็อพเพอร์ตี้ของระบบที่รองรับ

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

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

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

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

A ถึง D

ADAPTIVE_CRUISE_Control_LEAD_VEHICLE_MEASURED_DISTANCE

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

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

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

เปิดใช้งาน ABS

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

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

ANDROID_EPOCH_TIME

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

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

AAOS WRITE ไปยังพร็อพเพอร์ตี้นี้ครั้งเดียวระหว่างการเปิดเครื่อง และหลังจากนั้น WRITE เฉพาะเมื่อมีการเปลี่ยนแปลงแหล่งเวลาเท่านั้น AAOS จะเติมเต็มคายานพาหนะPropValue.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

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

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

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

AP_POWER_STATE_REQ

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

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

เปิดใช้งานEMERGENCY_BRAKING_อัตโนมัติ

เปิดหรือปิดใช้การเบรกฉุกเฉินอัตโนมัติ (AEB) ตั้งค่า true เพื่อเปิดใช้ AEB และตั้งค่า false เพื่อปิดใช้ 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

สถานะการปรับใช้แบตเตอรี่อัตโนมัติ

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

หาก AEB มีคำเตือนการชนไปข้างหน้าก่อนเปิดใช้งานเบรก คำเตือนเหล่านั้นจะต้อง แสดงผ่านคุณสมบัติ Forward Collision Alerts (FCW)

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

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

BLIND_SPOT_WARNING_เปิดใช้อยู่

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

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

สถานะคำเตือน BLIND_SPOT_TH

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

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

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

สถานะ CABIN_LIGHTS

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

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

สวิตช์ไฟ CABIN

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

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

สถานะคลัสเตอร์

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

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

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

int32[0] เปิด, ปิด: 0 - ปิด, 1 - เปิด, -1 - ไม่ใส่ใจ
int32[1] ขอบเขต - ซ้าย: ตัวเลขบวก - ตำแหน่งด้านซ้ายเป็นพิกเซล -1 - ไม่สนใจ (ควรตั้งค่าช่องขอบเขตทั้งหมด)
int32[2] ขอบเขต - บน: รูปแบบเดียวกันโดยมี "ซ้าย"
int32[3] ขอบเขต - ขวา: รูปแบบเดียวกับ "ซ้าย"
int32[4] ขอบเขต - ด้านล่าง: รูปแบบเดียวกันโดยมี "ซ้าย"
int32[5] ส่วนแทรก - ซ้าย: จำนวนบวก - ค่าจริงที่เหลือของหน่วยเป็นพิกเซล -1 - ไม่ใส่ใจ (ควรตั้งค่าช่อง "ไม่สนใจ" ทั้งหมด)
ส่วนแทรก int32[6] - บน: รูปแบบเดียวกันโดยมี "ซ้าย"
int32[7] ส่วนแทรก - ขวา: รูปแบบเดียวกันโดยมี "ซ้าย"
ส่วนต่อท้าย int32[8] - ด้านล่าง: รูปแบบเดียวกันโดยมี "ซ้าย"

สถานะการนำทางคลัสเตอร์

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

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

สถานะรายงานคลัสเตอร์

รายงานสถานะการแสดงผลปัจจุบันและสถานะ 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 และรองรับเฉพาะ CALL UI เฉพาะเมื่อเครือข่ายมือถือใช้งานได้ จากนั้น ถ้าเนื้อหมูมีจำหน่าย ส่ง [1 1 1] และถ้าอยู่นอกเครือข่าย ก็ส่ง [1 1 0]

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

คลัสเตอร์_REQUEST_DISPLAY

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

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

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

UI ของคลัสเตอร์

เริ่มต้น ClusterUI ในการแสดงผลคลัสเตอร์

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

สร้างผู้ใช้

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

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

int32[0] 42 // รหัสคำขอ
int32[1] 11 // รหัส Android ของผู้ใช้ที่สร้าง
int32[2] 6 // แฟล็ก Android (ผู้มาเยือนชั่วคราว) ของผู้ใช้ที่สร้างขึ้น
int32[3] 10 // ผู้ใช้ปัจจุบัน
int32[4] 0 // การแจ้งผู้ใช้ปัจจุบัน (ไม่มี)
int32[5] 3 // จำนวนผู้ใช้
int32[6] 0 // ผู้ใช้ครั้งแรก (ผู้ใช้ 0)
int32[7] 0 // การรายงานปัญหาของผู้ใช้ครั้งแรก (ไม่มี)
int32[8] 10 // ผู้ใช้คนที่ 2 (ผู้ใช้ 10)
int32[9] 0 // การแจ้งผู้ใช้ครั้งที่ 2 (ไม่มี)
int32[10] 11 // ผู้ใช้บุคคลที่สาม (ผู้ใช้ 11)
int32[11] 6 // สตริงของผู้ใช้คนที่ 3 (ผู้ใช้ชั่วคราว): "ElGuesto" // ของผู้ใช้ใหม่

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

int32[0] 42 // รหัสคำขอ
int32[1] 1 // CreateUserStatus::SUCCESS

แต่หากล้มเหลว ให้ทำดังนี้

int32[0] 42 // รหัสคำขอ
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 เมื่อพร็อพเพอร์ตี้นี้ไม่พร้อมใช้งาน เนื่องจากคำบรรยายปิดใช้อยู่ (เช่น 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) ตั้งค่าเป็น true เพื่อเปิดใช้ CC และ false เพื่อปิดใช้ CC ช่วงเวลานี้ พร็อพเพอร์ตี้ CruiseControlType ทุกรูปแบบร่วมกัน เมื่อเปิดใช้ CC ระบบ ADAS ใน ควรติดรถและตอบสนองต่อคำสั่ง โดยทั่วไปแล้ว CRUISE_CONTROL_ENABLED ควรคืนค่า true หรือ false เสมอ หากฟีเจอร์ไม่พร้อมใช้งานเนื่องจากสถานะชั่วคราว เช่น ความเร็วของยานพาหนะต่ำเกินไป ข้อมูลดังกล่าวจะต้องแสดงผ่าน ErrorState ในพร็อพเพอร์ตี้ CRUISE_CONTROL_STATE พร็อพเพอร์ตี้นี้ระบุเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น VehiclePropertyAccess.READ เท่านั้น

สถานะการควบคุม

สถานะปัจจุบันของการควบคุมความเร็ว (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

ประเภทปัจจุบันของ Cruise Control (CC) เมื่อ CRUISE_CONTROL_ENABLED เป็นจริง พร็อพเพอร์ตี้นี้แสดง ประเภทของ 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

อุปกรณ์ปัจจุบัน

เฟืองปัจจุบัน ในกรณีที่ไม่ใช่ด้วยตนเอง เฟืองที่เลือกอาจไม่ตรงกับเฟืองปัจจุบัน สำหรับ ตัวอย่างเช่น ถ้าเฟืองที่เลือกคือ 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

นโยบายปัจจุบัน

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

string: "sample_policy_id" // power policy ID

ปิดใช้ฟีเจอร์เสริม

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

ความสว่างของการแสดงผล

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

DISTANCE_DISPLAY_UNITS

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

เปิด

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

ล็อกประตู

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

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

การย้ายประตู

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

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

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

หน้าร้าน

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

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

E ถึง G

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) ตั้งค่า true เพื่อเปิดใช้ ELKA และ false เพื่อปิดใช้ 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 เท่านั้น

ระดับน้ำมัน

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

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

ENGINE_OIL_TEMP

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

ENGINE_RPM

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

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

ENV_OUTSIDE_TEMPERATURE

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

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

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_เชื่อมต่อแล้ว

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

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

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

เริ่มหรือหยุดชาร์จแบตเตอรี่ 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

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

FOG_LIGHTS_SWITCH

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

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

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

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

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

FRONT_FOG_LIGHTS_STATE

สถานะไฟตัดหมอกหน้า แสดงสถานะปัจจุบันของไฟตัดหมอกหน้า ต้องใช้ FOG_LIGHTS_STATE หรือ FRONT_FOG_LIGHTS_STATE เพียง 1 รายการเท่านั้น ดูข้อมูลเพิ่มเติมในเอกสารประกอบเกี่ยวกับ 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 "เท็จ" หมายความว่าหน่วยเป็นปริมาตรระยะไกล เช่น L/100KM พร็อพเพอร์ตี้นี้ระบุเป็น 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 เท่านั้น

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

GEAR_SELECTION

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

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

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

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

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

GLOVE_BOX_LOCKED

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

H ถึง I

HANDS_ON_DETECTION_ไดรฟ์_สถานะ

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

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

HANDS_ON_DETECTION_ENABLED

เปิดหรือปิดใช้ Hands On Detection (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

สถานะแสงอันตราย แสดงสถานะปัจจุบันของไฟเลี้ยวฉุกเฉิน

สวิตช์ไฟ HAZARD_LIGHTS

สวิตช์ไฟเลี้ยวฉุกเฉิน การตั้งค่าที่ผู้ใช้ต้องการ พร็อพเพอร์ตี้นี้ระบุเป็น 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)

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

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

HVAC_ACTUAL_FAN_SPEED_RPM

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

เปิดระบบปรับอากาศอัตโนมัติ

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

ความเร็ว FAN สำหรับระบบปรับอากาศ (HVAC)

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

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

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

เปิดระบบ HVAC_MAX_AC_ON

เปิดหรือปิด AC สูงสุด เมื่อ MAX AC เปิดอยู่ ECU สามารถปรับสิ่งต่างๆ เช่น ตำแหน่งช่องระบายอากาศ ความเร็วพัดลม และอุณหภูมิตามความจำเป็นเพื่อทำความเย็นให้รถโดยเร็วที่สุด พารามิเตอร์ที่แก้ไขเป็นผลข้างเคียงจากการเปิดหรือปิดพารามิเตอร์ MAX AC จะสร้างการเรียกกลับไปยัง VHAL onPropertyEvent() รายการ พร็อพเพอร์ตี้นี้ได้รับการระบุเป็น 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 ใน HvacPower_DependentProperties ของ VehiclePropConfig.configArray ต้องมีเฉพาะพร็อพเพอร์ตี้ที่เชื่อมโยงกับ 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)

การเปิดและปิดระบบหมุนเวียน ควบคุมการจ่ายอากาศภายนอกไปยังห้องโดยสาร การหมุนเวียนอากาศ เปิดหมายความว่าอากาศส่วนใหญ่ที่เข้าสู่ห้องโดยสารมาจากห้องโดยสาร การหมุนเวียนอากาศ ปิด หมายความว่าอากาศส่วนใหญ่ที่เข้าสู่ห้องโดยสารมาจากภายนอกรถ พร็อพเพอร์ตี้นี้กำหนดเป็น 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] [ขอบเขตล่างของอุณหภูมิที่รองรับเป็นองศาเซลเซียส] * 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 สำหรับ HVAC ตรรกะอาจเป็นดังนี้ วิธีแปลงอุณหภูมิจากเซลเซียสเป็นฟาเรนไฮต์

// 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;

เช่น เมื่อคนขับใช้ Voice Assistant เพื่อตั้งค่า 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 ต้องสร้าง Callback ที่มีค่าพร็อพเพอร์ตี้ [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0] ในกรณีนี้ แอปจะรู้ได้ว่าค่านี้เป็น 70.0 องศาฟาเรนไฮต์ใน UI ของรถยนต์

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

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] (ไม่บังคับ) จำนวนเครื่องหมาย ค่าต้องเท่ากับ o มากกว่า 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 เสมอ
int64array[0] ช่วงพักการใช้งานในหน่วยนาโนวินาทีนับตั้งแต่การเปิดเครื่องครั้งล่าสุด หมายถึงเวลาของเหตุการณ์คีย์ดาวน์ล่าสุด สำหรับเหตุการณ์ดาวน์ นี่คือเวลาของเหตุการณ์ที่เลื่อนลง

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

HW_MOTION_INPUT

พร็อพเพอร์ตี้เพื่อป้อนเหตุการณ์อินพุตฮาร์ดแวร์ไปยัง Android

int32array[0] จอแสดงผลเป้าหมายที่กําหนดโดย VehicleDisplay เช่น
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
int32array[1] ประเภทอินพุตที่กำหนดไว้ในยานพาหนะHwMotionInputSource เช่น
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] ช่วงพัก ผ่านนาโนวินาทีตั้งแต่เปิดเครื่อง ระบุเวลาที่ผู้ใช้กดลงครั้งแรกเพื่อเริ่มสตรีมเหตุการณ์ตำแหน่ง สำหรับเหตุการณ์ที่ดาวน์ จะเป็นเวลาที่เกิดเหตุการณ์ของเหตุการณ์ดาวน์

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

HW_ROTARY_INPUT

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

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

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

สถานะตัวตน

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

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

INFO_DRIVER_SEAT

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

เปลี่ยนโหมด: สถิติ
โหมดการเข้าถึง: 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 โดยใช้ enum PortLocationType หากยานพาหนะมีพอร์ตหลายพอร์ต พร็อพเพอร์ตี้นี้ต้องแสดงผลพอร์ตที่ชาร์จได้เร็วที่สุด หากต้องการสื่อสารตำแหน่งพอร์ตทั้งหมด ให้ใช้ INFO_MULTI_EV_PORT_LOCATIONS

ตำแหน่งพอร์ต EV: สถิติ
โหมดการเข้าถึง: READ
ประเภท 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

ประเภทข้อมูล Funnel

รายการเชื้อเพลิงที่ยานพาหนะอาจใช้ FuelType::FUEL_TYPE_ELECTRIC ต้องระบุก็ต่อเมื่อยานพาหนะชาร์จได้แบบเสียบปลั๊กเท่านั้น เช่น ยานพาหนะไฟฟ้าแบบไฮบริดเต็มรูปแบบ (FHEV) ต้องไม่มี FuelType::FUEL_TYPE_ELECTRIC เนื่องจากค่า INT32_VEC สำหรับ 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 }

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

ข้อมูล_สร้าง

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

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

INFO_MODEL

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

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

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 รายการ หากต้องการอธิบายตำแหน่งของพอร์ตเดียว โปรดดู INFO-EV-PORT-LOCATION

ข้อมูล_VIN

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

ข้อมูลผู้ใช้เริ่มต้น

กำหนดผู้ใช้ 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

J ถึง R

LANE_CENTERING_ASSIST_COMMAND

คำสั่ง Lane Centering Assist (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) ตั้งค่าเป็น true เพื่อเปิดใช้ LCA และตั้งค่า false เพื่อปิด LCA เมื่อเปิดใช้ LCA ระบบ ADAS ในยานพาหนะควรเปิดอยู่และกำลังรอ สัญญาณเปิดใช้งานจากคนขับ เมื่อเปิดใช้งานฟีเจอร์แล้ว ระบบ ADAS ควร บังคับพวงมาลัยรถเพื่อให้อยู่กึ่งกลางในเลนปัจจุบัน

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

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

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

LANE_CENTERING_ASSIST_STATE

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

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

สำหรับรหัสพื้นที่ส่วนกลาง (0) อาร์เรย์ VehicleAreaConfig#supportedEnumValues ต้องเป็น กำหนดไว้เว้นแต่ทุกสถานะของ LaneCenteringAssistState ทั้ง 2 แบบ (รวมถึง "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 ทั้ง 2 แบบ (รวมถึง "OTHER" ไม่แนะนำ) และรองรับ ErrorState

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

LANE_KEEP_ASSIST_Enabled

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

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

ค่าต้องแสดงคอลเลกชันของบิต การตั้งค่าสถานะบิตถูกกำหนดไว้ใน การกำหนดลักษณะตำแหน่ง ค่าต้องมี DEAD_RECKONED อย่างใดอย่างหนึ่งหรือ RAW_GNSS_ONLY ในกลุ่มการตั้งค่าสถานะบิต

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

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

MIRROR_AUTO_FOLD_ENABLED

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

MIRROR_AUTO_TILT_ENABLED

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

MIRROR_FOLD

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

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

MIRROR_LOCK

ล็อกกระจก "จริง" หมายความว่าตำแหน่งมิเรอร์ล็อกอยู่และเปลี่ยนแปลงไม่ได้ พร็อพเพอร์ตี้นี้ระบุเป็น 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 บ่งบอกถึง สถานะการเปลี่ยนระหว่างตำแหน่งด้านล่างสุดและขึ้นด้านบนจนสุด

โหมดกลางคืน

จริงแสดงว่าเซ็นเซอร์โหมดกลางคืนตรวจพบสภาพแวดล้อมในห้องโดยสารของรถยนต์ ให้มีแสงน้อยได้ ตัวอย่างเช่น แพลตฟอร์มสามารถใช้ 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)

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

หากไม่มีการตรึงเฟรมในการประทับเวลาที่ระบุ จะต้องตอบกลับ 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 องค์ประกอบ)

เป็นไปได้ที่แต่ละเฟรมจะมีชุดย่อยของค่าเซ็นเซอร์แตกต่างกัน โดยทั้ง 2 ระบบ เซ็นเซอร์ที่มีให้ และเซ็นเซอร์เฉพาะผู้ขาย เพื่อรองรับความต้องการนี้ องค์ประกอบไบต์ของ ค่าพร็อพเพอร์ตี้จะใช้เป็นบิตมาสก์ ไบต์ต้องมีจำนวนไบต์เพียงพอในการแสดง จำนวนเซ็นเซอร์ทั้งหมดที่เป็นไปได้ (ในกรณีนี้คือ 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] ไม่ใช่ค่าเซ็นเซอร์ที่ถูกต้อง

เปิด

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

สวน BRAKE_AUTO_APPLY

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

ที่จอดรถ

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

PER_DISPLAY_BRIGHTNESS

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

เหลือเพียง PER_DISPLAY_BRIGHTNESS และ PER_DISPLAY_BRIGHTNESS ควรนำไปใช้ หากทั้ง 2 แบบ ว่างอยู่ PER_DISPLAY_BRIGHTNESS ใช้งานโดย AAOS

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

int32Values[0] พอร์ตจอแสดงผล
ความสว่าง 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

เสียงเพอร์เฟ็กต์

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

ความเร็วการแสดงยานพาหนะ

ความเร็วของยานพาหนะ ค่าต้องเป็นบวกเมื่อรถวิ่งไปข้างหน้าและ ค่าลบเมื่อรถถอยหลัง ค่านี้ไม่เกี่ยวข้องกับค่าเกียร์ (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 ตั้งค่าพร็อพเพอร์ตี้นี้เพื่อเปลี่ยนนโยบายไฟฟ้ารถยนต์ บริการนโยบายพลังงานของรถยนต์สมัครใช้บริการพร็อพเพอร์ตี้นี้และเปลี่ยนนโยบายการใช้พลังงานจริง คำขอเกิดขึ้นโดยการตั้งค่าคาพาหนะPropValue ด้วยรหัสของนโยบายพลังงานซึ่งกำหนดไว้ที่ /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

สถานะการอ่านแสง

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

สวิตช์ไฟอ่านหนังสือ

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

สถานะ REAR_FOG_LIGHTS

กลับไปยังสถานะปัจจุบันของไฟตัดหมอกด้านหลัง เพียงรายการเดียวจาก 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เท่านั้น

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

นำผู้ใช้ออก

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

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

int32[0] 42 // รหัสคำขอ
int32[1] 11 // (รหัสผู้ใช้ Android ของผู้ใช้ที่ถูกนำออก)
int32[2] 0 // (การตั้งค่าสถานะของผู้ใช้ Android ของผู้ใช้ที่ถูกนำออก)
int32[3] 10 // ผู้ใช้ปัจจุบัน
int32[4] 0 // การแจ้งผู้ใช้ปัจจุบัน (ไม่มี)
int32[5] 2 // จำนวนผู้ใช้
int32[6] 0 // ผู้ใช้ครั้งแรก (ผู้ใช้ 0)
int32[7] 0 // การรายงานปัญหาของผู้ใช้ครั้งแรก (ไม่มี)
int32[8] 10 // ผู้ใช้คนที่ 2 (ผู้ใช้ 10)
int32[9] 0 // การแจ้งผู้ใช้ครั้งที่ 2 (ไม่มี)

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

S ถึง Z

SEAT_AIRBAG_ENABLED

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

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

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

SEAT_BACKREST_ANGLE_1_MOVE

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

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

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

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

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 เท่านั้น

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

SEAT_BELT_HEIGHT_MOVE

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

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

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

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

SEAT_BELT_HEIGHT_POS

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

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

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

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

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

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

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

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

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

SEAT_DEPTH_POS

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

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

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

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

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

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

พร็อพเพอร์ตี้นี้กำหนดเป็น VehiclePropertyAccess.READ_WRITE แต่ OEM สามารถใช้เป็น <covehiclepropertyaccess.read< 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: ยานพาหนะแสงสถานะ
ประเภทหน่วย: ไม่มี
รุ่น: Android 14

SEAT_FOOTWELL_LIGHTS_SWITCH

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

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

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

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

SEAT_FORE_AFT_MOVE

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

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

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

SEAT_FORE_AFT_POS

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

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

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

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

SEAT_HEADREST_ANGLE_MOVE

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

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

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

SEAT_HEADREST_ANGLE_POS

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

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

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

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

SEAT_HEADREST_FORE_AFT_MOVE

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

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

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

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

SEAT_HEADREST_FORE_AFT_POS

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

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

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

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

SEAT_HEADREST_HEIGHT_MOVE

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

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

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

SEAT_HEADREST_HEIGHT_POS

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

SEAT_HEADREST_HEIGHT_POS_V2

ตำแหน่งความสูงของพนักพิงศีรษะ ตั้งค่าความสูงของพนักพิงศีรษะสำหรับที่นั่งที่รองรับ 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 ใน DeviceAreaConfig ต้องรองรับจำนวนเต็มทั้งหมดตั้งแต่ minInt32Value ถึง maxInt32Value

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

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

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

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

SEAT_LUMBAR_SIDE_SUPPORT_MOVE

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

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

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

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

SEAT_LUMBAR_SIDE_SUPPORT_POS

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

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

เปลี่ยนโหมด: 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 ใน DeviceAreaConfig แต่ละรายการ ระบบต้องรองรับจำนวนเต็มทั้งหมดระหว่าง minInt32Value ถึง maxInt32Value maxInt32Value หมายถึงตำแหน่งที่สูงที่สุดของส่วนรองรับหลังส่วนล่าง minInt32Value หมายถึงตำแหน่งต่ำสุดของการรองรับเอว

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

SEAT_MEMORY_SELECT

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

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

SEAT_MEMORY_SET

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

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

SEAT_OCCUPANCY

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

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

SEAT_TILT_MOVE

การเคลื่อนไหวของการปรับเอียงเบาะ ต้องกำหนด maxInt32Value และ minInt32Value ใน DeviceAreaConfig แต่ละรายการ ต้องรองรับจำนวนเต็มทั้งหมดระหว่าง 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 บ่งบอกสถานะการเปลี่ยนผ่านระหว่างตำแหน่งปกติกับตำแหน่งที่ลูกค้าเดินเข้า

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

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

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

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

SHUTDOWN_REQUEST

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

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

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

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

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

หากอนุญาต ระบบภายนอกจะส่งสัญญาณปิดเครื่องไปยังระบบเครื่องเสียง ซึ่งทำให้ 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 ใน DeviceAreaConfig ต้องรองรับค่าทั้งหมดที่อยู่ระหว่าง minInt32Value ถึง maxInt32Value สัญลักษณ์ maxInt32Value บ่งบอกว่าพวงมาลัยอยู่ในตำแหน่งสูงสุด minInt32Value บ่งบอกว่าพวงมาลัยอยู่ในตำแหน่งต่ำสุด

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

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

สถานะ STEERING_WHEEL_LIGHTS_

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

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

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

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

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

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

SUPPORTED_PROPERTY_IDS

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

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

SWITCH_USER

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

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

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

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

TIRE_PRESSURE

แรงดันลมยาง ยางแต่ละเส้นจะระบุด้วยการกำหนดค่า areaConfig.areaId ระบบจะใช้ minFloatValue และ maxFloatValue ที่เกี่ยวข้องเพื่อจัดเก็บช่วงแรงดันที่ OEM แนะนำ ต้องกําหนดค่าสําหรับ minFloatValue และ maxFloatValue ใน 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 ใช้เพื่อระบุหน่วยการแสดงความดันที่รองรับ หน่วยแรงดันกำหนดเป็นยานพาหนะ เช่น configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR

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

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

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

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

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

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

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

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

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

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

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

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

int32[0] 42 // 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 (ค่าที่สอง: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)

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

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

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

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

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

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

น้ำหนักรถเปล่า

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

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 DevicePropConfig.configArray ระบุหน่วยแสดงผลความเร็วที่รองรับ หน่วยแรงดันจะกำหนดไว้ใน VehicleUnit เช่น

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

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

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

VHAL_HEARTBEAT

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

WATCHDOG_ALIVE

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

WATCHDOG_TERMINATED_PROCESS

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

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

WHEEL_TICK

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

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

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

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

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

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

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

WINDSHIELD_WIPERS_STATE

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

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

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

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

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