Начать

В этом документе объясняется, как начать разработку с помощью Awareness API для Android. Awareness API является частью сервисов Google Play .

Чтобы использовать Awareness API, вам понадобится учетная запись Google . Если у вас уже есть учетная запись, то все готово. Вам также может понадобиться отдельная учетная запись Google для целей тестирования.

Прежде чем начать

Получить ключ API

Если вы еще не включили Awareness API и не получили ключ Google API, для этого выполните действия, описанные в разделах «Регистрация и ключи API» .

Настройте свое приложение

  1. В файле build.gradle уровня проекта включите репозиторий Google Maven как в разделы 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.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 и типов ограждений, которые использует ваше приложение.

Пример звонка

В следующем примере вызова getDetectedActivity() показано, как использовать модель сервисов Google Play без установления соединения с API Awareness:

    // 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: