gpg::NearbyConnections::Builder

#include <nearby_connections_builder.h>

Builder dùng để tạo các đối tượng NearbyConnections

Tóm tắt

Hàm khởi tạo và phá huỷ
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 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 (được lệnh gọi lại trả về).
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 kết thúc.
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ụ được 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 dùng để tạo đối tượng NearbyConnections, sau đó cố gắng tạo đối tượng đó.

Nếu thành công, hàm này sẽ trả về unique_ptr cho đối tượng NearbyConnections. Để biết thêm thông tin, vui lòng 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 (được lệnh gọi lại trả về).

Mã ứng dụng khách cho phép một đối tượng duy nhất đăng ký làm trình nghe cho nhiều thực thể NearbyConnection và cho biết lệnh gọi lại nào đang được trả về cho thực thể 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ể 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 kết thúc.

Ứng dụng phải gọi phương thức 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 được 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.

Xin lưu ý rằng lệnh gọi lại này phải được gọi trước khi bạn 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) bằng Loglevel là INFO.

SetServiceId

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

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

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

~Trình tạo

 ~Builder()