public abstract class

MessageListener

extends Object
java.lang.Object
   ↳ com.google.android.gms.nearby.messages.MessageListener

Class Overview

A listener for receiving subscribed messages. These callbacks will be delivered when messages are found or lost.

Summary

Public Constructors
MessageListener()
Public Methods
void onBleSignalChanged(Message message, BleSignal bleSignal)
Called when the Bluetooth Low Energy (BLE) signal associated with a message changes.
void onDistanceChanged(Message message, Distance distance)
Called when Nearby's estimate of the distance to a message changes.
void onFound(Message message)
Called when messages are found.
void onLost(Message message)
Called when a message is no longer detectable nearby.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public MessageListener ()

Public Methods

public void onBleSignalChanged (Message message, BleSignal bleSignal)

Called when the Bluetooth Low Energy (BLE) signal associated with a message changes.

For example, this is called when we see the first BLE advertisement frame associated with a message; or when we see subsequent frames with different RSSI.

Note: This callback currently only works for BLE beacon messages.

Note: This callback is not supported by the version of subscribe(GoogleApiClient, PendingIntent) that takes a PendingIntent.

Parameters
message Message
bleSignal BleSignal

public void onDistanceChanged (Message message, Distance distance)

Called when Nearby's estimate of the distance to a message changes.

For example, this is called when we first gather enough information to make a distance estimate; or when the message remains nearby, but gets closer or further away.

Note: This callback currently only works for BLE beacon messages.

Note: This callback is not supported by the version of subscribe(GoogleApiClient, PendingIntent) that takes a PendingIntent.

Parameters
message Message: The message whose distance changed.
distance Distance: The new distance estimate.

public void onFound (Message message)

Called when messages are found.

This method is called the first time the message is seen nearby. After a message has been lost (see onLost(Message)), it's eligible for onFound(Message) again.

Parameters
message Message: The found message.

public void onLost (Message message)

Called when a message is no longer detectable nearby.

Note: This callback currently works best for BLE beacon messages. For other messages, it may not be called in a timely fashion, or at all.

This method will not be called repeatedly (unless the message is found again between lost calls).

Parameters
message Message: The lost message.