gpg::NearbyConnections

#include <nearby_connections.h>

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

Özet

Oluşturucular ve Yıkıcılar
NearbyConnections()
~NearbyConnections()

Herkese açık işlevler
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 kimlikle uzak uç noktayla olan 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 bir uç noktaya bağlantı ister.
SendReliableMessage(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload)	void Belirtilen kimlikle uzak uç noktaya güvenilir bir mesaj gönderir.
SendReliableMessage(const std::vector< std::string > & remote_endpoint_ids, const std::vector< uint8_t > & payload)	void Belirtilen kimliklerle uzak uç noktalara güvenilir bir mesaj gönderir.
SendUnreliableMessage(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload)	void Belirtilen kimlikle 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 bir 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ç noktaların bağlantısını keser; Gerçekleşen reklamları veya keşifleri durdurur.
StopAdvertising()	void Yerel uç noktanın reklamını yapmayı durdurur.
StopDiscovery(const std::string & service_id)	void Önceden belirtilen bir 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ı.

Herkese açık işlevler

AcceptConnectionRequest

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

Bağlantı isteğini kabul eder.

Ardından, 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 kullanarak yapabilir. remote_endpoint_id, bağlantıyı isteyen uzak uç noktanın kimliğiyle eşleşmelidir. Bu kimliği ConnectionRequestCallback sağlar. payload, bağlantı yanıtıyla birlikte gönderilecek 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, IMessageListener yerine MessageListenerHelper kullanması açısından AcceptConnectionRequest işlevinden farklıdır.

Bağlantıyı kes

void Disconnect(
  const std::string & remote_endpoint_id
)

Belirtilen kimlikle uzak uç noktayla olan 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ıyı isteyen 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, uygulamanın bu uç noktayı tanımlamak için diğer cihazdaki kullanıcılara gösterebileceği bir addır. Boş bir dize belirtirseniz cihaz adı kullanılır. remote_endpoint_id, bu uygulamanın bağlanma isteği gönderdiği uzak uç noktanın kimliğidir. payload, bağlantı isteğiyle birlikte gönderilecek özel bir mesaj ayarlayabilir. Alternatif olarak, uygulamanız yük yerine 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" mesajı görüntülenir. veya "Bağlantı Reddedildi" tıklayın. Aksi takdirde bir 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 aldığında veya uzak uç noktayla bağlantı kesildiğinde belirtilen dinleyiciyi ç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 bir uç noktaya bağlantı ister.

SendConnectionRequest özelliğinden yalnızca IMessageListener yerine MessageListenerHelper kullanması açısından farklıdır.

SendReliableMessage

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

Belirtilen kimlikle uzak uç noktaya güvenilir bir mesaj gönderir.

SendReliableMessage

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

Belirtilen kimliklerle 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 kimlikle 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 bir uygulama için bir uç noktanın reklamını yapmaya başlar.

name, uç noktayı tanımlamak için uygulamanın 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, uygulama süre dolmadan StopAdvertising() veya Stop() yöntemini çağırmadığı sürece reklamın çalıştırılacağı süreyi (milisaniye cinsinden) belirtir. duration değeri gpg::Duration::zero() değerine eşitse reklam, uygulama StopAdvertising() öğesini ç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 yöntemini çağırır; bu geri çağırma, başarıyla ilgili uç nokta bilgilerini veya başarısızlık durumunda hata kodunu alır. Bu işlev, uzak bir uç nokta, uygulamanın uç noktasıyla bağlantı istediğinde request_callback öğesini çağırır. Bu işlev, uygulama StopAdvertising çağırana veya süre geçene kadar bu uç noktanın varlığını yayınlamaya devam eder. Reklamı yapılan bir uç nokta zaten 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 öğesini çağırana kadar buna devam eder. service_id, uygulamaların StartAdvertising üzerinden reklam yayınlarken sağladığı değerle eşleşmelidir. duration, keşfin çalışması için maksimum süreyi (milisaniye cinsinden) belirtir (uygulama StopDiscovery() çağrısı yaparsa daha erken durabilir). Duration değeri gpg::Duration::zero() değerine eşitse keşif, uygulama StopDiscovery() veya Stop() çağırana kadar 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şlev, IEndpointDiscoveryListener yerine EndpointDiscoveryListenerHelper kullanması açısından StartDiscovery işlevinden farklıdır.

Durdur

void Stop()

Tüm uzak uç noktaların bağlantısını keser; Gerçekleşen reklamları veya keşifleri durdurur.

Dahili durumu temizler.

StopAdvertising

void StopAdvertising()

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

Aksi halde mevcut bağlantılar yırtılmaz.

StopDiscovery

void StopDiscovery(
  const std::string & service_id
)

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

~NearbyConnections

 ~NearbyConnections()