iOS-এ ক্লাউড অ্যাঙ্করগুলির জন্য কুইকস্টার্ট

ARCore Cloud Anchor API , বা ARCore Cloud Anchor পরিষেবা , আপনার iOS অ্যাপের জন্য ক্লাউড অ্যাঙ্কর ক্ষমতা প্রদান করে, যা iOS এবং Android ডিভাইসের ব্যবহারকারীদের জন্য AR অভিজ্ঞতা শেয়ার করা সম্ভব করে তোলে।

এই নির্দেশিকা আপনাকে দেখায় কিভাবে:

  • ক্লাউড অ্যাঙ্করগুলির সাথে কাজ করার জন্য আপনার উন্নয়ন পরিবেশ সেট আপ করুন৷
  • একটি নমুনা অ্যাপে অ্যাঙ্কর হোস্টিং এবং সমাধান করার চেষ্টা করুন

পূর্বশর্ত

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

ক্লাউড অ্যাঙ্কর ব্যবহার করে

নিম্নলিখিত ধাপগুলি ARCore ক্লাউড অ্যাঙ্কর সমর্থন করে এমন একটি অ্যাপ কনফিগার এবং তৈরি করার জন্য গুরুত্বপূর্ণ কাজগুলি দেখানোর জন্য ক্লাউড অ্যাঙ্করস নমুনা অ্যাপ ব্যবহার করে।

ক্লাউড অ্যাঙ্করস নমুনা অ্যাপ পান

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

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

  3. আপনি নমুনা অ্যাপ্লিকেশন কোড খুঁজে পেতে পারেন
    /arcore-ios-sdk-master/Examples/CloudAnchorExample

    ক্রমাগত ক্লাউড অ্যাঙ্কর নমুনা অ্যাপ কোড আছে
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample

সেশন সেটআপ

সেশন সেট আপ করার অংশ হিসাবে নমুনা অ্যাপটি নিম্নলিখিত গুরুত্বপূর্ণ কাজগুলি সম্পাদন করে:

  • একটি GARSession তৈরি করা
  • একটি ARSession তৈরি করা এবং এটি চালানো
  • একটি ARSessionDelegate সেট করা হচ্ছে।
  • session:didUpdateFrame: পদ্ধতিতে GARSessionARFrame s পাস করা।

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

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

নমুনা অ্যাপে ফায়ারবেস ডাটাবেস সেট আপ করতে:

  1. আপনার অ্যাপে Firebase যোগ করার জন্য Firebase নির্দেশাবলী অনুসরণ করুন।
  2. আপনার অ্যাপে Firebase যোগ করার অংশ হিসেবে তৈরি করা GoogleService-Info.plist ফাইলটি ডাউনলোড করুন।
  3. নমুনার জন্য Firebase সঞ্চয়স্থান সক্ষম করুন:
    • Firebase কনসোলে যান এবং নমুনা অ্যাপের জন্য আপনার সেট আপ করা প্রকল্পটি নির্বাচন করুন।
    • Database প্যানেল নির্বাচন করুন।
    • Realtime Database বিকল্পে, Get Started ক্লিক করুন।
    • Security rules for Realtime Database খোলে।
      • নমুনা চালানোর উদ্দেশ্যে, Start in test mode নির্বাচন করুন।
      • মনে রাখবেন যে আপনি যদি এমন একটি অ্যাপের জন্য Firebase ব্যবহার করেন যা আপনি প্রকাশ করার পরিকল্পনা করছেন, তাহলে আপনার আরও সীমাবদ্ধ নিরাপত্তা নিয়ম ব্যবহার করা উচিত।
  4. Xcode-এ, Info.plist এর পাশে GoogleService-Info.plist ফাইলটি আপনার অ্যাপে যোগ করুন।

ARCore API সেট আপ করুন

ক্লাউড অ্যাঙ্কর ব্যবহার করতে, আপনাকে প্রথমে আপনার অ্যাপ্লিকেশনের জন্য ARCore API সেট আপ করতে হবে।

পড আপডেট চালান

CloudAnchorExample অ্যাপটি আপনার প্রয়োজন হবে এমন ARCore SDK এবং iOS সংস্করণগুলির সাথে একটি Podfile পূর্বে কনফিগার করা সহ পাঠানো হয়। এই নির্ভরতাগুলি ইনস্টল করতে:

  1. একটি টার্মিনাল উইন্ডো খুলুন এবং ফোল্ডার থেকে pod update চালান যেখানে Xcode প্রকল্প বিদ্যমান।
    এটি একটি .xcworkspace ফাইল তৈরি করে যা আপনি পরে অ্যাপটি তৈরি এবং চালানোর জন্য ব্যবহার করবেন।

আপনার নিজের অ্যাপে Podfile কনফিগার করার বিষয়ে বিস্তারিত জানতে আপনার অ্যাপে ARCore SDK যোগ করুন দেখুন।

  1. Xcode-এ প্রজেক্টের জন্য .xcworkspace ফাইলটি খুলুন।

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

অ্যাপ বান্ডেল আইডি পরিবর্তন করুন

Xcode-এ, অ্যাপের বান্ডিল আইডি পরিবর্তন করুন যাতে আপনি আপনার দলের সাথে অ্যাপটিতে সাইন ইন করতে পারেন।

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

  1. আপনার ডিভাইসটি সংযুক্ত করুন এবং Xcode-এ অ্যাপটি চালু করুন।

  2. (ঐচ্ছিক) আপনি যদি নমুনা অ্যাপ তৈরি এবং চালাচ্ছেন, তাহলে ক্লাউড অ্যাঙ্কর হোস্ট করতে এবং সমাধান করতে অ্যাপটি ব্যবহার করার বিষয়ে বিশদ বিবরণের জন্য নিম্নলিখিত বিভাগটি দেখুন।

নমুনা অ্যাপ্লিকেশন চেষ্টা করে দেখুন

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

  2. অনুরোধ করা হলে, অ্যাপটিকে ক্যামেরার অনুমতি দিন। ARKit তারপর আপনার ক্যামেরার সামনে প্লেন সনাক্ত করতে শুরু করে।

  3. হোস্টিং মোডে প্রবেশ করতে HOST আলতো চাপুন। হোস্ট করা অ্যাঙ্কর শেয়ার করার জন্য একটি রুম কোড তৈরি হয় এবং আপনার স্ক্রিনে প্রদর্শিত হয়।

  4. সেখানে একটি ক্লাউড অ্যাঙ্কর হোস্ট করা শুরু করতে একটি প্লেনে আলতো চাপুন৷

    • অ্যাপটি প্লেনে একটি অ্যান্ডি অ্যান্ড্রয়েড অবজেক্ট রাখে এবং এটিতে একটি অ্যাঙ্কর সংযুক্ত করে।
    • ARCore API ক্লাউড এন্ডপয়েন্টে একটি হোস্ট অনুরোধ পাঠানো হয়। হোস্ট রিকোয়েস্টে অ্যাঙ্কর এর কাছাকাছি ভিজ্যুয়াল ফিচারের সাথে সম্পর্কিত ডেটা অন্তর্ভুক্ত করে।
    • একবার অ্যাঙ্কর হোস্ট করা হলে, এটি একটি আইডি পায় যা এই স্পেসে ক্লাউড অ্যাঙ্করগুলি সমাধান করার জন্য ব্যবহৃত হয়।
  5. একই বা অন্য কোনো ডিভাইস ব্যবহার করে এই রুমের জন্য পূর্বে হোস্ট করা ক্লাউড অ্যাঙ্কর অ্যাক্সেস করতে RESOLVE ট্যাপ করুন এবং একটি রুম কোড লিখুন।

    • ARCore API ক্লাউড এন্ডপয়েন্টে একটি সমাধানের অনুরোধ পাঠানো হয়।
    • সমাধানের অনুরোধে একটি ক্লাউড অ্যাঙ্কর আইডি অন্তর্ভুক্ত রয়েছে। যদি আইডি একটি হোস্ট করা অ্যাঙ্করের সাথে মেলে এবং স্থানীয়করণ সফল হয়, সার্ভারটি আপনার স্থানীয় স্থানাঙ্কে অ্যাঙ্করের রূপান্তর ফিরিয়ে দেয়।
    • নমুনা অ্যাপটি আপনার দৃশ্যে অ্যাঙ্কর যোগ করতে এবং এতে সংযুক্ত ভার্চুয়াল অবজেক্ট রেন্ডার করতে রূপান্তর ব্যবহার করে।

আপনার অ্যাপে ARCore SDK যোগ করুন

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

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

        platform :ios, '11.0'
        pod 'ARCore/CloudAnchors', '~> 1.45.0'
    
  1. একটি টার্মিনাল উইন্ডো খুলুন এবং আপনার এক্সকোড প্রকল্প বিদ্যমান ফোল্ডার থেকে pod update চালান।
    এটি একটি .xcworkspace ফাইল তৈরি করে যা আপনি অ্যাপটি তৈরি এবং চালানোর জন্য ব্যবহার করেন।

অবিরাম মেঘ নোঙ্গর

হোস্ট এ ক্লাউড অ্যাঙ্কর অধ্যবসায়- এ বর্ণিত হিসাবে, আপনি ক্লাউড অ্যাঙ্করকে 365 দিন পর্যন্ত বেঁচে থাকার সময় দিতে পারেন। স্থায়ী ক্লাউড অ্যাঙ্কর ব্যবহারের জন্য নমুনা কোড GitHub থেকে iOS-এর জন্য ARCore SDK- এর /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample ডিরেক্টরিতে পাওয়া যায়।

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

,

ARCore Cloud Anchor API , বা ARCore Cloud Anchor পরিষেবা , আপনার iOS অ্যাপের জন্য ক্লাউড অ্যাঙ্কর ক্ষমতা প্রদান করে, যা iOS এবং Android ডিভাইসের ব্যবহারকারীদের জন্য AR অভিজ্ঞতা শেয়ার করা সম্ভব করে তোলে।

এই নির্দেশিকা আপনাকে দেখায় কিভাবে:

  • ক্লাউড অ্যাঙ্করগুলির সাথে কাজ করার জন্য আপনার উন্নয়ন পরিবেশ সেট আপ করুন৷
  • একটি নমুনা অ্যাপে অ্যাঙ্কর হোস্টিং এবং সমাধান করার চেষ্টা করুন

পূর্বশর্ত

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

ক্লাউড অ্যাঙ্কর ব্যবহার করে

নিম্নলিখিত ধাপগুলি ARCore ক্লাউড অ্যাঙ্কর সমর্থন করে এমন একটি অ্যাপ কনফিগার এবং তৈরি করার জন্য গুরুত্বপূর্ণ কাজগুলি দেখানোর জন্য ক্লাউড অ্যাঙ্করস নমুনা অ্যাপ ব্যবহার করে।

ক্লাউড অ্যাঙ্করস নমুনা অ্যাপ পান

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

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

  3. আপনি নমুনা অ্যাপ্লিকেশন কোড খুঁজে পেতে পারেন
    /arcore-ios-sdk-master/Examples/CloudAnchorExample

    ক্রমাগত ক্লাউড অ্যাঙ্কর নমুনা অ্যাপ কোড আছে
    /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample

সেশন সেটআপ

সেশন সেট আপ করার অংশ হিসাবে নমুনা অ্যাপটি নিম্নলিখিত গুরুত্বপূর্ণ কাজগুলি সম্পাদন করে:

  • একটি GARSession তৈরি করা
  • একটি ARSession তৈরি করা এবং এটি চালানো
  • একটি ARSessionDelegate সেট করা হচ্ছে।
  • session:didUpdateFrame: পদ্ধতিতে GARSessionARFrame s পাস করা।

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

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

নমুনা অ্যাপে ফায়ারবেস ডাটাবেস সেট আপ করতে:

  1. আপনার অ্যাপে Firebase যোগ করার জন্য Firebase নির্দেশাবলী অনুসরণ করুন।
  2. আপনার অ্যাপে Firebase যোগ করার অংশ হিসেবে তৈরি করা GoogleService-Info.plist ফাইলটি ডাউনলোড করুন।
  3. নমুনার জন্য Firebase সঞ্চয়স্থান সক্ষম করুন:
    • Firebase কনসোলে যান এবং নমুনা অ্যাপের জন্য আপনার সেট আপ করা প্রকল্পটি নির্বাচন করুন।
    • Database প্যানেল নির্বাচন করুন।
    • Realtime Database বিকল্পে, Get Started ক্লিক করুন।
    • Security rules for Realtime Database খোলে।
      • নমুনা চালানোর উদ্দেশ্যে, Start in test mode নির্বাচন করুন।
      • মনে রাখবেন যে আপনি যদি এমন একটি অ্যাপের জন্য Firebase ব্যবহার করেন যা আপনি প্রকাশ করার পরিকল্পনা করছেন, তাহলে আপনার আরও সীমাবদ্ধ নিরাপত্তা নিয়ম ব্যবহার করা উচিত।
  4. Xcode-এ, Info.plist এর পাশে GoogleService-Info.plist ফাইলটি আপনার অ্যাপে যোগ করুন।

ARCore API সেট আপ করুন

ক্লাউড অ্যাঙ্কর ব্যবহার করতে, আপনাকে প্রথমে আপনার অ্যাপ্লিকেশনের জন্য ARCore API সেট আপ করতে হবে।

পড আপডেট চালান

CloudAnchorExample অ্যাপটি আপনার প্রয়োজন হবে এমন ARCore SDK এবং iOS সংস্করণগুলির সাথে একটি Podfile পূর্বে কনফিগার করা সহ পাঠানো হয়। এই নির্ভরতাগুলি ইনস্টল করতে:

  1. একটি টার্মিনাল উইন্ডো খুলুন এবং ফোল্ডার থেকে pod update চালান যেখানে Xcode প্রকল্প বিদ্যমান।
    এটি একটি .xcworkspace ফাইল তৈরি করে যা আপনি পরে অ্যাপটি তৈরি এবং চালানোর জন্য ব্যবহার করবেন।

আপনার নিজের অ্যাপে Podfile কনফিগার করার বিষয়ে বিস্তারিত জানতে আপনার অ্যাপে ARCore SDK যোগ করুন দেখুন।

  1. Xcode-এ প্রজেক্টের জন্য .xcworkspace ফাইলটি খুলুন।

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

অ্যাপ বান্ডেল আইডি পরিবর্তন করুন

Xcode-এ, অ্যাপের বান্ডিল আইডি পরিবর্তন করুন যাতে আপনি আপনার দলের সাথে অ্যাপটিতে সাইন ইন করতে পারেন।

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

  1. আপনার ডিভাইসটি সংযুক্ত করুন এবং Xcode-এ অ্যাপটি চালু করুন।

  2. (ঐচ্ছিক) আপনি যদি নমুনা অ্যাপ তৈরি এবং চালাচ্ছেন, তাহলে ক্লাউড অ্যাঙ্কর হোস্ট করতে এবং সমাধান করতে অ্যাপটি ব্যবহার করার বিষয়ে বিশদ বিবরণের জন্য নিম্নলিখিত বিভাগটি দেখুন।

নমুনা অ্যাপ্লিকেশন চেষ্টা করে দেখুন

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

  2. অনুরোধ করা হলে, অ্যাপটিকে ক্যামেরার অনুমতি দিন। ARKit তারপর আপনার ক্যামেরার সামনে প্লেন সনাক্ত করতে শুরু করে।

  3. হোস্টিং মোডে প্রবেশ করতে HOST আলতো চাপুন। হোস্ট করা অ্যাঙ্কর শেয়ার করার জন্য একটি রুম কোড তৈরি হয় এবং আপনার স্ক্রিনে প্রদর্শিত হয়।

  4. সেখানে একটি ক্লাউড অ্যাঙ্কর হোস্ট করা শুরু করতে একটি প্লেনে আলতো চাপুন৷

    • অ্যাপটি প্লেনে একটি অ্যান্ডি অ্যান্ড্রয়েড অবজেক্ট রাখে এবং এটিতে একটি অ্যাঙ্কর সংযুক্ত করে।
    • ARCore API ক্লাউড এন্ডপয়েন্টে একটি হোস্ট অনুরোধ পাঠানো হয়। হোস্ট রিকোয়েস্টে অ্যাঙ্কর এর কাছাকাছি ভিজ্যুয়াল ফিচারের সাথে সম্পর্কিত ডেটা অন্তর্ভুক্ত করে।
    • একবার অ্যাঙ্কর হোস্ট করা হলে, এটি একটি আইডি পায় যা এই স্পেসে ক্লাউড অ্যাঙ্করগুলি সমাধান করার জন্য ব্যবহৃত হয়।
  5. একই বা অন্য কোনো ডিভাইস ব্যবহার করে এই রুমের জন্য পূর্বে হোস্ট করা ক্লাউড অ্যাঙ্কর অ্যাক্সেস করতে RESOLVE ট্যাপ করুন এবং একটি রুম কোড লিখুন।

    • ARCore API ক্লাউড এন্ডপয়েন্টে একটি সমাধানের অনুরোধ পাঠানো হয়।
    • সমাধানের অনুরোধে একটি ক্লাউড অ্যাঙ্কর আইডি অন্তর্ভুক্ত রয়েছে। যদি আইডি একটি হোস্ট করা অ্যাঙ্করের সাথে মেলে এবং স্থানীয়করণ সফল হয়, সার্ভারটি আপনার স্থানীয় স্থানাঙ্কে অ্যাঙ্করের রূপান্তর ফিরিয়ে দেয়।
    • নমুনা অ্যাপটি আপনার দৃশ্যে অ্যাঙ্কর যোগ করতে এবং এতে সংযুক্ত ভার্চুয়াল অবজেক্ট রেন্ডার করতে রূপান্তর ব্যবহার করে।

আপনার অ্যাপে ARCore SDK যোগ করুন

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

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

        platform :ios, '11.0'
        pod 'ARCore/CloudAnchors', '~> 1.45.0'
    
  1. একটি টার্মিনাল উইন্ডো খুলুন এবং আপনার এক্সকোড প্রকল্প বিদ্যমান ফোল্ডার থেকে pod update চালান।
    এটি একটি .xcworkspace ফাইল তৈরি করে যা আপনি অ্যাপটি তৈরি এবং চালানোর জন্য ব্যবহার করেন।

অবিরাম মেঘ নোঙ্গর

হোস্ট এ ক্লাউড অ্যাঙ্কর অধ্যবসায়- এ বর্ণিত হিসাবে, আপনি ক্লাউড অ্যাঙ্করকে 365 দিন পর্যন্ত বেঁচে থাকার সময় দিতে পারেন। স্থায়ী ক্লাউড অ্যাঙ্কর ব্যবহারের জন্য নমুনা কোড GitHub থেকে iOS-এর জন্য ARCore SDK- এর /arcore-ios-sdk-master/Examples/PersistentCloudAnchorExample ডিরেক্টরিতে পাওয়া যায়।

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