gpg:: NearbyConnections:: Builder
#include <nearby_connections_builder.h>
Builder (أداة إنشاء) يتم استخدامها لإنشاء عناصر NearbyConnections.
ملخّص
الدلالة والهياكل |
|
---|---|
Builder()
|
|
~Builder()
|
الأنواع العلنية |
|
---|---|
OnInitializationFinishedCallback
|
typedefstd::function< void(InitializationStatus)>
استدعاء يستدعي التطبيق عند إعداد واجهة برمجة التطبيقات أو عند تعذُّر الإعداد. |
OnLogCallback
|
typedefstd::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
، ثم تحاول إنشائه.
وفي حال نجاح هذا الإجراء، سيتم عرض 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()