2 * Copyright (c) 2011 - 2016 Samsung Electronics Co., Ltd All Rights Reserved
4 * Licensed under the Apache License, Version 2.0 (the License);
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an AS IS BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
18 #ifndef __TIZEN_APPFW_ALARM_DOC_H__
19 #define __TIZEN_APPFW_ALARM_DOC_H__
22 * @ingroup CAPI_APPLICATION_MODULE
23 * @defgroup CAPI_ALARM_MODULE Alarm
24 * @brief The @ref CAPI_ALARM_MODULE API allows setting an "alarm clock" for the delivery of a notification at some point in the future.
25 * @section CAPI_ALARM_MODULE_HEADER Required Header
26 * \#include <app_alarm.h>
28 * @section CAPI_ALARM_MODULE_OVERVIEW Overview
29 * Mobile devices typically give constant access to information from various sources. Some of this information is best delivered
30 * through alarms - the most obvious case is a calendar scheduling application which lets you know when a meeting is about to start.
31 * Alarms are certainly better than actively waiting in a loop. They are also better than putting an interface to sleep because they do not
32 * block your main UI thread. Use of alarms helps build smooth user experiences and implements unattended data synchronization tasks.
33 * If an application is installed after setting the alarm, your alarm is canceled automatically.\n
34 * When the alarm is expired, Alarm Manager will turn on the LCD to prohibit background jobs.
35 * If you want to use alarm API without turning on the LCD, you can use alarm_schedule_after_delay().
36 * There are 3 ways to set an alarm.
40 * <th>DESCRIPTION</th>
43 * <td>alarm_schedule_once_after_delay()</td>
44 * <td>Sets an alarm to be triggered at specific time once</td>
47 * <td>alarm_schedule_once_at_date()</td>
48 * <td>Sets an alarm to be triggered after specific delay once</td>
51 * <td>alarm_schedule_with_recurrence_week_flag()</td>
52 * <td>Sets an alarm to be triggered at specific time with recurrent days of the week(can repeat on days of the week)</td>
55 * <td>alarm_schedule_after_delay()</td>
56 * <td>Sets an alarm to be triggered after specific time(Since @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif, this api does not support exact period and delay for minimizing the wakeups of the device. The system can adjust when the alarm expires.)</td>
62 #endif /* __TIZEN_APPFW_ALARM_DOC_H__ */