বিশেষ প্রপার্টি

ভেন্ডর প্রপার্টি

পার্টনার-নির্দিষ্ট চাহিদা পূরণ করতে, VHAL ভেন্ডর প্রপার্টিকে অনুমতি দেয় যা শুধুমাত্র সিস্টেম API-এর মাধ্যমে অ্যাক্সেস করা যায়। ভেন্ডর প্রপার্টি নিয়ে কাজ করার সময় নিম্নলিখিত নির্দেশিকা অনুসরণ করুন:

  • সবসময় প্রথমে সিস্টেম প্রপার্টি ব্যবহার করার চেষ্টা করুন, ভেন্ডর প্রপার্টি শেষ উপায় হিসেবে ব্যবহার করা উচিত যখন কোনও সিস্টেম প্রপার্টি আপনার প্রয়োজন পূরণ করে না।
  • ইকোসিস্টেম ফ্র্যাগমেন্টেশন প্রতিরোধ করতে, SDK VehiclePropertyIds-এ আগে থেকেই আছে এমন গাড়ির প্রপার্টি রেপ্লিকেট করতে ভেন্ডর প্রপার্টি ব্যবহার করা যাবে না। আরও জানতে, CDD-এর বিভাগ ২.৫, অটোমোটিভ সংক্রান্ত প্রয়োজনীয়তা দেখুন।
  • প্রপার্টি আইডি তৈরি করতে নিম্নলিখিত ফিল্ড ব্যবহার করুন:
    • VehiclePropertyGroup:VENDOR ভেন্ডর গ্রুপ শুধুমাত্র ভেন্ডর প্রপার্টির জন্য ব্যবহার করা হয়।
    • VehicleArea উপযুক্ত এলাকার ধরন বেছে নিন।
    • VehiclePropertyType ডেটার সঠিক ধরন বেছে নিন। BYTES টাইপ র ডেটা পাস করার অনুমতি দেয়, যা বেশিরভাগ ক্ষেত্রে যথেষ্ট। ভেন্ডর প্রপার্টির মাধ্যমে ঘন ঘন বিগ ডেটা পাঠালে পুরো গাড়ির নেটওয়ার্ক অ্যাক্সেস স্লো হয়ে যেতে পারে। বড় পেলোড যোগ করার সময় সতর্ক থাকুন।
    • Property ID ভেন্ডর প্রপার্টির জন্য একটি অনন্য দুই-বাইট আইডি বেছে নিন। যেমন, 0x1234.
  • VehiclePropConfig.configString-এ ভেন্ডর প্রপার্টির একটি সংক্ষিপ্ত বিবরণ লিখুন। এর ফলে, বৈধতা চেক করার টুল, আগে থেকে থাকা গাড়ির প্রপার্টি দুর্ঘটনাবশত রেপ্লিকেশন হয়ে গেলে তা ফ্ল্যাগ করতে পারে। যেমন, "XYZ-এর জন্য আমার কাস্টম প্রপার্টি।"
  • CarPropertyManager (Java কম্পোনেন্টের জন্য) বা libvhalclient (নেটিভের জন্য)-এর মাধ্যমে অ্যাক্সেস করুন। অন্যান্য গাড়ির API পরিবর্তন করবেন না, কারণ এটি করলে ভবিষ্যতে মানানসই হওয়ার ক্ষেত্রে সমস্যা হতে পারে।

ভেন্ডর প্রপার্টি সংক্রান্ত অনুমতি

নির্দিষ্ট করা যেকোনও ভেন্ডর প্রপার্টির জন্য ডিফল্ট অনুমতি হল android.car.Car.PERMISSION_VENDOR_EXTENSION। অনুমতি নিয়ন্ত্রণের আরও সূক্ষ্ম গ্র্যানুলারিটির জন্য, SUPPORT_CUSTOMIZE_VENDOR_PERMISSION প্রপার্টিকে সাপোর্ট করুন। এই STATIC প্রপার্টি শুধু পড়া যায়, যার জন্য এর কনফিগারেশন অ্যারে ভেন্ডর প্রপার্টির অনুমতি নির্দিষ্ট করে। configArray নিম্নলিখিতভাবে সেট করা হয় (i হল একটি পূর্ণসংখ্যা যা ০ থেকে শুরু হয়):

  • configArray[3 * i] propId, ভেন্ডর প্রপার্টির জন্য প্রপার্টি আইডি।
  • configArray[3 * i + 1] VehicleVendorPermission.aidl-এ একটি enum যা প্রপার্টির ভ্যালু পড়ার অনুমতি নির্দেশ করে।
  • configArray[3 * i + 2] VehicleVendorPermission.aidl-এ একটি enum যা প্রপার্টি ভ্যালু লেখার অনুমতি নির্দেশ করে।

যেমন, নিম্নলিখিত কনফিগারেশন অ্যারে দুটি ভেন্ডর প্রপার্টি কনফিগার করে, vendor_prop_1 এবং vendor_prop_2, যাতে অনুমতি থাকে:

  • vendor_prop_1-এর জন্য android.car.hardware.property.VehicleVendorPermission.PERMISSION_GET_CAR_VENDOR_CATEGORY_SEAT পড়ার, android.car.hardware.property.VehicleVendorPermission.PERMISSION_SET_CAR_VENDOR_CATEGORY_SEAT লেখার অনুমতি প্রয়োজন।
  • vendor_prop-2-এর জন্য android.car.hardware.property.VehicleVendorPermission.PERMISSION_GET_CAR_VENDOR_CATEGORY_INFO প্রয়োজন, যা Android অ্যাপের জন্য রাইটেবল নয়।
configArray = {
  PERMISSION_SET_VENDOR_CATEGORY_SEAT
    vendor_prop_2, PERMISSION_GET_VENDOR_CATEGORY_INFO, PERMISSION_NOT_ACCESSIBLE
}

এই অ্যারেতে নেই এমন ভেন্ডর প্রপার্টি ডিফল্ট ভেন্ডর অনুমতি গ্রহণ করে। PERMISSION_NOT_ACCESSIBLE বেছে নেওয়া হলে, Android অ্যাপ প্রপার্টি অ্যাক্সেস করতে পারবে না। উদাহরণে, Android অ্যাপ vendor_prop_2-এর জন্য কোনও ভ্যালু লিখতে পারবে না। শুধুমাত্র নেটিভ VHAL ক্লায়েন্ট এই প্রপার্টিতে লিখতে পারবে।

উন্নত ড্রাইভার অ্যাসিস্ট্যান্স সিস্টেম (ADAS)

ADAS গাড়ির প্রপার্টি দেখুন।

সিট ও স্টিয়ারিং

SEAT এবং STEERING_WHEEL প্রপার্টি দেখুন।

HVAC

HVAC-সম্পর্কিত প্রপার্টি সেট করে HVAC নিয়ন্ত্রণ করার জন্য আপনি VHAL ব্যবহার করতে পারবেন। বেশিরভাগ HVAC প্রপার্টি গাড়ির নির্দিষ্ট অংশের সাথে যুক্ত, যদিও বেশ কিছু গ্লোবাল প্রপার্টিও আছে। নমুনা দ্বারা সংজ্ঞায়িত প্রপার্টির মধ্যে এগুলি অন্তর্ভুক্ত:

প্রপার্টি উদ্দেশ্য
HVAC_TEMPERATURE_SET এরিয়া আইডি অনুযায়ী তাপমাত্রা সেট করুন।
HVAC_POWER_ON প্রতিটি এরিয়া আইডি অনুযায়ী HVAC সিস্টেমের পাওয়ার স্টেট।

HVAC সিস্টেমের পাওয়ার স্ট্যাটাসের উপর নির্ভর করে এমন HVAC প্রপার্টির জন্য, সেগুলি অবশ্যই HVAC_POWER_ON কনফিগারেশন অ্যারেতে তালিকাভুক্ত হতে হবে। HVAC প্রপার্টির সম্পূর্ণ তালিকা দেখতে, VehicleProperty.aidl-এ HVAC_* সার্চ করুন, কাজ করে এমন সিস্টেম প্রপার্টি দেখুন। প্রপার্টি।

AreaID-তে নন-GLOBAL VehicleArea টাইপ HVAC প্রপার্টি ম্যাপ করার নিয়ম: প্রপার্টি দ্বারা প্রভাবিত নির্দিষ্ট VehicleArea টাইপের প্রতিটি "এলাকা" অবশ্যই সেই প্রপার্টির জন্য একটি এলাকা আইডিতে অন্তর্ভুক্ত করতে হবে। তাপমাত্রা কন্ট্রোলার সেই সিটে অ্যাসাইন করা হয় যেটিতে "সবচেয়ে বেশি প্রভাব" পড়ে, তবে প্রভাবিত হওয়া প্রতিটি সিটকে অবশ্যই একবার অন্তর্ভুক্ত করতে হবে। The assignment of the center rear seat to the left or right AreaID might seem arbitrary, but the inclusion of every affected seat in exactly one AreaID ensures that the seats in the car are all expressed and that a reasonable way to affect each seat is available.

উদাহরণ ১

একটি গাড়িতে দুটি সামনের সিট (ROW_1_LEFT, ROW_1_RIGHT) এবং তিনটি পিছনের সিট (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) থাকে। দুটি তাপমাত্রা নিয়ন্ত্রণ ইউনিট আছে, একটি ড্রাইভারের দিকে এবং অন্যটি যাত্রীর দিকে। HVAC_TEMPERATURE_SET-এর জন্য AreaID-এর সঠিক ম্যাপিং সেট দুটি এলিমেন্ট সহ অ্যারে হবে:

  • ROW_1_LEFT | ROW_2_LEFT
  • ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT

একই হার্ডওয়্যার কনফিগারেশনের জন্য বিকল্প ম্যাপিং হল:

  • ROW_1_LEFT | ROW_2_CENTER | ROW_2_LEFT
  • ROW_1_RIGHT | ROW_2_RIGHT

উদাহরণ ২

একটি গাড়িতে তিনটি সিটের সারি রয়েছে যার সামনের সারিতে দুটি সিট (ROW_1_LEFT, ROW_1_RIGHT) এবং দ্বিতীয় (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) এবং তৃতীয় সারিতে তিনটি সিট (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT) রয়েছে। তাপমাত্রা নিয়ন্ত্রণ করার তিনটি ইউনিট আছে, একটি চালকের দিকে, একটি যাত্রীর দিকে এবং একটি পিছনের দিকে। AreaID-তে HVAC_TEMPERATURE_SET ম্যাপ করার একটি যুক্তিযুক্ত উপায় হল তিন এলিমেন্টের অ্যারে:

  • ROW_1_LEFT
  • ROW_1_RIGHT
  • ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT

উদাহরণ ৩

একটি গাড়িতে দুটি সামনের সিট (ROW_1_LEFT, ROW_1_RIGHT) এবং তিনটি পিছনের সিট (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) থাকে। ধরুন, গাড়িতে শুধু সামনের দুটি সিটের জন্য HVAC_AUTO_ON প্রপার্টি কাজ করে। HVAC_AUTO_ON-এর জন্য AreaID-এর একটি সঠিক ম্যাপিং সেট হবে একটি এলিমেন্ট অ্যারে:

  • ROW_1_LEFT | ROW_1_RIGHT

HVAC_AUTO_ON-এ যদি ড্রাইভার ও যাত্রীর জন্য আলাদা কন্ট্রোল ইউনিট থাকে, তাহলে বিকল্প ম্যাপিং হিসেবে দুটি এলিমেন্টের অ্যারে ব্যবহার করা যেতে পারে:

  • ROW_1_LEFT
  • ROW_1_RIGHT

INFO_EXTERIOR_DIMENSIONS

১ নম্বর ছবিতে যেমন দেখানো হয়েছে, সেই অনুযায়ী গাড়ির বাইরের দিকের মাপ মিলিমিটারে পরিমাপ করা হয়।

ছবি ১. গাড়ির বাইরের ডাইমেনশন, সামনের ভিউ।
ছবি ২. গাড়ির বাইরের দিকের ডাইমেনশন, সাইড ভিউ।

গাড়ির বাইরের দিকের মাপ নির্ধারণ করতে এই সারণিতে বর্ণিত প্রপার্টি ব্যবহার করুন।

গাড়ির প্রপার্টি VHAL ফিল্ড বর্ণনা
উচ্চতা int32Values[0] ভূমি থেকে গাড়ির সর্বোচ্চ বিন্দুর মধ্যে উল্লম্ব দূরত্ব। এটি ধরে নেয় যে ফ্যাক্টরি হুইল সাধারণত স্ফীত থাকে।
দৈর্ঘ্য int32Values[1] গাড়ির সামনের ও পিছনের দিকের সবচেয়ে বাইরের পয়েন্টের মধ্যে অনুভূমিক দূরত্ব।
প্রস্থ, মিরর বাদ দিয়ে int32Values[2] গাড়ির দুই পাশের সবচেয়ে বাইরের দুটি বিন্দুর মধ্যে অনুভূমিক দূরত্ব, সাইড মিরর বাদ দিয়ে।
মিরর সহ প্রস্থ int32Values[3] গাড়ির দু'পাশের সবচেয়ে বাইরের দুটি বিন্দুর মধ্যে অনুভূমিক দূরত্ব, যার মধ্যে সাইড মিররও অন্তর্ভুক্ত।
হুইল বেস int32Values[4] গাড়ির সামনের ও পিছনের চাকার কেন্দ্রের মধ্যে দূরত্ব।
ট্র্যাকের প্রস্থ, সামনের দিকে int32Values[5] সামনের চাকার মধ্যে দূরত্ব, একটি টায়ার ট্রেডের কেন্দ্র রেখা থেকে বিপরীত টায়ার ট্রেডের কেন্দ্র রেখা পর্যন্ত পরিমাপ করা হয়।
ট্র্যাকের প্রস্থ, পিছনের চাকা int32Values[6] পিছনের চাকার মধ্যে দূরত্ব, একটি টায়ার ট্রেডের কেন্দ্র রেখা থেকে বিপরীত টায়ার ট্রেডের কেন্দ্র রেখা পর্যন্ত পরিমাপ করা হয়।
কার্ব-টু-কার্ব টার্নিং ডায়ামিটার int32Values[7] সম্পূর্ণ লক করা স্টিয়ারিং হুইল সহ সম্পূর্ণ বাঁক নেওয়ার সময় গাড়ির বাইরের চাকা দ্বারা তৈরি বৃত্তের ব্যাস।

ইউরোপীয় ইউনিয়নের সাধারণ নিরাপত্তা রেগুলেশন মেনে চলা

Android-এর মাধ্যমে যদি গাড়িকে ইউরোপীয় ইউনিয়নের জেনারেল সেফটি রেগুলেশন (GSR) সংক্রান্ত প্রয়োজনীয়তা মেনে চলতে হয়, তাহলে GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT প্রপার্টি সাপোর্ট করতে হবে। ব্যবহারের একটি উদাহরণ হল GSR-ISA (ইন্টেলিজেন্ট স্পিড অ্যাসিস্ট) যা EU রেগুলেশন 2019/2144-এ উল্লেখ করা আছে। এই প্রপার্টি Android 13 থেকে AIDL VHAL-এ যোগ করা হয়েছে, তবে এটি Android 12 রিলিজ হওয়ার পর থেকে Car Service-এ কাজ করে। এই প্রপার্টিকে রিড-অনলি স্ট্যাটিক গ্লোবাল ইন্টিজার প্রপার্টি হিসেবে সংজ্ঞায়িত করা হয়েছে, যার সম্ভাব্য ভ্যালু GsrComplianceRequirementType enum দ্বারা সংজ্ঞায়িত করা হয়েছে:

নাম মান বর্ণনা
GSR_COMPLIANCE_NOT_REQUIRED 0 GSR মেনে চলার প্রয়োজন নেই
GSR_COMPLIANCE_REQUIRED_V1 1 GSR মেনে চলতে হবে এবং প্রয়োজনীয় সমাধান ভার্সন হল ১।

HIDL VHAL-এ (Android 12-এ) এই প্রপার্টি সাপোর্ট করার জন্য, ভেন্ডরদের অবশ্যই প্রপার্টি আইডি হার্ড-কোড করতে হবে। যেমন, নিম্নলিখিত স্নিপেট থেকে বোঝা যায় যে রেফারেন্স HIDL VHAL DefaultConfig.h-এ এটি কীভাবে কাজ করে:

{
  .config =
      {
          // GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT
          .prop = 0x11400F47,
          .access = VehiclePropertyAccess::READ,
          .changeMode = VehiclePropertyChangeMode::STATIC,
      },
  // GsrComplianceRequirementType::GSR_COMPLIANCE_REQUIRED_V1
  .initialValue = {.int32Values = {1}},
}

AIDL VHAL-এ (Android 13 থেকে) এই প্রপার্টিকে সাপোর্ট করতে, ভেন্ডররা VehicleProperty.h থেকে প্রপার্টি আইডি এবং GsrComplianceRequirementType.h থেকে enum ব্যবহার করতে পারবেন। যেমন, রেফারেন্স AIDL VHAL DefaultProperties.json-এর মতো:

{
  "property": "VehicleProperty::GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT",
  "defaultValue": {
    "int32Values": [
      "GsrComplianceRequirementType::GSR_COMPLIANCE_REQUIRED_V1"
    ]
  }
}

Android অ্যাপ থেকে এই প্রপার্টি পড়তে, CarPropertyManager.getIntProperty ব্যবহার করুন।

  • Android 13 ও তার পরবর্তী ভার্সনে, প্রপার্টি আইডি হিসেবে VehiclePropertyIds.GENERAL_SAFETY_REGULATION_COMPLIANCE ব্যবহার করুন।
  • Android 12-এ, প্রপার্টি আইডি হিসেবে 0x11400F47-এর হার্ড-কোডেড ভ্যালু ব্যবহার করুন। এই প্রপার্টির জন্য Car#PERMISSION_CAR_INFO অনুমতি প্রয়োজন।