Начать

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

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

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

Получите ключ API.

Если вы еще не включили API Awareness и не получили ключ API Google, выполните действия, описанные в разделе «Регистрация и ключи 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.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: