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 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()