डेवलपर के लिए दिशा-निर्देश

यहां दिए गए दिशा-निर्देशों की मदद से, Nearby Messages API और Nearby Connections API का इस्तेमाल करके अच्छी क्वालिटी वाले ऐप्लिकेशन बनाए जा सकते हैं.

उपयोगकर्ता की निजता का सम्मान करना

  • उपयोगकर्ता को यह समझने में मदद करें कि आपका ऐप्लिकेशन, आस-पास के उपयोगकर्ताओं को कौन-सा डेटा दिखाएगा.

  • पासवर्ड और क्रेडिट कार्ड नंबर जैसी संवेदनशील जानकारी पब्लिश न करें. इसके बजाय, अनुमति देने वाले टोकन या लेन-देन के आइडेंटिफ़ायर पास करें.

Nearby को शुरू करने के लिए, उपयोगकर्ता की साफ़ तौर पर की गई कार्रवाई की ज़रूरत होती है

  • उपयोगकर्ता को हैरान न करें. Nearby को चालू करने के लिए, उपयोगकर्ता को कोई कार्रवाई करनी होगी. जैसे, बटन पर टैप करना, ऐप्लिकेशन के किसी सेक्शन पर जाना, खास स्विच चालू करना वगैरह.

  • iOS और Android, दोनों पर Nearby Calling की सुविधा को पहली बार इस्तेमाल करने पर, Nearby से अनुमति लेने के लिए एक डायलॉग बॉक्स दिखेगा. Nearby को चालू करने से पहले, उपयोगकर्ता की कार्रवाई का इंतज़ार करने से उसे डायलॉग बॉक्स के बारे में ज़्यादा जानकारी मिलेगी. साथ ही, वह इसे आपके ऐप्लिकेशन की आस-पास के लोगों से जुड़ी सुविधा से जोड़ पाएगा.

बैटरी की खपत को ध्यान में रखें

Nearby की सुविधा के लिए रेडियो और सेंसर का इस्तेमाल करने से, आपका ऐप्लिकेशन सामान्य से 2.5 से 3.5 गुना ज़्यादा बैटरी इस्तेमाल करेगा. बैटरी का इस्तेमाल कम करने के लिए, यहां दिए गए सुझावों को अपनाएं.

  • Android पर, जब BLE के बिना काम करने वाले डिवाइसों से पब्लिश या सदस्यता ली जा रही हो, तब सिर्फ़ किसी गतिविधि से Nearby Messages API को चालू करें. साथ ही, स्क्रीन चालू होने पर और आपका ऐप्लिकेशन फ़ोरग्राउंड में होने पर ही उस गतिविधि को चालू रखें. इसके लिए, Nearby.getMessagesClient() के Context पैरामीटर में, गतिविधि को आर्ग्युमेंट के तौर पर पास करें. किसी सेवा से आस-पास मौजूद डिवाइसों से कनेक्ट करने की सुविधा सिर्फ़ तब काम करती है, जब ब्लूटूथ लो एनर्जी (बीएलई) बीकन मैसेज की सदस्यता ली गई हो.

  • Android पर, अपने ऐप्लिकेशन के Activity.onStop() कॉलबैक में, चालू पब्लिश या सदस्यता लेने वाले किसी भी व्यक्ति के लिए Nearby.getMessagesClient(Activity).unpublish() और Nearby.getMessagesClient(Activity).unsubscribe() को कॉल करें. iOS पर, आपको कुछ करने की ज़रूरत नहीं है, क्योंकि यह प्रोसेस अपने-आप मैनेज होती है.

  • उपयोगकर्ता के लिए, पब्लिश और सदस्यता लेने की सुविधा को बंद करना आसान बनाएं.

  • उपयोगकर्ता की जानकारी के बिना, बैकग्राउंड में पब्लिश या सदस्यता न लें.

सही ब्रैंडिंग का इस्तेमाल करना

  • हमने स्टैंडर्ड ऐसेट का एक सेट उपलब्ध कराया है. इसका इस्तेमाल करके, अपने ऐप्लिकेशन में Nearby की जानकारी दी जा सकती है. Nearby के बारे में बताते समय, सिर्फ़ मंज़ूरी वाले इन आइकॉन का इस्तेमाल करें.

  • PNG ऐसेट

  • SVG ऐसेट