ภาพรวมของ Fence API

ใน API การรับรู้ แนวคิดของรั้วจะนํามาจากเขตพื้นที่เสมือน ซึ่งมีการกําหนดภูมิภาคหรือเขตพื้นที่เสมือน และแอปจะได้รับการเรียกกลับเมื่อผู้ใช้ป้อนหรือออกจากเขตพื้นที่เสมือน Fence API ขยายแนวคิดของการกําหนดเขตพื้นที่เสมือนให้รวมเงื่อนไขบริบทอื่นๆ อีกจํานวนมากนอกเหนือจากความใกล้เคียงทางภูมิศาสตร์ แอปจะได้รับโค้ดเรียกกลับทุกครั้งที่บริบทบริบทเปลี่ยนแปลง ตัวอย่างเช่น หากแอปกําหนดรั้วของหูฟัง ก็จะมีการเรียกกลับเมื่อเสียบหูฟังและเมื่อถอดปลั๊ก

คุณใช้ Fence API เพื่อระบุรั้วโดยอิงตามสัญญาณบริบทได้ เช่น

• ตําแหน่งปัจจุบันของผู้ใช้ (ละติจูด/ลองจิจูด)
• กิจกรรมปัจจุบันของผู้ใช้ เช่น การเดินหรือขับรถ
• เงื่อนไขเฉพาะของอุปกรณ์ เช่น ต่อหูฟังไหม
• ระยะห่างจากบีคอนที่อยู่ใกล้เคียง

Fence API ช่วยให้คุณรวมสัญญาณบริบทหลายรายการเพื่อสร้างรั้วที่มีโอเปอเรเตอร์บูลีน AND, OR และ NOT ได้ จากนั้นแอปของคุณจะได้รับโค้ดเรียกกลับทุกครั้งที่คําขออยู่ในเงื่อนไขของรั้ว ตัวอย่างของรั้วที่เป็นไปได้ มีดังต่อไปนี้

• ผู้ใช้เสียบหูฟังและเริ่มเดิน
• ผู้ใช้ป้อนเขตพื้นที่เสมือน 100 เมตรก่อน 17:00 น. ทุกวันธรรมดา
• ผู้ใช้ป้อนช่วงของบีคอน BLE ที่เฉพาะเจาะจง

ตัวอย่างต่อไปนี้แสดงวิธีกําหนดรั้วที่จะเปิดใช้งานทุกครั้งที่ผู้ใช้เดิน

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

เมื่อคุณได้กําหนดรั้วแล้ว คุณต้องดําเนินการต่อไปนี้:

• โทรหา updateFences เพื่อลงทะเบียนรั้วเพื่อรับสายติดต่อกลับ
• กําหนดโค้ดเรียกกลับที่เรียกใช้ได้เมื่อสถานะรั้วมีการเปลี่ยนแปลง

ตัวอย่างต่อไปนี้แสดงวิธีสร้างและบันทึกรั้ว ในตัวอย่างนี้ มีการใช้คลาสย่อยที่กําหนดเองของ BroadcastReceiver ในการจัดการ Intent เมื่อมีการเรียกใช้รั้ว

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);
        }
    }
}