Tizen Native API
|
Functions | |
int | context_trigger_add_rule (context_trigger_rule_h rule, int *rule_id) |
Registers a rule. | |
int | context_trigger_remove_rule (int rule_id) |
Removes a rule. | |
int | context_trigger_enable_rule (int rule_id) |
Enables a rule. | |
int | context_trigger_disable_rule (int rule_id) |
Disables a rule. | |
int | context_trigger_get_own_rule_ids (int **enabled_rule_ids, int *enabled_rule_count, int **disabled_rule_ids, int *disabled_rule_count) |
Gets the IDs of the rules owned by the current application. | |
int | context_trigger_get_rule_by_id (int rule_id, context_trigger_rule_h *rule) |
Gets a rule stored in the system by rule ID. | |
int | context_trigger_rule_create (context_trigger_logical_type_e logical_type, context_trigger_rule_h *rule) |
Creates an empty rule. | |
int | context_trigger_rule_destroy (context_trigger_rule_h rule) |
Releases the resources occupied by a rule handle. | |
int | context_trigger_rule_add_entry (context_trigger_rule_h rule, context_trigger_rule_entry_h entry) |
Adds an event or a condition to a rule. | |
int | context_trigger_rule_set_action_app_control (context_trigger_rule_h rule, app_control_h app_control) |
Sets a app launching request as the action of a rule. | |
int | context_trigger_rule_set_action_notification (context_trigger_rule_h rule, const char *title, const char *content, const char *icon_path, app_control_h app_control) |
Sets a notification posting request as the action of a rule. | |
int | context_trigger_rule_set_description (context_trigger_rule_h rule, const char *description) |
Sets the description of a rule. | |
int | context_trigger_rule_get_description (context_trigger_rule_h rule, char **description) |
Gets the description of a rule. | |
int | context_trigger_rule_event_create (context_trigger_event_e event_item, context_trigger_logical_type_e logical_type, context_trigger_rule_entry_h *entry) |
Creates an event entry. | |
int | context_trigger_rule_event_is_supported (context_trigger_event_e event_item, bool *supported) |
Checks whether a contextual event is supported in the current device. | |
int | context_trigger_rule_condition_create (context_trigger_condition_e condition_item, context_trigger_logical_type_e logical_type, context_trigger_rule_entry_h *entry) |
Creates a condition entry. | |
int | context_trigger_rule_condition_is_supported (context_trigger_condition_e condition_item, bool *supported) |
Checks whether a contextual condition is supported in the current device. | |
int | context_trigger_rule_entry_destroy (context_trigger_rule_entry_h entry) |
Releases the resource occupied by an entry. | |
int | context_trigger_rule_entry_add_option_int (context_trigger_rule_entry_h entry, const char *option_key, int value) |
Sets an integer type option to an event or condition entry. | |
int | context_trigger_rule_entry_add_option_string (context_trigger_rule_entry_h entry, const char *option_key, const char *value) |
Sets a string type option to an event or condition entry. | |
int | context_trigger_rule_entry_add_option (context_trigger_rule_entry_h entry, const char *option_key, const char *event_data_key) |
Sets an option to a condition entry, which references an attribute that will be extracted from the event. | |
int | context_trigger_rule_entry_add_key (context_trigger_rule_entry_h entry, context_trigger_logical_type_e logical_type, const char *key) |
Adds an attribute key to an entry. | |
int | context_trigger_rule_entry_add_comparison_int (context_trigger_rule_entry_h entry, const char *key, const char *comp_operator, int value) |
Adds a comparison between an attribute key and an integer. | |
int | context_trigger_rule_entry_add_comparison_string (context_trigger_rule_entry_h entry, const char *key, const char *comp_operator, const char *value) |
Adds a comparison between an attribute key and a string. | |
int | context_trigger_rule_entry_add_comparison (context_trigger_rule_entry_h entry, const char *key, const char *comp_operator, const char *event_data_key) |
Adds a comparison between an attribute of a condition and an attribute extracted from the event. | |
Typedefs | |
typedef struct _context_trigger_rule_s * | context_trigger_rule_h |
Handle for editing a trigger rule. | |
typedef struct _context_trigger_rule_entry_s * | context_trigger_rule_entry_h |
Handle for editing an event or a condition, which is added to a rule. | |
Defines | |
#define | CONTEXT_TRIGGER_EQUAL_TO "==" |
The operator "is equal to". | |
#define | CONTEXT_TRIGGER_NOT_EQUAL_TO "!=" |
The operator "is not equal to". | |
#define | CONTEXT_TRIGGER_GREATER_THAN ">" |
The operator "is greater than". | |
#define | CONTEXT_TRIGGER_GREATER_THAN_OR_EQUAL_TO ">=" |
The operator "is greater than or equal to". | |
#define | CONTEXT_TRIGGER_LESS_THAN "<" |
The operator "is less than". | |
#define | CONTEXT_TRIGGER_LESS_THAN_OR_EQUAL_TO "<=" |
The operator "is less than or equal to". | |
#define | CONTEXT_TRIGGER_TRUE 1 |
Logical true. | |
#define | CONTEXT_TRIGGER_FALSE 0 |
Logical false. | |
#define | CONTEXT_TRIGGER_TIME_OF_DAY "TimeOfDay" |
The attribute key denoting "time of day". | |
#define | CONTEXT_TRIGGER_DAY_OF_WEEK "DayOfWeek" |
The attribute key denoting "day of week". | |
#define | CONTEXT_TRIGGER_DAY_OF_MONTH "DayOfMonth" |
The attribute key denoting "day of month". | |
#define | CONTEXT_TRIGGER_IS_CONNECTED "IsConnected" |
The attribute key denoting boolean states of "is connected". | |
#define | CONTEXT_TRIGGER_IS_CHARGING "IsCharging" |
The attribute key denoting boolean states of "is charging". | |
#define | CONTEXT_TRIGGER_IS_ENABLED "IsEnabled" |
The attribute key denoting boolean states of "is enabled". | |
#define | CONTEXT_TRIGGER_LEVEL "Level" |
The attribute key denoting "level". | |
#define | CONTEXT_TRIGGER_STATE "State" |
The attribute key denoting "state". | |
#define | CONTEXT_TRIGGER_BSSID "BSSID" |
The attribute key denoting "BSSID". | |
#define | CONTEXT_TRIGGER_TYPE "Type" |
The attribute key denoting "type". | |
#define | CONTEXT_TRIGGER_EVENT "Event" |
The attribute key denoting "event". | |
#define | CONTEXT_TRIGGER_ACCURACY "Accuracy" |
The attribute key denoting "accuracy". | |
#define | CONTEXT_TRIGGER_MEDIUM "Medium" |
The attribute key denoting "medium". | |
#define | CONTEXT_TRIGGER_PLACE_ID "PlaceId" |
The attribute key denoting "place id". | |
#define | CONTEXT_TRIGGER_APP_ID "AppId" |
The attribute key denoting "application id". | |
#define | CONTEXT_TRIGGER_ADDRESS "Address" |
The attribute key denoting "address". | |
#define | CONTEXT_TRIGGER_RANK "Rank" |
The attribute key denoting "rank". | |
#define | CONTEXT_TRIGGER_TOTAL_COUNT "TotalCount" |
The attribute key denoting "total count". | |
#define | CONTEXT_TRIGGER_MON "Mon" |
The attribute value denoting Monday. | |
#define | CONTEXT_TRIGGER_TUE "Tue" |
The attribute value denoting Tuesday. | |
#define | CONTEXT_TRIGGER_WED "Wed" |
The attribute value denoting Wednesday. | |
#define | CONTEXT_TRIGGER_THU "Thu" |
The attribute value denoting Thursday. | |
#define | CONTEXT_TRIGGER_FRI "Fri" |
The attribute value denoting Friday. | |
#define | CONTEXT_TRIGGER_SAT "Sat" |
The attribute value denoting Saturday. | |
#define | CONTEXT_TRIGGER_SUN "Sun" |
The attribute value denoting Sunday. | |
#define | CONTEXT_TRIGGER_WEEKDAY "Weekday" |
The attribute value denoting Weekdays. | |
#define | CONTEXT_TRIGGER_WEEKEND "Weekend" |
The attribute value denoting Weekends. | |
#define | CONTEXT_TRIGGER_EMPTY "Empty" |
The attribute value denoting the "empty" state. | |
#define | CONTEXT_TRIGGER_CRITICAL "Critical" |
The attribute value denoting the "critical" state. | |
#define | CONTEXT_TRIGGER_LOW "Low" |
The attribute value denoting the "low" state. | |
#define | CONTEXT_TRIGGER_NORMAL "Normal" |
The attribute value denoting the "normal" state. | |
#define | CONTEXT_TRIGGER_HIGH "High" |
The attribute value denoting the "high" state. | |
#define | CONTEXT_TRIGGER_FULL "Full" |
The attribute value denoting the "full" state. | |
#define | CONTEXT_TRIGGER_DISABLED "Disabled" |
The attribute value denoting the "disabled" state. | |
#define | CONTEXT_TRIGGER_SEARCHING "Searching" |
The attribute value denoting the "searching" state. | |
#define | CONTEXT_TRIGGER_CONNECTING "Connecting" |
The attribute value denoting the "connecting" state. | |
#define | CONTEXT_TRIGGER_CONNECTED "Connected" |
The attribute value denoting the "connected" state. | |
#define | CONTEXT_TRIGGER_UNCONNECTED "Unconnected" |
The attribute value denoting the "unconnected" state. | |
#define | CONTEXT_TRIGGER_IDLE "Idle" |
The attribute value denoting the "idle" state. | |
#define | CONTEXT_TRIGGER_VOICE "Voice" |
The attribute value denoting the "voice" type. | |
#define | CONTEXT_TRIGGER_VIDEO "Video" |
The attribute value denoting the "video" type. | |
#define | CONTEXT_TRIGGER_HEADSET "Headset" |
The attribute value denoting the "headset" type. | |
#define | CONTEXT_TRIGGER_BLUETOOTH "Bluetooth" |
The attribute value denoting the "bluetooth" type. | |
#define | CONTEXT_TRIGGER_RECEIVED "Received" |
The attribute value denoting the "received" event. | |
#define | CONTEXT_TRIGGER_SENT "Sent" |
The attribute value denoting the "sent" event. | |
#define | CONTEXT_TRIGGER_SMS "SMS" |
The attribute value denoting the "SMS" type. | |
#define | CONTEXT_TRIGGER_MMS "MMS" |
The attribute value denoting the "MMS" type. | |
#define | CONTEXT_TRIGGER_DETECTED "Detected" |
The attribute value denoting the "detected" event. | |
#define | CONTEXT_TRIGGER_IN "In" |
The attribute value denoting the "in" event. | |
#define | CONTEXT_TRIGGER_OUT "Out" |
The attribute value denoting the "out" event. |
The contextual trigger API provides a way to define rules, each of which can trigger a specified action when the rule is satisfied.
Required Header
#include <context_trigger.h>
Overview
The contextual trigger API provides a way to define trigger rules, each of which launches an application or posts a notification if it is satisfied.
To use this API, an application first needs to assemble a rule, which consists of the following three components:
- An Event: The contextual trigger engine starts to verify if the rule is satisfied, when the event occurs. As the name suggests, it is literally an event that can be recognized in the device, e.g., changes of setting values or connections of peripherals. See context_trigger_event_e for all available event items.
-
A Set of Conditions: If the event occurs, the trigger engine checks whether the conditions are satisfied or not. The application can choose the way of combining conditions, i.e., logical conjunction or disjunction. In case of logical conjunction, for example, the set of conditions is
true
if and only if all conditions aretrue
. If no condition is set, i.e., the set of conditions is empty, the trigger engine considers the set is satisfied, regardless of the current context. See context_trigger_condition_e for all available condition items. - An Action: If the conditions are satisfied, a designated action will be triggered. The action can be an app launching request or a notification posting request.
Note that, a rule only can be managed by the application that has registered the rule.
If the rule is not required anymore, it can be disabled and removed from the engine. Note that, rule activation, deactivation, and removals are only allowed to the owner application, which has registered the rule to the trigger engine. In the below example, the application queries its own rule IDs, deactivates enabled rules, and removes all rules from the trigger engine.
For more details, please see the programming guide and the tutorial.
Related Features
Some of the event and condition items in this API are related with one of the following features:
- http://tizen.org/feature/network.telephony
- http://tizen.org/feature/location.gps
- http://tizen.org/feature/network.bluetooth
- http://tizen.org/feature/network.wifi
It is recommended to design feature related code in your application for reliability.
For your convenience, context_trigger_rule_event_is_supported() and context_trigger_rule_condition_is_supported() are provided. Applications can use these functions to check the availability of a necessary event or condition, before registering a rule, to be sure that the rule is valid in the current device.
In general, you can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application. To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK. More details on featuring your application can be found from Feature Element.
Define Documentation
#define CONTEXT_TRIGGER_ACCURACY "Accuracy" |
The attribute key denoting "accuracy".
This can be used as left operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find available right operands.
- Since :
- 2.4
#define CONTEXT_TRIGGER_ADDRESS "Address" |
The attribute key denoting "address".
This can be used as a key of context_trigger_rule_entry_add_option_string(), or context_trigger_rule_entry_add_comparison_string().
See the programming guide and CAPI_CONTEXT_TRIGGER_MODULE_OPTION_FORMAT to find the corresponding items.
- Since :
- 2.4
#define CONTEXT_TRIGGER_APP_ID "AppId" |
The attribute key denoting "application id".
This can be used as a key of context_trigger_rule_entry_add_option_string().
See the programming guide to find the corresponding trigger events.
- Since :
- 2.4
#define CONTEXT_TRIGGER_BLUETOOTH "Bluetooth" |
The attribute value denoting the "bluetooth" type.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_BSSID "BSSID" |
The attribute key denoting "BSSID".
This can be used as left operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find available right operands.
- Since :
- 2.4
#define CONTEXT_TRIGGER_CONNECTED "Connected" |
The attribute value denoting the "connected" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_CONNECTING "Connecting" |
The attribute value denoting the "connecting" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_CRITICAL "Critical" |
The attribute value denoting the "critical" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_DAY_OF_MONTH "DayOfMonth" |
The attribute key denoting "day of month".
This can be used as left operands of context_trigger_rule_entry_add_comparison_int().
The valid range of the corresponding right operands is from 1 to 31.
- Since :
- 2.4
#define CONTEXT_TRIGGER_DAY_OF_WEEK "DayOfWeek" |
The attribute key denoting "day of week".
This can be used as a key of context_trigger_rule_entry_add_option_string(), or left operands of context_trigger_rule_entry_add_comparison_string().
As the right operands of this attribute, one of the following values are allowed: CONTEXT_TRIGGER_MON, CONTEXT_TRIGGER_TUE, CONTEXT_TRIGGER_WED, CONTEXT_TRIGGER_THU, CONTEXT_TRIGGER_FRI, CONTEXT_TRIGGER_SAT, CONTEXT_TRIGGER_SUN, CONTEXT_TRIGGER_WEEKDAY, and CONTEXT_TRIGGER_WEEKEND.
- Since :
- 2.4
#define CONTEXT_TRIGGER_DETECTED "Detected" |
The attribute value denoting the "detected" event.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_DISABLED "Disabled" |
The attribute value denoting the "disabled" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_EMPTY "Empty" |
The attribute value denoting the "empty" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_EQUAL_TO "==" |
The operator "is equal to".
This can be used as operators of context_trigger_rule_entry_add_comparison_int() and context_trigger_rule_entry_add_comparison_string().
- Since :
- 2.4
#define CONTEXT_TRIGGER_EVENT "Event" |
The attribute key denoting "event".
This can be used as left operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find available right operands.
- Since :
- 2.4
#define CONTEXT_TRIGGER_FALSE 0 |
Logical false.
This can be used as right operands of context_trigger_rule_entry_add_comparison_int().
- Since :
- 2.4
#define CONTEXT_TRIGGER_FRI "Fri" |
The attribute value denoting Friday.
This can be used as a value of context_trigger_rule_entry_add_option_string() or right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding option keys or left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_FULL "Full" |
The attribute value denoting the "full" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_GREATER_THAN ">" |
The operator "is greater than".
This can be used as operators of context_trigger_rule_entry_add_comparison_int().
- Since :
- 2.4
#define CONTEXT_TRIGGER_GREATER_THAN_OR_EQUAL_TO ">=" |
The operator "is greater than or equal to".
This can be used as operators of context_trigger_rule_entry_add_comparison_int().
- Since :
- 2.4
#define CONTEXT_TRIGGER_HEADSET "Headset" |
The attribute value denoting the "headset" type.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_HIGH "High" |
The attribute value denoting the "high" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_IDLE "Idle" |
The attribute value denoting the "idle" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_IN "In" |
The attribute value denoting the "in" event.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_IS_CHARGING "IsCharging" |
The attribute key denoting boolean states of "is charging".
This can be used as left operands of context_trigger_rule_entry_add_comparison_int().
As the right operands of this attribute, one of the following values are allowed: CONTEXT_TRIGGER_TRUE and CONTEXT_TRIGGER_FALSE.
- Since :
- 2.4
#define CONTEXT_TRIGGER_IS_CONNECTED "IsConnected" |
The attribute key denoting boolean states of "is connected".
This can be used as left operands of context_trigger_rule_entry_add_comparison_int().
As the right operands of this attribute, one of the following values are allowed: CONTEXT_TRIGGER_TRUE and CONTEXT_TRIGGER_FALSE.
- Since :
- 2.4
#define CONTEXT_TRIGGER_IS_ENABLED "IsEnabled" |
The attribute key denoting boolean states of "is enabled".
This can be used as left operands of context_trigger_rule_entry_add_comparison_int().
As the right operands of this attribute, one of the following values are allowed: CONTEXT_TRIGGER_TRUE and CONTEXT_TRIGGER_FALSE.
- Since :
- 2.4
#define CONTEXT_TRIGGER_LESS_THAN "<" |
The operator "is less than".
This can be used as operators of context_trigger_rule_entry_add_comparison_int().
- Since :
- 2.4
#define CONTEXT_TRIGGER_LESS_THAN_OR_EQUAL_TO "<=" |
The operator "is less than or equal to".
This can be used as operators of context_trigger_rule_entry_add_comparison_int().
- Since :
- 2.4
#define CONTEXT_TRIGGER_LEVEL "Level" |
The attribute key denoting "level".
This can be used as left operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find available right operands values.
- Since :
- 2.4
#define CONTEXT_TRIGGER_LOW "Low" |
The attribute value denoting the "low" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_MEDIUM "Medium" |
The attribute key denoting "medium".
This can be used as left operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find available right operands.
- Since :
- 2.4
#define CONTEXT_TRIGGER_MMS "MMS" |
The attribute value denoting the "MMS" type.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_MON "Mon" |
The attribute value denoting Monday.
This can be used as a value of context_trigger_rule_entry_add_option_string() or right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding option keys or left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_NORMAL "Normal" |
The attribute value denoting the "normal" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_NOT_EQUAL_TO "!=" |
The operator "is not equal to".
This can be used as operators of context_trigger_rule_entry_add_comparison_int() and context_trigger_rule_entry_add_comparison_string().
- Since :
- 2.4
#define CONTEXT_TRIGGER_OUT "Out" |
The attribute value denoting the "out" event.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_PLACE_ID "PlaceId" |
The attribute key denoting "place id".
This can be used as a key of context_trigger_rule_entry_add_option_int().
See the programming guide to find the corresponding trigger events.
- Since :
- 2.4
#define CONTEXT_TRIGGER_RANK "Rank" |
The attribute key denoting "rank".
This can be used as left operands of context_trigger_rule_entry_add_comparison_int().
See the programming guide to find available right operands.
- Since :
- 2.4
#define CONTEXT_TRIGGER_RECEIVED "Received" |
The attribute value denoting the "received" event.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_SAT "Sat" |
The attribute value denoting Saturday.
This can be used as a value of context_trigger_rule_entry_add_option_string() or right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding option keys or left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_SEARCHING "Searching" |
The attribute value denoting the "searching" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_SENT "Sent" |
The attribute value denoting the "sent" event.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_SMS "SMS" |
The attribute value denoting the "SMS" type.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_STATE "State" |
The attribute key denoting "state".
This can be used as left operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find available right operands.
- Since :
- 2.4
#define CONTEXT_TRIGGER_SUN "Sun" |
The attribute value denoting Sunday.
This can be used as a value of context_trigger_rule_entry_add_option_string() or right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding option keys or left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_THU "Thu" |
The attribute value denoting Thursday.
This can be used as a value of context_trigger_rule_entry_add_option_string() or right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding option keys or left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_TIME_OF_DAY "TimeOfDay" |
The attribute key denoting "time of day".
This can be used as a key of context_trigger_rule_entry_add_option_string(), or left operands of context_trigger_rule_entry_add_comparison_int().
When being used as option, it is time interval of the day. For example, "13-15" denotes "from 1 PM to 3 PM". When being used with CONTEXT_TRIGGER_EVENT_TIME or CONTEXT_TRIGGER_CONDITION_TIME, it's unit is "minute", the valid range of the corresponding right operands is thus from 0 (12:00 AM) to 1439 (11:59 PM).
- Since :
- 2.4
#define CONTEXT_TRIGGER_TOTAL_COUNT "TotalCount" |
The attribute key denoting "total count".
This can be used as left operands of context_trigger_rule_entry_add_comparison_int().
See the programming guide to find available right operands.
- Since :
- 2.4
#define CONTEXT_TRIGGER_TRUE 1 |
Logical true.
This can be used as right operands of context_trigger_rule_entry_add_comparison_int().
- Since :
- 2.4
#define CONTEXT_TRIGGER_TUE "Tue" |
The attribute value denoting Tuesday.
This can be used as a value of context_trigger_rule_entry_add_option_string() or right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding option keys or left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_TYPE "Type" |
The attribute key denoting "type".
This can be used as left operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find available right operands.
- Since :
- 2.4
#define CONTEXT_TRIGGER_UNCONNECTED "Unconnected" |
The attribute value denoting the "unconnected" state.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_VIDEO "Video" |
The attribute value denoting the "video" type.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_VOICE "Voice" |
The attribute value denoting the "voice" type.
This can be used as right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_WED "Wed" |
The attribute value denoting Wednesday.
This can be used as a value of context_trigger_rule_entry_add_option_string() or right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding option keys or left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_WEEKDAY "Weekday" |
The attribute value denoting Weekdays.
This can be used as a value of context_trigger_rule_entry_add_option_string() or right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding option keys or left operand attribute keys.
- Since :
- 2.4
#define CONTEXT_TRIGGER_WEEKEND "Weekend" |
The attribute value denoting Weekends.
This can be used as a value of context_trigger_rule_entry_add_option_string() or right operands of context_trigger_rule_entry_add_comparison_string().
See the programming guide to find the corresponding option keys or left operand attribute keys.
- Since :
- 2.4
Typedef Documentation
typedef struct _context_trigger_rule_entry_s* context_trigger_rule_entry_h |
Handle for editing an event or a condition, which is added to a rule.
- Since :
- 2.4
typedef struct _context_trigger_rule_s* context_trigger_rule_h |
Handle for editing a trigger rule.
- Since :
- 2.4
Enumeration Type Documentation
Enumeration for condition types.
- Since :
- 2.4
- Enumerator:
CONTEXT_TRIGGER_CONDITION_TIME Time of day
CONTEXT_TRIGGER_CONDITION_BATTERY Battery level
CONTEXT_TRIGGER_CONDITION_CHARGER Charger connection
CONTEXT_TRIGGER_CONDITION_GPS GPS state
CONTEXT_TRIGGER_CONDITION_HEADPHONE Headphone connection
CONTEXT_TRIGGER_CONDITION_USB USB connection
CONTEXT_TRIGGER_CONDITION_WIFI WiFi state
Privilege: http://tizen.org/privilege/network.getCONTEXT_TRIGGER_CONDITION_POWER_SAVING_MODE Power saving mode setting
CONTEXT_TRIGGER_CONDITION_CALL Call state
Privilege: http://tizen.org/privilege/telephonyCONTEXT_TRIGGER_CONDITION_APP_USE_FREQUENCY Frequency of app use
Privilege: http://tizen.org/privilege/apphistory.readCONTEXT_TRIGGER_CONDITION_COMMUNICATION_FREQUENCY Frequency of communication via call or message
Privilege: http://tizen.org/privilege/callhistory.readCONTEXT_TRIGGER_CONDITION_MUSIC_PLAYBACK_FREQUENCY Frequency of music playback
Privilege: http://tizen.org/privilege/mediahistory.readCONTEXT_TRIGGER_CONDITION_VIDEO_PLAYBACK_FREQUENCY Frequency of video playback
Privilege: http://tizen.org/privilege/mediahistory.read
Enumeration of error codes for context trigger API.
- Since :
- 2.4
- Enumerator:
Enumeration for event types.
- Since :
- 2.4
- Enumerator:
CONTEXT_TRIGGER_EVENT_TIME At certain times of day and days of week
Privilege: http://tizen.org/privilege/alarm.setCONTEXT_TRIGGER_EVENT_BATTERY Battery level changed
CONTEXT_TRIGGER_EVENT_CHARGER Charger connected/disconnected
CONTEXT_TRIGGER_EVENT_GPS GPS state changed
CONTEXT_TRIGGER_EVENT_HEADPHONE Headphone connected/disconnected
CONTEXT_TRIGGER_EVENT_USB USB connected/disconnected
CONTEXT_TRIGGER_EVENT_WIFI WiFi state changed
Privilege: http://tizen.org/privilege/network.getCONTEXT_TRIGGER_EVENT_POWER_SAVING_MODE Power saving mode enabled/disabled
CONTEXT_TRIGGER_EVENT_CALL Call state changed
Privilege: http://tizen.org/privilege/telephonyCONTEXT_TRIGGER_EVENT_EMAIL Email sent/received
CONTEXT_TRIGGER_EVENT_MESSAGE Message sent/received
Privilege: http://tizen.org/privilege/message.readCONTEXT_TRIGGER_EVENT_ACTIVITY_STATIONARY 'Stationary' activity detected
CONTEXT_TRIGGER_EVENT_ACTIVITY_WALKING 'Walking' activity detected
CONTEXT_TRIGGER_EVENT_ACTIVITY_RUNNING 'Running' activity detected
CONTEXT_TRIGGER_EVENT_ACTIVITY_IN_VEHICLE 'In vehicle' activity detected
CONTEXT_TRIGGER_EVENT_PLACE Get in/out to/from a specific user place
Privilege: http://tizen.org/privilege/location
Function Documentation
int context_trigger_add_rule | ( | context_trigger_rule_h | rule, |
int * | rule_id | ||
) |
Registers a rule.
Using this, applications can register a rule and get the ID of the registered rule.
A rule only can be enabled, disabled, or removed by the application that has registered the rule.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/alarm.set
http://tizen.org/privilege/telephony
http://tizen.org/privilege/message.read
http://tizen.org/privilege/network.get
- Remarks:
- When registering a new rule, regarding the event and condition items used to compose the rule, the application may require one or more privileges. If the application does not have a necessary privilege, CONTEXT_TRIGGER_ERROR_PERMISSION_DENIED is returned.
- Parameters:
-
[in] rule The rule to register [out] rule_id The ID assigned to the rule
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_PERMISSION_DENIED Permission denied CONTEXT_TRIGGER_ERROR_NOT_SUPPORTED Unsupported event/condition contained CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
- See also:
- context_trigger_remove_rule()
int context_trigger_disable_rule | ( | int | rule_id | ) |
Disables a rule.
This deactivates the rule designated by the rule_id
, which is owned by the application.
- Since :
- 2.4
- Parameters:
-
[in] rule_id The ID of the rule to be disabled
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed CONTEXT_TRIGGER_ERROR_RULE_NOT_ENABLED Rule is not enabled CONTEXT_TRIGGER_ERROR_RULE_NOT_EXIST Rule does not exist
- See also:
- context_trigger_enable_rule()
int context_trigger_enable_rule | ( | int | rule_id | ) |
Enables a rule.
This activates the rule designated by the rule_id
, which is owned by the application.
- Since :
- 2.4
- Parameters:
-
[in] rule_id The ID of the rule to be enabled
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed CONTEXT_TRIGGER_ERROR_RULE_ENABLED Rule is enabled already CONTEXT_TRIGGER_ERROR_RULE_NOT_EXIST Rule does not exist
- See also:
- context_trigger_disable_rule()
int context_trigger_get_own_rule_ids | ( | int ** | enabled_rule_ids, |
int * | enabled_rule_count, | ||
int ** | disabled_rule_ids, | ||
int * | disabled_rule_count | ||
) |
Gets the IDs of the rules owned by the current application.
- Since :
- 2.4
- Remarks:
- The arrays
enabled_rule_ids
anddisabled_rule_ids
must be released usingfree()
.
- Parameters:
-
[out] enabled_rule_ids The IDs of the active rules [out] enabled_rule_count The number of the active rules [out] disabled_rule_ids The IDs of the inactive rules [out] disabled_rule_count The number of the inactive rules
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed
int context_trigger_get_rule_by_id | ( | int | rule_id, |
context_trigger_rule_h * | rule | ||
) |
Gets a rule stored in the system by rule ID.
- Since :
- 2.4
- Remarks:
- The
rule
must be released using context_trigger_rule_destroy().
- Parameters:
-
[in] rule_id The ID of the rule to be retrieved [out] rule The rule retrieved
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed CONTEXT_TRIGGER_ERROR_RULE_NOT_EXIST Rule does not exist
int context_trigger_remove_rule | ( | int | rule_id | ) |
Removes a rule.
This removes the rule designated by the rule_id
, which is owned by the application.
- Since :
- 2.4
- Remarks:
- If the rule has been activated, it should be disabled through context_trigger_disable_rule() in advance.
- Parameters:
-
[in] rule_id The ID of the rule to be removed
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed CONTEXT_TRIGGER_ERROR_RULE_ENABLED Rule is enabled already CONTEXT_TRIGGER_ERROR_RULE_NOT_EXIST Rule does not exist
- See also:
- context_trigger_add_rule()
int context_trigger_rule_add_entry | ( | context_trigger_rule_h | rule, |
context_trigger_rule_entry_h | entry | ||
) |
Adds an event or a condition to a rule.
- Since :
- 2.4
- Parameters:
-
[in] rule The rule [in] entry The event or condition entry to be added to the rule
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
int context_trigger_rule_condition_create | ( | context_trigger_condition_e | condition_item, |
context_trigger_logical_type_e | logical_type, | ||
context_trigger_rule_entry_h * | entry | ||
) |
Creates a condition entry.
A condition of a contextual condition item is created.
- Since :
- 2.4
- Remarks:
- The
entry
must be released using context_trigger_rule_entry_destroy().
- Parameters:
-
[in] condition_item The contextual condition item [in] logical_type The logical operator [out] entry The condition entry to be initialized
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Memory allocation failed
- See also:
- context_trigger_rule_entry_destroy()
int context_trigger_rule_condition_is_supported | ( | context_trigger_condition_e | condition_item, |
bool * | supported | ||
) |
Checks whether a contextual condition is supported in the current device.
- Since :
- 2.4
- Parameters:
-
[in] condition_item The contextual condition item [out] supported If supported, true
; Otherwise,false
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed
int context_trigger_rule_create | ( | context_trigger_logical_type_e | logical_type, |
context_trigger_rule_h * | rule | ||
) |
Creates an empty rule.
An empty rule container is created. When using this, a logical operator, one of context_trigger_logical_type_e, needs to be designated.
In case of CONTEXT_TRIGGER_LOGICAL_CONJUNCTION, the rule can be satisfied only if all conditions are true. Otherwise, in case of CONTEXT_TRIGGER_LOGICAL_DISJUNCTION, the rule can be satisfied if at least one is true.
- Since :
- 2.4
- Remarks:
- The
rule
must be released using context_trigger_rule_destroy().
- Parameters:
-
[in] logical_type The logical operator [out] rule The rule handle to be initialized
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Memory allocation failed
- See also:
- context_trigger_rule_destroy()
int context_trigger_rule_destroy | ( | context_trigger_rule_h | rule | ) |
Releases the resources occupied by a rule handle.
- Since :
- 2.4
- Parameters:
-
[in] rule The rule handle to be released
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
- Precondition:
- context_trigger_rule_create()
- See also:
- context_trigger_get_rule_by_id()
int context_trigger_rule_entry_add_comparison | ( | context_trigger_rule_entry_h | entry, |
const char * | key, | ||
const char * | comp_operator, | ||
const char * | event_data_key | ||
) |
Adds a comparison between an attribute of a condition and an attribute extracted from the event.
The key needs to be registered in advance, via context_trigger_rule_entry_add_key().
- Since :
- 2.4
- Parameters:
-
[in] entry The condition entry [in] key The attribute key of the condition, which will be used as the left operand [in] comp_operator The comparison operator [in] event_data_key The event data key of which the corresponding data value will be used as the right operand
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_NO_DATA The key was not added in the entry CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
- Precondition:
- context_trigger_rule_entry_add_key()
int context_trigger_rule_entry_add_comparison_int | ( | context_trigger_rule_entry_h | entry, |
const char * | key, | ||
const char * | comp_operator, | ||
int | value | ||
) |
Adds a comparison between an attribute key and an integer.
The key needs to be registered in advance, via context_trigger_rule_entry_add_key(). As the comparison operator, one of the following operators is allowed: CONTEXT_TRIGGER_EQUAL_TO, CONTEXT_TRIGGER_NOT_EQUAL_TO, CONTEXT_TRIGGER_LESS_THAN, CONTEXT_TRIGGER_GREATER_THAN, CONTEXT_TRIGGER_LESS_THAN_OR_EQUAL_TO and CONTEXT_TRIGGER_GREATER_THAN_OR_EQUAL_TO.
- Since :
- 2.4
- Parameters:
-
[in] entry The event or condition entry [in] key The attribute key, which will be used as the left operand [in] comp_operator The comparison operator [in] value The right operand value
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_NO_DATA The key was not added in the entry CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
- Precondition:
- context_trigger_rule_entry_add_key()
int context_trigger_rule_entry_add_comparison_string | ( | context_trigger_rule_entry_h | entry, |
const char * | key, | ||
const char * | comp_operator, | ||
const char * | value | ||
) |
Adds a comparison between an attribute key and a string.
The key needs to be registered in advance, via context_trigger_rule_entry_add_key(). As the comparison operator, one of the following operators is allowed: CONTEXT_TRIGGER_EQUAL_TO and CONTEXT_TRIGGER_NOT_EQUAL_TO.
- Since :
- 2.4
- Parameters:
-
[in] entry The event or condition entry [in] key The attribute key, which will be used as the left operand [in] comp_operator The comparison operator [in] value The right operand value
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_NO_DATA The key was not added in the entry CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
- Precondition:
- context_trigger_rule_entry_add_key()
int context_trigger_rule_entry_add_key | ( | context_trigger_rule_entry_h | entry, |
context_trigger_logical_type_e | logical_type, | ||
const char * | key | ||
) |
Adds an attribute key to an entry.
The key will be used as the left operand of comparisons. See the programming guide to find available attribute keys for each event/condition item.
- Since :
- 2.4
- Parameters:
-
[in] entry The event or condition entry [in] logical_type The logical operator [in] key The attribute key
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
int context_trigger_rule_entry_add_option | ( | context_trigger_rule_entry_h | entry, |
const char * | option_key, | ||
const char * | event_data_key | ||
) |
Sets an option to a condition entry, which references an attribute that will be extracted from the event.
See the programming guide to find available option keys for each condition item.
- Since :
- 2.4
- Parameters:
-
[in] entry The condition entry [in] option_key The option key [in] event_data_key The event data key of which the corresponding data value will be used as the option parameter
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
int context_trigger_rule_entry_add_option_int | ( | context_trigger_rule_entry_h | entry, |
const char * | option_key, | ||
int | value | ||
) |
Sets an integer type option to an event or condition entry.
See the programming guide to find available option keys for each event/condition item.
- Since :
- 2.4
- Parameters:
-
[in] entry The event or condition entry [in] option_key The option key [in] value The option value
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
int context_trigger_rule_entry_add_option_string | ( | context_trigger_rule_entry_h | entry, |
const char * | option_key, | ||
const char * | value | ||
) |
Sets a string type option to an event or condition entry.
See the programming guide to find available option keys for each event/condition item.
- Since :
- 2.4
- Parameters:
-
[in] entry The event or condition entry [in] option_key The option key [in] value The option value
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
Releases the resource occupied by an entry.
- Since :
- 2.4
- Parameters:
-
[in] entry The event or condition entry
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter
int context_trigger_rule_event_create | ( | context_trigger_event_e | event_item, |
context_trigger_logical_type_e | logical_type, | ||
context_trigger_rule_entry_h * | entry | ||
) |
Creates an event entry.
An event of a contextual event item, which will be monitored by the system, is created.
- Since :
- 2.4
- Remarks:
- The
entry
must be released using context_trigger_rule_entry_destroy().
- Parameters:
-
[in] event_item The contextual event item [in] logical_type The logical operator [out] entry The event entry to be initialized
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Memory allocation failed
- See also:
- context_trigger_rule_entry_destroy()
int context_trigger_rule_event_is_supported | ( | context_trigger_event_e | event_item, |
bool * | supported | ||
) |
Checks whether a contextual event is supported in the current device.
- Since :
- 2.4
- Parameters:
-
[in] event_item The contextual event item [out] supported If supported, true
; Otherwise,false
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed
int context_trigger_rule_get_description | ( | context_trigger_rule_h | rule, |
char ** | description | ||
) |
Gets the description of a rule.
- Since :
- 2.4
- Remarks:
- The
description
must be released usingfree()
.
- Parameters:
-
[in] rule The rule [out] description The description of the rule
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed
int context_trigger_rule_set_action_app_control | ( | context_trigger_rule_h | rule, |
app_control_h | app_control | ||
) |
Sets a app launching request as the action of a rule.
Contextual Trigger accepts an App Control as the action of a rule, an application thus can be launched when the rule is satisfied.
- Since :
- 2.4
- Privilege Level:
- public
- Remarks:
- In addition to the privilege http://tizen.org/privilege/appmanager.launch, if it is an App Control that makes a call to someone, the privilege http://tizen.org/privilege/call is also required.
- The launch request of the service application is restricted. The function will return CONTEXT_TRIGGER_ERROR_INVALID_RULE, if the launch request is for the service application.
- Parameters:
-
[in] rule The rule [in] app_control The App Control, which will be used to launch an application
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_PERMISSION_DENIED Permission denied CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
int context_trigger_rule_set_action_notification | ( | context_trigger_rule_h | rule, |
const char * | title, | ||
const char * | content, | ||
const char * | icon_path, | ||
app_control_h | app_control | ||
) |
Sets a notification posting request as the action of a rule.
A basic notification can be posted when the rule is satisfied, which consists of the title, a content body text, an icon, and an App Control.
- Since :
- 2.4
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/notification
- Remarks:
- The
app_control
can beNULL
. In that case, no application will be launched via the notification.
- Parameters:
-
[in] rule The rule [in] title The title text [in] content The content body text [in] icon_path The icon file path [in] app_control The app control
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_PERMISSION_DENIED Permission denied CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed CONTEXT_TRIGGER_ERROR_INVALID_RULE Invalid rule
int context_trigger_rule_set_description | ( | context_trigger_rule_h | rule, |
const char * | description | ||
) |
Sets the description of a rule.
- Since :
- 2.4
- Parameters:
-
[in] rule The rule [in] description The description to be set
- Returns:
- 0 on success, otherwise a negative error value
- Return values:
-
CONTEXT_TRIGGER_ERROR_NONE Successful CONTEXT_TRIGGER_ERROR_INVALID_PARAMETER Invalid parameter CONTEXT_TRIGGER_ERROR_OUT_OF_MEMORY Out of memory CONTEXT_TRIGGER_ERROR_OPERATION_FAILED Operation failed