शुरू करना
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
इस दस्तावेज़ में, Android पर Awareness API का इस्तेमाल करके ऐप्लिकेशन बनाने का तरीका बताया गया है. Awareness API, Google Play services का हिस्सा है.
Awareness API का इस्तेमाल करने के लिए, आपके पास Google खाता होना चाहिए.
अगर आपके पास पहले से कोई खाता है, तो आपको कुछ करने की ज़रूरत नहीं है. हो सकता है कि आपको जांच के लिए, एक अलग Google खाता भी चाहिए.
शुरू करने से पहले
एपीआई पासकोड पाना
अगर आपने अब तक Awareness API को चालू नहीं किया है और Google API पासकोड नहीं लिया है, तो ऐसा करने के लिए साइन अप और एपीआई पासकोड में दिया गया तरीका अपनाएं.
प्रोजेक्ट-लेवल की build.gradle फ़ाइल में, buildscript और allprojects, दोनों सेक्शन में Google की Maven रिपॉज़िटरी शामिल करें:
buildscript {
repositories {
google()
}
}
allprojects {
repositories {
google()
}
}
अपने मॉड्यूल की ऐप्लिकेशन-लेवल वाली Gradle फ़ाइल में, Awareness API की डिपेंडेंसी जोड़ें. आम तौर पर, यह फ़ाइल app/build.gradle होती है:
dependencies {
implementation 'com.google.android.gms:play-services-awareness:19.1.0'
}
अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में, Awareness API पासकोड जोड़ें. ऐसा करने के लिए, android:name="com.google.android.awareness.API_KEY" के साथ <meta-data> टैग जोड़ें. android:value के लिए, अपनी Awareness API पासकोड डालें और उसे कोटेशन मार्क में रखें.
<manifest>
<application>
<meta-data
android:name="com.google.android.awareness.API_KEY"
android:value="API_KEY"/>
</application>
</manifest>अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में ज़रूरी अनुमतियां जोड़ें. ज़रूरी अनुमतियां, एपीआई के तरीकों और आपके ऐप्लिकेशन में इस्तेमाल किए जाने वाले फ़ेंस टाइप के आधार पर अलग-अलग होती हैं.
कॉल का उदाहरण
getDetectedActivity() के लिए दिए गए उदाहरण में, Awareness API के साथ कनेक्ट किए बिना काम करने वाले Google Play services मॉडल का इस्तेमाल करने का तरीका बताया गया है:
// 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");
}
})
अगले चरण
Awareness API में मौजूद अलग-अलग एपीआई के बारे में ज़्यादा जानें:
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2025-08-31 (UTC) को अपडेट किया गया.
[null,null,["आखिरी बार 2025-08-31 (UTC) को अपडेट किया गया."],[[["\u003cp\u003eThis documentation provides a guide on how to start developing with the Awareness API on Android, which is part of Google Play services and requires a Google Account.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, developers need to obtain an API key, configure their app by adding necessary dependencies and permissions in the \u003ccode\u003ebuild.gradle\u003c/code\u003e and \u003ccode\u003eAndroidManifest.xml\u003c/code\u003e files, respectively, and include their API key in the manifest.\u003c/p\u003e\n"],["\u003cp\u003eAn example call demonstrates using the connectionless Google Play services model with the Awareness API, specifically showing how to get the user's current activity using the \u003ccode\u003egetDetectedActivity()\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can further explore the Awareness API through the Snapshot API and Fence API guides and references for more advanced functionalities.\u003c/p\u003e\n"]]],["To begin using the Awareness API, obtain a Google API key and configure your Android app. This involves adding Google's Maven repository to your project's `build.gradle` file and including the Awareness API dependency in your module's `build.gradle`. Insert your API key into `AndroidManifest.xml` and add necessary permissions, depending on the API methods used. The `getDetectedActivity()` example shows how to retrieve the user's current activity.\n"],null,["# Get started\n\nThis document explains how to start to develop with the Awareness API on\nAndroid. The Awareness API is part of [Google Play services](/android/guides/overview).\n\nTo use the Awareness API, you need a [Google Account](//www.google.com/accounts/NewAccount).\nIf you already have an account, then you're all set. You might also want a\nseparate Google Account for testing purposes.\n\nBefore you begin\n----------------\n\n### Obtain an API key\n\nIf you haven't already enabled the Awareness API and obtained a Google API key,\nfollow the steps in [Signup and API keys](/awareness/android-api/get-a-key)\nto do so.\n\n### Configure your app\n\n1. In your project-level `build.gradle` file, include Google's Maven repository\n in both your `buildscript` and `allprojects` sections:\n\n buildscript {\n repositories {\n google()\n }\n }\n\n allprojects {\n repositories {\n google()\n }\n }\n\n2. Add the dependencies for the Awareness API to your module's app-level\n Gradle file, which is usually `app/build.gradle`:\n\n dependencies {\n implementation 'com.google.android.gms:play-services-awareness:19.1.0'\n }\n\n3. Add your Awareness API Key to your app's `AndroidManifest.xml` file. To do\n so, add a `\u003cmeta-data\u003e` tag with\n `android:name=\"com.google.android.awareness.API_KEY\"`. For `android:value`,\n insert your own Awareness API Key, surrounded by quotation marks.\n\n ```xml\n \u003cmanifest\u003e\n \u003capplication\u003e\n \u003cmeta-data\n android:name=\"com.google.android.awareness.API_KEY\"\n android:value=\"\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\"/\u003e\n \u003c/application\u003e\n \u003c/manifest\u003e\n ```\n4. Add the necessary permissions to your app's `AndroidManifest.xml` file. The\n required permissions vary, depending on the API methods and fence types that\n your app uses.\n\nExample call\n------------\n\nThe following example call to\n[`getDetectedActivity()`](/android/reference/com/google/android/gms/awareness/SnapshotClient#getDetectedActivity())\ndemonstrates how to use the connectionless Google Play services model with the\nAwareness API: \n\n // Each type of contextual information in the snapshot API has a corresponding \"get\" method.\n // For instance, this is how to get the user's current Activity.\n Awareness.getSnapshotClient(this).getDetectedActivity()\n .addOnSuccessListener(new OnSuccessListener\u003cDetectedActivityResponse\u003e() {\n @Override\n public void onSuccess(DetectedActivityResponse dar) {\n ActivityRecognitionResult arr = dar.getActivityRecognitionResult();\n // getMostProbableActivity() is good enough for basic Activity detection.\n // To work within a threshold of confidence,\n // use ActivityRecognitionResult.getProbableActivities() to get a list of\n // potential current activities, and check the confidence of each one.\n DetectedActivity probableActivity = arr.getMostProbableActivity();\n\n int confidence = probableActivity.getConfidence();\n String activityStr = probableActivity.toString();\n mLogFragment.getLogView().println(\"Activity: \" + activityStr\n + \", Confidence: \" + confidence + \"/100\");\n }\n })\n\nNext steps\n----------\n\nLearn more about the different APIs within the Awareness API:\n\n- [Snapshot API guide](/awareness/android-api/snapshot-api-overview) and [Snapshot API reference](/android/reference/com/google/android/gms/awareness/snapshot/package-summary).\n- [Fence API guide](/awareness/android-api/fence-api-overview) and [Fence API\n reference](/android/reference/com/google/android/gms/awareness/fence/package-summary)."]]
