Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit c1609dc0 authored by Luan Nguyen's avatar Luan Nguyen
Browse files

docs: Update information on delivering message to clarify that 

MessageAPI is not reliable.

bug: 20088602
Change-Id: I2244598e5a155bc6e477d367287b8683ebdf019f
parent 0312f377

docs/html/training/wearables/data-layer/messages.jd

+10 −2
Original line number Diff line number Diff line
@@ -34,7 +34,7 @@ such as sending a message to the wearable to start an activity.</p> 


<p>Multiple wearable devices can be connected to a user’s handheld device. Each connected device in

the network is considered a <em>node</em>. With multiple connected devices, you must consider which

nodes receive the messages. For example, In a voice transcription app that receives voice data on

nodes receive the messages. For example, in a voice transcription app that receives voice data on

the wearable device, you should send the message to a node with the processing power and battery

capacity to handle the request, such as a handheld device.</p>
@@ -196,7 +196,15 @@ class.</p> 


<p>The following example shows how to send a message to the transcription-capable node from a

wearable device. Verify that the node is available before you attempt to send the message. This call

is synchronous and blocks processing until the message is received or until the request times out.

is synchronous and blocks processing until the system queues the message for delivery.

</p>



<p class="note"><strong>Note:</strong> A successful result code does not guarantee delivery of the

message. If your app requires data reliability, use

<a href="{@docRoot}reference/com/google/android/gms/wearable/DataItem.html"><code>DataItem</code></a>

objects or the

<a href="{@docRoot}reference/com/google/android/gms/wearable/ChannelApi.html"><code>ChannelApi</code></a>

class to send data between devices.

</p>



<pre>