‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

شروع به کار

اعلان منسوخ شدن: Awareness API منسوخ شده است.

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

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

قبل‌از شروع

دریافت کلید میانای API (کلید میانای برنامه‌سازی کاربردی)

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

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

در فایل build.gradle سطح پروژه، مخزن Maven متعلق به Google را در هر دو بخش buildscript و allprojects اضافه کنید:
```
buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}
```
وابستگی‌های Awareness API را به فایل Gradle سطح برنامه واحدتان اضافه کنید، که معمولاً app/build.gradle است:
```
dependencies {
  implementation 'com.google.android.gms:play-services-awareness:20.0.0'
}
```
«کلید میانای برنامه‌سازی کاربردی Awareness» را به فایل AndroidManifest.xml برنامه‌تان اضافه کنید. برای انجام این کار، برچسب <meta-data> را با android:name="com.google.android.awareness.API_KEY" اضافه کنید. برای android:value، «کلید میانای برنامه‌سازی کاربردی Awareness» خودتان را که با علامت نقل‌قول احاطه شده است وارد کنید.
```
<manifest>
    <application>
        <meta-data
            android:name="com.google.android.awareness.API_KEY"
            android:value="API_KEY"/>
    </application>
</manifest>
```
اجازه‌های لازم را به فایل AndroidManifest.xml برنامه‌تان اضافه کنید. اجازه‌های لازم بسته به روش‌های میانای برنامه‌سازی کاربردی و انواع حصاری که برنامه‌تان استفاده می‌کند متفاوت است.

تماس نمونه

نمونه فراخوانی زیر برای 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");
            }
        })

مراحل بعدی

درباره میاناهای برنامه‌سازی کاربردی مختلف در Awareness API بیشتر بدانید: