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，由回呼傳回的用戶端 ID。
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，由回呼傳回的用戶端 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，以及 min_level 的 LogLevel。

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 上沒有任何作用，但其他平台可能需要透過該 ID 才能放送廣告。

~建構工具

 ~Builder()