gpg::NearbyConnections::Builder

#include <nearby_connections_builder.h>

Builder (أداة إنشاء) يتم استخدامها لإنشاء عناصر NearbyConnections.

ملخّص

الدلالة والهياكل
Builder()
~Builder()

الأنواع العلنية
OnInitializationFinishedCallback typedef
std::function< void(InitializationStatus)>
استدعاء يستدعي التطبيق عند إعداد واجهة برمجة التطبيقات أو عند تعذُّر الإعداد.
OnLogCallback typedef
std::function< void(LogLevel, const std::string &)>
هذا هو نوع معاودة الاتصال بتسجيل الدخول الذي يمكن تقديمه إلى حزمة تطوير البرامج (SDK).

الدوال العامة
Create(const PlatformConfiguration & platform)
std::unique_ptr< NearbyConnections >
تحدّد هذه السياسة النظام الأساسي الذي سيُنشئ Builder له الكائن NearbyConnections، ثم تحاول إنشائه.
SetClientId(int64_t client_id)
لضبط معرِّف عميل لواجهة برمجة التطبيقات هذه، يتم عرضه من خلال عمليات معاودة الاتصال.
SetDefaultOnLog(LogLevel min_level)
تحدِّد هذه السياسة أنّ التسجيل يجب أن يستخدم DEFAULT_ON_LOG_CALLBACK على مستوى السجلّ المحدَّد.
SetOnInitializationFinished(OnInitializationFinishedCallback callback)
يسجل معاودة الاتصال التي يتصل بها التطبيق عند انتهاء عملية الإعداد.
SetOnLog(OnLogCallback callback, LogLevel min_level)
يتم تسجيل معاودة الاتصال التي ستؤدي إلى تسجيل الدخول.
SetOnLog(OnLogCallback callback)
يتم تسجيل معاودة الاتصال التي ستؤدي إلى تسجيل الدخول.
SetServiceId(const std::string & service_id)
تعمل على ضبط معرّف خدمة يتم استخدامه عند عرض الإعلانات.

الأنواع العلنية

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، ثم تحاول إنشائه.

وفي حال نجاح هذا الإجراء، سيتم عرض unique_ptr إلى الكائن NearbyConnections. لمزيد من المعلومات، يُرجى الاطّلاع على المستندات حول إعداد النظام الأساسي.

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
)

يتم تسجيل معاودة الاتصال التي ستؤدي إلى تسجيل الدخول.

يعادل هذا استدعاء SetOnLog(OnLogCallback, LogLevel) باستخدام LogLevel من INFO.

SetServiceId

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

تعمل على ضبط معرّف خدمة يتم استخدامه عند عرض الإعلانات.

لا يُعتبر هذا المعرّف أيّ إجراء على Android، ولكن قد تتطلّبه المنصات الأخرى أن يتيح إمكانية عرض الإعلانات.

~أداة الإنشاء

 ~Builder()