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

شروع به کار

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

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

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

قبل‌از شروع

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

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

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

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

allprojects {
    repositories {
        google()
    }
}
```
وابستگی‌های «میانای برنامه‌سازی کاربردی آگاهی» را به فایل Gradle سطح برنامه واحدتان اضافه کنید، که معمولاً app/build.gradle است:
```
dependencies {
  implementation 'com.google.android.gms:play-services-awareness:20.0.0'
}
```
«کلید API آگاهی» را به فایل 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» با میانای برنامه کاربردی «آگاهی» استفاده کنید:

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

مراحل بعدی

درباره میاناهای برنامه‌سازی کاربردی مختلف در «میانای برنامه‌سازی کاربردی آگاهی» بیشتر بدانید: