অ্যান্ড্রয়েডের জন্য ক্লাউড অ্যাঙ্কর দ্রুত শুরু

cloud_anchor_java এবং persistent_cloud_anchor_java নমুনা অ্যাপে ক্লাউড অ্যাঙ্কর হোস্টিং এবং সমাধান করার চেষ্টা করুন।

আপনি কোন নমুনা অ্যাপ্লিকেশন ব্যবহার করা উচিত?

ক্লাউড অ্যাঙ্কর হল অ্যাঙ্কর যেগুলি ARCore API ক্লাউড এন্ডপয়েন্টে হোস্ট করা হয়। এই API ব্যবহারকারীদের একই অ্যাপে অভিজ্ঞতা শেয়ার করতে সক্ষম করে। ক্রমাগত ক্লাউড অ্যাঙ্কর হল ক্লাউড অ্যাঙ্কর যা 24 ঘন্টারও বেশি সময় ধরে হোস্ট করা যেতে পারে।

  • persistent_cloud_anchor_java হল একটি সহযোগী প্রকল্প ব্যবহারের ক্ষেত্রে একটি বাস্তবায়ন। এটি ARCore API কল অনুমোদন করতে চাবিহীন অনুমোদন ব্যবহার করে। যেহেতু এটি ডিভাইসগুলির মধ্যে ক্লাউড অ্যাঙ্কর আইডিগুলি ভাগ করার জন্য একটি ফায়ারবেস ব্যাকএন্ড ব্যবহার করে না, এটি চালু করা এবং চালানো অনেক সহজ৷
  • cloud_anchor_java হল একটি মাল্টি-প্লেয়ার ব্যবহারের ক্ষেত্রে একটি বাস্তবায়ন। এটি ARCore API কল অনুমোদন করতে একটি API কী ব্যবহার করে।

পূর্বশর্ত

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

হার্ডওয়্যার

সফটওয়্যার

  • 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 cloud_anchor_java এবং persistent_cloud_anchor_java নমুনা অ্যাপ ক্লাউড অ্যাঙ্কর কার্যকারিতা প্রদর্শন করে। অ্যান্ড্রয়েড স্টুডিওতে অ্যাপগুলি খুলতে এই পদক্ষেপগুলি অনুসরণ করুন৷

ক্রমাগত মেঘ নোঙ্গর

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

  2. আপনার মেশিনে arcore-android-sdk ডিরেক্টরি যেখানে সংরক্ষিত আছে সেখানে নেভিগেট করুন। সম্পূর্ণ SDK ফোল্ডার খুলবেন না। পরিবর্তে, নমুনাগুলিতে যান > persistent_cloud_anchor_java এবং Open এ ক্লিক করুন।

মেঘ নোঙ্গর

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

  2. আপনার মেশিনে arcore-android-sdk ডিরেক্টরি যেখানে সংরক্ষিত আছে সেখানে নেভিগেট করুন। সম্পূর্ণ SDK ফোল্ডার খুলবেন না। পরিবর্তে, নমুনা > cloud_anchor_java এ যান এবং Open এ ক্লিক করুন।

ক্লাউড অ্যাঙ্কর আইডি শেয়ারিং সেট আপ করুন

ক্লাউড অ্যাঙ্কর আইডিগুলি হল এমন স্ট্রিং যা হোস্ট করা ক্লাউড অ্যাঙ্করগুলিকে শনাক্ত করে৷ এগুলি হোস্ট করা অ্যাঙ্করগুলির সাথে সংযুক্ত 3D বস্তুগুলি সমাধান করতে বা রেন্ডার করতে ব্যবহৃত হয়।

ক্রমাগত মেঘ নোঙ্গর

ক্লাউড অ্যাঙ্কর আইডি শেয়ারিং অ্যাপে স্থানীয়ভাবে রক্ষণাবেক্ষণ করা হয়। আপনাকে এখানে কিছু করতে হবে না।

মেঘ নোঙ্গর

cloud_anchor_java নমুনা অ্যাপটি ডিভাইসের মধ্যে ক্লাউড অ্যাঙ্কর আইডি শেয়ার করতে Firebase-এর রিয়েলটাইম ডেটাবেস ব্যবহার করে। আপনি আপনার নিজের অ্যাপে একটি ভিন্ন সমাধান ব্যবহার করতে পারেন।

  1. ম্যানুয়ালি আপনার অ্যাপে Firebase যোগ করুন। cloud_anchor_java প্যাকেজের নাম হল com.google.ar.core.examples.java.cloudanchor । আপনি এটি main/AndroidManifest.xml এ খুঁজে পেতে পারেন।
  2. আপনি আপনার অ্যাপে Firebase যোগ করার সময় যে google-services.json ফাইলটি তৈরি করেছেন সেটি ডাউনলোড করুন।
  3. Firebase দিয়ে একটি রিয়েলটাইম ডেটাবেস তৈরি করুন।
  4. অ্যান্ড্রয়েড স্টুডিওতে, আপনার প্রকল্পের app ডিরেক্টরিতে google-services.json ফাইলটি যোগ করুন।

ARCore API কল অনুমোদন করুন

আপনার অ্যাপের জন্য ক্লাউড অ্যাঙ্কর হোস্ট এবং সমাধান করতে ARCore API-তে কল অনুমোদন করুন। Google ক্লাউডে ARCore API ব্যবহার করার জন্য ধাপগুলি অনুসরণ করুন এবং স্থায়ী ক্লাউড অ্যাঙ্করগুলির জন্য কীলেস অনুমোদন বা ক্লাউড অ্যাঙ্করগুলির জন্য API কী অনুমোদন ব্যবহার করুন৷

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

ক্রমাগত মেঘ নোঙ্গর

অ্যাপটি চালান

  1. নিশ্চিত করুন যে আপনার ডিভাইসটি বিকাশকারী বিকল্প এবং USB ডিবাগিং সক্ষম করেছে৷
  2. আপনার ডেভেলপমেন্ট মেশিনে USB এর মাধ্যমে আপনার ডিভাইসটি সংযুক্ত করুন।
  3. অ্যান্ড্রয়েড স্টুডিওতে, স্থাপনার লক্ষ্য হিসাবে আপনার ডিভাইসটি নির্বাচন করুন এবং রানে ক্লিক করুন।

persistent_cloud_anchor_java আপনার ডিভাইসে চালু হওয়া উচিত, ARCore কে ডিভাইসের ক্যামেরার সামনে প্লেনগুলি সনাক্ত করতে অনুরোধ করে৷

Google ক্লাউড অনুমোদন ব্যর্থ হলে, সমস্যা সমাধানের পদক্ষেপগুলি দেখুন।

একটি নোঙ্গর রাখুন

  1. একবার অ্যাপটি প্লেন শনাক্ত করতে শুরু করলে, শনাক্ত করা প্লেনের একটিতে অ্যাঙ্কর রাখতে আপনার স্ক্রীনে ট্যাপ করুন।
  2. স্থাপিত অ্যাঙ্কর হোস্ট করতে HOST বোতামে আলতো চাপুন৷ এটি ARCore API-কে একটি হোস্ট অনুরোধ পাঠায়, যার মধ্যে রয়েছে অ্যাঙ্করের অবস্থানের প্রতিনিধিত্বকারী ডেটা যা এর কাছাকাছি ভিজ্যুয়াল বৈশিষ্ট্যগুলির সাথে সম্পর্কিত।

একটি সফল হোস্ট অনুরোধ স্থাপন করা স্থানে একটি অ্যাঙ্কর স্থাপন করে এবং এটিকে একটি ক্লাউড অ্যাঙ্কর আইডি বরাদ্দ করে৷ হোস্ট অনুরোধ সফল হলে, অ্যাপটি একটি রুম কোড প্রদর্শন করবে। আপনি যেকোনো ডিভাইসে এই রুমের জন্য পূর্বে হোস্ট করা অ্যাঙ্কর অ্যাক্সেস করতে এই কোডটি ব্যবহার করতে পারেন।

একটি নোঙ্গর সমাধান

  1. এই রুমে হোস্ট করা অ্যাঙ্করগুলি অ্যাক্সেস করতে রিসলভ ট্যাপ করুন এবং পূর্বে ফিরে আসা রুম কোড লিখুন। এটি ARCore API-কে একটি সমাধানের অনুরোধ পাঠায়, যা বর্তমানে রুমে হোস্ট করা সমস্ত অ্যাঙ্করের আইডি ফেরত দেয়। persistent_cloud_anchor_java হোস্ট করা অ্যাঙ্করগুলির সাথে সংযুক্ত 3D অবজেক্ট রেন্ডার করতে এই আইডিগুলি ব্যবহার করবে।

মেঘ নোঙ্গর

অ্যাপটি চালান

  1. নিশ্চিত করুন যে আপনার ডিভাইসটি বিকাশকারী বিকল্প এবং USB ডিবাগিং সক্ষম করেছে৷
  2. আপনার ডেভেলপমেন্ট মেশিনে USB এর মাধ্যমে আপনার ডিভাইসটি সংযুক্ত করুন।
  3. অ্যান্ড্রয়েড স্টুডিওতে, স্থাপনার লক্ষ্য হিসাবে আপনার ডিভাইসটি নির্বাচন করুন এবং রানে ক্লিক করুন।

cloud_anchor_java আপনার ডিভাইসে চালু হওয়া উচিত, ARCore কে ডিভাইসের ক্যামেরার সামনে প্লেনগুলি সনাক্ত করতে অনুরোধ করে৷

ত্রুটি: com.google.firebase.database.DatabaseException: Failed to get FirebaseDatabase instance: Specify DatabaseURL within FirebaseApp or from your getInstance

আপনি যদি এই ত্রুটির সম্মুখীন হন, নিশ্চিত করুন যে firebase_url প্রপার্টি google-services.json এ উপস্থিত রয়েছে। রিয়েলটাইম ডেটাবেস তৈরি করা হয়েছে তা নিশ্চিত করে এবং google-services.json ডাউনলোড করে আপনি এই সম্পত্তির জন্য সঠিক মান পেতে পারেন।


একটি নোঙ্গর রাখুন

  1. একবার অ্যাপটি প্লেন শনাক্ত করতে শুরু করলে, শনাক্ত করা প্লেনের একটিতে অ্যাঙ্কর রাখতে আপনার স্ক্রীনে ট্যাপ করুন।
  2. স্থাপিত অ্যাঙ্কর হোস্ট করতে HOST বোতামে আলতো চাপুন৷ এটি ARCore API-কে একটি হোস্ট অনুরোধ পাঠায়, যার মধ্যে রয়েছে অ্যাঙ্করের অবস্থানের প্রতিনিধিত্বকারী ডেটা যা এর কাছাকাছি ভিজ্যুয়াল বৈশিষ্ট্যগুলির সাথে সম্পর্কিত।

একটি সফল হোস্ট অনুরোধ স্থাপন করা স্থানে একটি অ্যাঙ্কর স্থাপন করে এবং এটিকে একটি ক্লাউড অ্যাঙ্করস আইডি বরাদ্দ করে৷ হোস্ট অনুরোধ সফল হলে, অ্যাপটি একটি রুম কোড প্রদর্শন করবে। আপনি যেকোনো ডিভাইসে এই রুমের জন্য পূর্বে হোস্ট করা অ্যাঙ্কর অ্যাক্সেস করতে এই কোডটি ব্যবহার করতে পারেন।

একটি নোঙ্গর সমাধান

  1. এই রুমে হোস্ট করা অ্যাঙ্করগুলি অ্যাক্সেস করতে রিসলভ ট্যাপ করুন এবং পূর্বে ফিরে আসা রুম কোড লিখুন। এটি ARCore API-কে একটি সমাধানের অনুরোধ পাঠায়, যা বর্তমানে রুমে হোস্ট করা সমস্ত অ্যাঙ্করের আইডি ফেরত দেয়। cloud_anchor_java হোস্ট করা অ্যাঙ্করগুলির সাথে সংযুক্ত 3D অবজেক্ট রেন্ডার করতে এই আইডিগুলি ব্যবহার করবে।

এরপর কি