<h2 id="scenario_1" name="scenario_1">Setting an Alarm after Specific Time</h2>
+ <table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">Since 2.4, <span style="font-family: Courier New,Courier,monospace">alarm_schedule_after_delay()</span> method does not support exact period and delay for minimizing the wakeups of the device. The system can adjust when the alarm expires.</td>
+ </tr>
+ </tbody>
+ </table>
+
<p>To set an alarm after a specific time:</p>
<ol>
<p>To schedule an alarm after a delay, the function requires 4 parameters:</p>
<ul>
<li>[in] <span style="font-family: Courier New,Courier,monospace">app_control</span>: The destination <span style="font-family: Courier New,Courier,monospace">app_control</span> to perform the specific work when the alarm is triggered</li>
- <li>[in] <span style="font-family: Courier New,Courier,monospace">delay</span>: The amount of time before the first execution (in seconds) </li>
- <li>[in] <span style="font-family: Courier New,Courier,monospace">period</span>: The amount of time before a subsequent alarm (in seconds). If set to 0, there is only 1 execution.</li>
+ <li>[in] <span style="font-family: Courier New,Courier,monospace">delay</span>: The amount of time before the first execution (in seconds) Since 2.4, Although this is inexact, the alarm will not fire before this time</li>
+ <li>[in] <span style="font-family: Courier New,Courier,monospace">period</span>: The amount of time before a subsequent alarm (in seconds). Since 2.4, This value does not guarantee the accuracy. The actual interval is calculated by the OS. The minimum value is 600sec.</li>
<li>[out] <span style="font-family: Courier New,Courier,monospace">alarm_id</span> The alarm ID that uniquely identifies an alarm</li>
</ul>
ret = alarm_schedule_at_date(app, &date, 0, &alarm_id);
</pre>
+
+ <table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">The <span style="font-family: Courier New,Courier,monospace">alarm_schedule_at_date()</span> method has been deprecated since Tizen 2.4. Use the <span style="font-family: Courier New,Courier,monospace">alarm_schedule_once_at_date()</span> method instead.</td>
+ </tr>
+ </tbody>
+ </table>
+
<h2 id="scenario_3" name="scenario_3">Setting a Recurring Alarm at a Specific Time of the Day</h2>