ภาพรวมของ Fence API

ใน Awareness 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);
        }
    }
}