Awareness API

Google I/O 2016 では Firebase や Instant Apps などが大いに注目されているが、個人的には Awareness API が凄く魅力的だった。

Awareness API の概要

Awareness API は、 Super easy make to your application. な API とのこと。

Awareness API では、７種のコンテキストを取得することが可能。

Context	Example
Location	Latitude and longitude
Place	Place, including place type
Beacons	Nearby beacons (including namespace, type, and content)
Time	Current local time
Activity	Detected user activity (walking, running, biking)
Headphones	Are headphones plugged in?
Weather	Current weather conditions

Awareness API の用途

上記の情報を取得できることから、ユーザーを取り巻く環境に反応してアプリの挙動を変えるときに有効と思われる。

例えば、

くるまでドライブ（Activity）してて、
特定のお店の近く（Location/Place）を走っていたとき、
そのお店が営業中（Time）だったら、
リマインドを促す。

みたいな。

Awareness API の魅力

インターフェースがシンプル

上記の挙動を実装する場合、旧来だと、主に次のような API を駆使して実現していた。

それぞれの API を呼び出す実装を、更に組み合わせてごにょごにょする... 実装コストとしてはかなり高め。

それを解消するのが Awareness API 。

Awareness API は直感的なインターフェースの API なので、実装コストは旧来より格段に下がってる。

// 「ドライブ開始」の条件設定...
AwarenessFence startDriving = DetectedActivityFence.starting(
        DetectedActivityFence.IN_VEHICLE);

// 「ドライブ中」の条件設定...
AwarenessFence duringDriving = DetectedActivityFence.during(
        DetectedActivityFence.IN_VEHICLE);

// 「特定のお店の近く」の条件設定...
AwarenessFence areaAroundStore = LocationFence.in(
        STORE_LATITUDE, STORE_LONGITUDE,
        1000 /* radius in meters */, 0L /* dwell time */);

// 「お店の営業時刻」の条件設定...
AwarenessFence openHours = TimeFence.inDailyInterval(TimeZone.getDefault(),
        10 * HOURS_IN_MILLIS, 18 + HOURS_IN_MILLIS);

// 「ドライブ中」「お店の近く」「お店の営業時間」の複数条件をまとめて...
AwarenessFence drivingNearStore = AwarenessFence.and(
        areaAroundStore,
        duringDriving,
        openHours);

// 更新リクエストのビルダークラスをインスタンス化
// ・「ドライブ開始したとき」
// ・「営業時間内のお店の近くをドライブしてるとき」の条件を設定...
FenceUpdateRequest fenceUpdateRequest = new FenceUpdateRequest.Builder()
        .addFence("startDriving", startDriving, pendingIntent)
        .addFence("drivingNearStore", drivingNearStore, pendingIntent)
        .build();

// 更新リクエストを投げる
Awareness.FenceApi.updateFences(googleApiClient, fenceUpdateRequest);

リクエストしたので、コールバック処理を実装。

void onReceive(Context context, Intent intent) {
    FenceState fenceState = FenceState.extract(intent);

    if (fenceState.getFenceKey().equals("startDriving")) {
        if (fenceState.getCurrentState() == FenceState.TRUE) {
          // ドライブ開始したので、マップを表示する
        }
    } else if (fenceState.getFenceKey().equals("drivingNearStore")) {
        if (fenceState.getCurrentState() == FenceState.TRUE) {
          // 営業中のお店の近くを走ってるので、そのお店に紐づく予定をリマインド
        }
    }
}

見たまんま、凄くシンプルで直感的なインターフェース。

Awareness API からコンテキストを取得する方法は２つ。

Fence API

上記に示した実装例が Fence API で、登録した条件下に合致したらコールバックされる。

Snapshot API

現在のユーザーのコンテキストを取得する。

PlacesResult placesResult = Awareness.SnapshotApi.getPlaces(googleApiClient).await();
WeatherResult weatherResult = Awareness.SnapshotApi.getWeather(googleApiClient).await();

バッテリー/メモリ使用を最適化

Awareness API のほうでバッテリー/メモリ容量を最適にしてくれるので、API 使用側はあまり意識せずに済む。

Smart battery savings

Power consumption and memory usage are automatically optimized to maximize battery life and memory capacity on your users' devices.

Awareness API の効果

これだけシンプルなインターフェースであれば、複雑な条件のユーザー環境内にアプリのコンテンツを訴求するための実装や評価結果による改善など、PDCA の足かせにならずに済みそう。（複雑な API は実装/テストのし辛さが目立つので）

また、バッテリーやメモリの面倒も見てくれるとのことなので、低スペック端末や古い OS version をサポートしているアプリなどでも導入敷居は低いと思った。

以上です。補足・修正あればご指摘ください。

Awareness API - Google I/O 2016