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

Commit 50ea9422 authored by Luan Nguyen's avatar Luan Nguyen Committed by Android Git Automerger
Browse files

am 4e7500e1: am c1609dc0: docs: Update information on delivering message to... 

am 4e7500e1: am c1609dc0: docs: Update information on delivering message to clarify that MessageAPI is not reliable.

* commit '4e7500e1':
  docs: Update information on delivering message to clarify that MessageAPI is not reliable.
parents 6bb65f0d 4e7500e1

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

+10 −2
Original line number Original line 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

<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

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

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>

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

<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

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>

</p>





<pre>

<pre>