জিওস্পেশিয়াল এপিআই এবং ক্লাউড অ্যাঙ্কর- এর মতো ARCore ফিচারগুলো গুগল ক্লাউডে হোস্ট করা ARCore এপিআই ব্যবহার করে। এই ফিচারগুলো ব্যবহার করার সময়, আপনার অ্যাপ্লিকেশনটি ARCore এপিআই পরিষেবা অ্যাক্সেস করার জন্য ক্রেডেনশিয়াল ব্যবহার করে।
এই কুইকস্টার্টটিতে বর্ণনা করা হয়েছে কীভাবে আপনার অ্যাপ্লিকেশনটি সেট আপ করবেন, যাতে এটি গুগল ক্লাউডে হোস্ট করা ARCore API পরিষেবার সাথে যোগাযোগ করতে পারে।
একটি নতুন গুগল ক্লাউড প্রজেক্ট তৈরি করুন অথবা একটি বিদ্যমান প্রজেক্ট ব্যবহার করুন
আপনার যদি কোনো চলমান প্রকল্প থাকে, তবে সেটি নির্বাচন করুন।
আপনার যদি আগে থেকে কোনো গুগল ক্লাউড প্রজেক্ট না থাকে, তাহলে একটি তৈরি করুন।
ARCore API সক্রিয় করুন
ARCore API ব্যবহার করতে হলে, আপনাকে আপনার প্রোজেক্টে এটি সক্রিয় করতে হবে।
একটি অনুমোদন পদ্ধতি সেট আপ করুন
একটি অ্যান্ড্রয়েড অ্যাপ্লিকেশন দুটি ভিন্ন অনুমোদন পদ্ধতি ব্যবহার করে ARCore API-এর সাথে যোগাযোগ করতে পারে: কী-বিহীন অনুমোদন (OAuth 2.0), যা প্রস্তাবিত পদ্ধতি, এবং এপিআই কী অনুমোদন।
- কী-বিহীন অনুমোদন আপনার অ্যাপ্লিকেশনকে অনুমোদন করার জন্য অ্যাপ্লিকেশনটির প্যাকেজ নাম এবং সাইনিং কী-এর ফিঙ্গারপ্রিন্টের একটি সমন্বয় ব্যবহার করে।
- এপিআই কী হলো একটি স্ট্রিং যা একটি গুগল ক্লাউড প্রজেক্টকে শনাক্ত করে। এপিআই কী সাধারণত নিরাপদ বলে বিবেচিত হয় না, কারণ এগুলি সাধারণত ক্লায়েন্টদের কাছে অ্যাক্সেসযোগ্য থাকে। ARCore এপিআই-এর সাথে যোগাযোগের জন্য কীলেস অথরাইজেশন ব্যবহার করার কথা বিবেচনা করুন।
চাবিবিহীন
কীলেস অথেনটিকেশন ব্যবহার করে আপনার অ্যাপকে অনুমোদন দিতে, OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করুন।
স্বাক্ষর করার মূল আঙুলের ছাপ নির্ধারণ করুন
একটি OAuth 2.0 ক্লায়েন্ট আইডি আপনার অ্যাপকে শনাক্ত করতে এর সাইনিং কী ফিঙ্গারপ্রিন্ট ব্যবহার করে।
আপনার ডিবাগ সাইনিং ফিঙ্গারপ্রিন্ট কীভাবে পাবেন
আপনার প্রজেক্ট রান বা ডিবাগ করার সময়, অ্যান্ড্রয়েড এসডিকে টুলগুলো স্বয়ংক্রিয়ভাবে একটি ডিবাগ সার্টিফিকেট দিয়ে আপনার অ্যাপে স্বাক্ষর করে।
- অ্যান্ড্রয়েড স্টুডিওতে গ্রেডল টুলপেনটি খুলুন।
- project-name > টাস্ক > অ্যান্ড্রয়েড- এ যান।
- signingReport টাস্কটি চালান।
- ডিবাগ ভ্যারিয়েন্টের জন্য SHA-1 ফিঙ্গারপ্রিন্টটি কপি করুন।
কীস্টোর থেকে কীভাবে একটি সাইনিং ফিঙ্গারপ্রিন্ট পাওয়া যায়
আপনার কাছে কীস্টোর ফাইল থাকলে, ফিঙ্গারপ্রিন্ট নির্ধারণ করতে 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
প্লে অ্যাপ সাইনিং থেকে আপনার অ্যাপের সাইনিং কী কীভাবে পাবেন
প্লে অ্যাপ সাইনিং ব্যবহার করার সময়, গুগল আপনার অ্যাপের সাইনিং কী পরিচালনা করে এবং এটি ব্যবহার করে আপনার APK-গুলো সাইন করে। এই কী-টি সাইনিং ফিঙ্গারপ্রিন্টের জন্য ব্যবহার করা উচিত।
- Google Play Console-এর App Signing পেজে , App signing key certificate পর্যন্ত স্ক্রোল করুন।
- SHA-1 সার্টিফিকেট ফিঙ্গারপ্রিন্ট ব্যবহার করুন।
OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করুন
পূর্ববর্তী ধাপগুলো থেকে প্রাপ্ত প্রতিটি প্রযোজ্য সাইনিং কী-এর জন্য, আপনার গুগল ক্লাউড প্রজেক্টের ক্রেডেনশিয়ালসে একটি OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করুন।
গুগল ক্লাউডে, ক্রেডেনশিয়ালস পৃষ্ঠাটি খুলুন।
Create credentials-এ ক্লিক করুন, তারপর মেনু থেকে OAuth client ID নির্বাচন করুন।
প্রয়োজনীয় ক্ষেত্রগুলি নিম্নরূপভাবে পূরণ করুন:
- অ্যাপ্লিকেশনের ধরণ : অ্যান্ড্রয়েড নির্বাচন করুন।
- প্যাকেজের নাম : আপনার AndroidManifest.xml- এ ঘোষিত প্যাকেজের নামটি ব্যবহার করুন।
- SHA-1 সার্টিফিকেট ফিঙ্গারপ্রিন্ট : পূর্ববর্তী ধাপগুলোতে প্রাপ্ত ফিঙ্গারপ্রিন্ট ব্যবহার করুন।
তৈরি করুন চাপুন।
প্রয়োজনীয় লাইব্রেরিগুলো অন্তর্ভুক্ত করুন
- আপনার অ্যাপের ডিপেন্ডেন্সিতে
com.google.android.gms:play-services-auth:16+অন্তর্ভুক্ত করুন। আপনি যদি কোড মিনিফিকেশন ব্যবহার করেন, তাহলে এটি আপনার অ্যাপের
build.gradleফাইলে যোগ করুন:buildTypes { release { ... proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } }আপনার অ্যাপের
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.** { *; }
আপনার অ্যাপটি এখন কীলেস অথেনটিকেশন ব্যবহার করার জন্য কনফিগার করা হয়েছে।
এপিআই কী
- গুগল ক্লাউডে, ক্রেডেনশিয়ালস পৃষ্ঠাটি খুলুন।
যোগ্যতা - Create credentials-এ ক্লিক করুন, তারপর মেনু থেকে API key নির্বাচন করুন।
এপিআই কী তৈরি করার ডায়ালগ বক্সে আপনার সদ্য তৈরি করা কী-টির স্ট্রিংটি প্রদর্শিত হয়। অ্যান্ড্রয়েড স্টুডিওতে, আপনার প্রজেক্টে নতুন API কী-টি যোগ করুন। আপনার অ্যাপের
AndroidManifest.xmlফাইলের<application>এলিমেন্টের ভেতরে একটি<meta-data>এলিমেন্টে API কী-টি অন্তর্ভুক্ত করুন:<meta-data android:name="com.google.android.ar.API_KEY" android:value="API_KEY"/>- আপনার এপিআই কী সুরক্ষিত করতে এপিআই কী-এর সীমাবদ্ধতা সংক্রান্ত ডকুমেন্টেশন পর্যালোচনা করুন।
আপনার অ্যাপটি এখন এপিআই কী ব্যবহার করার জন্য কনফিগার করা হয়েছে।
এরপর কী?
অনুমোদন কনফিগার করা হয়ে গেলে, এটি ব্যবহার করে এমন নিম্নলিখিত ARCore ফিচারগুলো দেখে নিন: