फ़ेंस बनाएं

फ़ेंस, एक या उससे ज़्यादा कॉन्टेक्स्ट की शर्तों को तय करता है. आपका ऐप्लिकेशन इन शर्तों के हिसाब से काम कर सकता है. किसी फ़ेंस की स्थिति बदलने पर, आपके ऐप्लिकेशन को कॉलबैक मिलता है.

जियोफ़ेंस दो तरह के होते हैं: प्रिमिटिव फ़ेंस, जो कॉन्टेक्स्ट के बुनियादी सेट के सिग्नल दिखाते हैं. वहीं, कॉम्बिनेशन फ़ेंस, बूलियन ऑपरेटर का इस्तेमाल करके कई प्रिमिटिव फ़ेंस को जोड़ते हैं. सभी फ़ेंस, AwarenessFence के इंस्टेंस होते हैं.

प्रिमिटिव फ़ेंस बनाना

प्रिमिटिव फ़ेंस, कॉन्टेक्स्ट सिग्नल के बुनियादी सेट को दिखाते हैं. इन्हें awareness.fence पैकेज में तय किया जाता है. यहां एक सामान्य फ़ेंस बनाने का उदाहरण दिया गया है. इसमें बताया गया है कि जब उपयोगकर्ता की गतिविधि WALKING के तौर पर पता चलती है, तब फ़ेंस TRUE होता है. इसके अलावा, फ़ेंस FALSE होता है:

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

ऊपर दिए गए उदाहरण में, DetectedActivityFence को during को कॉल करके बनाया गया था. इसका मतलब है कि जब भी उपयोगकर्ता WALKING होता है, तब फ़ेंस TRUE स्थिति में होता है.

ट्रांज़िशन पर प्रतिक्रिया देना

TimeFence को छोड़कर, हर प्रिमिटिव फ़ेंस टाइप को कॉन्टेक्स्ट की स्थिति बदलने पर कुछ समय के लिए ट्रिगर किया जा सकता है. उदाहरण के लिए, किसी उपयोगकर्ता के starting या stopping होने पर, कुछ समय के लिए ट्रिगर होने वाला DetectedActivityFence सेट किया जा सकता है. ट्रांज़िशन फ़ेंस, कुछ सेकंड के लिए TRUE स्थिति में होते हैं. इसके बाद, वे फिर से FALSE स्थिति में आ जाते हैं.

कॉम्बिनेशन फ़ेंस बनाना

कॉम्बिनेशन फ़ेंस, कई प्रिमिटिव फ़ेंस टाइप को बूलियन ऑपरेटर के साथ जोड़ते हैं. यहां दिए गए उदाहरण में, एक ऐसा कॉम्बिनेशन फ़ेंस बनाया गया है जो तब चालू होता है, जब उपयोगकर्ता चल रहा हो और हेडफ़ोन प्लग इन किए गए हों:

// Create the primitive fences.
AwarenessFence walkingFence = DetectedActivityFence.during(DetectedActivityFence.WALKING);
AwarenessFence headphoneFence = HeadphoneFence.during(HeadphoneState.PLUGGED_IN);

// Create a combination fence to AND primitive fences.
AwarenessFence walkingWithHeadphones = AwarenessFence.and(
      walkingFence, headphoneFence
);

AND, OR, और NOT के नेस्ट किए गए ट्री मान्य होते हैं. इसलिए, फ़ेंस का कोई भी बूलियन कॉम्बिनेशन इस्तेमाल किया जा सकता है. यहां दिए गए उदाहरण में, एक फ़ेंस दिखाया गया है. यह तब ट्रिगर होता है, जब कोई उपयोगकर्ता मौजूदा जगह से 100 मीटर से ज़्यादा दूर चला जाता है या मौजूदा समय से एक घंटा बीत जाता है.

double currentLocationLat;  // current location latitude
double currentLocationLng;  // current location longitude
long nowMillis = System.currentTimeMillis();
long oneHourMillis = 1L * 60L * 60L * 1000L;

AwarenessFence orExample = AwarenessFence.or(
        AwarenessFence.not(LocationFence.in(
                currentLocationLat,
                currentLocationLng,
                100.0,
                100.0,
                0L)),
        TimeFence.inInterval(nowMillis + oneHourMillis, Long.MAX_VALUE));

अगला चरण: जियोफ़ेंस रजिस्टर करें.