gpg::NearbyConnections::Builder

#include <nearby_connections_builder.h>

Builder 類別是用來建構 NearbyConnections 物件。

摘要

建構函式和解構函式
Builder()
~Builder()

公開類型
OnInitializationFinishedCallback typedef
std::function< void(InitializationStatus)>
應用程式叫用 API 的初始化，或初始化失敗時的回呼。
OnLogCallback typedef
std::function< void(LogLevel, const std::string &)>
可提供給 SDK 的記錄回呼類型。

公開函式
Create(const PlatformConfiguration & platform)
std::unique_ptr< NearbyConnections >
指定 Builder 要為哪個平台建立 NearbyConnections 物件，然後嘗試建立該物件。
SetClientId(int64_t client_id)
設定這個 API 的用戶端 ID，這個 API 會由回呼傳回。
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)
設定放送廣告時使用的服務 ID。

公開類型

OnInitializationFinishedCallback

std::function< void(InitializationStatus)> OnInitializationFinishedCallback

應用程式叫用 API 的初始化，或初始化失敗時的回呼。

OnLogCallback

std::function< void(LogLevel, const std::string &)> OnLogCallback

可提供給 SDK 的記錄回呼類型。

公開函式

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()