From c1609dc0b25c3143ae8d74bc44fb36873b7d289c Mon Sep 17 00:00:00 2001 From: Luan Nguyen Date: Tue, 28 Apr 2015 11:36:42 -0700 Subject: [PATCH] docs: Update information on delivering message to clarify that MessageAPI is not reliable. bug: 20088602 Change-Id: I2244598e5a155bc6e477d367287b8683ebdf019f --- docs/html/training/wearables/data-layer/messages.jd | 12 ++++++++++-- 1 file 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 043aff2f1dd9d..ef9bfb176a5bc 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.

Multiple wearable devices can be connected to a user’s handheld device. Each connected device in the network is considered a node. 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.

@@ -196,7 +196,15 @@ class.

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. +

+ +

Note: A successful result code does not guarantee delivery of the +message. If your app requires data reliability, use +DataItem +objects or the +ChannelApi +class to send data between devices.