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)
تضبط هذه السياسة معرِّف عميل لواجهة برمجة التطبيقات هذه، والتي يتم عرضها من خلال عمليات معاودة الاتصال.
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()