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,這個 API 會由回呼傳回。
|
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 的初始化,或初始化失敗時的回呼。
公開函式
Builder
Builder()
建立
std::unique_ptr< NearbyConnections > Create( const PlatformConfiguration & platform )
指定 Builder
要為哪個平台建立 NearbyConnections
物件,然後嘗試建立該物件。
如果成功,系統會將 unique_ptr
傳回 NearbyConnections
物件。詳情請參閱平台設定說明文件。
SetClientId
Builder & SetClientId( int64_t client_id )
設定這個 API 的用戶端 ID,這個 API 會由回呼傳回。
用戶端 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 )
註冊會執行記錄功能的回呼。
這相當於使用 INFO
的 LogLevel 呼叫 SetOnLog(OnLogCallback, LogLevel)
。
SetServiceId
Builder & SetServiceId( const std::string & service_id )
設定放送廣告時使用的服務 ID。
這個 ID 不適用於 Android,但其他平台可能需要經過認證才能放送廣告。
~建構工具
~Builder()