gpg::NearbyConnections::Builder

#include <nearby_connections_builder.h>

המחלקה Builder משמשת ליצירת אובייקטים של NearbyConnections.

סיכום

בנייה
Builder()
~Builder()

סוגים ציבוריים
OnInitializationFinishedCallback typedef
std::function< void(InitializationStatus)>
קריאה חוזרת (callback) שהאפליקציה מפעילה באתחול ה-API, או כשהאתחול נכשל.
OnLogCallback typedef
std::function< void(LogLevel, const std::string &)>
סוג הקריאה החוזרת (callback) של רישום ביומן שאפשר לספק ל-SDK.

פונקציות ציבוריות
Create(const PlatformConfiguration & platform)
std::unique_ptr< NearbyConnections >
המדיניות הזו מציינת את הפלטפורמה שעבורה Builder יוצר את האובייקט NearbyConnections, ואז מנסה ליצור אותו.
SetClientId(int64_t client_id)
מגדיר מזהה לקוח ל-API הזה, שמוחזר באמצעות קריאות חוזרות (callback).
SetDefaultOnLog(LogLevel min_level)
מציינת שהרישום ביומן צריך להשתמש ב-DEFAULT_ON_LOG_CALLBACK ברמת היומן שצוינה.
SetOnInitializationFinished(OnInitializationFinishedCallback callback)
רושם קריאה חוזרת (callback) שהאפליקציה מתקשרת אליה בסיום האתחול.
SetOnLog(OnLogCallback callback, LogLevel min_level)
רושם קריאה חוזרת (callback) שמבצעת רישום ביומן.
SetOnLog(OnLogCallback callback)
רושם קריאה חוזרת (callback) שמבצעת רישום ביומן.
SetServiceId(const std::string & service_id)
מגדיר מזהה שירות שמשמש במהלך הפרסום.

סוגים ציבוריים

OnInitializationFinishedCallback

std::function< void(InitializationStatus)> OnInitializationFinishedCallback

קריאה חוזרת (callback) שהאפליקציה מפעילה באתחול ה-API, או כשהאתחול נכשל.

OnLogCallback

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

סוג הקריאה החוזרת (callback) של רישום ביומן שאפשר לספק ל-SDK.

פונקציות ציבוריות

בנאי

 Builder()

יצירה

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

המדיניות הזו מציינת את הפלטפורמה שעבורה Builder יוצר את האובייקט NearbyConnections, ואז מנסה ליצור אותו.

אם הפעולה בוצעה ללא שגיאות, היא תחזיר unique_ptr לאובייקט NearbyConnections. למידע נוסף, עיינו במשאבי העזרה בנושא הגדרת פלטפורמה.

SetClientId

Builder & SetClientId(
  int64_t client_id
)

מגדיר מזהה לקוח ל-API הזה, שמוחזר באמצעות קריאות חוזרות (callback).

ה-Client ID מאפשר לאובייקט יחיד להירשם כ-listener במספר מכונות של NearbyConnection ולקבוע אילו קריאות חוזרות (callback) מוחזרות עבור כל אחת מהמכונות. המזהה הזה לא מבצע שום פעולה ב-Android.

SetDefaultOnLog

Builder & SetDefaultOnLog(
  LogLevel min_level
)

מציינת שהרישום ביומן צריך להשתמש ב-DEFAULT_ON_LOG_CALLBACK ברמת היומן שצוינה.

min_level מציין את רמת היומן המינימלית שבה האפליקציה מפעילה את הקריאה החוזרת (callback) שמוגדרת כברירת מחדל.

הרמות האפשריות הן: VERBOSE, INFO, WARNING וERROR.

המפרט הזה מקביל להפעלת SetOnLog(OnLogCallback, LogLevel) כאשר OnLogCallback מוגדר לערך DEFAULT_ON_LOG_CALLBACK ו-LogLevel לערך min_level.

SetOnInitializationFinished

Builder & SetOnInitializationFinished(
  OnInitializationFinishedCallback callback
)

רושם קריאה חוזרת (callback) שהאפליקציה מתקשרת אליה בסיום האתחול.

האפליקציה צריכה להתקשר למוקד לפני ביצוע השיחה אל Create. יכול להיות שהאפליקציה תפעיל את הקריאה החוזרת כמה פעמים. לדוגמה, אם משתמש מקבל שיחת טלפון ואז חוזר לאפליקציה, NearbyConnections יאתחל מחדש ויפעיל את הקריאה החוזרת הזו שוב.

שימו לב שצריך להפעיל את הקריאה החוזרת (callback) הזו כדי להשתמש באובייקט NearbyConnections.

SetOnLog

Builder & SetOnLog(
  OnLogCallback callback,
  LogLevel min_level
)

רושם קריאה חוזרת (callback) שמבצעת רישום ביומן.

min_level מציין את רמת היומן המינימלית. בסדר עולה, הרמות האפשריות הן: VERBOSE, INFO, WARNING ו-ERROR.

SetOnLog

Builder & SetOnLog(
  OnLogCallback callback
)

רושם קריאה חוזרת (callback) שמבצעת רישום ביומן.

הפעולה הזו מקבילה לקריאה ל-SetOnLog(OnLogCallback, LogLevel) עם LogLevel של INFO.

SetServiceId

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

מגדיר מזהה שירות שמשמש במהלך הפרסום.

המזהה הזה לא עושה דבר ב-Android, אבל יכול להיות שפלטפורמות אחרות ידרשו אותו כדי לפרסם.

~Builder

 ~Builder()