summaryrefslogtreecommitdiffstats
path: root/docs/html/training
diff options
context:
space:
mode:
authorLuan Nguyen <luann@google.com>2015-04-28 20:39:14 +0000
committerAndroid Git Automerger <android-git-automerger@android.com>2015-04-28 20:39:14 +0000
commit4e7500e10cf10eb697bb3e916bf705b9db470c8f (patch)
tree5bf917b1e84012ab9fed9b0effb72f10c919de44 /docs/html/training
parenta4edc82e9b50189b187996e8c4f4e851bdf83893 (diff)
parentc1609dc0b25c3143ae8d74bc44fb36873b7d289c (diff)
downloadframeworks_base-4e7500e10cf10eb697bb3e916bf705b9db470c8f.zip
frameworks_base-4e7500e10cf10eb697bb3e916bf705b9db470c8f.tar.gz
frameworks_base-4e7500e10cf10eb697bb3e916bf705b9db470c8f.tar.bz2
am c1609dc0: docs: Update information on delivering message to clarify that MessageAPI is not reliable.
* commit 'c1609dc0b25c3143ae8d74bc44fb36873b7d289c': docs: Update information on delivering message to clarify that MessageAPI is not reliable.
Diffstat (limited to 'docs/html/training')
-rw-r--r--docs/html/training/wearables/data-layer/messages.jd12
1 files changed, 10 insertions, 2 deletions
diff --git a/docs/html/training/wearables/data-layer/messages.jd b/docs/html/training/wearables/data-layer/messages.jd
index 043aff2..ef9bfb1 100644
--- a/docs/html/training/wearables/data-layer/messages.jd
+++ b/docs/html/training/wearables/data-layer/messages.jd
@@ -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>