আপনার iOS অ্যাপের জন্য Geospatial API সক্ষম করুন

আপনার অ্যাপের সেটিংস কনফিগার করুন যাতে এটি Geospatial API ব্যবহার করতে পারে।

পূর্বশর্ত

এগিয়ে যাওয়ার আগে নিশ্চিত করুন যে আপনি মৌলিক AR ধারণা এবং কীভাবে একটি ARCore সেশন কনফিগার করবেন তা বুঝতে পেরেছেন।

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

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

আপনি যদি ARCore-এর সাথে বিকাশের জন্য নতুন হয়ে থাকেন, তাহলে সফ্টওয়্যার এবং হার্ডওয়্যার প্রয়োজনীয়তা, পূর্বপ্রস্তুতি এবং আপনি যে প্ল্যাটফর্মগুলি ব্যবহার করছেন তার জন্য নির্দিষ্ট অন্যান্য তথ্য সম্পর্কে তথ্যের জন্য শুরু করা দেখুন।

ARCore API সক্ষম করুন

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

কীবিহীন অনুমোদন পছন্দ করা হয়, তবে API কী অনুমোদনও সমর্থিত।

আপনার অ্যাপে প্রয়োজনীয় লাইব্রেরি যোগ করুন

ARCore API কল করার জন্য আপনার অ্যাপটিকে অনুমোদন করার পরে, আপনার অ্যাপে ভূ-স্থানীয় বৈশিষ্ট্যগুলি সক্ষম করতে আপনাকে অবশ্যই লাইব্রেরি যোগ করতে হবে।

ARCore SDK এবং সমর্থিত iOS সংস্করণ অন্তর্ভুক্ত করতে আপনার অ্যাপের জন্য Podfile আপডেট করুন। এটা করতে:

  1. আপনার প্রকল্পের Podfile নিম্নলিখিত platform এবং pod যোগ করুন:

    platform :ios, '11.0'
pod 'ARCore/Geospatial', '~> 1.42.0'

    আপনি যদি iOS 10 সমর্থন করতে চান তাহলে আপনি platform :ios, '10.0' নির্দিষ্ট করতে পারেন, কিন্তু মনে রাখবেন যে জিওস্পেশিয়াল API শুধুমাত্র iOS >= 11-এ রানটাইমে কাজ করবে।

  2. একটি টার্মিনাল উইন্ডো খুলুন এবং আপনার এক্সকোড প্রকল্প বিদ্যমান ফোল্ডার থেকে pod install চালান।

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

আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট ARCore SDK প্রয়োজনীয়তাগুলিকে সন্তুষ্ট করে তা নিশ্চিত করুন, যেমন Quickstart- এ বর্ণিত হয়েছে।

সেশন কনফিগারেশনে ভূ-স্থানীয় ক্ষমতা সক্ষম করুন

ডিভাইসের সামঞ্জস্যতা পরীক্ষা করুন

ARCore সমর্থন করে এমন সমস্ত ডিভাইস জিওস্পেশিয়াল API সমর্থন করে না, যেমন Quickstart- এ বর্ণিত হয়েছে।

GARSession.isGeospatialModeSupported: ডিভাইসটি পরীক্ষা করতে, নিচের মতো:

if (![self.garSession isGeospatialModeSupported:GARGeospatialModeEnabled]) {
  [self setErrorStatus:@"GARGeospatialModeEnabled is not supported on this device."];
  return;
}

GARSessionConfiguration *configuration = [[GARSessionConfiguration alloc] init];
configuration.geospatialMode = GARGeospatialModeEnabled;
[self.garSession setConfiguration:configuration error:&error];
if (error) {
  [self setErrorStatus:[NSString stringWithFormat:@"Failed to configure GARSession: %d",
                                                  (int)error.code]];
  return;
}

রানটাইমে অবস্থানের অনুমতির জন্য ব্যবহারকারীকে জিজ্ঞাসা করুন

সেশন কনফিগার করার আগে আপনার অ্যাপকে রানটাইমে নিম্নলিখিত অবস্থানের অনুমতির অনুরোধ করতে হবে:

ডিভাইসের বর্তমান অবস্থানে ভূ-স্থানিক প্রাপ্যতা পরীক্ষা করুন

যেহেতু জিওস্পেশিয়াল এপিআই একটি জিওস্প্যাশিয়াল ট্রান্সফর্ম নির্ধারণ করতে ভিপিএস এবং জিপিএসের সংমিশ্রণ ব্যবহার করে, যতক্ষণ পর্যন্ত ডিভাইসটি তার অবস্থান নির্ধারণ করতে সক্ষম হয় ততক্ষণ পর্যন্ত এপিআই ব্যবহার করা যেতে পারে। কম GPS নির্ভুলতা সহ এলাকায়, যেমন ইনডোর স্পেস এবং ঘন শহুরে পরিবেশ, API উচ্চ নির্ভুলতা রূপান্তর তৈরি করতে VPS কভারেজের উপর নির্ভর করবে। সাধারণ অবস্থার অধীনে, VPS প্রায় 5 মিটার অবস্থানগত নির্ভুলতা এবং 5 ডিগ্রী ঘূর্ণনগত নির্ভুলতা প্রদান করবে বলে আশা করা যেতে পারে। GARSession.checkVPSAvailabilityAtCoordinate:completionHandler: একটি নির্দিষ্ট অবস্থানে VPS কভারেজ আছে কিনা তা নির্ধারণ করতে ব্যবহার করুন।

জিওস্পেশিয়াল এপিআই এমন এলাকায়ও ব্যবহার করা যেতে পারে যেখানে ভিপিএস কভারেজ নেই। অল্প বা কোনো ওভারহেড বাধা সহ বহিরঙ্গন পরিবেশে, উচ্চ নির্ভুলতার সাথে একটি রূপান্তর তৈরি করার জন্য GPS যথেষ্ট হতে পারে।

এরপর কি