شروع به کار

این سند نحوه شروع توسعه با Awareness API در اندروید را توضیح می‌دهد. Awareness API بخشی از سرویس‌های گوگل پلی است.

برای استفاده از Awareness API، به یک حساب کاربری گوگل نیاز دارید. اگر از قبل حساب کاربری دارید، همه چیز آماده است. همچنین ممکن است برای اهداف آزمایشی به یک حساب کاربری گوگل جداگانه نیاز داشته باشید.

قبل از اینکه شروع کنی

دریافت کلید API

اگر قبلاً Awareness API را فعال نکرده‌اید و کلید Google API دریافت نکرده‌اید، مراحل موجود در Signup و API keys را برای انجام این کار دنبال کنید.

برنامه خود را پیکربندی کنید

1. در فایل build.gradle در سطح پروژه، مخزن Maven گوگل را هم در بخش‌های buildscript و هم allprojects وارد کنید:

   buildscript {
       repositories {
           google()
       }
   }
   
   allprojects {
       repositories {
           google()
       }
   }
   

2. وابستگی‌های API مربوط به Awareness را به فایل Gradle سطح برنامه ماژول خود که معمولاً app/build.gradle است، اضافه کنید:

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

3. کلید API مربوط به Awareness خود را به فایل AndroidManifest.xml برنامه خود اضافه کنید. برای انجام این کار، یک تگ <meta-data> با android:name="com.google.android.awareness.API_KEY" اضافه کنید. برای android:value ، کلید API مربوط به Awareness خود را که بین علامت نقل قول قرار دارد، وارد کنید.

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

4. مجوزهای لازم را به فایل AndroidManifest.xml برنامه خود اضافه کنید. مجوزهای مورد نیاز بسته به متدهای API و انواع fence که برنامه شما استفاده می‌کند، متفاوت است.

مثال فراخوانی

مثال زیر نحوه استفاده از مدل بدون getDetectedActivity() سرویس‌های گوگل پلی را با Awareness API نشان می‌دهد:

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

مراحل بعدی

درباره APIهای مختلف درون Awareness API بیشتر بدانید:

• راهنمای API اسنپ‌شات و مرجع API اسنپ‌شات .
• راهنمای API حصار و مرجع API حصار .