フェンスの作成

フェンスは、アプリが反応できるコンテキスト条件を 1 つ以上定義します。フェンスの状態が変化すると、アプリはコールバックを受け取ります。

フェンスには、コンテキスト シグナルの基本セットを表すプリミティブ フェンスと、ブール演算子を使用して複数のプリミティブ フェンスを組み合わせる組み合わせフェンスの 2 種類があります。すべてのフェンスは AwarenessFence のインスタンスです。

プリミティブ フェンスを作成する

コンテキスト シグナルの基本セットを表すプリミティブ フェンスは、awareness.fence パッケージで定義されます。次の例は、ユーザーの検出されたアクティビティが WALKING の場合は TRUE、それ以外の場合は FALSE になるシンプルなフェンスを作成する方法を示しています。

AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);

上記の例では、DetectedActivityFence は during の呼び出しによって作成されました。つまり、ユーザーが WALKING のときは常にフェンスが TRUE 状態になります。

遷移に対応する

TimeFence を除く各プリミティブ フェンスタイプは、コンテキスト状態が遷移するときに一時的にトリガーすることもできます。たとえば、ユーザーが starting または stopping のアクティビティを行っているときに、DetectedActivityFence を一時的にトリガーするように設定できます。切り替えフェンスは、数秒間 TRUE 状態になってから、再び FALSE に戻ります。

組み合わせフェンスを作成する

組み合わせフェンスは、ブール演算子を使用して複数のプリミティブ フェンスタイプを組み合わせます。次の例は、ユーザーが歩いていて、かつヘッドフォンが接続されている場合に有効になる複合フェンスの作成を示しています。

// Create the primitive fences.
AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);
AwarenessFence headphoneFence = HeadphoneFence.during(HeadphoneState.PLUGGED_IN);

// Create a combination fence to AND primitive fences.
AwarenessFence walkingWithHeadphones = AwarenessFence.and(
      walkingFence, headphoneFence
);

AND、OR、NOT のネストされたツリーは有効であるため、フェンスのブール値の組み合わせはすべて可能です。次の例は、ユーザーが現在地から 100 メートル以上移動したとき、または現在時刻から 1 時間以上経過したときにトリガーされるフェンスを示しています。

double currentLocationLat;  // current location latitude
double currentLocationLng;  // current location longitude
long nowMillis = System.currentTimeMillis();
long oneHourMillis = 1L * 60L * 60L * 1000L;

AwarenessFence orExample = AwarenessFence.or(
        AwarenessFence.not(LocationFence.in(
                currentLocationLat,
                currentLocationLng,
                100.0,
                100.0,
                0L)),
        TimeFence.inInterval(nowMillis + oneHourMillis, Long.MAX_VALUE));

次のステップ: フェンスを登録する。