شروع کنید

این سند نحوه شروع توسعه با API Aware در Android را توضیح می دهد. Awareness API بخشی از خدمات Google Play است.

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

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

یک کلید API دریافت کنید

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

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

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

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

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

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

  3. Awareness API Key خود را به فایل 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 و انواع حصاری که برنامه شما استفاده می کند، مجوزهای مورد نیاز متفاوت است.

تماس مثال

فراخوانی مثال زیر برای getDetectedActivity() نحوه استفاده از مدل خدمات بدون اتصال Google Play را با 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 های مختلف در API Awareness بیشتر بیاموزید: