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
، ثم يحاول إنشاءه.
وفي حال نجاح الإجراء، سيتم عرض 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()