إعدادات الموقع

يتم تحديد كلّ سمة متوافقة من خلال إعدادات السمة المحدّدة من خلال بنية VehiclePropConfig وتتضمّن الحقول التالية.

الحقل الوصف
prop

معرّف الموقع يجب أن يكون هذا العنصر إما إحدى خصائص النظام المحدّدة من خصائص النظام المتوافقة أو سمة خاصّة بالمورّد. يتم إنشاء رقم تعريف الموقع باستخدام عملية "أو" بين الحقول التالية (من اليمين إلى اليسار):

  • ‫(0x00000000) 16 بت: معرّف فريد من النطاق 0x0100 - 0xffff
  • ‫(0x00000000) 8 بت: أنواع المواقع التي تحدّد نوع الموقع
  • ‫(0x00000000) 4 بت: أنواع المناطق.
  • ‫(0x00000000) 4 بت: VehiclePropertyGroup> يشير ذلك إلى SYSTEM (0x10000000) أو VENDOR (0x20000000). اطّلِع على خصائص المورّدين للاطّلاع على الخصائص التي يمكنك تخصيصها.

على سبيل المثال،
INFO_VIN (0x11100100) = UniqueID (0x00000100) | VehiclePropertyType.STRING (0x00100000) | VehicleArea.GLOBAL (0x01000000) | VehiclePropertyGroup.SYSTEM (0x10000000)
access وضع الوصول إلى الموقع. يجب أن تكون إحدى القيم التالية: READ أو WRITE أو READ_WRITE. يجب أن تكون هذه القيمة مساوية لوضع الوصول المحدّد في خصائص النظام المتوافقة.
changeMode
  • تغيير وضع الموقع يجب أن تكون إحدى القيم التالية: STATIC ON_CHANGE أو CONTINUOUS. تعني القيمة STATIC أنّ قيمة السمة لا تتغيّر أبدًا بعد تشغيل النظام. يشير الرمز ON_CHANGE إلى أنّه يجب أن يُبلغ مقياس VHAL عن تغيُّر القيمة. CONTINUOUS تعني أنّ قيمة الموقع تتغيّر باستمرار ويجب أن يُبلغ VHAL عن ذلك استنادًا إلى معدّل عيّنات الاشتراك.
  • يجب أن يكون وضع التغيير مساويًا لوضع التغيير المحدّد في خصائص النظام المتوافقة.
configArray مصفوفة اختيارية تحتوي على إعدادات خاصة بالموقع يمكن ترك هذا الحقل فارغًا.
configString سلسلة اختيارية تحتوي على إعدادات خاصة بالموقع الإلكتروني يمكن ترك هذا الحقل فارغًا.
minSampleRate وmaxSampleRate

الحد الأدنى والأقصى لعدد عيّنات القياس المسموح به للموقع المستمر لا يتم استخدامها إذا لم تكن السمة مستمرة.

أنواع المواقع

تم تحديدها على أنّها قوائم أرقام مميزة في VehiclePropertyType.aidl. في ما يلي جدول يسرد أنواع المواقع المتوافقة.

نوع الموقع القيمة الوصف
سلسلة 0x00100000 سمة سلسلة، تستخدِم حقل stringValue في قيمة سمة المركبة.
منطقية 0x00200000 سمة منطقية، تستخدِم العنصر الأول في حقل int32Values في قيمة سمة المركبة. 0 تعني false، وNone 0 تعني true.
INT32 0x00400000 سمة عدد صحيح، تستخدِم العنصر الأول في حقل int32Values في قيمة سمة المركبة.
INT32_VEC 0x00410000 السمة Integer[]، تستخدِم العناصر في حقل int32Values في قيمة سمة المركبة.
INT64 0x00500000 سمة طويلة، تستخدِم العنصر الأول في حقل int64Values في قيمة سمة المركبة.
INT64_VEC 0x00510000 تستخدم السمة Long[] العناصر في حقل int64Values في قيمة سمة المركبة.
FLOAT 0x00600000 سمة Float، تستخدِم العنصر الأول في حقل floatValues في قيمة سمة المركبة.
FLOAT_VEC 0x00610000 تستخدم سمة Float[] العناصر في حقل floatValues في قيمة سمة المركبة.
BYTES 0x00700000 تستخدم سمة byte[] العناصر في حقل byteValues في قيمة سمة Vehicle.
مختلط 0x00e00000 موقع من النوع المختلط أيّ مجموعة من أنواع السلاسل أو المتجهات يجب تحديد التنسيق الدقيق في صفيف الإعدادات في إعدادات الموقع.

بالنسبة إلى خصائص النوع MIXED الخاصة بالمورّد، يجب تنسيق configArray وفقًا للبنية التالية:

  • configArray[0]، 1 تشير إلى أنّ السمة لها قيمة سلسلة
  • configArray[1]، 1 تشير إلى أنّ السمة لها قيمة منطقية
  • configArray[2], 1 تشير إلى أنّ السمة لها قيمة عددية
  • configArray[3]، يشير الرقم إلى حجم Integer[] في السمة
  • configArray[4]، 1 تشير إلى أنّ السمة لها قيمة Long
  • configArray[5]، يشير الرقم إلى حجم Long[] في السمة
  • configArray[6]، 1 تشير إلى أنّ السمة لها قيمة Float
  • configArray[7]، يشير الرقم إلى حجم Float[] في السمة
  • configArray[8]، يشير الرقم إلى حجم byte[] في السمة.

على سبيل المثال، يشير الرمز configArray = {1, 1, 1, 3, 0, 0, 0, 0, 0} إلى أنّ السمة تحتوي على قيمة سلسلة وقيمة منطقية وقيمة عدد صحيح وصفيف يحتوي على ثلاثة أعداد صحيحة.

ضبط رقم تعريف المنطقة

قد تحتوي أيضًا كلّ إعدادات الموقع على قائمة بإعدادات معرّفات المناطق. وهذه القائمة اختيارية للمواقع العالمية ومطلوبة للمواقع المخصّصة لمناطق معيّنة (المواقع التي تضم مناطق متوافقة متعددة). تحتوي كلّ عملية ضبط لرقم تعريف المنطقة على الحقول التالية.

الحقل الوصف
areaId رقم تعريف هذه المنطقة. اطّلِع على معرّفات المناطق.
minInt32Value وmaxInt32Value
  • الحد الأدنى والأقصى للقيمة اختياريان للسمات من النوع INT32. يتم تجاهلها لجميع الأنواع الأخرى. يتم تجاهله إذا كانت كلتا القيمتَين 0.
  • بالنسبة إلى الموقع الشامل، إذا كان يجب تحديد الحد الأدنى والحد الأقصى للقيمة، يجب استخدام إعداد منطقة واحد مع رقم تعريف المنطقة 0.
minInt64Value وmaxInt64Value
  • الحد الأدنى والأقصى للقيمة اختياريان للخصائص من النوع INT64. يتم تجاهلها لجميع الأنواع الأخرى. يتم تجاهله إذا كانت كلتا القيمتَين 0.
  • بالنسبة إلى الموقع الشامل، إذا كان يجب تحديد الحد الأدنى والحد الأقصى للقيمة، يجب استخدام إعداد منطقة واحد مع رقم تعريف المنطقة 0.
minFloatValue وmaxFloatValue
  • الحد الأدنى والأقصى للقيمة اختياريان للسمات من النوع Float. يتم تجاهلها لجميع الأنواع الأخرى. يتم تجاهله إذا كان كلاهما 0.0.
  • بالنسبة إلى الموقع الشامل، إذا كان يجب تحديد الحد الأدنى والحد الأقصى للقيمة، يجب استخدام إعداد منطقة واحد مع رقم تعريف المنطقة 0.
(ميزات جديدة في Android 14)
supportedEnumValues
  • قائمة اختيارية بالقيم المسموح بها إذا تم تعريف السمة على أنّها سمة نوع فهرس تصاعدي. إذا لم يتم تحديد قيمة (فارغة) أو قبل Android 14، يُفترض أنّه يمكن استخدام كل قيم التعداد.
  • بالنسبة إلى الموقع العام، إذا كان من الضروري تحديد قيم النطاق المحدَّد، يجب استخدام إعداد واحد للمنطقة بمعرّف المنطقة 0.

أنواع المناطق

تم تحديدها على أنّها قوائم أرقام مميزة في VehicleArea.aidl. في ما يلي أنواع المناطق المتوافقة.

نوع المنطقة القيمة الوصف
GLOBAL 0x01000000 هذا الموقع هو موقع عالمي وليس له مناطق متعددة.
نافذة 0x03000000 المنطقة المستندة إلى النوافذ، تستخدِم VehicleAreaWindow enum.
MIRROR 0x04000000 المنطقة المستندة إلى المرايا، تستخدِم VehicleAreaMirror enum.
سيات 0x05000000 المنطقة استنادًا إلى المقاعد، تستخدِم التعداد VehicleAreaSeat.
باب 0x06000000 المنطقة المستندة إلى الأبواب، تستخدِم VehicleAreaDoor enum.
عجلة 0x07000000 المنطقة المستندة إلى العجلات، تستخدِم VehicleAreaWheel enum.

يجب أن يستخدم كل موقع مصنّف حسب المنطقة نوع منطقة محدّدًا مسبقًا. يحتوي كل نوع منطقة على مجموعة من علامات البت المحدّدة في قائمة أرقام صحيحة لنوع المنطقة. على سبيل المثال، تحدِّد منطقة SEAT VehicleAreaSeat قوائم القيم المحدَّدة مسبقًا:

  • ROW_1_LEFT = 0x0001
  • ROW_1_CENTER = 0x0002
  • ROW_1_RIGHT = 0x0004
  • ROW_2_LEFT = 0x0010
  • ROW_2_CENTER = 0x0020
  • ROW_2_RIGHT = 0x0040
  • ROW_3_LEFT = 0x0100
  • ...

أرقام تعريف المناطق

يتمّ تحديد المواقع الجغرافية المحدّدة بمناطق معيّنة من خلال أرقام تعريف المناطق. قد يتضمّن كل موقع جغرافي معيّن رقم تعريف منطقة واحدًا أو أكثر. يتألّف رقم تعريف المنطقة من علامة واحدة أو أكثر من التعداد المعنيّ. على سبيل المثال، قد يستخدم موقع يستخدم VehicleAreaSeat معرّفات المناطق التالية:

اسم الوصف
ROW_1_LEFT | ROW_1_RIGHT ينطبق رقم تعريف المنطقة على كلا المقعدَين الأماميَين.
ROW_2_LEFT لا ينطبق ذلك إلا على المقعد الخلفي الأيسر.
ROW_2_RIGHT لا ينطبق ذلك إلا على المقعد الأيمن الخلفي.

لمزيد من المعلومات، يُرجى الاطّلاع على التدفئة والتهوية وتكييف الهواء.