フェンスの作成

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

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

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

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

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

上記の例では、during の呼び出しによって DetectedActivityFence が作成されています。これは、ユーザーが 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));

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