package location.nearby.connections

Get desktop application:
View/edit binary Protocol Buffers messages

Available channels on the local device.

Used in: MediumMetadata

• repeated int32 channels = 1

Used in: V1Frame

• optional BandwidthUpgradeNegotiationFrame.EventType event_type = 1

• optional BandwidthUpgradeNegotiationFrame.UpgradePathInfo upgrade_path_info = 2

  Exactly one of the following fields will be set.

• optional BandwidthUpgradeNegotiationFrame.ClientIntroduction client_introduction = 3

• optional BandwidthUpgradeNegotiationFrame.ClientIntroductionAck client_introduction_ack = 4

Accompanies CLIENT_INTRODUCTION events.

Used in: BandwidthUpgradeNegotiationFrame

• optional string endpoint_id = 1

• optional bool supports_disabling_encryption = 2

Accompanies CLIENT_INTRODUCTION_ACK events.

Used in: BandwidthUpgradeNegotiationFrame

(message has no fields)

Used in: BandwidthUpgradeNegotiationFrame

• UNKNOWN_EVENT_TYPE = 0

• UPGRADE_PATH_AVAILABLE = 1

• LAST_WRITE_TO_PRIOR_CHANNEL = 2

• SAFE_TO_CLOSE_PRIOR_CHANNEL = 3

• CLIENT_INTRODUCTION = 4

• UPGRADE_FAILURE = 5

• CLIENT_INTRODUCTION_ACK = 6

Accompanies UPGRADE_PATH_AVAILABLE and UPGRADE_FAILURE events.

Used in: BandwidthUpgradeNegotiationFrame

• optional UpgradePathInfo.Medium medium = 1

• optional UpgradePathInfo.WifiHotspotCredentials wifi_hotspot_credentials = 2

  Exactly one of the following fields will be set.

• optional UpgradePathInfo.WifiLanSocket wifi_lan_socket = 3

• optional UpgradePathInfo.BluetoothCredentials bluetooth_credentials = 4

• optional UpgradePathInfo.WifiAwareCredentials wifi_aware_credentials = 5

• optional UpgradePathInfo.WifiDirectCredentials wifi_direct_credentials = 6

• optional UpgradePathInfo.WebRtcCredentials web_rtc_credentials = 8

• optional bool supports_disabling_encryption = 7

  Disable Encryption for this upgrade medium to improve throughput.

• optional bool supports_client_introduction_ack = 9

  An ack will be sent after the CLIENT_INTRODUCTION frame.

Accompanies Medium.BLUETOOTH.

Used in: UpgradePathInfo

• optional string service_name = 1

• optional string mac_address = 2

Should always match cs/symbol:location.nearby.proto.connections.Medium

Used in: UpgradePathInfo

• UNKNOWN_MEDIUM = 0

• MDNS = 1

• BLUETOOTH = 2

• WIFI_HOTSPOT = 3

• BLE = 4

• WIFI_LAN = 5

• WIFI_AWARE = 6

• NFC = 7

• WIFI_DIRECT = 8

• WEB_RTC = 9

• USB = 11

  10 is reserved.

Accompanies Medium.WEB_RTC

Used in: UpgradePathInfo

• optional string peer_id = 1

• optional LocationHint location_hint = 2

Accompanies Medium.WIFI_AWARE.

Used in: UpgradePathInfo

• optional string service_id = 1

• optional bytes service_info = 2

• optional string password = 3

Accompanies Medium.WIFI_DIRECT.

Used in: UpgradePathInfo

• optional string ssid = 1

• optional string password = 2

• optional int32 port = 3

• optional int32 frequency = 4

• optional string gateway = 5

Accompanies Medium.WIFI_HOTSPOT.

Used in: UpgradePathInfo

• optional string ssid = 1

• optional string password = 2

• optional int32 port = 3

• optional string gateway = 4

• optional int32 frequency = 5

  This field can be a band or frequency

Accompanies Medium.WIFI_LAN.

Used in: UpgradePathInfo

• optional bytes ip_address = 1

• optional int32 wifi_port = 2

Used in: V1Frame

• optional string endpoint_id = 1

• optional string endpoint_name = 2

• optional bytes handshake_data = 3

• optional int32 nonce = 4

  A random number generated for each outgoing connection that is presently used to act as a tiebreaker when 2 devices connect to each other simultaneously; this can also be used for other initialization-scoped things in the future.

• repeated ConnectionRequestFrame.Medium mediums = 5

  The mediums this device supports upgrading to. This list should be filtered by both the strategy and this device's individual limitations.

• optional bytes endpoint_info = 6

• optional MediumMetadata medium_metadata = 7

• optional int32 keep_alive_interval_millis = 8

• optional int32 keep_alive_timeout_millis = 9

• optional int32 device_type = 10

  The type of {@link Device} object.

• optional bytes device_info = 11

  The bytes of serialized {@link Device} object.

Should always match cs/symbol:location.nearby.proto.connections.Medium LINT.IfChange

Used in: ConnectionRequestFrame

• UNKNOWN_MEDIUM = 0

• MDNS = 1

• BLUETOOTH = 2

• WIFI_HOTSPOT = 3

• BLE = 4

• WIFI_LAN = 5

• WIFI_AWARE = 6

• NFC = 7

• WIFI_DIRECT = 8

• WEB_RTC = 9

• BLE_L2CAP = 10

• USB = 11

This doesn't need to send back endpoint_id and endpoint_name (like the ConnectionRequestFrame does) because those have already been transmitted out-of-band, at the time this endpoint was discovered.

Used in: V1Frame

• optional int32 status = 1

  One of: - ConnectionsStatusCodes.STATUS_OK - ConnectionsStatusCodes.STATUS_CONNECTION_REJECTED.

• optional bytes handshake_data = 2

• optional ConnectionResponseFrame.ResponseStatus response = 3

• optional OsInfo os_info = 4

• optional int32 multiplex_socket_bitmask = 5

  A bitmask value to indicate which medium supports Multiplex transmission feature. Each supporting medium could utilize one bit starting from the least significant bit in this field. eq. BT utilizes the LSB bit which 0x01 means bt supports multiplex while 0x00 means not. Refer to ClientProxy.java for the bit usages.

• optional int32 nearby_connections_version = 6

Used to replace the status integer parameter with a meaningful enum item. Map ConnectionsStatusCodes.STATUS_OK to ACCEPT and ConnectionsStatusCodes.STATUS_CONNECTION_REJECTED to REJECT. Flag: connection_replace_status_with_response_connectionResponseFrame

Used in: ConnectionResponseFrame

• UNKNOWN_RESPONSE_STATUS = 0

• ACCEPT = 1

• REJECT = 2

Informs the remote side to immediately severe the socket connection. Used in bandwidth upgrades to get around a race condition, but may be used in other situations to trigger a faster disconnection event than waiting for socket closed on the remote side.

Used in: V1Frame

• optional bool request_safe_to_disconnect = 1

  Apply safe-to-disconnect protocol if true.

• optional bool ack_safe_to_disconnect = 2

  Ack of receiving Disconnection frame will be sent to the sender frame.

Used in: V1Frame

• optional bool ack = 1

  And ack will be sent after receiving KEEP_ALIVE frame.

LocationHint is used to specify a location as well as format.

Used in: BandwidthUpgradeNegotiationFrame.UpgradePathInfo.WebRtcCredentials

• optional string location = 1

  Location is the location, provided in the format specified by format.

• optional LocationStandard.Format format = 2

  the format of location.

(message has no fields)

Used in: LocationHint

• UNKNOWN = 0

• E164_CALLING = 1

  E164 country codes: https://en.wikipedia.org/wiki/List_of_country_calling_codes e.g. +1 for USA

• ISO_3166_1_ALPHA_2 = 2

  ISO 3166-1 alpha-2 country codes: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

Used in: ConnectionRequestFrame

• optional bool supports_5_ghz = 1

  True if local device supports 5GHz.

• optional string bssid = 2

  WiFi LAN BSSID, in the form of a six-byte MAC address: XX:XX:XX:XX:XX:XX

• optional bytes ip_address = 3

  IP address, in network byte order: the highest order byte of the address is in byte[0].

• optional bool supports_6_ghz = 4

  True if local device supports 6GHz.

• optional bool mobile_radio = 5

  True if local device has mobile radio.

• optional int32 ap_frequency = 6

  The frequency of the WiFi LAN AP(in MHz). Or -1 is not associated with an AP over WiFi, -2 represents the active network uses an Ethernet transport.

• optional AvailableChannels available_channels = 7

  Available channels on the local device.

• optional WifiDirectCliUsableChannels wifi_direct_cli_usable_channels = 8

  Usable WiFi Direct client channels on the local device.

• optional WifiLanUsableChannels wifi_lan_usable_channels = 9

  Usable WiFi LAN channels on the local device.

• optional WifiAwareUsableChannels wifi_aware_usable_channels = 10

  Usable WiFi Aware channels on the local device.

• optional WifiHotspotStaUsableChannels wifi_hotspot_sta_usable_channels = 11

  Usable WiFi Hotspot STA channels on the local device.

• optional OfflineFrame.Version version = 1

• optional V1Frame v1 = 2

  Right now there's only 1 version, but if there are more, exactly one of the following fields will be set.

Used in: OfflineFrame

• UNKNOWN_VERSION = 0

• V1 = 1

Device capability for OS information.

Used in: ConnectionResponseFrame

• optional OsInfo.OsType type = 1

Used in: OsInfo

• UNKNOWN_OS_TYPE = 0

• ANDROID = 1

• CHROME_OS = 2

• WINDOWS = 3

• APPLE = 4

• LINUX = 100

  g3 test environment

A paired key encryption packet sent between devices, contains signed data.

Used in: V1Frame

• optional bytes signed_data = 1

  The encrypted data (raw authentication token for the established connection) in byte array format.

Used in: V1Frame

• optional PayloadTransferFrame.PacketType packet_type = 1

• optional PayloadTransferFrame.PayloadHeader payload_header = 2

• optional PayloadTransferFrame.PayloadChunk payload_chunk = 3

  Exactly one of the following fields will be set, depending on the type.

• optional PayloadTransferFrame.ControlMessage control_message = 4

Accompanies CONTROL packets.

Used in: PayloadTransferFrame

• optional ControlMessage.EventType event = 1

• optional int64 offset = 2

Used in: ControlMessage

• UNKNOWN_EVENT_TYPE = 0

• PAYLOAD_ERROR = 1

• PAYLOAD_CANCELED = 2

• PAYLOAD_RECEIVED_ACK = 3

Used in: PayloadTransferFrame

• UNKNOWN_PACKET_TYPE = 0

• DATA = 1

• CONTROL = 2

Accompanies DATA packets.

Used in: PayloadTransferFrame

• optional int32 flags = 1

• optional int64 offset = 2

• optional bytes body = 3

• LAST_CHUNK = 1

Used in: PayloadTransferFrame

• optional int64 id = 1

• optional PayloadHeader.PayloadType type = 2

• optional int64 total_size = 3

• optional bool is_sensitive = 4

• optional string file_name = 5

• optional string parent_folder = 6

Used in: PayloadHeader

• UNKNOWN_PAYLOAD_TYPE = 0

• BYTES = 1

• FILE = 2

• STREAM = 3

Used in: OfflineFrame

• optional V1Frame.FrameType type = 1

• optional ConnectionRequestFrame connection_request = 2

  Exactly one of the following fields will be set.

• optional ConnectionResponseFrame connection_response = 3

• optional PayloadTransferFrame payload_transfer = 4

• optional BandwidthUpgradeNegotiationFrame bandwidth_upgrade_negotiation = 5

• optional KeepAliveFrame keep_alive = 6

• optional DisconnectionFrame disconnection = 7

• optional PairedKeyEncryptionFrame paired_key_encryption = 8

Used in: V1Frame

• UNKNOWN_FRAME_TYPE = 0

• CONNECTION_REQUEST = 1

• CONNECTION_RESPONSE = 2

• PAYLOAD_TRANSFER = 3

• BANDWIDTH_UPGRADE_NEGOTIATION = 4

• KEEP_ALIVE = 5

• DISCONNECTION = 6

• PAIRED_KEY_ENCRYPTION = 7

Usable WiFi Aware channels on the local device.

Used in: MediumMetadata

• repeated int32 channels = 1

Usable WiFi Direct client channels on the local device.

Used in: MediumMetadata

• repeated int32 channels = 1

Usable WiFi Hotspot STA channels on the local device.

Used in: MediumMetadata

• repeated int32 channels = 1

Usable WiFi LAN channels on the local device.

Used in: MediumMetadata

• repeated int32 channels = 1