शुरू करें

इस दस्तावेज़ में बताया गया है कि Android पर अवेयरनेस एपीआई के साथ डेवलपमेंट कैसे शुरू किया जाए. अवेयरनेस एपीआई, Google Play services का हिस्सा है.

अवेयरनेस एपीआई का इस्तेमाल करने के लिए, आपके पास Google खाता होना ज़रूरी है. अगर आपके पास पहले से खाता है, तो आप बिलकुल तैयार हैं. आप जाँच के लिए एक अलग Google खाता भी बना सकते हैं.

शुरू करने से पहले

एपीआई कुंजी पाना

अगर आपने पहले से अवेयरनेस एपीआई चालू नहीं किया है और आपको Google API कुंजी मिली है, तो ऐसा करने के लिए साइन अप और एपीआई कुंजियों को पूरा करें.

अपना ऐप्लिकेशन कॉन्फ़िगर करें

  1. अपने प्रोजेक्ट-लेवल की build.gradle फ़ाइल में, अपने buildscript और allprojects दोनों सेक्शन में Google का मेवन रिपॉज़िटरी शामिल करें:

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. अपने मॉड्यूल की ऐप्लिकेशन-लेवल ग्रेड फ़ाइल में अवेयरनेस एपीआई के लिए डिपेंडेंसी जोड़ें, जो आम तौर पर app/build.gradle होती है:

    dependencies {
  implementation 'com.google.android.gms:play-services-awareness:19.0.1'
}

  3. अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में, जागरूकता एपीआई कुंजी जोड़ें. ऐसा करने के लिए, android:name="com.google.android.awareness.API_KEY" के साथ <meta-data> टैग जोड़ें. android:value के लिए, खुद की अवेयरनेस एपीआई कुंजी डालें, जो कोटेशन मार्क से घिरी होती है.

    <manifest>
    <application>
        <meta-data
            android:name="com.google.android.awareness.API_KEY"
            android:value="API_KEY"/>
    </application>
</manifest>

  4. अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में ज़रूरी अनुमतियां जोड़ें. आपके ऐप्लिकेशन में इस्तेमाल किए जाने वाले एपीआई के तरीके और फ़ेंस के टाइप के आधार पर, यह ज़रूरी अनुमतियां अलग-अलग होती हैं.

कॉल का उदाहरण

यहां दिए गए उदाहरण में, getDetectedActivity() को कॉल किया गया है. इसमें बताया गया है कि कनेक्शन के बिना, Google Play services की मदद से, बिना कनेक्शन वाले Google मॉडल का इस्तेमाल कैसे किया जा सकता है:

    // 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");
            }
        })

अगले चरण

अवेयरनेस एपीआई में मौजूद अलग-अलग एपीआई के बारे में ज़्यादा जानें: