অ্যান্ড্রয়েডের জন্য জিওস্পেশিয়াল কুইকস্টার্ট

ARCore জিওস্পেশিয়াল এপিআই-এর জন্য এই কুইকস্টার্ট আপনাকে দেখায় যে কীভাবে Android স্টুডিওতে একটি নমুনা অ্যাপ চালাতে হয় যা জিওস্পেশিয়াল এপিআই প্রদর্শন করে।

জিওস্পেশিয়াল এপিআই-এর সাথে আপনার নিজস্ব অ্যাপ ডেভেলপ করার গাইডের জন্য, অ্যান্ড্রয়েড (কোটলিন/জাভা) এর জন্য জিওস্পেশিয়াল ডেভেলপার গাইড বা অ্যান্ড্রয়েড এনডিকে (সি) এর জন্য জিওস্পেটিয়াল ডেভেলপার গাইড দেখুন।

জিওস্পেশিয়াল এপিআই সম্পর্কে আরও তথ্যের জন্য ARCore Geospatial API-এর ভূমিকা দেখুন।

আপনি যদি ARCore-এর সাথে ডেভেলপ করতে নতুন হয়ে থাকেন, তাহলে শুরু করা দেখুন।

প্রয়োজনীয়তা

ডিভাইস সমর্থন

ARCore-এর সাথে কাজ করার জন্য প্রত্যয়িত ডিভাইসগুলির একটি সম্পূর্ণ তালিকার জন্য সমর্থিত ডিভাইসগুলি দেখুন। Geospatial API-এর জন্য, হার্ডওয়্যারের মূল অংশগুলির মধ্যে একটি হল একটি ম্যাগনেটোমিটার যা জিওস্পেশিয়াল API স্পেসিফিকেশন পূরণ করে। কিছু ম্যাগনেটোমিটার স্পেস পূরণ করে না; এই অফ-স্পেক ম্যাগনেটোমিটার সহ ডিভাইসগুলি সমর্থিত নয়।

সফটওয়্যার

  • সমর্থিত ডিভাইসে AR এর জন্য Google Play Services- এর সর্বশেষ সংস্করণ ইনস্টল করা আছে।

  • Android SDK প্ল্যাটফর্ম সংস্করণ 7.0 (API স্তর 24) বা উচ্চতর সহ Android Studio সংস্করণ 3.0 বা তার পরের

  • Android এর জন্য ARCore SDK, যেটি আপনি দুটি উপায়ে পেতে পারেন:

    • এটি GitHub থেকে ডাউনলোড করুন এবং এটি আপনার মেশিনে বের করুন।

    • নিম্নলিখিত কমান্ড দিয়ে সংগ্রহস্থল ক্লোন করুন:

      git clone https://github.com/google-ar/arcore-android-sdk.git

নমুনা অ্যাপটি খুলুন এবং সেট আপ করুন

অ্যান্ড্রয়েডের জন্য ARCore SDK-এর সাথে অন্তর্ভুক্ত geospatial_java প্রজেক্টটি কোড বর্ণনা করে যেটি Geospatial API কল করে।

  1. অ্যান্ড্রয়েড স্টুডিওতে, ফাইল মেনু থেকে, খুলুন ক্লিক করুন।

  2. arcore-android-sdk- এর জন্য প্রোজেক্ট ফোল্ডারে নেভিগেট করুন।

  3. নমুনা ফোল্ডারটি খুলুন, geospatial_java ফোল্ডারটি নির্বাচন করুন এবং Open এ ক্লিক করুন।

একটি Google ক্লাউড প্রকল্প সেট আপ করুন৷

ভিজ্যুয়াল পজিশনিং সিস্টেম (VPS) ব্যবহার করার জন্য, আপনার অ্যাপটিকে একটি Google ক্লাউড প্রকল্পের সাথে যুক্ত করতে হবে যা ARCore API-এর জন্য সক্ষম করা আছে। অনুমোদন সেট আপ করতে Google ক্লাউডে ARCore API ব্যবহার করুন দেখুন। আপনি কীলেস বা API কী অনুমোদন বেছে নিতে পারেন।

নমুনা অ্যাপ চালান

অ্যান্ড্রয়েড স্টুডিওতে, নমুনা অ্যাপটি চালান।

আপনার ডিভাইসের বর্তমান ভূ-স্থানিক ভঙ্গি বর্ণনা করে ডিবাগ তথ্য সহ আপনি একটি ক্যামেরা ভিউ দেখতে সক্ষম হবেন। আপনি যখন আপনার চারপাশের পরিবেশ স্ক্যান করছেন, লক্ষ্য করুন যে আপনি যদি ভিপিএস স্থানীয়করণ দ্বারা সমর্থিত কোনো এলাকায় থাকেন তবে আপনি ঘুরতে ঘুরতে অবস্থান নির্ভুলতার আত্মবিশ্বাসের মান পরিবর্তিত হতে পারে।

যখন ARCore আপনার ডিভাইসের অবস্থান এবং শিরোনাম সম্পর্কে আত্মবিশ্বাসী হয়, আপনি ভূ-স্থানিক ভঙ্গি ব্যবহার করে আপনার বর্তমান অবস্থানে একটি অ্যাঙ্কর স্থাপন করতে পারেন।

VPS তথ্য অনুপলব্ধ হলে অবস্থান নির্ভুলতা খুব কম হতে পারে। অ্যাপটি অবশ্যই ইন্টারনেটের সাথে সংযুক্ত থাকতে হবে এবং অবস্থানটি অবশ্যই VPS-এর কাছে জানা থাকতে হবে। সর্বোত্তম ফলাফলের জন্য, দিনের আলোর সময় বাইরে নমুনা অ্যাপটি চালান (ঘরের ভিতরে নয়)।

এছাড়াও, আপনি যদি এমন কোনো এলাকায় থাকেন যা VPS সমর্থন করে না, অথবা GPS সংকেত পর্যাপ্ত না হলে, অ্যাঙ্কর স্থাপন করার জন্য আপনাকে অ্যাপে কনফিডেন্স থ্রেশহোল্ড সামঞ্জস্য করতে হতে পারে।

থ্রেশহোল্ড সামঞ্জস্য করতে:

  1. অ্যান্ড্রয়েড স্টুডিওতে, GeospatialActivity খুলুন এবং নিম্নলিখিত বিভাগে ব্রাউজ করুন:

    // The thresholds that are required for horizontal and heading accuracies before entering into the
    // LOCALIZED state. Once the accuracies are equal or less than these values, the app will
    // allow the user to place anchors.
    private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
    private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;
    
  2. প্রয়োজন অনুসারে এই মানগুলি সামঞ্জস্য করুন। মান যত বেশি, নির্ভুলতা তত কম

    নির্ভুলতা কমিয়ে আনলে অ্যাঙ্কর স্থাপনের ক্ষেত্রে অ্যাপটিকে আরও বেশি অক্ষাংশের অনুমতি দেয়। আরও তথ্যের জন্য ভঙ্গি নির্ভুলতার জন্য সামঞ্জস্য দেখুন।

পরবর্তী পদক্ষেপ