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 koneksi.
AcceptConnectionRequest(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, MessageListenerHelper helper)	void Menerima permintaan koneksi.
Disconnect(const std::string & remote_endpoint_id)	void Memutuskan koneksi dari endpoint jarak jauh dengan ID yang ditentukan.
RejectConnectionRequest(const std::string & remote_endpoint_id)	void Menolak permintaan koneksi.
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 Memutuskan koneksi dari semua endpoint jarak jauh; menghentikan iklan atau penemuan 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::NearbyConnections::Builder	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 koneksi.

Selanjutnya, aplikasi dapat mengirim pesan ke, dan menerimanya dari, endpoint yang ditentukan. Aplikasi dapat melakukannya, menggunakan listener, hingga aplikasi terputus dari endpoint lain. remote_endpoint_id harus cocok dengan ID endpoint jarak jauh yang meminta koneksi. ConnectionRequestCallback memberikan ID tersebut. payload dapat menyimpan pesan untuk dikirim bersama dengan 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 koneksi.

Fungsi ini hanya berbeda dengan AcceptConnectionRequest karena menggunakan MessageListenerHelper, bukan IMessageListener.

Berhenti hubungkan

void Disconnect(
  const std::string & remote_endpoint_id
)

Memutuskan koneksi dari endpoint jarak jauh dengan ID yang ditentukan.

NearbyConnections

 NearbyConnections()

RejectConnectionRequest

void RejectConnectionRequest(
  const std::string & remote_endpoint_id
)

Menolak permintaan koneksi.

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 menentukan 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, aplikasi Anda dapat meneruskan vektor byte kosong, bukan payload. Fungsi ini memanggil callback yang ditentukan sebagai respons terhadap permintaan. Jika berhasil, operasi akan menghasilkan respons "Koneksi Diterima" atau "Koneksi Ditolak". Jika tidak, pesan kegagalan akan ditampilkan. Jika koneksi diterima, aplikasi dapat mengirim pesan ke endpoint jarak jauh, dan aplikasi akan 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.

Hanya berbeda dengan SendConnectionRequest karena 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 menentukan 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 berlanjut tanpa batas hingga aplikasi memanggil StopAdvertising(). Fungsi ini memanggil start_advertising_callback saat iklan dimulai atau gagal; callback ini menerima info endpoint saat berhasil atau kode error saat 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 melakukannya 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) agar penemuan berjalan (penemuan dapat berhenti lebih awal jika aplikasi memanggil StopDiscovery()). Jika nilai Duration sama dengan gpg::Duration::zero(), penemuan akan berlanjut tanpa batas hingga aplikasi memanggil StopDiscovery() atau Stop(). Jika sudah ada pemroses yang terdaftar untuk menemukan endpoint untuk 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.

Berhenti

void Stop()

Memutuskan koneksi dari semua endpoint jarak jauh; menghentikan iklan atau penemuan yang sedang berlangsung.

Menghapus status internal.

StopAdvertising

void StopAdvertising()

Berhenti mengiklankan endpoint lokal.

Tindakan ini TIDAK menyebabkan koneksi yang ada dihentikan.

StopDiscovery

void StopDiscovery(
  const std::string & service_id
)

Berhenti menemukan endpoint jarak jauh untuk ID layanan yang ditentukan sebelumnya.

~NearbyConnections

 ~NearbyConnections()