Fence API'ye genel bakış

Farkındalık API'sinde çitler kavramı, coğrafi sınırlamadan alınmıştır. Coğrafi sınırlamada bir coğrafi bölge veya coğrafi sınır tanımlanır ve bir kullanıcı coğrafi sınırlama bölgesine girdiğinde ya da bu bölgeden çıktığında uygulamaya geri çağırma işlemleri gönderilir. Fence API, coğrafi yakınlığa ek olarak birçok bağlam koşulunu da içerecek şekilde coğrafi sınırlama kavramını genişletir. Bir uygulama, bağlam durumu her değiştiğinde geri çağırma alır. Örneğin, uygulamanız kulaklıklar için bir sınır tanımlarsa kulaklıklar takıldığında ve çıkarıldığında geri çağırma işlemleri gerçekleşir.

Aşağıdakiler gibi bağlam sinyallerine dayalı çitler tanımlamak için Fence API'yi kullanabilirsiniz:

• Kullanıcının mevcut konumu (enlem/boylam)
• Kullanıcının yürüme veya araba kullanma gibi mevcut etkinliği.
• Kulaklığın takılı olup olmadığı gibi cihaza özel koşullar
• Yakındaki beacon'lara yakınlık

Fence API, AND, OR ve NOT Boole operatörleriyle çitler oluşturmak için birden fazla bağlam sinyalini birleştirmenize olanak tanır. Ardından, çit koşulları karşılandığında uygulamanız geri çağırma işlemleri alır. Olası sınırlara ilişkin bazı örnekler:

• Kullanıcı kulaklıklarını takıp yürümeye başlıyor.
• Kullanıcı, hafta içi saat 17:00'den önce 100 metrelik bir coğrafi sınıra giriyor.
• Kullanıcı, belirli bir BLE işaretçisinin aralığını girer.

Aşağıdaki örnekte, kullanıcı yürüdüğünde etkinleşen bir çitin nasıl tanımlanacağı gösterilmektedir:

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

Bir çit tanımladıktan sonra şunları yapmanız gerekir:

• Geri arama almak için çiti kaydetmek üzere updateFences işlevini çağırın.
• Çit durumu değiştiğinde çağrılabilecek bir geri çağırma tanımlayın.

Aşağıdaki örnekte, çit oluşturan ve kaydeden bir yöntem gösterilmektedir. Bu örnekte, çit tetiklendiğinde amacı işlemek için BroadcastReceiver öğesinin özel bir alt sınıfı kullanılır.

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