iOS-এর জন্য জিওস্পেশিয়াল কুইকস্টার্ট

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

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

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

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

পূর্বশর্ত

  • Xcode সংস্করণ 13.0 বা তার পরে
  • Cocoapods 1.4.0 বা তার পরে যদি Cocoapods ব্যবহার করা হয়
  • একটি ARKit-সামঞ্জস্যপূর্ণ Apple ডিভাইস যেটি iOS 12.0 বা তার পরবর্তী সংস্করণে চলে (iOS 12.0 বা তার পরবর্তী সংস্করণের স্থাপনার লক্ষ্য প্রয়োজন)

নমুনা অ্যাপ সেট আপ করুন

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

  1. নমুনা অ্যাপ কোড পেতে GitHub থেকে iOS-এর জন্য ARCore SDK ক্লোন করুন বা ডাউনলোড করুন।

  2. একটি টার্মিনাল বা ফাইন্ডার উইন্ডো খুলুন এবং যে ফোল্ডারে আপনি SDK ক্লোন বা ডাউনলোড করেছেন সেখানে নেভিগেট করুন।

  3. arcore-ios-sdk-master/Examples ফোল্ডারে নেভিগেট করুন।

  4. Examples ফোল্ডারটি খুলুন, GeospatialExample ফোল্ডারটি নির্বাচন করুন এবং Open এ ক্লিক করুন।

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

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

আপনার Google ক্লাউড প্রজেক্টে আপনাকে অবশ্যই ARCore API সক্ষম করতে হবে । আপনি যদি প্রকল্পটি তৈরি করতে চান তবে নিম্নলিখিতগুলি করুন:

  1. Google ক্লাউড প্ল্যাটফর্মে একটি প্রকল্প তৈরি করুন দেখুন।

  2. একটি উপযুক্ত প্রকল্পের নাম লিখুন, এবং এটির জন্য একটি অবস্থান চয়ন করুন৷

  3. তৈরি করুন ক্লিক করুন।

  4. সাইডবারে, APIs এবং পরিষেবাগুলি নির্বাচন করুন, তারপরে লাইব্রেরি ।

  5. ARCore API অনুসন্ধান করুন, এটি নির্বাচন করুন এবং সক্ষম করুন ক্লিক করুন।

অনুমোদন সেট আপ করুন

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

  1. আপনার Google ক্লাউড প্রজেক্টে, একটি API কী প্রাপ্ত করুন যা বর্ণনা করা হয়েছে একটি API কী তৈরি করা ।

  2. API কী অনুলিপি করুন, যেমন আপনি এটি পেস্ট করবেন, পরবর্তী ধাপে।

  3. Xcode-এ, GeospatialExample নমুনা অ্যাপে, ViewController.m ফাইলটি খুলুন এবং আপনার-api-কী অনুসন্ধান করুন।

  4. GARSession এ আপনার API কী যুক্ত করুন : আপনার পূর্ববর্তী ধাপ থেকে অনুলিপি করা API কী পাঠ্যের উপরে পেস্ট করুন, আপনার-এপিআই-কী (উদ্ধৃতিগুলি ছেড়ে দিন), যেমনটি নীচে দেখানো হয়েছে।

    self.garSession = [GARSession sessionWithAPIKey:@"your-api-key"
                               bundleIdentifier:nil
                                          error:&error];

ARCore SDK সেট আপ করুন

GeospatialExample অ্যাপটি আপনার প্রয়োজনীয় ARCore SDK এবং iOS সংস্করণগুলির সাথে একটি Podfile প্রি-কনফিগার করা হয়। এই নির্ভরতাগুলি ইনস্টল করতে, একটি টার্মিনাল উইন্ডো খুলুন এবং Xcode প্রকল্পটি বিদ্যমান ফোল্ডার থেকে pod install চালান।

এটি একটি .xcworkspace ফাইল তৈরি করে যা আপনি পরে অ্যাপটি তৈরি এবং চালানোর জন্য ব্যবহার করবেন।

নমুনা অ্যাপ তৈরি করুন এবং চালান

  1. Xcode-এ, GeospatialExample ওয়ার্কস্পেস ফাইলটি নির্বাচন করুন এবং Signing & Capabilities- এ ক্লিক করুন।

  2. বাক্সটি চেক করুন, স্বয়ংক্রিয়ভাবে স্বাক্ষর পরিচালনা করুন ৷

  3. দলের ক্ষেত্রে, একটি দলের নাম লিখুন।

    আপনি Xcode থেকে অ্যাপটি চালানোর জন্য ডিফল্ট বান্ডেল আইডেন্টিফায়ার ব্যবহার করতে পারেন, কিন্তু আপনি যদি GeospatialExample উৎপাদনে আপনার নিজের অ্যাপের জন্য স্টাব হিসেবে ব্যবহার করেন তাহলে আপনাকে অবশ্যই এটি পরিবর্তন করতে হবে।

  4. নমুনা অ্যাপ্লিকেশন চালানোর জন্য আপনার ডিভাইস সংযোগ করুন.

  5. আপনার ডিভাইসে এটি চালু করতে .xcworkspace ফাইল থেকে GeospatialExample অ্যাপটি তৈরি করুন এবং চালান।

    বিল্ড ত্রুটিগুলি এড়াতে, নিশ্চিত করুন যে আপনি .xcworkspace ফাইল থেকে তৈরি করছেন এবং .xcodeproj ফাইলটি নয়৷

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

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

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

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

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

  1. Xcode-এ, ViewController.m ফাইলটি খুলুন এবং নিম্নলিখিত বিভাগে ব্রাউজ করুন:

    // Thresholds for 'good enough' accuracy. These can be tuned for the
// application. We use both 'low'
// and 'high' values here to avoid flickering state changes.
static const CLLocationAccuracy kHorizontalAccuracyLowThreshold = 10;
static const CLLocationAccuracy kHorizontalAccuracyHighThreshold = 20;
static const CLLocationDirectionAccuracy kHeadingAccuracyLowThreshold = 15;
static const CLLocationDirectionAccuracy kHeadingAccuracyHighThreshold = 25;

  2. প্রয়োজন অনুসারে এই মানগুলি সামঞ্জস্য করুন। মান যত বেশি, নির্ভুলতা তত কম ।

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

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

iOS-এর জন্য Geospatial বিকাশকারী নির্দেশিকা পর্যালোচনা করুন এবং Geospatial API দিয়ে বিল্ডিং শুরু করুন।