รั้วกำหนดเงื่อนไขบริบทอย่างน้อย 1 รายการที่แอปของคุณตอบสนองได้ เมื่อสถานะของรั้วเปลี่ยนแปลง แอปจะได้รับการเรียกกลับ
รั้วมี 2 ประเภท ได้แก่ รั้วดั้งเดิมซึ่งแสดงถึงชุดสัญญาณบริบทพื้นฐาน
และรั้วผสมซึ่งรวมรั้วดั้งเดิมหลายรั้วเข้าด้วยกันโดยใช้
โอเปอเรเตอร์บูลีน รั้วทั้งหมดเป็นอินสแตนซ์ของ AwarenessFence
สร้างรั้วแบบง่าย
รั้วพื้นฐานซึ่งแสดงถึงชุดสัญญาณบริบทพื้นฐานจะกำหนดไว้ในแพ็กเกจ awareness.fence
ตัวอย่างต่อไปนี้แสดงการสร้างรั้วอย่างง่ายซึ่งจะTRUE
เมื่อกิจกรรมที่ตรวจพบของผู้ใช้คือWALKING
และFALSEในกรณีอื่นๆ
AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);
ในตัวอย่างก่อนหน้านี้ DetectedActivityFence
สร้างขึ้นโดยการเรียกใช้ during
ซึ่งหมายความว่ารั้วจะอยู่ในสถานะ TRUE ทุกครั้งที่ผู้ใช้อยู่ใน WALKING
รีแอ็กต่อทรานซิชัน
รั้วกั้นแต่ละประเภท ยกเว้น TimeFence ยังสามารถ
ทริกเกอร์ชั่วขณะเมื่อสถานะบริบทเปลี่ยน เช่น คุณสามารถ
ตั้งค่า DetectedActivityFence ให้ทริกเกอร์ชั่วคราวเมื่อผู้ใช้
starting
หรือ
stopping
กิจกรรม รั้วเปลี่ยนสถานะจะอยู่ในสถานะ TRUE เป็นเวลา 2-3 วินาทีก่อนที่จะเปลี่ยนเป็น 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));
ขั้นตอนถัดไป: ลงทะเบียนรั้ว