工作需求:需要在某个时间点提前提醒用户秒杀活动开始
由于推送到达率不高不够及时,使用系统日历的日程是最方便最简单的选择
1.使用系统日历需要添加权限 targetSdkVersion=23以上的需要动态申请权限
<uses-permission android:name="android.permission.READ_CALENDAR" />
<uses-permission android:name="android.permission.WRITE_CALENDAR" />
2.检查日历是否有账户
private Uri CALANDER_URL = CalendarContract.Calendars.CONTENT_URI;
private Uri CALANDER_EVENT_URL = CalendarContract.Events.CONTENT_URI;
private Uri CALANDER_REMIDER_URL = CalendarContract.Reminders.CONTENT_URI;
private int checkCalendarAccount(Context context) {
Cursor userCursor = context.getContentResolver().query(CALANDER_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();
}
}
}
3.添加账户
private String CALENDARS_NAME = "detonation_product";
private String CALENDARS_ACCOUNT_NAME = "calendar@localhost.com";
private String CALENDARS_ACCOUNT_TYPE = "LOCAL";
private String CALENDARS_DISPLAY_NAME = "日程";
private 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 = CALANDER_URL.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;
}
4.检查是否已经添加了日历账户,如果没有添加先添加一个日历账户再查询
private 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;
}
}
}
5.添加日程 设置日程标题 添加日程描述 日程开始时间(毫秒)
public void addCalendarEvent(Context context, String title, String description, long beginTime) {
// 获取日历账户的id
int calId = checkAndAddCalendarAccount(context);
if (calId < 0) {
// 获取账户id失败直接返回,添加日历事件失败
return;
}
ContentValues event = new ContentValues();
event.put("title", title);
event.put("description", description);
// 插入账户的id
event.put("calendar_id", calId);
Calendar mCalendar = Calendar.getInstance();
mCalendar.setTimeInMillis(beginTime);//设置日程开始时间
long start = mCalendar.getTime().getTime();
mCalendar.setTimeInMillis(start + 1000 * 5 * 60);//设置日程终止时间,我整个日程持续五分钟,你可以根据你自己的情况设置
long end = mCalendar.getTime().getTime();
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, TimeZone.getDefault().getID()); //这个是时区,必须有,
//添加事件
Uri newEvent = context.getContentResolver().insert(CALANDER_EVENT_URL, event);
if (newEvent == null) {
// 添加日历事件失败直接返回
return;
}
Uri uri = null;//我项目中需求是提前5分钟提示,然后每隔一分钟提醒一次,一共提醒3次
for (int i = 0; i < 3; i++) {
//事件提醒的设定
ContentValues values = new ContentValues();
values.put(CalendarContract.Reminders.EVENT_ID, ContentUris.parseId(newEvent));
// 提前几分钟有提醒 提前5分钟提醒 提前4分钟提醒 提前3分钟提醒
values.put(CalendarContract.Reminders.MINUTES, 5-i);
values.put(CalendarContract.Reminders.METHOD, CalendarContract.Reminders.METHOD_ALERT);
uri = context.getContentResolver().insert(CALANDER_REMIDER_URL, values);
}
if (uri == null) {
// 添加闹钟提醒失败直接返回
return;
}
}
6.有添加日程就有删除日程,删除日程只需要提供日程的标题即可
public void deleteCalendarEvent(Context context, String title) {
Cursor eventCursor = context.getContentResolver().query(CALANDER_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(CALANDER_EVENT_URL, id);
int rows = context.getContentResolver().delete(deleteUri, null, null);
if (rows == -1) {
//事件删除失败
return;
}
}
}
}
} finally {
if (eventCursor != null) {
eventCursor.close();
}
}
}
日程的提醒时间一定在设置日程开始时间之前
如果闹钟不响,请检查手机日历闹钟是否设置铃声,是否静音或者音量太小,我刚开始做的时候就是遇到这个问题,一直以为某个值没有设对,结果尴尬了