Начать

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

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

Прежде чем вы начнете

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

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

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