Clarify deprecated API

Change-Id: I73f1be0ec31fd4d023b34f3c4392f749c427dd26
Signed-off-by: Minje Ahn <minje.ahn@samsung.com>

diff --git a/include/media_audio.h b/include/media_audio.h
index 2b8fd7f..ff80926 100755 (executable)
--- a/include/media_audio.h
+++ b/include/media_audio.h
@@ -390,7 +390,7 @@ int audio_meta_get_duration(audio_meta_h audio, int *duration);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
-int audio_meta_get_played_count(audio_meta_h audio, int *played_count);
+int audio_meta_get_played_count(audio_meta_h audio, int *played_count) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_get_played_time() instead]
@@ -408,7 +408,7 @@ int audio_meta_get_played_count(audio_meta_h audio, int *played_count);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
-int audio_meta_get_played_time(audio_meta_h audio, time_t *played_time);
+int audio_meta_get_played_time(audio_meta_h audio, time_t *played_time) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif.
@@ -428,7 +428,7 @@ int audio_meta_get_played_time(audio_meta_h audio, time_t *played_time);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
-int audio_meta_get_played_position(audio_meta_h audio, int *played_position);
+int audio_meta_get_played_position(audio_meta_h audio, int *played_position) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_increase_played_count() instead]
@@ -447,7 +447,7 @@ int audio_meta_get_played_position(audio_meta_h audio, int *played_position);
  *
  * @post audio_meta_update_to_db().
  */
-int audio_meta_set_played_count(audio_meta_h audio, int played_count);
+int audio_meta_set_played_count(audio_meta_h audio, int played_count) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_set_played_time() instead]
@@ -466,7 +466,7 @@ int audio_meta_set_played_count(audio_meta_h audio, int played_count);
  *
  * @post audio_meta_update_to_db().
  */
-int audio_meta_set_played_time(audio_meta_h audio, time_t played_time);
+int audio_meta_set_played_time(audio_meta_h audio, time_t played_time) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif.
@@ -488,7 +488,7 @@ int audio_meta_set_played_time(audio_meta_h audio, time_t played_time);
  *
  * @post audio_meta_update_to_db().
  */
-int audio_meta_set_played_position(audio_meta_h audio, int played_position);
+int audio_meta_set_played_position(audio_meta_h audio, int played_position) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Updates an audio metadata with modified attributes in the media database.

diff --git a/include/media_video.h b/include/media_video.h
index 9b465e6..9d8da34 100755 (executable)
--- a/include/media_video.h
+++ b/include/media_video.h
@@ -375,7 +375,6 @@ int video_meta_get_height(video_meta_h video, int *height);
  */
 int video_meta_get_rotation(video_meta_h video, int *rotation);
 
-
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_get_played_count() instead]
  * @brief Gets the played count of the video.
@@ -391,7 +390,7 @@ int video_meta_get_rotation(video_meta_h video, int *rotation);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
-int video_meta_get_played_count(video_meta_h video, int *played_count);
+int video_meta_get_played_count(video_meta_h video, int *played_count) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_get_played_time() instead]
@@ -408,7 +407,7 @@ int video_meta_get_played_count(video_meta_h video, int *played_count);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
-int video_meta_get_played_time(video_meta_h video, time_t *played_time);
+int video_meta_get_played_time(video_meta_h video, time_t *played_time) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif.
@@ -428,7 +427,7 @@ int video_meta_get_played_time(video_meta_h video, time_t *played_time);
  * @retval #MEDIA_CONTENT_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval #MEDIA_CONTENT_ERROR_PERMISSION_DENIED Permission denied
  */
-int video_meta_get_played_position(video_meta_h video, int *played_position);
+int video_meta_get_played_position(video_meta_h video, int *played_position) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_increase_played_count() instead]
@@ -447,7 +446,7 @@ int video_meta_get_played_position(video_meta_h video, int *played_position);
  *
  * @post video_meta_update_to_db().
  */
-int video_meta_set_played_count(video_meta_h video, int played_count);
+int video_meta_set_played_count(video_meta_h video, int played_count) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif. [Use media_info_set_played_time() instead]
@@ -466,7 +465,7 @@ int video_meta_set_played_count(video_meta_h video, int played_count);
  *
  * @post video_meta_update_to_db().
  */
-int video_meta_set_played_time(video_meta_h video, time_t played_time);
+int video_meta_set_played_time(video_meta_h video, time_t played_time) TIZEN_DEPRECATED_API;
 
 /**
  * @deprecated Deprecated since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif.
@@ -488,7 +487,7 @@ int video_meta_set_played_time(video_meta_h video, time_t played_time);
  *
  * @post video_meta_update_to_db().
  */
-int video_meta_set_played_position(video_meta_h video, int played_position);
+int video_meta_set_played_position(video_meta_h video, int played_position) TIZEN_DEPRECATED_API;
 
 /**
  * @brief Updates an video metadata with modified attributes in the media database.

diff --git a/src/media_audio.c b/src/media_audio.c
index 7c39ea9..e27ce41 100755 (executable)
--- a/src/media_audio.c
+++ b/src/media_audio.c
@@ -475,6 +475,7 @@ int audio_meta_get_duration(audio_meta_h audio, int *duration)
 int audio_meta_get_played_count(audio_meta_h audio, int *played_count)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: audio_meta_get_played_count() is deprecated and will be removed from next release. Use media_info_get_played_count() instead.");
        audio_meta_s *_audio = (audio_meta_s*)audio;
 
        if (_audio && played_count) {
@@ -491,6 +492,7 @@ int audio_meta_get_played_count(audio_meta_h audio, int *played_count)
 int audio_meta_get_played_time(audio_meta_h audio, time_t* played_time)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: audio_meta_get_played_time() is deprecated and will be removed from next release. Use media_info_get_played_time() instead.");
        audio_meta_s *_audio = (audio_meta_s*)audio;
 
        if (_audio) {
@@ -507,6 +509,7 @@ int audio_meta_get_played_time(audio_meta_h audio, time_t* played_time)
 int audio_meta_get_played_position(audio_meta_h audio, int *played_position)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: audio_meta_get_played_position() is deprecated and will be removed from next release.");
        audio_meta_s *_audio = (audio_meta_s*)audio;
 
        if (_audio) {
@@ -523,6 +526,7 @@ int audio_meta_get_played_position(audio_meta_h audio, int *played_position)
 int audio_meta_set_played_count(audio_meta_h audio, int played_count)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: audio_meta_set_played_count() is deprecated and will be removed from next release. Use media_info_increase_played_count() instead.");
        audio_meta_s *_audio = (audio_meta_s*)audio;
 
        if ((_audio != NULL) && (played_count >= 0)) {
@@ -538,6 +542,7 @@ int audio_meta_set_played_count(audio_meta_h audio, int played_count)
 int audio_meta_set_played_time(audio_meta_h audio, time_t played_time)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: audio_meta_set_played_time() is deprecated and will be removed from next release. Use media_info_set_played_time() instead.");
        audio_meta_s *_audio = (audio_meta_s*)audio;
 
        if ((_audio != NULL) && (played_time >= 0)) {
@@ -553,6 +558,7 @@ int audio_meta_set_played_time(audio_meta_h audio, time_t played_time)
 int audio_meta_set_played_position(audio_meta_h audio, int played_position)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: audio_meta_set_played_position() is deprecated and will be removed from next release.");
        audio_meta_s *_audio = (audio_meta_s*)audio;
 
        if ((_audio != NULL) && (played_position >= 0)) {

diff --git a/src/media_video.c b/src/media_video.c
index 3ba6f6b..ba0f3ad 100755 (executable)
--- a/src/media_video.c
+++ b/src/media_video.c
@@ -486,6 +486,7 @@ int video_meta_get_rotation(video_meta_h video, int *rotation)
 int video_meta_get_played_count(video_meta_h video, int *played_count)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: video_meta_get_played_count() is deprecated and will be removed from next release. Use media_info_get_played_count() instead.");
        video_meta_s *_video = (video_meta_s*)video;
 
        if (_video && played_count) {
@@ -502,6 +503,7 @@ int video_meta_get_played_count(video_meta_h video, int *played_count)
 int video_meta_get_played_time(video_meta_h video, time_t* played_time)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: video_meta_get_played_time() is deprecated and will be removed from next release. Use media_info_get_played_time() instead.");
        video_meta_s *_video = (video_meta_s*)video;
 
        if (_video) {
@@ -518,6 +520,7 @@ int video_meta_get_played_time(video_meta_h video, time_t* played_time)
 int video_meta_get_played_position(video_meta_h video, int *played_position)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: video_meta_get_played_position() is deprecated and will be removed from next release.");
        video_meta_s *_video = (video_meta_s*)video;
 
        if (_video) {
@@ -534,6 +537,7 @@ int video_meta_get_played_position(video_meta_h video, int *played_position)
 int video_meta_set_played_count(video_meta_h video, int played_count)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: video_meta_set_played_count() is deprecated and will be removed from next release. Use media_info_increase_played_count() instead.");
        video_meta_s *_video = (video_meta_s*)video;
 
        if ((_video != NULL) && (played_count >= 0)) {
@@ -549,6 +553,7 @@ int video_meta_set_played_count(video_meta_h video, int played_count)
 int video_meta_set_played_time(video_meta_h video, time_t played_time)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: video_meta_set_played_time() is deprecated and will be removed from next release. Use media_info_set_played_time() instead.");
        video_meta_s *_video = (video_meta_s*)video;
 
        if ((_video != NULL) && (played_time >= 0)) {
@@ -564,6 +569,7 @@ int video_meta_set_played_time(video_meta_h video, time_t played_time)
 int video_meta_set_played_position(video_meta_h video, int played_position)
 {
        int ret = MEDIA_CONTENT_ERROR_NONE;
+       media_content_warn("DEPRECATION WARNING: video_meta_set_played_position() is deprecated and will be removed from next release.");
        video_meta_s *_video = (video_meta_s*)video;
 
        if ((_video != NULL) && (played_position >= 0)) {