gpg:: NearbyConnections
#include <nearby_connections.h>
API yang digunakan untuk membuat koneksi dan berkomunikasi antar aplikasi di jaringan lokal yang sama.
Ringkasan
Konstruktor dan Destruktor |
|
---|---|
NearbyConnections()
|
|
~NearbyConnections()
|
Fungsi publik |
|
---|---|
AcceptConnectionRequest(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, IMessageListener *listener)
|
void
Menerima permintaan untuk terhubung.
|
AcceptConnectionRequest(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, MessageListenerHelper helper)
|
void
Menerima permintaan untuk terhubung.
|
Disconnect(const std::string & remote_endpoint_id)
|
void
Memutuskan sambungan dari endpoint jarak jauh dengan ID yang ditentukan.
|
RejectConnectionRequest(const std::string & remote_endpoint_id)
|
void
Menolak permintaan untuk terhubung.
|
SendConnectionRequest(const std::string & name, const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, ConnectionResponseCallback callback, IMessageListener *listener)
|
void
Meminta koneksi dibuat dengan endpoint jarak jauh.
|
SendConnectionRequest(const std::string & name, const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, ConnectionResponseCallback callback, MessageListenerHelper helper)
|
void
Meminta koneksi ke endpoint jarak jauh.
|
SendReliableMessage(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload)
|
void
Mengirim pesan yang andal ke endpoint jarak jauh dengan ID yang ditentukan.
|
SendReliableMessage(const std::vector< std::string > & remote_endpoint_ids, const std::vector< uint8_t > & payload)
|
void
Mengirim pesan yang andal ke endpoint jarak jauh dengan ID yang ditentukan.
|
SendUnreliableMessage(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload)
|
void
Mengirim pesan yang tidak dapat diandalkan ke endpoint jarak jauh dengan ID yang ditentukan.
|
SendUnreliableMessage(const std::vector< std::string > & remote_endpoint_ids, const std::vector< uint8_t > & payload)
|
void
Mengirim pesan yang tidak dapat diandalkan ke endpoint jarak jauh dengan ID yang ditentukan.
|
StartAdvertising(const std::string & name, const std::vector< AppIdentifier > & app_identifiers, Duration duration, StartAdvertisingCallback start_advertising_callback, ConnectionRequestCallback request_callback)
|
void
Mulai mengiklankan endpoint untuk aplikasi lokal.
|
StartDiscovery(const std::string & service_id, Duration duration, IEndpointDiscoveryListener *listener)
|
void
Menemukan endpoint jarak jauh dengan ID layanan yang ditentukan, dan memanggil pemroses berulang kali saat aplikasi menemukan dan kehilangan endpoint.
|
StartDiscovery(const std::string & service_id, Duration duration, EndpointDiscoveryListenerHelper helper)
|
void
Menemukan endpoint jarak jauh dengan ID layanan yang ditentukan.
|
Stop()
|
void
Terputus dari semua endpoint jarak jauh; menghentikan iklan atau penemuan apa pun yang sedang berlangsung.
|
StopAdvertising()
|
void
Berhenti mengiklankan endpoint lokal.
|
StopDiscovery(const std::string & service_id)
|
void
Berhenti menemukan endpoint jarak jauh untuk ID layanan yang ditentukan sebelumnya.
|
Class |
|
---|---|
gpg:: |
Class Builder yang digunakan untuk membuat objek NearbyConnections. |
Fungsi publik
AcceptConnectionRequest
void AcceptConnectionRequest( const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, IMessageListener *listener )
Menerima permintaan untuk terhubung.
Selanjutnya, aplikasi dapat mengirim pesan ke, dan menerimanya dari, endpoint yang ditentukan. Aplikasi ini dapat melakukannya, menggunakan listener
, hingga aplikasi terputus dari endpoint lainnya. remote_endpoint_id
harus cocok dengan ID endpoint jarak jauh yang meminta koneksi. ConnectionRequestCallback
memberikan ID tersebut. payload
dapat menyimpan pesan yang akan dikirim bersama respons koneksi. listener
menentukan pemroses yang akan diberi tahu tentang peristiwa untuk koneksi ini.
AcceptConnectionRequest
void AcceptConnectionRequest( const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, MessageListenerHelper helper )
Menerima permintaan untuk terhubung.
Fungsi ini hanya berbeda dengan AcceptConnectionRequest
karena menggunakan MessageListenerHelper
, bukan IMessageListener
.
Putuskan koneksi
void Disconnect( const std::string & remote_endpoint_id )
Memutuskan sambungan dari endpoint jarak jauh dengan ID yang ditentukan.
NearbyConnections
NearbyConnections()
RejectConnectionRequest
void RejectConnectionRequest( const std::string & remote_endpoint_id )
Menolak permintaan untuk terhubung.
remote_endpoint_id
harus cocok dengan ID endpoint jarak jauh yang meminta koneksi. ConnectionRequestCallback
memberikan ID tersebut.
SendConnectionRequest
void SendConnectionRequest( const std::string & name, const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, ConnectionResponseCallback callback, IMessageListener *listener )
Meminta koneksi dibuat dengan endpoint jarak jauh.
name
adalah nama yang dapat ditampilkan aplikasi kepada pengguna di perangkat lain untuk mengidentifikasi endpoint ini. Jika Anda menetapkan string kosong, nama perangkat akan digunakan. remote_endpoint_id
adalah ID endpoint jarak jauh tempat aplikasi ini mengirim permintaan untuk terhubung. payload
dapat menyimpan pesan kustom untuk dikirim bersama dengan permintaan koneksi. Atau, sebagai ganti payload, aplikasi Anda dapat meneruskan vektor byte kosong. Fungsi ini memanggil callback yang ditentukan sebagai respons terhadap permintaan. Jika operasi berhasil, akan muncul respons "Koneksi Diterima" atau "Koneksi Ditolak". Jika tidak, pesan kegagalan akan muncul. Dalam kasus koneksi yang diterima, aplikasi dapat mengirim pesan ke endpoint jarak jauh, dan aplikasi memanggil pemroses yang ditentukan saat menerima pesan atau pemutusan koneksi dari endpoint jarak jauh.
SendConnectionRequest
void SendConnectionRequest( const std::string & name, const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, ConnectionResponseCallback callback, MessageListenerHelper helper )
Meminta koneksi ke endpoint jarak jauh.
Berbeda dengan SendConnectionRequest
hanya karena kode ini menggunakan MessageListenerHelper
, bukan IMessageListener
.
SendReliableMessage
void SendReliableMessage( const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload )
Mengirim pesan yang andal ke endpoint jarak jauh dengan ID yang ditentukan.
SendReliableMessage
void SendReliableMessage( const std::vector< std::string > & remote_endpoint_ids, const std::vector< uint8_t > & payload )
Mengirim pesan yang andal ke endpoint jarak jauh dengan ID yang ditentukan.
SendUnreliableMessage
void SendUnreliableMessage( const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload )
Mengirim pesan yang tidak dapat diandalkan ke endpoint jarak jauh dengan ID yang ditentukan.
SendUnreliableMessage
void SendUnreliableMessage( const std::vector< std::string > & remote_endpoint_ids, const std::vector< uint8_t > & payload )
Mengirim pesan yang tidak dapat diandalkan ke endpoint jarak jauh dengan ID yang ditentukan.
StartAdvertising
void StartAdvertising( const std::string & name, const std::vector< AppIdentifier > & app_identifiers, Duration duration, StartAdvertisingCallback start_advertising_callback, ConnectionRequestCallback request_callback )
Mulai mengiklankan endpoint untuk aplikasi lokal.
name
dapat berupa nama yang ditampilkan aplikasi kepada pengguna untuk mengidentifikasi endpoint. Jika Anda menetapkan string kosong, nama perangkat akan digunakan. Jika ditentukan, app_identifiers
akan menentukan cara menginstal atau meluncurkan aplikasi ini di berbagai platform. duration
menentukan durasi (dalam milidetik) iklan akan berjalan, kecuali jika aplikasi memanggil StopAdvertising()
atau Stop()
sebelum durasi berakhir. Jika nilai duration
sama dengan gpg::Duration::zero()
, iklan akan terus berlanjut tanpa batas hingga aplikasi memanggil StopAdvertising()
. Fungsi ini memanggil start_advertising_callback
saat iklan dimulai atau gagal; callback ini menerima info endpoint saat iklan berhasil atau kode error jika gagal. Fungsi ini memanggil request_callback
saat endpoint jarak jauh meminta koneksi dengan endpoint aplikasi. Fungsi ini terus mengiklankan keberadaan endpoint ini hingga aplikasi memanggil StopAdvertising
, atau durasi berlalu. Jika sudah ada endpoint yang diiklankan, panggilan ini akan gagal.
StartDiscovery
void StartDiscovery( const std::string & service_id, Duration duration, IEndpointDiscoveryListener *listener )
Menemukan endpoint jarak jauh dengan ID layanan yang ditentukan, dan memanggil pemroses berulang kali saat aplikasi menemukan dan kehilangan endpoint.
Terus lakukan hingga aplikasi memanggil StopDiscovery
dengan ID layanan yang ditentukan. service_id
harus cocok dengan nilai yang diberikan aplikasi saat beriklan melalui StartAdvertising
. duration
menentukan durasi maksimum (dalam milidetik) untuk menjalankan penemuan (dapat berhenti lebih cepat jika aplikasi memanggil StopDiscovery()
). Jika nilai Duration
sama dengan gpg::Duration::zero()
, penemuan akan berlanjut tanpa batas waktu hingga aplikasi memanggil StopDiscovery()
atau Stop()
. Jika sudah ada pemroses yang didaftarkan untuk menemukan endpoint bagi ID layanan yang ditentukan, panggilan ini akan gagal.
StartDiscovery
void StartDiscovery( const std::string & service_id, Duration duration, EndpointDiscoveryListenerHelper helper )
Menemukan endpoint jarak jauh dengan ID layanan yang ditentukan.
Fungsi ini berbeda dengan StartDiscovery
hanya karena menggunakan EndpointDiscoveryListenerHelper
, bukan IEndpointDiscoveryListener
.
Hentikan
void Stop()
Terputus dari semua endpoint jarak jauh; menghentikan iklan atau penemuan apa pun yang sedang berlangsung.
Membersihkan status internal.
StopAdvertising
void StopAdvertising()
Berhenti mengiklankan endpoint lokal.
Tindakan ini TIDAK menyebabkan koneksi yang ada terputus.
StopDiscovery
void StopDiscovery( const std::string & service_id )
Berhenti menemukan endpoint jarak jauh untuk ID layanan yang ditentukan sebelumnya.
~NearbyConnections
~NearbyConnections()