From: Mu-Woong Date: Wed, 1 Jul 2015 11:11:10 +0000 (+0900) Subject: [context] Update contextual history API guide regarding recent ACRs, including ACR-301 X-Git-Tag: tizen_3.0/TD_SYNC/20161201~744^2 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=a5d58f3c25fc48b4c79534cb186d30bcaa5e8b81;p=sdk%2Fonline-doc.git [context] Update contextual history API guide regarding recent ACRs, including ACR-301 Change-Id: Ia458a61abff21eb18faf05e7c27456fc0760178c Signed-off-by: Mu-Woong --- diff --git a/org.tizen.guides/html/native/context/history_n.htm b/org.tizen.guides/html/native/context/history_n.htm index abb4866..90a1596 100644 --- a/org.tizen.guides/html/native/context/history_n.htm +++ b/org.tizen.guides/html/native/context/history_n.htm @@ -50,7 +50,7 @@ -

The Contextual History API provides history data about application usage, media playback, communications, and device settings. When an application reads each type of history data, the application must set filters (mandatory and optional) to specify the necessary statistics. The following example shows how to get information about the 5 most frequently used applications from the last 30 days.

+

The Contextual History API provides history data about application usage, media playback, communications, and device settings. When an application reads each type of history data, the application can set filters to specify the necessary statistics. The following example shows how to get information about the 5 most frequently used applications from the last 30 days.

 // Setting filter key and values
 context_history_filter_set_int(filter, CONTEXT_HISTORY_FILTER_RESULT_SIZE, 5);
@@ -65,7 +65,7 @@ Once the context_hist
 
 
History Data Types

 
-
Through contextual history, you can mainly retrieve statistics for 3 types of usages logs, including application usage, media playback, and communications. The following table summarizes the available history data types and required privileges.

+
Through contextual history, you can mainly retrieve statistics for 3 categories of usages logs, including application usage, media playback, and communications. The following table summarizes the available history data types and required privileges.

 
 
@@ -154,7 +154,7 @@ Once the context_hist
 			
-			
@@ -174,6 +174,12 @@ Once the context_hist
 			
 		
+			
-			
-			
-			
-		
-		
-			
-			
-			
+			
+			

 	Table: History data types and required privileges
Description
 		

 		

+			
 				All types
 			
 			CONTEXT_HISTORY_FILTER_TIME_SPAN

 		

+				All types EXCEPT:
+				
CONTEXT_HISTORY_COMMON_SETTING_FOR_APP

+				
CONTEXT_HISTORY_COMMON_SETTING_FOR_MUSIC

+				
CONTEXT_HISTORY_COMMON_SETTING_FOR_VIDEO

+					
 			CONTEXT_HISTORY_FILTER_RESULT_SIZE
 			Integer
 			
@@ -201,36 +207,27 @@ Once the context_hist
 			
 		

 		

+			
 				CONTEXT_HISTORY_PEAK_TIME_FOR_APP
-				
CONTEXT_HISTORY_PEAK_TIME_FOR_MUSIC

-				
CONTEXT_HISTORY_PEAK_TIME_FOR_VIDEO

+				
CONTEXT_HISTORY_COMMON_SETTING_FOR_APP
 			

 			CONTEXT_HISTORY_FILTER_APP_ID
 			String
 			
-				Use the CONTEXT_HISTORY_PEAK_TIME_FOR_APP filter to compute the peak time for a specific application. Without this filter, the peak time is computed from the usage history of all applications.
-				
In case of the peak time for music or video playbacks, these filters can be used to restrict the application that is used to play the media contents. Without this filter, playback logs from all applications are used to get the statistics.

+				Use this filter to compute the peak time (or the common settings) for a specific application. Without this filter, the peak time (or the common setting) is computed from the usage history of all applications.
 				
For more information on the application IDs, see the Application Framework guide.

 					
 		

 		
CONTEXT_HISTORY_FILTER_DAY_OF_WEEKInteger
 			
-				Use this filter to get application usage patterns on weekdays or weekends. The filter value can be either CONTEXT_HISTORY_FILTER_DAY_OF_WEEK_WEEKDAYS, CONTEXT_HISTORY_FILTER_DAY_OF_WEEK_WEEKENDS, or CONTEXT_HISTORY_FILTER_DAY_OF_WEEK_ALL. By default, data from both weekdays and weekends are used if this filter is not set.
-			
CONTEXT_HISTORY_COMMON_SETTING_FOR_APP
-				
CONTEXT_HISTORY_COMMON_SETTING_FOR_MUSIC

-				
CONTEXT_HISTORY_COMMON_SETTING_FOR_VIDEO

+				CONTEXT_HISTORY_PEAK_TIME_FOR_APP
+				
CONTEXT_HISTORY_PEAK_TIME_FOR_MUSIC
+				
CONTEXT_HISTORY_PEAK_TIME_FOR_VIDEO
 			
CONTEXT_HISTORY_FILTER_APP_IDStringCONTEXT_HISTORY_FILTER_DAY_OF_WEEKInteger
 			
-				Use this filter to retrieve the most common setting values for a specific application.
-				
In case of music or video playback history, this filter can be used to get the common setting values when listening to music or watching videos using a specific application.

+				Use this filter to get usage patterns on weekdays or weekends. The filter value can be either CONTEXT_HISTORY_FILTER_DAY_OF_WEEK_WEEKDAYS, CONTEXT_HISTORY_FILTER_DAY_OF_WEEK_WEEKENDS, or CONTEXT_HISTORY_FILTER_DAY_OF_WEEK_ALL. By default, data from both weekdays and weekends are used if this filter is not set.