gpg::NearbyConnections

#include <nearby_connections.h>

동일한 로컬 네트워크에서 연결을 만들고 앱 간에 통신하는 데 사용되는 API입니다.

요약

생성자 및 소멸자
NearbyConnections()
~NearbyConnections()

공개 함수
AcceptConnectionRequest(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, IMessageListener *listener)	void 연결 요청을 수락합니다.
AcceptConnectionRequest(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, MessageListenerHelper helper)	void 연결 요청을 수락합니다.
Disconnect(const std::string & remote_endpoint_id)	void 지정된 ID로 원격 엔드포인트와의 연결을 해제합니다.
RejectConnectionRequest(const std::string & remote_endpoint_id)	void 연결 요청을 거부합니다.
SendConnectionRequest(const std::string & name, const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, ConnectionResponseCallback callback, IMessageListener *listener)	void 원격 엔드포인트와 연결을 설정하도록 요청합니다.
SendConnectionRequest(const std::string & name, const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload, ConnectionResponseCallback callback, MessageListenerHelper helper)	void 원격 엔드포인트에 대한 연결을 요청합니다.
SendReliableMessage(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload)	void 지정된 ID가 있는 원격 엔드포인트에 신뢰할 수 있는 메시지를 전송합니다.
SendReliableMessage(const std::vector< std::string > & remote_endpoint_ids, const std::vector< uint8_t > & payload)	void 지정된 ID로 원격 엔드포인트에 신뢰할 수 있는 메시지를 전송합니다.
SendUnreliableMessage(const std::string & remote_endpoint_id, const std::vector< uint8_t > & payload)	void 지정된 ID가 있는 원격 엔드포인트에 신뢰할 수 없는 메시지를 전송합니다.
SendUnreliableMessage(const std::vector< std::string > & remote_endpoint_ids, const std::vector< uint8_t > & payload)	void 지정된 ID가 있는 원격 엔드포인트에 신뢰할 수 없는 메시지를 전송합니다.
StartAdvertising(const std::string & name, const std::vector< AppIdentifier > & app_identifiers, Duration duration, StartAdvertisingCallback start_advertising_callback, ConnectionRequestCallback request_callback)	void 로컬 앱의 엔드포인트 공지를 시작합니다.
StartDiscovery(const std::string & service_id, Duration duration, IEndpointDiscoveryListener *listener)	void 지정된 서비스 ID로 원격 엔드포인트를 찾고 앱이 엔드포인트를 찾아서 잃을 때 리스너를 반복적으로 호출합니다.
StartDiscovery(const std::string & service_id, Duration duration, EndpointDiscoveryListenerHelper helper)	void 지정된 서비스 ID가 있는 원격 엔드포인트를 찾습니다.
Stop()	void 모든 원격 엔드포인트와의 연결을 해제하고, 진행 중인 모든 광고 또는 검색을 중지합니다.
StopAdvertising()	void 로컬 엔드포인트 공지를 중지합니다.
StopDiscovery(const std::string & service_id)	void 이전에 지정된 서비스 ID의 원격 엔드포인트 찾기를 중지합니다.

클래스
gpg::NearbyConnections::Builder	Builder 클래스에 있음)은 NearbyConnections 객체를 생성하는 데 사용됩니다.

공개 함수

AcceptConnectionRequest

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

연결 요청을 수락합니다.

이후에 앱은 지정된 엔드포인트로 메시지를 보내거나 받을 수 있습니다. 이렇게 하려면 앱이 다른 엔드포인트에서 연결 해제될 때까지 listener를 사용하면 됩니다. remote_endpoint_id는 연결을 요청한 원격 엔드포인트의 ID와 일치해야 합니다. ConnectionRequestCallback에서 이 ID를 제공합니다. payload는 연결 응답과 함께 전송할 메시지를 보유할 수 있습니다. listener는 이 연결의 이벤트에 대한 알림을 받을 리스너를 지정합니다.

AcceptConnectionRequest

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

연결 요청을 수락합니다.

이 함수는 IMessageListener가 아닌 MessageListenerHelper를 사용한다는 점에서 AcceptConnectionRequest과만 다릅니다.

연결 해제

void Disconnect(
  const std::string & remote_endpoint_id
)

지정된 ID로 원격 엔드포인트와의 연결을 해제합니다.

NearbyConnections

 NearbyConnections()

RejectConnectionRequest

void RejectConnectionRequest(
  const std::string & remote_endpoint_id
)

연결 요청을 거부합니다.

remote_endpoint_id는 연결을 요청한 원격 엔드포인트의 ID와 일치해야 합니다. ConnectionRequestCallback에서 이 ID를 제공합니다.

SendConnectionRequest

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

원격 엔드포인트와 연결을 설정하도록 요청합니다.

name은 앱이 이 엔드포인트를 식별하기 위해 다른 기기의 사용자에게 표시할 수 있는 이름입니다. 빈 문자열을 지정하면 기기 이름이 사용됩니다. remote_endpoint_id는 이 앱에서 연결 요청을 전송하는 원격 엔드포인트의 ID입니다. payload는 연결 요청과 함께 전송할 맞춤 메시지를 보유할 수 있습니다. 또는 페이로드 대신 앱에서 빈 바이트 벡터를 전달할 수 있습니다. 이 함수는 요청에 대한 응답으로 지정된 콜백을 호출합니다. 작업이 성공하면 'Connection Accepted' 또는 'Connection Rejected'라는 응답이 발생합니다. 그러지 않으면 실패 메시지가 생성됩니다. 연결이 수락되면 앱이 원격 엔드포인트로 메시지를 보낼 수 있으며, 메시지를 수신하거나 원격 엔드포인트에서 연결이 끊어지면 앱은 지정된 리스너를 호출합니다.

SendConnectionRequest

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

원격 엔드포인트에 대한 연결을 요청합니다.

IMessageListener 대신 MessageListenerHelper를 사용한다는 점만 SendConnectionRequest와 다릅니다.

SendReliableMessage

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

지정된 ID가 있는 원격 엔드포인트에 신뢰할 수 있는 메시지를 전송합니다.

SendReliableMessage

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

지정된 ID로 원격 엔드포인트에 신뢰할 수 있는 메시지를 전송합니다.

SendUnreliableMessage

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

지정된 ID가 있는 원격 엔드포인트에 신뢰할 수 없는 메시지를 전송합니다.

SendUnreliableMessage

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

지정된 ID가 있는 원격 엔드포인트에 신뢰할 수 없는 메시지를 전송합니다.

StartAdvertising

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

로컬 앱의 엔드포인트 공지를 시작합니다.

name은 앱에서 엔드포인트를 식별하기 위해 사용자에게 표시하는 이름일 수 있습니다. 빈 문자열을 지정하면 기기 이름이 사용됩니다. 지정된 경우 app_identifiers은 다른 플랫폼에서 이 앱을 설치하거나 실행하는 방법을 지정합니다. duration는 광고가 실행되는 지속 시간 (밀리초)을 지정합니다. 단, 재생 시간이 만료되기 전에 앱이 StopAdvertising() 또는 Stop()를 호출하지 않아야 합니다. duration 값이 gpg::Duration::zero()과 같으면 앱에서 StopAdvertising()를 호출할 때까지 광고가 무기한 계속됩니다. 이 함수는 광고가 시작되거나 실패할 때 start_advertising_callback를 호출합니다. 이 콜백은 성공 시 엔드포인트 정보를 수신하거나 실패 시 오류 코드를 수신합니다. 이 함수는 원격 엔드포인트에서 앱의 엔드포인트와의 연결을 요청할 때 request_callback를 호출합니다. 이 함수는 앱이 StopAdvertising를 호출하거나 기간이 경과할 때까지 이 엔드포인트의 존재를 계속 알립니다. 공지 중인 엔드포인트가 이미 있는 경우 이 호출은 실패합니다.

StartDiscovery

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

지정된 서비스 ID로 원격 엔드포인트를 찾고 앱이 엔드포인트를 찾아서 잃을 때 리스너를 반복적으로 호출합니다.

앱이 지정된 서비스 ID로 StopDiscovery를 호출할 때까지 이 작업을 계속합니다. service_id는 StartAdvertising를 통해 광고할 때 앱에서 제공하는 값과 일치해야 합니다. duration는 검색이 실행될 최대 시간 (밀리초)을 지정합니다 (앱에서 StopDiscovery()을 호출하는 경우 더 빨리 중지될 수 있음). Duration 값이 gpg::Duration::zero()와 같으면 앱이 StopDiscovery() 또는 Stop()를 호출할 때까지 검색이 무기한 계속됩니다. 지정된 서비스 ID의 엔드포인트를 찾기 위해 등록된 리스너가 이미 있는 경우 이 호출은 실패합니다.

StartDiscovery

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

지정된 서비스 ID가 있는 원격 엔드포인트를 찾습니다.

이 함수는 IEndpointDiscoveryListener 대신 EndpointDiscoveryListenerHelper를 사용한다는 점에서만 StartDiscovery와 다릅니다.

중지

void Stop()

모든 원격 엔드포인트와의 연결을 해제하고, 진행 중인 모든 광고 또는 검색을 중지합니다.

내부 상태를 삭제합니다.

StopAdvertising

void StopAdvertising()

로컬 엔드포인트 공지를 중지합니다.

이렇게 해도 기존 연결이 끊어지지는 않습니다.

StopDiscovery

void StopDiscovery(
  const std::string & service_id
)

이전에 지정된 서비스 ID의 원격 엔드포인트 찾기를 중지합니다.

~NearbyConnections

 ~NearbyConnections()