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

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

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

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

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

'आस-पास' सुविधा शुरू करने के लिए उपयोगकर्ता की शुरू की गई खास कार्रवाई की ज़रूरत होगी

  • उपयोगकर्ता को हैरान न करें. उपयोगकर्ता को आस-पास की सुविधा चालू करने के लिए, कोई खास कार्रवाई करने (जैसे कि एक बटन पर टैप करना, आपके ऐप्लिकेशन में किसी सेक्शन पर जाना, कोई खास स्विच करना वगैरह) करना ज़रूरी हो.

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

बैटरी के खर्च का ध्यान रखें

आस-पास मौजूद रेडियो और सेंसर की वजह से आपका ऐप्लिकेशन सामान्य दर से 2.5-3.5 गुना ज़्यादा बैटरी खर्च कर पाएगा. बैटरी खर्च को कम करने के लिए, नीचे दिए गए सुझाव देखें.

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

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

  • उपयोगकर्ता के लिए चालू पब्लिकेशन और सदस्यता लेना आसान बनाना.

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

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

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

  • PNG एसेट

  • SVG एसेट