विज्ञापन दें और खोजें

उपयोगकर्ता के सभी ज़रूरी अनुमतियां मिलने के बाद, आपका ऐप्लिकेशन ये काम शुरू कर सकता है आस-पास के डिवाइस खोजने के लिए विज्ञापन देना और खोजना.

सबसे पहले, अपने इस्तेमाल के उदाहरण के लिए, कोई Strategy चुनें. आपके चुने गए Strategy से, आपके ऐप्लिकेशन के लिए कनेक्शन टोपोलॉजी का पता चलता है (एक विज्ञापन देने वाले लोग या कंपनियां, N खोज करने वाले लोगों को या M को विज्ञापन देने वाले लोगों या कंपनियों को N खोजने वाले लोगों को देती हैं.

विज्ञापन दिखाने वाले डिवाइसों पर, अपनी पसंद के मुताबिक startAdvertising() को कॉल करें Strategy और एक serviceId पैरामीटर जो आपके ऐप्लिकेशन की पहचान करते हैं.

जिन डिवाइसों पर आस-पास मौजूद विज्ञापन देने वाले लोगों या कंपनियों को खोजा जाएगा उन पर, startDiscovery() को इससे कॉल करें: Strategy और serviceId मौजूद हैं.

serviceId वैल्यू से आपके ऐप्लिकेशन की पहचान खास तौर पर होनी चाहिए. सबसे सही तरीका यह है कि आपके ऐप्लिकेशन का पैकेज नाम (उदाहरण के लिए, com.google.example.myapp).

नीचे दिए गए उदाहरण में विज्ञापन दिखाने का तरीका बताया गया है:

private void startAdvertising() {
  AdvertisingOptions advertisingOptions =
      new AdvertisingOptions.Builder().setStrategy(STRATEGY).build();
  Nearby.getConnectionsClient(context)
      .startAdvertising(
          getLocalUserName(), SERVICE_ID, connectionLifecycleCallback, advertisingOptions)
      .addOnSuccessListener(
          (Void unused) -> {
            // We're advertising!
          })
      .addOnFailureListener(
          (Exception e) -> {
            // We were unable to start advertising.
          });
}

ConnectionLifecycleCallback पैरामीटर एक कॉलबैक है जिसे शुरू किया जाएगा जब खोज करने वाले लोग, विज्ञापन देने वाले से जुड़ने का अनुरोध करते हैं. मैनेज करें कनेक्शन: तय करें.

नीचे दिए गए उदाहरण में, कॉन्टेंट को खोजने का तरीका बताया गया है:

private void startDiscovery() {
  DiscoveryOptions discoveryOptions =
      new DiscoveryOptions.Builder().setStrategy(STRATEGY).build();
  Nearby.getConnectionsClient(context)
      .startDiscovery(SERVICE_ID, endpointDiscoveryCallback, discoveryOptions)
      .addOnSuccessListener(
          (Void unused) -> {
            // We're discovering!
          })
      .addOnFailureListener(
          (Exception e) -> {
            // We're unable to start discovering.
          });
}

EndpointDiscoveryCallback पैरामीटर एक कॉलबैक है जिसे शुरू किया जाएगा आस-पास मौजूद विज्ञापन देने वालों के बारे में पता चलता है या वे गुम हो जाते हैं. मैनेज करें कनेक्शन: तय करें.

जब आपको विज्ञापन नहीं दिखाना हो, तो stopAdvertising() पर कॉल करें और stopDiscovery(), जब आपको खोजने की ज़रूरत न हो.

ध्यान दें: stopDiscovery() को कॉल करने के बाद भी, खोज करने वाला व्यक्ति अनुरोध कर सकता है विज्ञापन देने वालों के साथ आपके कनेक्शन का पता चला था; हालांकि, खोज करने वाला व्यक्ति जब तक यह पता दोबारा न चलने लगे, तब तक विज्ञापन देने वाले नए लोगों या कंपनियों को नहीं खोजा जा सकता.

चेतावनी: खोज के ज़्यादातर तरीकों में रेडियो से जुड़े बड़े पैमाने पर काम करना पड़ता है स्थापित कनेक्शन के टूटने की संभावना बढ़ जाती है, यह एक आम बात है अपने पसंदीदा साथी ढूंढने के बाद, stopDiscovery() को शुरू करने का पैटर्न है कनेक्ट करना और डेटा शेयर करना.