A listener for receiving subscribed messages. These callbacks will be delivered when messages are found or lost.
Public Constructor Summary
Public Method Summary
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 | |
void |
Inherited Method Summary
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
Messages.subscribe(GoogleApiClient, PendingIntent)
that takes a
PendingIntent
.
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
Messages.subscribe(GoogleApiClient, PendingIntent)
that takes a
PendingIntent
.
Parameters
message | The message whose distance changed. |
---|---|
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 | 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 | The lost message. |
---|