gpg::NearbyConnections::Builder

#include <nearby_connections_builder.h>

Builder có một lớp dùng để tạo đối tượng NearbyConnections.

Tóm tắt

Hàm khởi tạo và hàm phá
Builder()
~Builder()

Loại công khai
OnInitializationFinishedCallback typedef
std::function< void(InitializationStatus)>
Lệnh gọi lại mà ứng dụng gọi khi khởi chạy API, hoặc khi khởi chạy không thành công.
OnLogCallback typedef
std::function< void(LogLevel, const std::string &)>
Loại lệnh gọi lại ghi nhật ký có thể được cung cấp cho SDK.

Hàm công khai
Create(const PlatformConfiguration & platform)
std::unique_ptr< NearbyConnections >
Chỉ định nền tảng mà Builder được dùng để tạo đối tượng NearbyConnections, sau đó cố gắng tạo đối tượng đó.
SetClientId(int64_t client_id)
Đặt mã ứng dụng khách cho API này. Mã này được trả về bằng lệnh gọi lại.
SetDefaultOnLog(LogLevel min_level)
Chỉ định việc ghi nhật ký phải sử dụng DEFAULT_ON_LOG_CALLBACK ở cấp độ nhật ký được chỉ định.
SetOnInitializationFinished(OnInitializationFinishedCallback callback)
Đăng ký một lệnh gọi lại mà ứng dụng gọi khi quá trình khởi chạy hoàn tất.
SetOnLog(OnLogCallback callback, LogLevel min_level)
Đăng ký một lệnh gọi lại để thực hiện việc ghi nhật ký.
SetOnLog(OnLogCallback callback)
Đăng ký một lệnh gọi lại để thực hiện việc ghi nhật ký.
SetServiceId(const std::string & service_id)
Đặt mã dịch vụ dùng khi quảng cáo.

Loại công khai

OnInitializationFinishedCallback

std::function< void(InitializationStatus)> OnInitializationFinishedCallback

Lệnh gọi lại mà ứng dụng gọi khi khởi chạy API, hoặc khi khởi chạy không thành công.

OnLogCallback

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

Loại lệnh gọi lại ghi nhật ký có thể được cung cấp cho SDK.

Hàm công khai

Trình tạo

 Builder()

Tạo

std::unique_ptr< NearbyConnections > Create(
  const PlatformConfiguration & platform
)

Chỉ định nền tảng mà Builder được dùng để tạo đối tượng NearbyConnections, sau đó cố gắng tạo đối tượng đó.

Nếu thành công, thao tác này sẽ trả về unique_ptr cho đối tượng NearbyConnections. Để biết thêm thông tin, hãy xem tài liệu về cấu hình nền tảng.

SetClientId

Builder & SetClientId(
  int64_t client_id
)

Đặt mã ứng dụng khách cho API này. Mã này được trả về bằng lệnh gọi lại.

Mã ứng dụng khách cho phép một đối tượng đăng ký làm trình nghe cho nhiều thực thể NearbyConnection, đồng thời cho biết thực thể nào đang được trả về lệnh gọi lại nào. Mã nhận dạng này không có tác dụng gì trên Android.

SetDefaultOnLog

Builder & SetDefaultOnLog(
  LogLevel min_level
)

Chỉ định việc ghi nhật ký phải sử dụng DEFAULT_ON_LOG_CALLBACK ở cấp độ nhật ký được chỉ định.

min_level chỉ định cấp độ nhật ký tối thiểu mà ứng dụng gọi lệnh gọi lại mặc định.

Các cấp độ có thể có là: VERBOSE, INFO, WARNING và ERROR.

Quy cách này tương đương với việc gọi SetOnLog(OnLogCallback, LogLevel) với OnLogCallback được đặt thành DEFAULT_ON_LOG_CALLBACK và LogLevel là min_level.

SetOnInitializationFinished

Builder & SetOnInitializationFinished(
  OnInitializationFinishedCallback callback
)

Đăng ký một lệnh gọi lại mà ứng dụng gọi khi quá trình khởi chạy hoàn tất.

Ứng dụng phải gọi hàm này trước khi gọi Create. Ứng dụng có thể thực hiện lệnh gọi lại nhiều lần. Ví dụ: nếu người dùng nhận một cuộc gọi điện thoại rồi quay lại ứng dụng, thì NearbyConnections sẽ khởi động lại rồi gọi lại lệnh gọi lại này.

Lưu ý rằng bạn phải gọi lệnh gọi lại này thì mới có thể sử dụng đối tượng NearbyConnections.

SetOnLog

Builder & SetOnLog(
  OnLogCallback callback,
  LogLevel min_level
)

Đăng ký một lệnh gọi lại để thực hiện việc ghi nhật ký.

min_level chỉ định cấp độ nhật ký tối thiểu. Theo thứ tự tăng dần, các cấp có thể là: VERBOSE, INFO, WARNING và ERROR.

SetOnLog

Builder & SetOnLog(
  OnLogCallback callback
)

Đăng ký một lệnh gọi lại để thực hiện việc ghi nhật ký.

Điều này tương đương với việc gọi SetOnLog(OnLogCallback, LogLevel) có Loglevel là INFO.

SetServiceId

Builder & SetServiceId(
  const std::string & service_id
)

Đặt mã dịch vụ dùng khi quảng cáo.

Mã nhận dạng này không có tác dụng trên Android, nhưng các nền tảng khác có thể yêu cầu để có thể quảng cáo.

~Trình tạo

 ~Builder()