webrtc: Add missing precondition for negotiation callbacks

[Version] 0.2.106
[Issue Type] Doxygen

Change-Id: If95522da7cdd138ca5a4f1eb734bd9b4f0a7353d
Signed-off-by: Sangchul Lee <sc11.lee@samsung.com>

diff --git a/include/webrtc.h b/include/webrtc.h
index 22398ed2baf6853eb8a2bac2a7942b2d27745b47..72df47e5db9ddf0ea81c938ebf400b4afc05a47b 100644 (file)
--- a/include/webrtc.h
+++ b/include/webrtc.h
@@ -1404,6 +1404,7 @@ int webrtc_get_ice_transport_policy(webrtc_h webrtc, webrtc_ice_transport_policy
  *         otherwise a negative error value
  * @retval #WEBRTC_ERROR_NONE    Successful
  * @retval #WEBRTC_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a webrtc state must be set to #WEBRTC_STATE_IDLE.
  * @post webrtc_peer_connection_state_change_cb() will be invoked.
  * @see webrtc_unset_peer_connection_state_change_cb()
  * @see webrtc_peer_connection_state_change_cb()
@@ -1420,6 +1421,7 @@ int webrtc_set_peer_connection_state_change_cb(webrtc_h webrtc, webrtc_peer_conn
  * @retval #WEBRTC_ERROR_NONE    Successful
  * @retval #WEBRTC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #WEBRTC_ERROR_INVALID_OPERATION Invalid operation
+ * @pre @a webrtc state must be set to #WEBRTC_STATE_IDLE.
  * @see webrtc_set_peer_connection_state_change_cb()
  * @see webrtc_get_peer_connection_state()
  */
@@ -1451,6 +1453,7 @@ int webrtc_get_peer_connection_state(webrtc_h webrtc, webrtc_peer_connection_sta
  *         otherwise a negative error value
  * @retval #WEBRTC_ERROR_NONE    Successful
  * @retval #WEBRTC_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a webrtc state must be set to #WEBRTC_STATE_IDLE.
  * @post webrtc_signaling_state_change_cb() will be invoked.
  * @see webrtc_unset_signaling_state_change_cb()
  * @see webrtc_signaling_state_change_cb()
@@ -1467,6 +1470,7 @@ int webrtc_set_signaling_state_change_cb(webrtc_h webrtc, webrtc_signaling_state
  * @retval #WEBRTC_ERROR_NONE    Successful
  * @retval #WEBRTC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #WEBRTC_ERROR_INVALID_OPERATION Invalid operation
+ * @pre @a webrtc state must be set to #WEBRTC_STATE_IDLE.
  * @see webrtc_set_signaling_state_change_cb()
  * @see webrtc_get_signaling_state()
  */
@@ -1498,6 +1502,7 @@ int webrtc_get_signaling_state(webrtc_h webrtc, webrtc_signaling_state_e *state)
  *         otherwise a negative error value
  * @retval #WEBRTC_ERROR_NONE    Successful
  * @retval #WEBRTC_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a webrtc state must be set to #WEBRTC_STATE_IDLE.
  * @post webrtc_ice_gathering_state_change_cb() will be invoked.
  * @see webrtc_unset_ice_gathering_state_change_cb()
  * @see webrtc_ice_gathering_state_change_cb()
@@ -1514,6 +1519,7 @@ int webrtc_set_ice_gathering_state_change_cb(webrtc_h webrtc, webrtc_ice_gatheri
  * @retval #WEBRTC_ERROR_NONE    Successful
  * @retval #WEBRTC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #WEBRTC_ERROR_INVALID_OPERATION Invalid operation
+ * @pre @a webrtc state must be set to #WEBRTC_STATE_IDLE.
  * @see webrtc_set_ice_gathering_state_change_cb()
  * @see webrtc_get_ice_gathering_state()
  */
@@ -1545,6 +1551,7 @@ int webrtc_get_ice_gathering_state(webrtc_h webrtc, webrtc_ice_gathering_state_e
  *         otherwise a negative error value
  * @retval #WEBRTC_ERROR_NONE    Successful
  * @retval #WEBRTC_ERROR_INVALID_PARAMETER Invalid parameter
+ * @pre @a webrtc state must be set to #WEBRTC_STATE_IDLE.
  * @post webrtc_ice_connection_state_change_cb() will be invoked.
  * @see webrtc_unset_ice_connection_state_change_cb()
  * @see webrtc_ice_connection_state_change_cb()
@@ -1561,6 +1568,7 @@ int webrtc_set_ice_connection_state_change_cb(webrtc_h webrtc, webrtc_ice_connec
  * @retval #WEBRTC_ERROR_NONE    Successful
  * @retval #WEBRTC_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #WEBRTC_ERROR_INVALID_OPERATION Invalid operation
+ * @pre @a webrtc state must be set to #WEBRTC_STATE_IDLE.
  * @see webrtc_set_ice_connection_state_change_cb()
  * @see webrtc_get_ice_connection_state()
  */

diff --git a/packaging/capi-media-webrtc.spec b/packaging/capi-media-webrtc.spec
index cfe6abb83c5a2178edbe4a22653db8b27ee8cd75..81c38768bdda1c83ebe615aa3b55b4c8ea5e7ad9 100644 (file)
--- a/packaging/capi-media-webrtc.spec
+++ b/packaging/capi-media-webrtc.spec
@@ -1,6 +1,6 @@
 Name:       capi-media-webrtc
 Summary:    A WebRTC library in Tizen Native API
-Version:    0.2.105
+Version:    0.2.106
 Release:    0
 Group:      Multimedia/API
 License:    Apache-2.0