ใน Awareness API แนวคิดเรื่องรั้วมาจากการกำหนดเขตพื้นที่เสมือน ซึ่งมีการกำหนดภูมิภาคหรือเขตพื้นที่เสมือน และแอปจะได้รับ Callback เมื่อผู้ใช้เข้าหรือออกจากเขตพื้นที่เสมือน Fence API ขยายแนวคิดของการกำหนดเขตพื้นที่เสมือนให้รวมเงื่อนไขบริบทอื่นๆ อีกมากมายนอกเหนือจากความใกล้ชิดทางภูมิศาสตร์ แอปจะได้รับ Callback ทุกครั้งที่สถานะบริบทเปลี่ยนไป ตัวอย่างเช่น หากแอปกำหนดขอบเขตสำหรับหูฟัง แอปจะได้รับ Callback เมื่อเสียบหูฟังและเมื่อถอดปลั๊กหูฟัง
คุณสามารถใช้ Fence API เพื่อกำหนด Fence ตามสัญญาณบริบท เช่น
- ตำแหน่งปัจจุบันของผู้ใช้ (ละติจูด/ลองจิจูด)
- กิจกรรมปัจจุบันของผู้ใช้ เช่น การเดินหรือการขับรถ
- เงื่อนไขเฉพาะอุปกรณ์ เช่น มีการเสียบหูฟังหรือไม่
- ระยะห่างจากบีคอนที่อยู่ใกล้เคียง
Fence API ช่วยให้คุณรวมสัญญาณบริบทหลายรายการเพื่อสร้าง Fence ด้วยโอเปอเรเตอร์บูลีน AND, OR และ NOT จากนั้นแอปจะได้รับ Callback เมื่อใดก็ตามที่ตรงตามเงื่อนไขของ Fence ตัวอย่างของขอบเขตที่อาจเป็นไปได้มีดังนี้
- ผู้ใช้เสียบหูฟังและเริ่มเดิน
- ผู้ใช้เข้าสู่เขตพื้นที่เสมือนขนาด 100 เมตรก่อนเวลา 17:00 น. ในวันธรรมดา
- ผู้ใช้เข้าสู่ช่วงของบีคอน BLE ที่เฉพาะเจาะจง
ตัวอย่างต่อไปนี้แสดงวิธีกำหนดรั้วที่เปิดใช้งานเมื่อใดก็ตามที่ผู้ใช้เดิน
AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);
เมื่อกำหนดขอบเขตแล้ว คุณต้องดำเนินการต่อไปนี้
- โทรหา
updateFencesเพื่อลงทะเบียนเขตเสมือนเพื่อรับการติดต่อกลับ - กำหนด Callback ที่เรียกใช้ได้เมื่อสถานะ Fence เปลี่ยนแปลง
ตัวอย่างต่อไปนี้แสดงเมธอดที่สร้างและลงทะเบียน Fence ในตัวอย่างนี้ ระบบจะใช้คลาสย่อยที่กำหนดเองของ BroadcastReceiver เพื่อจัดการ Intent เมื่อทริกเกอร์ Fence
Awareness.getFenceClient(this).updateFences(new FenceUpdateRequest.Builder()
.addFence(FENCE_KEY, exercisingWithHeadphonesFence, mPendingIntent)
.build())
.addOnSuccessListener(new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void aVoid) {
Log.i(TAG, "Fence was successfully registered.");
}
})
.addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(@NonNull Exception e) {
Log.e(TAG, "Fence could not be registered: " + e);
}
});
public class FenceReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
FenceState fenceState = FenceState.extract(intent);
if (TextUtils.equals(fenceState.getFenceKey(), FENCE_KEY)) {
String fenceStateStr;
switch (fenceState.getCurrentState()) {
case FenceState.TRUE:
fenceStateStr = "true";
break;
case FenceState.FALSE:
fenceStateStr = "false";
break;
case FenceState.UNKNOWN:
fenceStateStr = "unknown";
break;
default:
fenceStateStr = "unknown value";
}
mLogFragment.getLogView().println("Fence state: " + fenceStateStr);
}
}
}