শুরু করুন

এই ডকুমেন্টটিতে অ্যান্ড্রয়েডে অ্যাওয়ারনেস এপিআই (Awareness API) ব্যবহার করে কীভাবে ডেভেলপমেন্ট শুরু করতে হয়, তা ব্যাখ্যা করা হয়েছে। অ্যাওয়ারনেস এপিআই হলো গুগল প্লে সার্ভিসেস- এর একটি অংশ।

অ্যাওয়ারনেস এপিআই ব্যবহার করার জন্য আপনার একটি গুগল অ্যাকাউন্ট প্রয়োজন। যদি আপনার আগে থেকেই একটি অ্যাকাউন্ট থাকে, তাহলে আর কিছু করার দরকার নেই। পরীক্ষার উদ্দেশ্যে আপনার একটি আলাদা গুগল অ্যাকাউন্টেরও প্রয়োজন হতে পারে।

শুরু করার আগে

একটি এপিআই কী সংগ্রহ করুন

আপনি যদি এখনও অ্যাওয়ারনেস এপিআই (Awareness API) সক্রিয় না করে থাকেন এবং গুগল এপিআই কী (Google API key) না পেয়ে থাকেন, তবে তা করার জন্য সাইনআপ এবং এপিআই কী (Signup and API keys) অংশে দেওয়া ধাপগুলো অনুসরণ করুন।

আপনার অ্যাপ কনফিগার করুন

  1. আপনার প্রোজেক্ট-স্তরের build.gradle ফাইলে, buildscript এবং allprojects উভয় সেকশনেই Google-এর Maven রিপোজিটরি অন্তর্ভুক্ত করুন:

    buildscript {
        repositories {
            google()
        }
    }
    
    allprojects {
        repositories {
            google()
        }
    }
    
  2. আপনার মডিউলের অ্যাপ-লেভেল গ্রেডল ফাইলে (যা সাধারণত app/build.gradle হয়) অ্যাওয়ারনেস এপিআই-এর জন্য প্রয়োজনীয় ডিপেন্ডেন্সিগুলো যোগ করুন:

    dependencies {
      implementation 'com.google.android.gms:play-services-awareness:20.0.0'
    }
    
  3. আপনার অ্যাপের AndroidManifest.xml ফাইলে আপনার Awareness API Key যোগ করুন। এটি করার জন্য, android:name="com.google.android.awareness.API_KEY" সহ একটি <meta-data> ট্যাগ যোগ করুন। android:value জন্য, উদ্ধৃতি চিহ্নের মধ্যে আপনার নিজের Awareness API Key প্রবেশ করান।

    <manifest>
        <application>
            <meta-data
                android:name="com.google.android.awareness.API_KEY"
                android:value="API_KEY"/>
        </application>
    </manifest>
  4. আপনার অ্যাপের AndroidManifest.xml ফাইলে প্রয়োজনীয় অনুমতিগুলো যোগ করুন। আপনার অ্যাপ যে API মেথড এবং ফেন্স টাইপ ব্যবহার করে, তার উপর নির্ভর করে প্রয়োজনীয় অনুমতিগুলো ভিন্ন হতে পারে।

উদাহরণ কল

getDetectedActivity() এর নিম্নলিখিত উদাহরণ কলটি দেখায় কিভাবে Awareness API-এর সাথে সংযোগহীন Google Play পরিষেবা মডেল ব্যবহার করতে হয়:

    // Each type of contextual information in the snapshot API has a corresponding "get" method.
    // For instance, this is how to get the user's current Activity.
    Awareness.getSnapshotClient(this).getDetectedActivity()
        .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
            @Override
            public void onSuccess(DetectedActivityResponse dar) {
                ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
                // getMostProbableActivity() is good enough for basic Activity detection.
                // To work within a threshold of confidence,
                // use ActivityRecognitionResult.getProbableActivities() to get a list of
                // potential current activities, and check the confidence of each one.
                DetectedActivity probableActivity = arr.getMostProbableActivity();

                int confidence = probableActivity.getConfidence();
                String activityStr = probableActivity.toString();
                mLogFragment.getLogView().println("Activity: " + activityStr
                    + ", Confidence: " + confidence + "/100");
            }
        })

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

অ্যাওয়ারনেস এপিআই-এর অন্তর্ভুক্ত বিভিন্ন এপিআই সম্পর্কে আরও জানুন: