Android向系统日历添加日程提醒事件
在项目开发过程中,有时会有预约提醒、定时提醒等需求,这时我们可以使用系统日历来辅助提醒。通过向系统日历中写入事件、设置提醒方式(闹钟),实现到达某个特定的时间自动提醒的功能。这样做的好处是由于提醒功能是交付给系统日历来做,不会出现应用被杀情况,能够做到准时提醒。
一般来说实现向系统日历中读写事件一般有以下几个步骤:
(1)需要有读写日历权限;
(2)如果没有日历账户需要先创建账户;
(3)实现日历事件增删改查、提醒功能;
一般来说实现向系统日历中读写事件一般有以下几个步骤:
(1)需要有读写日历权限;
(2)如果没有日历账户需要先创建账户;
(3)实现日历事件增删改查、提醒功能;
1.权限申请
<uses-permission android:name="android.permission.READ_CALENDAR" /> <uses-permission android:name="android.permission.WRITE_CALENDAR" />
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.具体实现
import android.content.ContentUris; import android.content.ContentValues; import android.content.Context; import android.database.Cursor; import android.graphics.Color; import android.net.Uri; import android.os.Build; import android.provider.CalendarContract; import android.support.annotation.RequiresApi; import android.text.TextUtils; import java.util.Calendar; import java.util.TimeZone; 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账户"; /** * 检查是否已经添加了日历账户,如果没有添加先添加一个日历账户再查询 * 获取账户成功返回账户id,否则返回-1 */ @RequiresApi(api = Build.VERSION_CODES.N) 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; } } } /** * 检查是否存在现有账户,存在则返回账户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) { //存在现有账户,取第一个账户的id返回 userCursor.moveToFirst(); return userCursor.getInt(userCursor.getColumnIndex(CalendarContract.Calendars._ID)); } else { return -1; } } finally { if (userCursor != null) { userCursor.close(); } } } /** * 添加日历账户,账户创建成功则返回账户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; } /** * 添加日历事件 */ @RequiresApi(api = Build.VERSION_CODES.N) 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);//设置开始时间 long start = mCalendar.getTime().getTime(); mCalendar.setTimeInMillis(start + 10 * 60 * 1000);//设置终止时间,开始时间加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);//设置有闹钟提醒 event.put(CalendarContract.Events.EVENT_TIMEZONE, "Asia/Shanghai");//这个是时区,必须有 Uri newEvent = context.getContentResolver().insert(Uri.parse(CALENDER_EVENT_URL), event); //添加事件 if (newEvent == null) { //添加日历事件失败直接返回 return; } //事件提醒的设定 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(); } } }
4.测试添加事件
CalendarReminderUtils.addCalendarEvent(this,"学校读书","吃了饭再去",System.currentTimeMillis()+3600*24*1000*2+10000,2);
5,效果
![](https://img2018.cnblogs.com/blog/1100100/201903/1100100-20190307144542766-201406455.png)
注意:6.0 以上需要申请权限才可以使用哦
最后,关注【码上加油站】微信公众号后,有疑惑有问题想加油的小伙伴可以码上加入社群,让我们一起码上加油吧!!!
posted on 2019-03-07 14:47 LoaderMan 阅读(11787) 评论(1) 编辑 收藏 举报