জিওস্পেশিয়াল এপিআই এবং ক্লাউড অ্যাঙ্কর- এর মতো ARCore ফিচারগুলো গুগল ক্লাউডে হোস্ট করা ARCore এপিআই ব্যবহার করে। এই ফিচারগুলো ব্যবহার করার সময়, আপনার অ্যাপ্লিকেশনটি ARCore এপিআই পরিষেবা অ্যাক্সেস করার জন্য ক্রেডেনশিয়াল ব্যবহার করে।
এই কুইকস্টার্টটিতে বর্ণনা করা হয়েছে কীভাবে আপনার অ্যাপ্লিকেশনটি সেট আপ করবেন, যাতে এটি গুগল ক্লাউডে হোস্ট করা ARCore API পরিষেবার সাথে যোগাযোগ করতে পারে।
একটি নতুন গুগল ক্লাউড প্রজেক্ট তৈরি করুন অথবা একটি বিদ্যমান প্রজেক্ট ব্যবহার করুন
আপনার যদি কোনো চলমান প্রকল্প থাকে, তবে সেটি নির্বাচন করুন।
আপনার যদি আগে থেকে কোনো গুগল ক্লাউড প্রজেক্ট না থাকে, তাহলে একটি তৈরি করুন।
ARCore API সক্রিয় করুন
ARCore API ব্যবহার করতে হলে, আপনাকে আপনার প্রোজেক্টে এটি সক্রিয় করতে হবে।
একটি অনুমোদন পদ্ধতি সেট আপ করুন
একটি iOS অ্যাপ্লিকেশন দুটি ভিন্ন অনুমোদন পদ্ধতি ব্যবহার করে ARCore API-এর সাথে যোগাযোগ করতে পারে: কী-বিহীন অনুমোদন, যা প্রস্তাবিত পদ্ধতি, এবং এপিআই কী অনুমোদন।
- কীলেস অথরাইজেশন এপিআই-তে অ্যাক্সেস নিয়ন্ত্রণের জন্য একটি স্বাক্ষরিত টোকেন ব্যবহার করে। এই পদ্ধতিতে টোকেন স্বাক্ষর করতে এবং এপিআই-তে অ্যাক্সেস নিয়ন্ত্রণ করতে আপনার মালিকানাধীন একটি সার্ভারের প্রয়োজন হয়।
- এপিআই কী হলো একটি স্ট্রিং যা একটি গুগল ক্লাউড প্রজেক্টকে শনাক্ত করে। এপিআই কী সাধারণত নিরাপদ বলে বিবেচিত হয় না, কারণ এগুলি সাধারণত ক্লায়েন্টদের কাছে অ্যাক্সেসযোগ্য থাকে। ARCore এপিআই-এর সাথে যোগাযোগের জন্য টোকেন অথরাইজেশন ব্যবহার করার কথা বিবেচনা করুন।
চাবিবিহীন
ARCore একটি ( JSON ওয়েব টোকেন ) ব্যবহার করে iOS-এ API কলের অনুমোদন সমর্থন করে। টোকেনটি অবশ্যই একটি Google পরিষেবা অ্যাকাউন্ট দ্বারা স্বাক্ষরিত হতে হবে।
iOS-এর জন্য টোকেন তৈরি করতে, আপনার সার্ভারে এমন একটি এন্ডপয়েন্ট থাকতে হবে যা নিম্নলিখিত শর্তগুলো পূরণ করে:
আপনার নিজস্ব অনুমোদন ব্যবস্থা অবশ্যই এন্ডপয়েন্টটিকে সুরক্ষিত রাখবে।
এন্ডপয়েন্টটিকে প্রতিবার একটি নতুন টোকেন তৈরি করতে হবে, যাতে:
- প্রত্যেক ব্যবহারকারী একটি অনন্য টোকেন পায়।
- টোকেনগুলোর মেয়াদ তাৎক্ষণিকভাবে শেষ হয়ে যায় না।
একটি পরিষেবা অ্যাকাউন্ট এবং স্বাক্ষর কী তৈরি করুন
একটি গুগল পরিষেবা অ্যাকাউন্ট এবং সাইনিং কী তৈরি করতে এই ধাপগুলো অনুসরণ করুন:
- গুগল ক্লাউডে, ক্রেডেনশিয়ালস পৃষ্ঠাটি খুলুন।
যোগ্যতা - ক্রেডেনশিয়াল তৈরি করুন > পরিষেবা অ্যাকাউন্ট-এ ক্লিক করুন।
- সার্ভিস অ্যাকাউন্ট ডিটেইলস- এর অধীনে, নতুন অ্যাকাউন্টটির জন্য একটি নাম টাইপ করুন, তারপর ক্রিয়েট-এ ক্লিক করুন।
- সার্ভিস অ্যাকাউন্ট পারমিশন পেজে, 'সিলেক্ট এ রোল' ড্রপ-ডাউনে যান। 'সার্ভিস অ্যাকাউন্টস > সার্ভিস অ্যাকাউন্ট টোকেন ক্রিয়েটর' নির্বাচন করুন, তারপর 'কন্টিনিউ'-তে ক্লিক করুন।
- ব্যবহারকারীদের এই পরিষেবা অ্যাকাউন্টে অ্যাক্সেস দেওয়ার পৃষ্ঠায়, 'সম্পন্ন' (Done) বোতামে ক্লিক করুন।
- ক্রেডেনশিয়ালস পৃষ্ঠায়, সার্ভিস অ্যাকাউন্টস বিভাগটি খুঁজুন এবং আপনার এইমাত্র তৈরি করা অ্যাকাউন্টের নামে ক্লিক করুন।
- সার্ভিস অ্যাকাউন্ট ডিটেইলস পেজে, নিচে স্ক্রল করে Keys সেকশনে যান এবং Add Key > Create new key নির্বাচন করুন।
কী টাইপ হিসেবে JSON নির্বাচন করুন এবং তৈরি করুন-এ ক্লিক করুন।
এটি আপনার মেশিনে প্রাইভেট কী সম্বলিত একটি JSON ফাইল ডাউনলোড করবে। ডাউনলোড করা JSON কী ফাইলটি একটি নিরাপদ স্থানে সংরক্ষণ করুন।
আপনার সার্ভারে টোকেন তৈরি করুন
আপনার সার্ভারে নতুন টোকেন (JWT) তৈরি করতে, স্ট্যান্ডার্ড JWT লাইব্রেরি এবং আপনার নতুন সার্ভিস অ্যাকাউন্ট থেকে নিরাপদে ডাউনলোড করা JSON ফাইলটি ব্যবহার করুন।
আপনার ডেভেলপমেন্ট মেশিনে টোকেন তৈরি করুন
আপনার ডেভেলপমেন্ট মেশিনে JWT তৈরি করতে, নিম্নলিখিত oauth2l কমান্ডটি ব্যবহার করুন:
oauth2l fetch --cache "" --jwt --json $KEYFILE --audience "https://arcore.googleapis.com/"
প্রতিবার একটি ভিন্ন টোকেন তৈরি করা নিশ্চিত করতে --cache ফ্ল্যাগ ব্যবহার করে একটি খালি ক্যাশে লোকেশন নির্দিষ্ট করা আবশ্যক। ফলাফলস্বরূপ প্রাপ্ত স্ট্রিংটি অবশ্যই ট্রিম করে নেবেন। অতিরিক্ত স্পেস বা নিউলাইন ক্যারেক্টার থাকলে API টোকেনটি প্রত্যাখ্যান করবে ।
টোকেনটিতে স্বাক্ষর করুন
JWT-তে স্বাক্ষর করার জন্য আপনাকে অবশ্যই RS256 অ্যালগরিদম এবং নিম্নলিখিত ক্লেইমগুলো ব্যবহার করতে হবে:
-
iss— পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানা। -
sub— পরিষেবা অ্যাকাউন্টের ইমেইল ঠিকানা। -
iat— টোকেনটি তৈরি হওয়ার ইউনিক্স ইপক টাইম, সেকেন্ডে। -
exp—iat+3600(১ ঘণ্টা)। এটি হলো ইউনিক্স ইপক টাইম, যখন টোকেনটির মেয়াদ শেষ হয় (সেকেন্ডে)। -
aud— শ্রোতা। এটি অবশ্যইhttps://arcore.googleapis.com/-এ সেট করতে হবে।
JWT পেলোডে নন-স্ট্যান্ডার্ড ক্লেইমের প্রয়োজন হয় না, তবে সংশ্লিষ্ট ব্যবহারকারীকে শনাক্ত করার জন্য uid ক্লেইমটি সহায়ক হতে পারে।
আপনার JWT তৈরি করার জন্য যদি আপনি ভিন্ন কোনো পদ্ধতি ব্যবহার করেন, যেমন গুগল-পরিচালিত পরিবেশে গুগল এপিআই ব্যবহার করেন, তাহলে এই বিভাগে উল্লিখিত ক্লেইমগুলো দিয়ে আপনার JWT-গুলোতে স্বাক্ষর করতে ভুলবেন না। সর্বোপরি, নিশ্চিত করুন যে অডিয়েন্স সঠিক আছে।
ARCore সেশনে টোকেনটি পাস করুন
আপনার অ্যাপটি এখন কীলেস অথেনটিকেশন ব্যবহার করার জন্য কনফিগার করা হয়েছে।
সেশনে টোকেন পাঠানোর সময় নিম্নলিখিত বিষয়গুলো লক্ষ্য করুন:
আপনি যদি সেশন তৈরি করতে এপিআই কী ব্যবহার করে থাকেন, তাহলে ARCore টোকেনটি উপেক্ষা করবে এবং একটি ত্রুটি দেখাবে।
If you no longer need the API key, delete it in the Google Developers Console and remove it from your app.
ARCore স্পেস বা বিশেষ অক্ষরযুক্ত টোকেন উপেক্ষা করে।
টোকেনগুলো সাধারণত এক ঘণ্টা পর মেয়াদোত্তীর্ণ হয়ে যায়। ব্যবহারের সময় আপনার টোকেনটির মেয়াদ শেষ হয়ে যাওয়ার সম্ভাবনা থাকলে, একটি নতুন টোকেন সংগ্রহ করে সেটি এপিআই-তে (API) জমা দিন।
এপিআই কী
- গুগল ক্লাউডে, ক্রেডেনশিয়ালস পৃষ্ঠাটি খুলুন।
যোগ্যতা - Create credentials-এ ক্লিক করুন, তারপর মেনু থেকে API key নির্বাচন করুন।
এপিআই কী তৈরি করার ডায়ালগ বক্সে আপনার সদ্য তৈরি করা কী-টির স্ট্রিংটি প্রদর্শিত হয়। - আপনার এপিআই কী সুরক্ষিত করতে এপিআই কী-এর সীমাবদ্ধতা সংক্রান্ত ডকুমেন্টেশন পর্যালোচনা করুন।
আপনার অ্যাপটি এখন এপিআই কী ব্যবহার করার জন্য কনফিগার করা হয়েছে।
এরপর কী?
অনুমোদন কনফিগার করা হয়ে গেলে, এটি ব্যবহার করে এমন নিম্নলিখিত ARCore ফিচারগুলো দেখে নিন: