1
/*
2
* Copyright 2013 The Android Open Source Project
3
*
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
7
*
8
* http://www.apache.org/licenses/LICENSE-2.0
9
*
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.
15
*/
16
17
package com.example.android.repeatingalarm;
18
19
import android.app.AlarmManager;
20
import android.app.PendingIntent;
21
import android.content.Intent;
22
import android.os.Bundle;
23
import android.os.SystemClock;
24
import android.support.v4.app.Fragment;
25
import android.view.MenuItem;
26
import com.example.android.common.logger.*;
27
28
29
public class RepeatingAlarmFragment extends Fragment {
30
31
// This value is defined and consumed by app code, so any value will work.
32
// There's no significance to this sample using 0.
33
public static final int REQUEST_CODE = 0;
34
35
@Override
36
public void onCreate(Bundle savedInstanceState) {
37
super.onCreate(savedInstanceState);
38
setHasOptionsMenu(true);
39
}
40
41
@Override
42
public boolean onOptionsItemSelected(MenuItem item) {
43
if(item.getItemId() == R.id.sample_action) {
44
46
// First create an intent for the alarm to activate.
47
// This code simply starts an Activity, or brings it to the front if it has already
48
// been created.
49
Intent intent = new Intent(getActivity(), MainActivity.class);
50
intent.setAction(Intent.ACTION_MAIN);
51
intent.setFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);
53
55
// Because the intent must be fired by a system service from outside the application,
56
// it's necessary to wrap it in a PendingIntent. Providing a different process with
57
// a PendingIntent gives that other process permission to fire the intent that this
58
// application has created.
59
// Also, this code creates a PendingIntent to start an Activity. To create a
60
// BroadcastIntent instead, simply call getBroadcast instead of getIntent.
61
PendingIntent pendingIntent = PendingIntent.getActivity(getActivity(), REQUEST_CODE,
62
intent, 0);
63
65
67
// There are two clock types for alarms, ELAPSED_REALTIME and RTC.
68
// ELAPSED_REALTIME uses time since system boot as a reference, and RTC uses UTC (wall
69
// clock) time. This means ELAPSED_REALTIME is suited to setting an alarm according to
70
// passage of time (every 15 seconds, 15 minutes, etc), since it isn't affected by
71
// timezone/locale. RTC is better suited for alarms that should be dependant on current
72
// locale.
73
74
// Both types have a WAKEUP version, which says to wake up the device if the screen is
75
// off. This is useful for situations such as alarm clocks. Abuse of this flag is an
76
// efficient way to skyrocket the uninstall rate of an application, so use with care.
77
// For most situations, ELAPSED_REALTIME will suffice.
78
int alarmType = AlarmManager.ELAPSED_REALTIME;
79
final int FIFTEEN_SEC_MILLIS = 15000;
80
81
// The AlarmManager, like most system services, isn't created by application code, but
82
// requested from the system.
83
AlarmManager alarmManager = (AlarmManager)
84
getActivity().getSystemService(getActivity().ALARM_SERVICE);
85
86
// setRepeating takes a start delay and period between alarms as arguments.
87
// The below code fires after 15 seconds, and repeats every 15 seconds. This is very
88
// useful for demonstration purposes, but horrendous for production. Don't be that dev.
89
alarmManager.setRepeating(alarmType, SystemClock.elapsedRealtime() + FIFTEEN_SEC_MILLIS,
90
FIFTEEN_SEC_MILLIS, pendingIntent);
92
Log.i("RepeatingAlarmFragment", "Alarm set.");
93
}
94
return true;
95
}
96
}