সচেতনতা API-তে, ফেন্স-এর ধারণাটি জিওফেন্সিং থেকে নেওয়া হয়েছে, এতে একটি ভৌগোলিক অঞ্চল বা জিওফেন্স নির্ধারণ করা হয় এবং কোনও ব্যবহারকারী জিওফেন্স অঞ্চলে প্রবেশ করলে বা বেরিয়ে গেলে, অ্যাপ কলব্যাক পায়। Fence API, ভৌগোলিক নৈকট্য ছাড়াও আরও অনেক প্রাসঙ্গিক শর্ত অন্তর্ভুক্ত করার জন্য জিওফেন্সিংয়ের ধারণাটিকে আরও প্রসারিত করে। কনটেক্সট স্টেট ট্রানজিশন হলে, অ্যাপ কলব্যাক পায়। যেমন, আপনার অ্যাপ যদি হেডফোনের জন্য একটি ফেন্স নির্ধারণ করে, তাহলে হেডফোন প্লাগ-ইন করা হলে এবং আনপ্লাগ করা হলে এটি কলব্যাক পায়।
আপনি Fence API ব্যবহার করে প্রসঙ্গ সিগন্যালের উপর ভিত্তি করে ফেন্স নির্ধারণ করতে পারেন, যেমন:
- ব্যবহারকারীর বর্তমান লোকেশন (অক্ষাংশ/দ্রাঘিমাংশ)
- ব্যবহারকারীর বর্তমান অ্যাক্টিভিটি, যেমন হাঁটা বা ড্রাইভিং করা।
- ডিভাইস-নির্দিষ্ট শর্ত, যেমন হেডফোন প্লাগ-ইন করা আছে কিনা।
- আশেপাশের বিকনের কাছাকাছি থাকা
Fence API আপনাকে একাধিক
প্রসঙ্গ সিগন্যাল
একত্রিত করে AND, OR এবং NOT বুলিয়ান অপারেটর সহ ফেন্স তৈরি করতে দেয়। ফেন্সের শর্ত পূরণ হলেই
আপনার অ্যাপ কলব্যাক পায়। সম্ভাব্য ফেন্সের কিছু উদাহরণের মধ্যে
নিম্নলিখিতগুলি পড়ে:
- ব্যবহারকারী হেডফোন কানে লাগিয়ে হাঁটতে শুরু করেন।
- সপ্তাহের কোনও দিন বিকেল ৫টার আগে ব্যবহারকারী ১০০-মিটার জিওফেন্সে প্রবেশ করেন।
- ব্যবহারকারী নির্দিষ্ট BLE বিকনের রেঞ্জ লিখছেন।
নিচের উদাহরণে দেখানো হয়েছে যে কীভাবে এমন একটি ফেন্স নির্ধারণ করতে হয় যা ব্যবহারকারী হাঁটলেই অ্যাক্টিভেট হয়ে যায়:
AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);
আপনি কোনও জিওফেন্স নির্ধারণ করার পরে, আপনাকে অবশ্যই নিম্নলিখিত কাজগুলি করতে হবে:
- কলব্যাক পেতে জিওফেন্স রেজিস্টার করতে
updateFencesনম্বরে কল করুন। - ফেন্সের স্ট্যাটাস পরিবর্তন হলে কলব্যাক করা যেতে পারে এমন একটি কলব্যাক নির্ধারণ করুন।
নিচের উদাহরণে একটি পদ্ধতি দেখানো হয়েছে যা একটি ফেঞ্চ তৈরি ও রেজিস্টার করে। এই
উদাহরণে, ফেন্স ট্রিগার করা হলে ইনটেন্ট ম্যানেজ করার জন্য BroadcastReceiver-এর কাস্টম সাবক্লাস
ব্যবহার করা হয়।
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);
}
}
}