Google ক্লাউডে ARCore API ব্যবহার করুন

প্ল্যাটফর্ম নির্বাচন করুন:

ARCore বৈশিষ্ট্য যেমন Geospatial API এবং Cloud Anchors Google Cloud এ হোস্ট করা ARCore API ব্যবহার করে। এই বৈশিষ্ট্যগুলি ব্যবহার করার সময়, আপনার অ্যাপ্লিকেশন ARCore API পরিষেবা অ্যাক্সেস করতে শংসাপত্র ব্যবহার করে৷

এই কুইকস্টার্ট বর্ণনা করে কিভাবে আপনার অ্যাপ্লিকেশন সেট আপ করতে হয় যাতে এটি Google ক্লাউডে হোস্ট করা ARCore API পরিষেবার সাথে যোগাযোগ করতে পারে।

একটি নতুন Google ক্লাউড প্রকল্প তৈরি করুন বা একটি বিদ্যমান প্রকল্প ব্যবহার করুন৷

আপনার যদি একটি বিদ্যমান প্রকল্প থাকে তবে এটি নির্বাচন করুন।

প্রকল্প নির্বাচক যান

আপনার যদি বিদ্যমান Google ক্লাউড প্রকল্প না থাকে তবে একটি তৈরি করুন৷

নতুন প্রকল্প তৈরি করুন

ARCore API সক্ষম করুন

ARCore API ব্যবহার করতে, আপনাকে অবশ্যই এটি আপনার প্রকল্পে সক্ষম করতে হবে।

ARCore API সক্ষম করুন

একটি অনুমোদন পদ্ধতি সেট আপ করুন

একটি ইউনিটি অ্যাপ্লিকেশন দুটি ভিন্ন অনুমোদন পদ্ধতি ব্যবহার করে ARCore API এর সাথে যোগাযোগ করতে পারে: কীলেস অনুমোদন, যা প্রস্তাবিত পদ্ধতি এবং API কী অনুমোদন:

  • অ্যান্ড্রয়েডে, কীলেস অনুমোদন আপনার আবেদনকে অনুমোদন করতে অ্যাপ্লিকেশনটির প্যাকেজ নাম এবং সাইনিং কী-এর আঙুলের ছাপের সংমিশ্রণ ব্যবহার করে।

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

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

চাবিহীন

কীলেস প্রমাণীকরণ ব্যবহার করে আপনার অ্যাপকে অনুমোদন করতে, OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করুন।

সাইনিং কী ফিঙ্গারপ্রিন্ট নির্ধারণ করুন

একটি OAuth 2.0 ক্লায়েন্ট আইডি আপনার অ্যাপ শনাক্ত করতে আপনার অ্যাপের সাইনিং কী ফিঙ্গারপ্রিন্ট ব্যবহার করে।

কিভাবে আপনার ডিবাগ সাইনিং ফিঙ্গারপ্রিন্ট পাবেন

আপনার প্রোজেক্ট চালানো বা ডিবাগ করার সময়, Android SDK টুলগুলি স্বয়ংক্রিয়ভাবে একটি জেনারেট করা ডিবাগ শংসাপত্রের সাথে আপনার অ্যাপে স্বাক্ষর করে।

ডিবাগ শংসাপত্র ফিঙ্গারপ্রিন্ট পেতে নিম্নলিখিত কমান্ডটি ব্যবহার করুন।

ম্যাক/লিনাক্স 
keytool -list -v -alias androiddebugkey -keystore ~/.android/debug.keystore
উইন্ডোজ 
keytool -list -v -alias androiddebugkey -keystore %USERPROFILE%\.android\debug.keystore

keytool ইউটিলিটি আপনাকে কীস্টোরের জন্য একটি পাসওয়ার্ড লিখতে অনুরোধ করে। ডিবাগ কীস্টোরের ডিফল্ট পাসওয়ার্ড হল android । keytool ইউটিলিটি তারপর আঙুলের ছাপ টার্মিনালে প্রিন্ট করে। যেমন: 

   Certificate fingerprint: SHA1: <strong>DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09

কিভাবে একটি কীস্টোর থেকে সাইনিং ফিঙ্গারপ্রিন্ট পাবেন

আপনার যদি একটি কীস্টোর ফাইল থাকে তবে ফিঙ্গারপ্রিন্ট নির্ধারণ করতে keytool ইউটিলিটি ব্যবহার করুন। 

keytool -list -v -alias your-key-name -keystore path-to-production-keystore

keytool ইউটিলিটি তারপর আঙুলের ছাপ টার্মিনালে প্রিন্ট করে। যেমন: 

   Certificate fingerprint: SHA1: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09

প্লে অ্যাপ সাইনিং থেকে কীভাবে আপনার অ্যাপের সাইনিং কী পাবেন

প্লে অ্যাপ সাইনিং ব্যবহার করার সময়, Google আপনার অ্যাপের সাইনিং কী পরিচালনা করে এবং আপনার APK সাইন ইন করতে এটি ব্যবহার করে। এই কীটি সাইনিং ফিঙ্গারপ্রিন্টের জন্য ব্যবহার করা উচিত।

  1. Google Play কনসোলে অ্যাপ সাইনিং পৃষ্ঠায় , অ্যাপ সাইনিং কী শংসাপত্রে স্ক্রোল করুন।
  2. SHA-1 সার্টিফিকেট ফিঙ্গারপ্রিন্ট ব্যবহার করুন।

OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করুন

পূর্ববর্তী ধাপ থেকে প্রতিটি প্রযোজ্য সাইনিং কী-এর জন্য, আপনার Google ক্লাউড প্রকল্পের শংসাপত্রে একটি OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করুন।

  • Google ক্লাউডে, শংসাপত্র পৃষ্ঠা খুলুন।

    শংসাপত্র

  • ক্রেডেনশিয়াল তৈরি করুন ক্লিক করুন, তারপর মেনু থেকে OAuth ক্লায়েন্ট আইডি নির্বাচন করুন।

  • নিম্নলিখিত হিসাবে প্রয়োজনীয় ক্ষেত্রগুলি পূরণ করুন:

    • আবেদনের ধরন : অ্যান্ড্রয়েড নির্বাচন করুন।
    • প্যাকেজের নাম : আপনার AndroidManifest.xml- এ ঘোষিত প্যাকেজের নাম ব্যবহার করুন।
    • SHA-1 শংসাপত্র ফিঙ্গারপ্রিন্ট : পূর্ববর্তী ধাপে প্রাপ্ত একটি আঙ্গুলের ছাপ ব্যবহার করুন।

  • তৈরি করুন টিপুন।

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

  1. আপনার অ্যাপের নির্ভরতার মধ্যে com.google.android.gms:play-services-auth:16+ অন্তর্ভুক্ত করুন।

  2. আপনি যদি কোড মিনিফিকেশন ব্যবহার করেন, তাহলে এটি আপনার অ্যাপের build.gradle ফাইলে যোগ করুন: 

    buildTypes {
  release {
    ...
    proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
  }
}

  3. আপনার অ্যাপের proguard-rules.pro ফাইলে নিম্নলিখিত যোগ করুন: 

    -keep class com.google.android.gms.common.** { *; }
-keep class com.google.android.gms.location.** { *; }
-keep class com.google.android.gms.auth.** { *; }
-keep class com.google.android.gms.tasks.** { *; }

আপনার অ্যাপ এখন কীলেস প্রমাণীকরণ ব্যবহার করার জন্য কনফিগার করা হয়েছে।

চাবিহীন

ARCore ( JSON ওয়েব টোকেন ) ব্যবহার করে iOS-এ API কলের অনুমোদন সমর্থন করে। টোকেনটি অবশ্যই একটি Google পরিষেবা অ্যাকাউন্ট দ্বারা স্বাক্ষরিত হতে হবে।

iOS-এর জন্য টোকেন তৈরি করার জন্য, আপনার সার্ভারে একটি শেষ পয়েন্ট থাকতে হবে যা নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:

  • আপনার নিজস্ব অনুমোদন প্রক্রিয়া অবশ্যই শেষ পয়েন্ট রক্ষা করবে।

  • শেষ বিন্দু অবশ্যই প্রতিবার একটি নতুন টোকেন তৈরি করবে, যেমন:

    • প্রতিটি ব্যবহারকারী একটি অনন্য টোকেন পায়।
    • টোকেন অবিলম্বে মেয়াদ শেষ হয় না.

একটি পরিষেবা অ্যাকাউন্ট এবং সাইনিং কী তৈরি করুন

একটি Google পরিষেবা অ্যাকাউন্ট এবং সাইনিং কী তৈরি করতে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. Google ক্লাউডে, শংসাপত্র পৃষ্ঠা খুলুন।
    শংসাপত্র
  2. ক্রিয়েট ক্রেডেনশিয়াল > সার্ভিস অ্যাকাউন্টে ক্লিক করুন।
  3. পরিষেবা অ্যাকাউন্টের বিবরণের অধীনে, নতুন অ্যাকাউন্টের জন্য একটি নাম টাইপ করুন, তারপর তৈরি করুন ক্লিক করুন।
  4. পরিষেবা অ্যাকাউন্ট অনুমতি পৃষ্ঠায়, একটি ভূমিকা নির্বাচন করুন ড্রপ-ডাউনে যান৷ Service Accounts > Service Account Token Creator নির্বাচন করুন, তারপর Continue-এ ক্লিক করুন।
  5. ব্যবহারকারীদের এই পরিষেবা অ্যাকাউন্ট পৃষ্ঠায় অ্যাক্সেস মঞ্জুর করুন , সম্পন্ন ক্লিক করুন।
  6. শংসাপত্র পৃষ্ঠায়, পরিষেবা অ্যাকাউন্ট বিভাগটি খুঁজুন এবং আপনি যে অ্যাকাউন্টটি তৈরি করেছেন তার নামে ক্লিক করুন।
  7. পরিষেবা অ্যাকাউন্টের বিবরণ পৃষ্ঠায়, কী বিভাগে স্ক্রোল করুন এবং কী যোগ করুন > নতুন কী তৈরি করুন নির্বাচন করুন।

  8. কী টাইপ হিসাবে JSON নির্বাচন করুন এবং তৈরি করুন ক্লিক করুন।

    এটি আপনার মেশিনের ব্যক্তিগত কী ধারণকারী একটি JSON ফাইল ডাউনলোড করে। ডাউনলোড করা JSON কী ফাইলটি একটি নিরাপদ স্থানে সংরক্ষণ করুন।

আপনার সার্ভারে টোকেন তৈরি করুন

আপনার সার্ভারে নতুন টোকেন (JWTs) তৈরি করতে, স্ট্যান্ডার্ড JWT লাইব্রেরি এবং JSON ফাইলটি ব্যবহার করুন যা আপনি আপনার নতুন পরিষেবা অ্যাকাউন্ট থেকে নিরাপদে ডাউনলোড করেছেন।

আপনার ডেভেলপমেন্ট মেশিনে টোকেন তৈরি করুন

আপনার ডেভেলপমেন্ট মেশিনে JWTs তৈরি করতে, নিম্নলিখিত oauth2l কমান্ডটি ব্যবহার করুন: 

oauth2l fetch --cache "" --jwt --json $KEYFILE --audience "https://arcore.googleapis.com/"

--cache ফ্ল্যাগ ব্যবহার করে একটি খালি ক্যাশে অবস্থান নির্দিষ্ট করা প্রয়োজন যাতে প্রতিবার একটি ভিন্ন টোকেন তৈরি করা হয়। ফলস্বরূপ স্ট্রিং ছাঁটা নিশ্চিত করুন। অতিরিক্ত স্পেস বা নতুন লাইনের অক্ষর এপিআইকে টোকেন প্রত্যাখ্যান করবে ।

টোকেনে স্বাক্ষর করুন

JWT-এ স্বাক্ষর করার জন্য আপনাকে অবশ্যই RS256 অ্যালগরিদম এবং নিম্নলিখিত দাবিগুলি ব্যবহার করতে হবে:

  • iss — পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানা।
  • sub - পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানা।
  • iat — ইউনিক্স যুগের সময় যখন টোকেন তৈরি হয়েছিল, সেকেন্ডে।
  • exp — iat + 3600 (1 ঘন্টা)। ইউনিক্স যুগের সময় যখন টোকেনের মেয়াদ শেষ হয়, সেকেন্ডে।
  • aud — দর্শক। এটি অবশ্যই https://arcore.googleapis.com/ এ সেট করতে হবে।

JWT পেলোডে অ-মানক দাবির প্রয়োজন নেই, যদিও আপনি uid দাবিটি সংশ্লিষ্ট ব্যবহারকারীকে সনাক্ত করার জন্য দরকারী বলে মনে করতে পারেন।

আপনি যদি আপনার JWTs তৈরি করার জন্য একটি ভিন্ন পদ্ধতি ব্যবহার করেন, যেমন Google-পরিচালিত পরিবেশে একটি Google API ব্যবহার করে, তাহলে এই বিভাগে থাকা দাবিগুলির সাথে আপনার JWTগুলি স্বাক্ষর করতে ভুলবেন না। সর্বোপরি, নিশ্চিত করুন যে দর্শকরা সঠিক।

ARCore সেশনে টোকেন পাস করুন

  1. নিশ্চিত করুন যে iOS প্রমাণীকরণ কৌশলটি AuthenticationToken- এ সেট করা আছে। ইউনিটিতে, এডিট > প্রজেক্ট সেটিংস > XR প্লাগ-ইন ম্যানেজমেন্ট > ARCore এক্সটেনশন- এ যান। iOS প্রমাণীকরণ কৌশল ড্রপ-ডাউন মেনুতে, প্রমাণীকরণ টোকেন বিকল্পটি নির্বাচন করুন।

  2. আপনি যখন একটি টোকেন পাবেন, তখন এটিকে ARAnchorManager.SetAuthToken() ব্যবহার করে আপনার ARCore সেশনে পাস করুন : 

    // Designate the token to authorize ARCore API calls
// on the iOS platform. This should be called each time the application's token is refreshed.
ARAnchorManager.SetAuthToken(authToken);

আপনার অ্যাপ এখন কীলেস প্রমাণীকরণ ব্যবহার করার জন্য কনফিগার করা হয়েছে।

আপনি অধিবেশনে একটি টোকেন পাস করার সময় নিম্নলিখিত নোট করুন:

  • আপনি সেশন তৈরি করতে একটি API কী ব্যবহার করলে, ARCore টোকেন উপেক্ষা করবে এবং একটি ত্রুটি লগ করবে।

    আপনার যদি আর API কী-এর প্রয়োজন না হয়, তাহলে Google Developers Console- এ মুছে ফেলুন এবং আপনার অ্যাপ থেকে সরিয়ে দিন।

  • ARCore টোকেনগুলিকে উপেক্ষা করে যাতে স্পেস বা বিশেষ অক্ষর থাকে।

  • টোকেন সাধারণত এক ঘন্টা পরে মেয়াদ শেষ হয়. যদি একটি সম্ভাবনা থাকে যে আপনার টোকেন ব্যবহারের সময় মেয়াদ শেষ হয়ে যেতে পারে, একটি নতুন টোকেন প্রাপ্ত করুন এবং এটি API-তে পাস করুন।

API কী

  1. Google ক্লাউডে, শংসাপত্র পৃষ্ঠা খুলুন।
    শংসাপত্র
  2. শংসাপত্র তৈরি করুন ক্লিক করুন, তারপর মেনু থেকে API কী নির্বাচন করুন।
    API কী তৈরি ডায়ালগ আপনার নতুন তৈরি কী-এর জন্য স্ট্রিং প্রদর্শন করে।

  3. ইউনিটিতে, এডিট > প্রজেক্ট সেটিংস > XR প্লাগ-ইন ম্যানেজমেন্ট > ARCore এক্সটেনশন- এ যান। প্রতিটি লক্ষ্য প্ল্যাটফর্মের জন্য (Android, iOS), এর প্রমাণীকরণ কৌশল ড্রপ-ডাউন মেনুতে, API কী বিকল্পটি নির্বাচন করুন। তারপরে, API কী ক্ষেত্রগুলিতে আপনার API কী সন্নিবেশ করুন।

  4. আপনার API কী সুরক্ষিত করতে API কী সীমাবদ্ধতার ডকুমেন্টেশন পর্যালোচনা করুন।

আপনার অ্যাপ এখন API কী ব্যবহার করার জন্য কনফিগার করা হয়েছে।

এরপর কি

অনুমোদন কনফিগার করার সাথে, নিম্নলিখিত ARCore বৈশিষ্ট্যগুলি দেখুন যা এটি ব্যবহার করে: