gpg::NearbyConnections

#include <nearby_connections.h>

Aynı yerel ağdaki uygulamalar arasında bağlantı ve iletişim kurmak için kullanılan bir API.

Özet

Oluşturucular ve Yıkıcılar

NearbyConnections()
~NearbyConnections()

Kamu işlevleri

AcceptConnectionRequest(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, IMessageListener *listener)
void
Bağlantı isteğini kabul eder.
AcceptConnectionRequest(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, MessageListenerHelper helper)
void
Bağlantı isteğini kabul eder.
Disconnect(const std::string & remote_endpoint_id)
void
Belirtilen kimliğe sahip uzak uç noktayla bağlantıyı keser.
RejectConnectionRequest(const std::string & remote_endpoint_id)
void
Bağlantı isteğini reddeder.
SendConnectionRequest(const std::string & name, const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, ConnectionResponseCallback callback, IMessageListener *listener)
void
Uzak uç nokta ile bağlantı kurulmasını ister.
SendConnectionRequest(const std::string & name, const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, ConnectionResponseCallback callback, MessageListenerHelper helper)
void
Uzak uç noktaya bağlantı isteğinde bulunur.
SendReliableMessage(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload)
void
Uzak uç noktaya belirtilen kimliğe sahip güvenilir bir ileti gönderir.
SendReliableMessage(const std::vector< std::string > & remote_endpoint_ids, const std::vector< uint8_t > & payload)
void
Belirtilen kimliklere sahip uzak uç noktalara güvenilir bir mesaj gönderir.
SendUnreliableMessage(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload)
void
Belirtilen kimliğe sahip uzak uç noktaya güvenilir olmayan bir mesaj gönderir.
SendUnreliableMessage(const std::vector< std::string > & remote_endpoint_ids, const std::vector< uint8_t > & payload)
void
Belirtilen kimliklere sahip uzak uç noktalara güvenilir olmayan bir mesaj gönderir.
StartAdvertising(const std::string & name, const std::vector< AppIdentifier > & app_identifiers, Duration duration, StartAdvertisingCallback start_advertising_callback, ConnectionRequestCallback request_callback)
void
Yerel uygulama için bir uç noktanın reklamını yapmaya başlar.
StartDiscovery(const std::string & service_id, Duration duration, IEndpointDiscoveryListener *listener)
void
Belirtilen hizmet kimliğine sahip uzak uç noktaları bulur ve uygulama, uç noktaları bulup kaybettikçe işleyiciyi tekrar tekrar çağırır.
StartDiscovery(const std::string & service_id, Duration duration, EndpointDiscoveryListenerHelper helper)
void
Belirtilen hizmet kimliğine sahip uzak uç noktaları bulur.
Stop()
void
Tüm uzak uç noktalarla olan bağlantıyı keser, gerçekleşen tüm reklam veya keşifleri durdurur.
StopAdvertising()
void
Yerel uç noktanın reklamını durdurur.
StopDiscovery(const std::string & service_id)
void
Önceden belirtilen hizmet kimliği için uzak uç noktaları bulmayı durdurur.

Sınıflar

gpg::NearbyConnections::Builder

NearbyConnections nesnelerini oluşturmak için kullanılan Builder sınıfı.

Kamu işlevleri

AcceptConnectionRequest

void AcceptConnectionRequest(
  const std::string & remote_endpoint_id,
  const std::vector< uint8_t > & payload,
  IMessageListener *listener
)

Bağlantı isteğini kabul eder.

Daha sonra, uygulama belirtilen uç noktaya mesaj gönderebilir ve bu uç noktadan mesaj alabilir. Bunu, uygulamanın diğer uç noktayla bağlantısı kesilene kadar listener yöntemini kullanarak yapabilir. remote_endpoint_id, bağlantı isteğinde bulunan uzak uç noktanın kimliğiyle eşleşmelidir. Bu kimliği ConnectionRequestCallback sağlar. payload, bağlantı yanıtıyla birlikte göndermek için bir mesajı bekletebilir. listener, bu bağlantıyla ilgili etkinlikler hakkında bilgilendirilecek bir işleyici belirtir.

AcceptConnectionRequest

void AcceptConnectionRequest(
  const std::string & remote_endpoint_id,
  const std::vector< uint8_t > & payload,
  MessageListenerHelper helper
)

Bağlantı isteğini kabul eder.

Bu işlev yalnızca AcceptConnectionRequest işlevinden, IMessageListener yerine MessageListenerHelper kullanması nedeniyle farklıdır.

Bağlantıyı kes

void Disconnect(
  const std::string & remote_endpoint_id
)

Belirtilen kimliğe sahip uzak uç noktayla bağlantıyı keser.

NearbyConnections

 NearbyConnections()

RejectConnectionRequest

void RejectConnectionRequest(
  const std::string & remote_endpoint_id
)

Bağlantı isteğini reddeder.

remote_endpoint_id, bağlantı isteğinde bulunan uzak uç noktanın kimliğiyle eşleşmelidir. Bu kimliği ConnectionRequestCallback sağlar.

SendConnectionRequest

void SendConnectionRequest(
  const std::string & name,
  const std::string & remote_endpoint_id,
  const std::vector< uint8_t > & payload,
  ConnectionResponseCallback callback,
  IMessageListener *listener
)

Uzak uç nokta ile bağlantı kurulmasını ister.

name, bu uç noktayı tanımlamak için uygulamanın diğer cihazdaki kullanıcılara gösterebileceği addır. Boş bir dize belirtirseniz cihaz adı kullanılır. remote_endpoint_id, bu uygulamanın bağlanmak için bir istek gönderdiği uzak uç noktanın kimliğidir. payload, bağlantı isteğiyle birlikte göndermek üzere özel bir mesaj tutabilir. Alternatif olarak, yük yerine uygulamanız boş bir bayt vektörü iletebilir. Bu işlev, isteğe yanıt olarak belirtilen geri çağırmayı çağırır. İşlem başarılı olursa "Bağlantı Kabul Edildi" veya "Bağlantı Reddedildi" yanıtını verir. Aksi takdirde hata mesajı oluşturulur. Kabul edilen bir bağlantı söz konusu olduğunda, uygulama uzak uç noktaya mesaj gönderebilir ve uygulama, bir mesaj alındığında veya uzak uç noktadan bağlantı kesildiğinde belirtilen işleyiciyi çağırır.

SendConnectionRequest

void SendConnectionRequest(
  const std::string & name,
  const std::string & remote_endpoint_id,
  const std::vector< uint8_t > & payload,
  ConnectionResponseCallback callback,
  MessageListenerHelper helper
)

Uzak uç noktaya bağlantı isteğinde bulunur.

SendConnectionRequest ile arasındaki fark, IMessageListener yerine MessageListenerHelper içermesidir.

SendReliableMessage

void SendReliableMessage(
  const std::string & remote_endpoint_id,
  const std::vector< uint8_t > & payload
)

Uzak uç noktaya belirtilen kimliğe sahip güvenilir bir ileti gönderir.

SendReliableMessage

void SendReliableMessage(
  const std::vector< std::string > & remote_endpoint_ids,
  const std::vector< uint8_t > & payload
)

Belirtilen kimliklere sahip uzak uç noktalara güvenilir bir mesaj gönderir.

SendUnreliableMessage

void SendUnreliableMessage(
  const std::string & remote_endpoint_id,
  const std::vector< uint8_t > & payload
)

Belirtilen kimliğe sahip uzak uç noktaya güvenilir olmayan bir mesaj gönderir.

SendUnreliableMessage

void SendUnreliableMessage(
  const std::vector< std::string > & remote_endpoint_ids,
  const std::vector< uint8_t > & payload
)

Belirtilen kimliklere sahip uzak uç noktalara güvenilir olmayan bir mesaj gönderir.

StartAdvertising

void StartAdvertising(
  const std::string & name,
  const std::vector< AppIdentifier > & app_identifiers,
  Duration duration,
  StartAdvertisingCallback start_advertising_callback,
  ConnectionRequestCallback request_callback
)

Yerel uygulama için bir uç noktanın reklamını yapmaya başlar.

name, uygulamanın uç noktayı tanımlamak için kullanıcılara gösterdiği bir ad olabilir. Boş bir dize belirtirseniz cihaz adı kullanılır. Belirtilmişse app_identifiers, bu uygulamanın farklı platformlarda nasıl yükleneceğini veya başlatılacağını belirtir. duration, süre sona ermeden uygulama StopAdvertising() veya Stop() yöntemini çağırmadığı sürece reklamın yayınlanacağı süreyi (milisaniye cinsinden) belirtir. duration değeri gpg::Duration::zero() ise reklam, uygulama StopAdvertising() çağırana kadar süresiz olarak devam eder. Bu işlev, reklam başladığında veya başarısız olduğunda start_advertising_callback'i çağırır. Bu geri çağırma, başarılı olan uç nokta bilgilerini veya hata durumunda bir hata kodunu alır. Bu işlev, uzak bir uç nokta, uygulamanın uç noktasıyla bağlantı istediğinde request_callback işlevini çağırır. Bu işlev, uygulama StopAdvertising çağırana veya süre geçene kadar bu uç noktanın varlığını bildirmeye devam eder. Halihazırda reklamı yapılan bir uç nokta varsa bu çağrı başarısız olur.

StartDiscovery

void StartDiscovery(
  const std::string & service_id,
  Duration duration,
  IEndpointDiscoveryListener *listener
)

Belirtilen hizmet kimliğine sahip uzak uç noktaları bulur ve uygulama, uç noktaları bulup kaybettikçe işleyiciyi tekrar tekrar çağırır.

Uygulama, belirtilen hizmet kimliğiyle StopDiscovery işlevini çağırana kadar bunu yapmaya devam eder. service_id, uygulamaların StartAdvertising aracılığıyla reklam yayınlarken sunduğu değerle eşleşmelidir. duration, keşfin çalıştırılacağı maksimum süreyi (milisaniye cinsinden) belirtir (uygulama StopDiscovery() işlevini çağırırsa daha erken durabilir). Duration değeri gpg::Duration::zero() değerine eşitse uygulama StopDiscovery() veya Stop() çağrısı yapana kadar keşif süresiz olarak devam eder. Belirtilen hizmet kimliği için uç noktaları bulmak üzere kayıtlı bir işleyici zaten varsa bu çağrı başarısız olur.

StartDiscovery

void StartDiscovery(
  const std::string & service_id,
  Duration duration,
  EndpointDiscoveryListenerHelper helper
)

Belirtilen hizmet kimliğine sahip uzak uç noktaları bulur.

Bu işlevin StartDiscovery işlevinden farkı, IEndpointDiscoveryListener yerine EndpointDiscoveryListenerHelper işlevinin kullanılmasıdır.

Durdur

void Stop()

Tüm uzak uç noktalarla olan bağlantıyı keser, gerçekleşen tüm reklam veya keşifleri durdurur.

Dahili durumu temizler.

StopAdvertising

void StopAdvertising()

Yerel uç noktanın reklamını durdurur.

Bu işlem, mevcut bağlantıların yıkılmasına neden DEĞİLDİR.

StopDiscovery

void StopDiscovery(
  const std::string & service_id
)

Önceden belirtilen hizmet kimliği için uzak uç noktaları bulmayı durdurur.

~Yakınlardaki Bağlantılar

 ~NearbyConnections()