gpg:: NearbyConnections:: Builder
#include <nearby_connections_builder.h>
Builder 类,用于构建 NearbyConnections 对象。
摘要
构造函数和析构函数 |
|
---|---|
Builder()
|
|
~Builder()
|
公共类型 |
|
---|---|
OnInitializationFinishedCallback
|
typedefstd::function< void(InitializationStatus)>
应用在初始化 API 时或初始化失败时调用的回调。 |
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 &
为此 API 设置由回调返回的客户端 ID。
|
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 &
设置通告时使用的服务 ID。
|
公共类型
OnInitializationFinishedCallback
std::function< void(InitializationStatus)> OnInitializationFinishedCallback
应用在初始化 API 时或初始化失败时调用的回调。
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 )
为此 API 设置由回调返回的客户端 ID。
客户端 ID 允许将单个对象注册为多个 NearbyConnection
实例的监听器,并指示哪些实例针对哪些返回了哪些回调。此 ID 在 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 )
注册将执行日志记录的回调。
这等同于调用 LogLevel 为 INFO
的 SetOnLog(OnLogCallback, LogLevel)
。
SetServiceId
Builder & SetServiceId( const std::string & service_id )
设置通告时使用的服务 ID。
此 ID 在 Android 上不会执行任何操作,但其他平台可能需要它才能投放广告。
~构建器
~Builder()