to top
RepeatingAlarm / src / com.example.android.repeatingalarm /

RepeatingAlarmFragment.java

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
}