Modified Push Tutorial ; 1. Added warning comment, 2. Replaced internal enum value
authorYounho Park <younho.park@samsung.com>
Thu, 3 Dec 2015 04:33:17 +0000 (13:33 +0900)
committerYounho Park <younho.park@samsung.com>
Thu, 3 Dec 2015 04:33:17 +0000 (13:33 +0900)
Change-Id: I2a780475074408812b18b77477bec269933d1484
Signed-off-by: Younho Park <younho.park@samsung.com>
org.tizen.tutorials/html/native/messaging/push_tutorial_n.htm

index e1bcc95..d9ce771 100644 (file)
@@ -236,7 +236,7 @@ push_service_disconnect(push_conn);
 push_conn = NULL;
 </pre>
 
-<p>The connection is automatically closed when the application terminates. Hence, if the application uses the push service while being launched, it does not need this function. However, the application can disconnect the service in the middle of the application operation. If you add a toggle switch to the application for switching the push service on and off, call this function when the service is switched off.</p>
+<p>The connection is automatically closed when the application terminates. Hence, if the application uses the push service while being launched, it does not need this function. However, the application can disconnect the service in the middle of the application operation. If you add a toggle switch to the application for switching the push service on and off, call this function when the service is switched off. If you call this function in the push callback functions, it may cause your application to crash.</p>
 </li>
 
 <li id="state" name="state">Handle state transitions.
@@ -320,7 +320,7 @@ _result_cb(push_service_result_e result, const char *msg, void *user_data)
 }
 </pre>
 
-<p>When an error occurs in the middle of the registration process, the reason is returned in the first parameter of the callback. For example, if the push server is not responding, the <span style="font-family: Courier New,Courier,monospace;">push_service_register()</span> function returns <span style="font-family: Courier New,Courier,monospace;">PUSH_SERVICE_ERROR_NONE</span> (because delivery to the service is successful), but the <span style="font-family: Courier New,Courier,monospace;">_result_cb()</span> function is called later with <span style="font-family: Courier New,Courier,monospace;">PUSH_RESULT_TIMEOUT</span>. In this case, the application does not need to request registration again because the push service keeps the previous request and sends it when the network becomes online. The <span style="font-family: Courier New,Courier,monospace;">msg</span> parameter is the error message from the push service if the request fails.</p>
+<p>When an error occurs in the middle of the registration process, the reason is returned in the first parameter of the callback. For example, if the push server is not responding, the <span style="font-family: Courier New,Courier,monospace;">push_service_register()</span> function returns <span style="font-family: Courier New,Courier,monospace;">PUSH_SERVICE_ERROR_NONE</span> (because delivery to the service is successful), but the <span style="font-family: Courier New,Courier,monospace;">_result_cb()</span> function is called later with <span style="font-family: Courier New,Courier,monospace;">PUSH_SERVICE_RESULT_TIMEOUT</span>. In this case, the application does not need to request registration again because the push service keeps the previous request and sends it when the network becomes online. The <span style="font-family: Courier New,Courier,monospace;">msg</span> parameter is the error message from the push service if the request fails.</p>
 </li>
 
 <li id="upon" name="upon">Handle the transit to the <span style="font-family: Courier New,Courier,monospace;">REGISTERED</span> state.
@@ -952,4 +952,4 @@ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga
 </script>
 
  </body>
-</html>
\ No newline at end of file
+</html>