gpg::NearbyConnections::Builder

#include <nearby_connections_builder.h>

Builder क्लास का इस्तेमाल, NearbyConnections ऑब्जेक्ट को बनाने के लिए किया जाता है.

खास जानकारी

कंस्ट्रक्टर और डिस्ट्रक्टर
Builder()
~Builder()

सार्वजनिक प्रकार
OnInitializationFinishedCallback	टाइपडिफ़ std::function< void(InitializationStatus)> एक कॉलबैक, जिसे ऐप्लिकेशन, एपीआई को शुरू करने पर या प्रोसेस पूरी न होने पर शुरू करता है.
OnLogCallback	टाइपडिफ़ std::function< void(LogLevel, const std::string &)> लॉग इन कॉलबैक का वह टाइप जो SDK टूल को दिया जा सकता है.

सार्वजनिक फ़ंक्शन
Create(const PlatformConfiguration & platform)	std::unique_ptr< NearbyConnections > इस प्लैटफ़ॉर्म के बारे में जानकारी देता है, जिसके लिए Builder, NearbyConnections ऑब्जेक्ट को बनाता है. इसके बाद, इसे बनाने की कोशिश करता है.
SetClientId(int64_t client_id)	Builder & इस एपीआई के लिए क्लाइंट आईडी सेट करता है, जो कॉलबैक से मिलता है.
SetDefaultOnLog(LogLevel min_level)	Builder & इससे पता चलता है कि लॉग इन करने के लिए, बताए गए लॉग लेवल पर DEFAULT_ON_LOG_CALLBACK का इस्तेमाल किया जाना चाहिए.
SetOnInitializationFinished(OnInitializationFinishedCallback callback)	Builder & यह एक कॉलबैक को रजिस्टर करता है, जिसे शुरू होने पर ऐप्लिकेशन कॉल करता है.
SetOnLog(OnLogCallback callback, LogLevel min_level)	Builder & ऐसी कॉलबैक को रजिस्टर करता है जो लॉग इन करेगा.
SetOnLog(OnLogCallback callback)	Builder & ऐसी कॉलबैक को रजिस्टर करता है जो लॉग इन करेगा.
SetServiceId(const std::string & service_id)	Builder & विज्ञापन दिखाते समय इस्तेमाल किया जाने वाला सेवा आईडी सेट करता है.

सार्वजनिक प्रकार

OnInitializationFinishedCallback

std::function< void(InitializationStatus)> OnInitializationFinishedCallback

एक कॉलबैक, जिसे ऐप्लिकेशन, एपीआई को शुरू करने पर या प्रोसेस पूरी न होने पर शुरू करता है.

OnLogCallback

std::function< void(LogLevel, const std::string &)> OnLogCallback

लॉग इन कॉलबैक का वह टाइप जो SDK टूल को दिया जा सकता है.

सार्वजनिक फ़ंक्शन

निर्माता

 Builder()

बनाएं

std::unique_ptr< NearbyConnections > Create(
  const PlatformConfiguration & platform
)

इस प्लैटफ़ॉर्म के लिए Builder की मदद से NearbyConnections ऑब्जेक्ट बनाया जाता है. इसके बाद, इसे बनाने की कोशिश की जाती है.

कामयाब होने पर, यह NearbyConnections ऑब्जेक्ट के लिए unique_ptr दिखाएगा. ज़्यादा जानकारी के लिए, प्लैटफ़ॉर्म कॉन्फ़िगरेशन से जुड़ा दस्तावेज़ देखें.

SetClientId

Builder & SetClientId(
  int64_t client_id
)

इस एपीआई के लिए क्लाइंट आईडी सेट करता है, जो कॉलबैक से मिलता है.

क्लाइंट आईडी, एक ऑब्जेक्ट को एक से ज़्यादा NearbyConnection इंस्टेंस के लिए लिसनर के तौर पर रजिस्टर करने की अनुमति देता है. साथ ही, इससे यह भी पता चलता है कि किस इंस्टेंस के लिए कौनसे कॉलबैक लौटाए जा रहे हैं. यह आईडी Android पर कुछ नहीं करता.

SetDefaultOnLog

Builder & SetDefaultOnLog(
  LogLevel min_level
)

इससे पता चलता है कि लॉग इन करने के लिए, बताए गए लॉग लेवल पर DEFAULT_ON_LOG_CALLBACK का इस्तेमाल किया जाना चाहिए.

min_level कम से कम लॉग लेवल के बारे में बताता है, जिस पर ऐप्लिकेशन डिफ़ॉल्ट कॉलबैक को शुरू करता है.

संभावित लेवल ये हैं: VERBOSE, INFO, WARNING, और ERROR.

यह स्पेसिफ़िकेशन, SetOnLog(OnLogCallback, LogLevel) को कॉल करने के बराबर है, जिसमें OnLogCallback को DEFAULT_ON_LOG_CALLBACK और LogLevel का min_level सेट किया गया हो.

SetOnInitializationFinished

Builder & SetOnInitializationFinished(
  OnInitializationFinishedCallback callback
)

यह उस कॉलबैक को रजिस्टर करता है जिसे शुरू होने पर ऐप्लिकेशन कॉल करता है.

Create को कॉल करने से पहले, ऐप्लिकेशन को कॉल करना होगा. ऐप्लिकेशन कॉलबैक को कई बार शुरू कर सकता है. उदाहरण के लिए, अगर किसी उपयोगकर्ता को फ़ोन कॉल आता है और वह ऐप्लिकेशन पर वापस आता है, तो NearbyConnections फिर से शुरू हो जाएगा और इस कॉलबैक को फिर से कॉल करेगा.

ध्यान दें कि NearbyConnections ऑब्जेक्ट का इस्तेमाल करने से पहले, इस कॉलबैक को कॉल करना ज़रूरी है.

SetOnLog

Builder & SetOnLog(
  OnLogCallback callback,
  LogLevel min_level
)

ऐसी कॉलबैक को रजिस्टर करता है जो लॉग इन करेगा.

min_level कम से कम लॉग लेवल तय करता है. बढ़ते क्रम में ये लेवल हो सकते हैं: VERBOSE, INFO, WARNING, और ERROR.

SetOnLog

Builder & SetOnLog(
  OnLogCallback callback
)

ऐसी कॉलबैक को रजिस्टर करता है जो लॉग इन करेगा.

यह INFO के Loglevel के साथ SetOnLog(OnLogCallback, LogLevel) को कॉल करने के बराबर है.

SetServiceId

Builder & SetServiceId(
  const std::string & service_id
)

विज्ञापन दिखाते समय इस्तेमाल किया जाने वाला सेवा आईडी सेट करता है.

यह आईडी Android पर कोई काम नहीं करता है. हालांकि, दूसरे प्लैटफ़ॉर्म पर विज्ञापन दिखाने के लिए इसकी ज़रूरत पड़ सकती है.

~बिल्डर

 ~Builder()