বিষয়ের জন্য উদ্দেশ্য-ভিত্তিক কমিশনিং

যদিও ম্যাটার SDK বিভিন্ন পরামিতি সহ ম্যাটার কমিশনিং শুরু করার জন্য একটি Task -ভিত্তিক API প্রদান করে, ফলাফল পর্যবেক্ষণ করে এবং ঐচ্ছিকভাবে শংসাপত্র যোগ করে, সেখানে এমন পরিস্থিতিতে রয়েছে যেখানে শুধুমাত্র একটি QR কোডের এন্ট্রি পয়েন্ট প্রয়োজন। উদাহরণস্বরূপ, একটি সাধারণ ক্যামেরা অ্যাপ্লিকেশন থেকে যা ভিউফাইন্ডারে একটি QR কোড দেখা গেলে কমিশনিং শুরু করার জন্য একটি শর্টকাট প্রদান করতে চায়।

চালিয়ে যাওয়ার আগে, নিশ্চিত করুন যে সমস্ত পূর্বশর্ত পূরণ করা হয়েছে।

বিষয় QR কোড

ম্যাটার QR কোডগুলি MT:Y3.13OTB00KA0648G00 এর সাধারণ রূপ নেয়, যেখানে MT: উপসর্গ একটি ধ্রুবক, এবং প্রত্যয়টি বর্ণমালা [A-Z0-9.-] ব্যবহার করে একটি বেস 38-এনকোডেড স্ট্রিং। প্রত্যয়টি সর্বদা কমপক্ষে 19টি অক্ষরের হতে হবে, তবে এটি দীর্ঘও হতে পারে।

একটি QR কোড একটি ম্যাটার QR কোড প্রতিনিধিত্ব করে কিনা তা নির্ধারণ করা জাভাতে নিম্নলিখিত রেজেক্স দিয়ে করা যেতে পারে:

fun isMatterQrCode(value: String): Boolean {
  return value.matches(Regex("""MT:[A-Z0-9.-]{19,}"""))
}

উদাহরণস্বরূপ, নিম্নলিখিত QR কোডটি MT:Y3.13OTB00KA0648G00 প্রতিনিধিত্ব করে:

অভিপ্রায় বিন্যাস

এই QR কোড ফর্ম্যাটটি ACTION_VIEW , data নির্দিষ্ট করা URI এবং Google Play পরিষেবাতে সেট করা লক্ষ্য প্যাকেজের সাথে একটি Intent পাঠিয়ে কমিশনিং প্রবাহ শুরু করতে URI হিসাবে ব্যবহার করা যেতে পারে:

fun startCommissioning(context: Context, qrCodeString: String): Boolean {
  val intent =
    Intent(Intent.ACTION_VIEW)
      .setData(Uri.parse(qrCodeString))
      .setPackage("com.google.android.gms")

  try {
    context.startActivity(intent)
    return true
  } catch (ex: ActivityNotFoundException) {
    // Supporting Play Services version not available.
    return false
  }
}

নমুনা অ্যাপ্লিকেশন

এই নমুনা অ্যাপটি দেখায় কিভাবে একটি ম্যাটার ডিভাইস চালু করা শুরু করতে হয় যখন ক্যামেরার ভিউফাইন্ডারে একটি ম্যাটার-সঙ্গতিপূর্ণ QR কোড দেখা যায়।

ইন্টেন্ট-ভিত্তিক কমিশনিং নমুনা অ্যাপ ডাউনলোড করুন

এই নমুনা অ্যাপের কোডটি নিম্নলিখিত অ্যান্ড্রয়েড লাইব্রেরিগুলিকে ব্যবহার করে:

• ক্যামেরাএক্স
• বারকোড স্ক্যানিং

এই নমুনা অ্যাপের জন্য লেখা কোড বোঝার জন্য নিম্নলিখিত নথিগুলিও দরকারী:

• CameraX দিয়ে শুরু করা
• অ্যান্ড্রয়েডে এমএল কিট দিয়ে বারকোড স্ক্যান করুন

ব্যবহার

অ্যাপটি শুরু হলে, ক্যামেরা প্রিভিউ স্ক্রিনে দেখানো হয়। যখন একটি ম্যাটার ডিভাইসের জন্য একটি QR কোড সনাক্ত করা হয়, তখন সেই ম্যাটার ডিভাইসের জন্য কমিশনিং করা উচিত কিনা তা নিশ্চিত করার জন্য একটি ডায়ালগ দেখানো হয়:

কমিশনিং নিশ্চিত হলে, Google Home Mobile SDK দ্বারা সমর্থিত "অ্যাপ পিকার" চালু করা হয়।

অ্যাপ পিকার প্রাথমিকভাবে ডিফল্ট কমিশনিং অ্যাপ্লিকেশনগুলির একটি সেট দেখায় (উদাহরণস্বরূপ, প্রথম স্ক্রিনশটে দেখানো Google হোম অ্যাপ)। যদি কেউ "অন্য অ্যাপ বেছে নিন"-এ ট্যাপ করে, তাহলে Google Home Mobile SDK কমিশনিং ফ্লোকে সমর্থন করে এমন অন্যান্য অ্যাপ্লিকেশানগুলি দেখানো হয় (দ্বিতীয় স্ক্রিনশট দেখুন)।

নির্বাচিত অ্যাপ্লিকেশনটি তারপর ডিভাইসের কমিশনিং সঞ্চালনের জন্য চালু করা হয়।