在項目開發(fā)過程中眠副,有時會有預約提醒画切、定時提醒等需求,這時我們可以使用系統(tǒng)日歷來輔助提醒囱怕。通過向系統(tǒng)日歷中寫入事件霍弹、設(shè)置提醒方式(鬧鐘),實現(xiàn)到達某個特定的時間自動提醒的功能娃弓。這樣做的好處是由于提醒功能是交付給系統(tǒng)日歷來做典格,不會出現(xiàn)應(yīng)用被殺情況,能夠做到準時提醒台丛。
一般來說實現(xiàn)向系統(tǒng)日歷中讀寫事件一般有以下幾個步驟:
(1)需要有讀寫日歷權(quán)限;
(2)如果沒有日歷賬戶需要先創(chuàng)建賬戶;
(3)實現(xiàn)日歷事件增刪改查耍缴、提醒功能;
1.權(quán)限申請
為了實現(xiàn)在項目中調(diào)用系統(tǒng)日歷和插入日程事件,我們首先在AndroidManifest.xml文件中添加如下相關(guān)權(quán)限
<uses-permission android:name="android.permission.READ_CALENDAR" />
<uses-permission android:name="android.permission.WRITE_CALENDAR" />
2.日歷相關(guān)uri
系統(tǒng)calendar content provider相關(guān)的uri,以下為Android2.2版本以后的uri
private static String CALENDER_URL = "content://com.android.calendar/calendars";
private static String CALENDER_EVENT_URL = "content://com.android.calendar/events";
private static String CALENDER_REMINDER_URL = "content://com.android.calendar/reminders";
3.具體實現(xiàn)
public class CalendarReminderUtils {
private static String CALENDER_URL = "content://com.android.calendar/calendars";
private static String CALENDER_EVENT_URL = "content://com.android.calendar/events";
private static String CALENDER_REMINDER_URL = "content://com.android.calendar/reminders";
private static String CALENDARS_NAME = "boohee";
private static String CALENDARS_ACCOUNT_NAME = "BOOHEE@boohee.com";
private static String CALENDARS_ACCOUNT_TYPE = "com.android.boohee";
private static String CALENDARS_DISPLAY_NAME = "BOOHEE賬戶";
/**
* 檢查是否已經(jīng)添加了日歷賬戶私恬,如果沒有添加先添加一個日歷賬戶再查詢
* 獲取賬戶成功返回賬戶id债沮,否則返回-1
*/
private static int checkAndAddCalendarAccount(Context context) {
int oldId = checkCalendarAccount(context);
if( oldId >= 0 ){
return oldId;
}else{
long addId = addCalendarAccount(context);
if (addId >= 0) {
return checkCalendarAccount(context);
} else {
return -1;
}
}
}
/**
* 檢查是否存在現(xiàn)有賬戶,存在則返回賬戶id本鸣,否則返回-1
*/
private static int checkCalendarAccount(Context context) {
Cursor userCursor = context.getContentResolver().query(Uri.parse(CALENDER_URL), null, null, null, null);
try {
if (userCursor == null) { //查詢返回空值
return -1;
}
int count = userCursor.getCount();
if (count > 0) { //存在現(xiàn)有賬戶疫衩,取第一個賬戶的id返回
userCursor.moveToFirst();
return userCursor.getInt(userCursor.getColumnIndex(CalendarContract.Calendars._ID));
} else {
return -1;
}
} finally {
if (userCursor != null) {
userCursor.close();
}
}
}
/**
* 添加日歷賬戶,賬戶創(chuàng)建成功則返回賬戶id荣德,否則返回-1
*/
private static long addCalendarAccount(Context context) {
TimeZone timeZone = TimeZone.getDefault();
ContentValues value = new ContentValues();
value.put(CalendarContract.Calendars.NAME, CALENDARS_NAME);
value.put(CalendarContract.Calendars.ACCOUNT_NAME, CALENDARS_ACCOUNT_NAME);
value.put(CalendarContract.Calendars.ACCOUNT_TYPE, CALENDARS_ACCOUNT_TYPE);
value.put(CalendarContract.Calendars.CALENDAR_DISPLAY_NAME, CALENDARS_DISPLAY_NAME);
value.put(CalendarContract.Calendars.VISIBLE, 1);
value.put(CalendarContract.Calendars.CALENDAR_COLOR, Color.BLUE);
value.put(CalendarContract.Calendars.CALENDAR_ACCESS_LEVEL, CalendarContract.Calendars.CAL_ACCESS_OWNER);
value.put(CalendarContract.Calendars.SYNC_EVENTS, 1);
value.put(CalendarContract.Calendars.CALENDAR_TIME_ZONE, timeZone.getID());
value.put(CalendarContract.Calendars.OWNER_ACCOUNT, CALENDARS_ACCOUNT_NAME);
value.put(CalendarContract.Calendars.CAN_ORGANIZER_RESPOND, 0);
Uri calendarUri = Uri.parse(CALENDER_URL);
calendarUri = calendarUri.buildUpon()
.appendQueryParameter(CalendarContract.CALLER_IS_SYNCADAPTER, "true")
.appendQueryParameter(CalendarContract.Calendars.ACCOUNT_NAME, CALENDARS_ACCOUNT_NAME)
.appendQueryParameter(CalendarContract.Calendars.ACCOUNT_TYPE, CALENDARS_ACCOUNT_TYPE)
.build();
Uri result = context.getContentResolver().insert(calendarUri, value);
long id = result == null ? -1 : ContentUris.parseId(result);
return id;
}
/**
* 添加日歷事件
*/
public static void addCalendarEvent(Context context, String title, String description, long reminderTime, int previousDate) {
if (context == null) {
return;
}
int calId = checkAndAddCalendarAccount(context); //獲取日歷賬戶的id
if (calId < 0) { //獲取賬戶id失敗直接返回闷煤,添加日歷事件失敗
return;
}
//添加日歷事件
Calendar mCalendar = Calendar.getInstance();
mCalendar.setTimeInMillis(reminderTime);//設(shè)置開始時間
long start = mCalendar.getTime().getTime();
mCalendar.setTimeInMillis(start + 10 * 60 * 1000);//設(shè)置終止時間,開始時間加10分鐘
long end = mCalendar.getTime().getTime();
ContentValues event = new ContentValues();
event.put("title", title);
event.put("description", description);
event.put("calendar_id", calId); //插入賬戶的id
event.put(CalendarContract.Events.DTSTART, start);
event.put(CalendarContract.Events.DTEND, end);
event.put(CalendarContract.Events.HAS_ALARM, 1);//設(shè)置有鬧鐘提醒
event.put(CalendarContract.Events.EVENT_TIMEZONE, "Asia/Shanghai");//這個是時區(qū)涮瞻,必須有
Uri newEvent = context.getContentResolver().insert(Uri.parse(CALENDER_EVENT_URL), event); //添加事件
if (newEvent == null) { //添加日歷事件失敗直接返回
return;
}
//事件提醒的設(shè)定
ContentValues values = new ContentValues();
values.put(CalendarContract.Reminders.EVENT_ID, ContentUris.parseId(newEvent));
values.put(CalendarContract.Reminders.MINUTES, previousDate * 24 * 60);// 提前previousDate天有提醒
values.put(CalendarContract.Reminders.METHOD, CalendarContract.Reminders.METHOD_ALERT);
Uri uri = context.getContentResolver().insert(Uri.parse(CALENDER_REMINDER_URL), values);
if(uri == null) { //添加事件提醒失敗直接返回
return;
}
}
/**
* 刪除日歷事件
*/
public static void deleteCalendarEvent(Context context,String title) {
if (context == null) {
return;
}
Cursor eventCursor = context.getContentResolver().query(Uri.parse(CALENDER_EVENT_URL), null, null, null, null);
try {
if (eventCursor == null) { //查詢返回空值
return;
}
if (eventCursor.getCount() > 0) {
//遍歷所有事件鲤拿,找到title跟需要查詢的title一樣的項
for (eventCursor.moveToFirst(); !eventCursor.isAfterLast(); eventCursor.moveToNext()) {
String eventTitle = eventCursor.getString(eventCursor.getColumnIndex("title"));
if (!TextUtils.isEmpty(title) && title.equals(eventTitle)) {
int id = eventCursor.getInt(eventCursor.getColumnIndex(CalendarContract.Calendars._ID));//取得id
Uri deleteUri = ContentUris.withAppendedId(Uri.parse(CALENDER_EVENT_URL), id);
int rows = context.getContentResolver().delete(deleteUri, null, null);
if (rows == -1) { //事件刪除失敗
return;
}
}
}
}
} finally {
if (eventCursor != null) {
eventCursor.close();
}
}
}
}