drgreen/android_frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Update information on delivering message to clarify that

Browse Source 
MessageAPI is not reliable.

bug: 20088602
Change-Id: I2244598e5a155bc6e477d367287b8683ebdf019f
This commit is contained in:
Luan Nguyen
2015-04-28 11:36:42 -07:00
parent 0312f37785
commit c1609dc0b2
1 changed files with 10 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/html/training/wearables/data-layer/messages.jd
View File

@ -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>