前言
很多时候,我们需要向APP中添加一个事件提醒功能,一般的话都是通过微信或是发送手机短信的方式来实现,但这样如果对于个人开发者的话,想通过这两种方法来实现通知提醒功能就有些限制了。你以为我们就要就此止步了?😦别着急,还有办法!幸运的是Android系统为我们提供了CalendarContract这个类,系统有关于日历的操作等等都是通过他实现哒!所以我们可以借助CalendarContract来实现向系统日历中插入事件。而且既然是插入到系统日历中,所以我们当然也就不用担心服务会因为内存不够被系统杀掉而导致提醒不及时的问题!哇!开心辣么大🤗!
继续前进,这次给大家带来的就是通过Android系统的CalendarContract类来封装实现的一个日历事件工具类,目前实现的功能有向系统日历插入日历账户、查询日历账户、添加、修改、删除日历事件以及事件提醒等功能。废话少说,看效果图:(整个工程的代码还是比较多的,为了节省篇幅,这里只截取一小部分的代码,如果想查看完整代码,结尾有附源码链接)
效果预览.gif
怎么样?心不心动?!赶快借此给自己的APP加上一个事件提醒功能吧!
这是什么?Google代码遵循的见其名知其意相信大家看到这个名字就应该大概猜到了他的作用吧?这张表保存了特定的事件信息。在这个表中每一行都有单一事件的信息,如事件的标题、位置、开始时间、结束时间等。这个事件能够发生一次或重复发生多次。会议、提醒和扩展的属性被保存的独立的表中,它们都有一个EVENT_ID跟Events表中的_ID进行关联。最终事件也就是插入到系统的这张表中,还有一个CalendarContract.Reminders,它主要是用来保存事件的提醒参数的,比如说设置提前15分钟、使用系统通知提醒作为提醒方式,这两个参数的值就是保存在CalendarContract.Reminders中的
下面来看张日历事件的数据模型图(素材来自网络):
image
既然Events这张表对我们实现这次的功能如此重要,那就让我们来看看他都提供了哪些字段:
字段
描述
CALENDAR_ID
事件所属的日历的_ID
ORGANIZER
事件的组织者(所有者)的电子邮件
TITLE
事件的标题
EVENT_LOCATION
事件发生的地点
DESCRIPTION
事件的标题
DTSTART
事件的开始时间,使用从纪元开始的UTC毫秒计时
DTEND
事件的结束时间,使用从纪元开始的UTC毫秒计时
EVENT_TIMEZONE
事件所针对的时区
EVENT_END_TIMEZONE
针对事件结束时间的时区
DURATION
用RFC5545格式表示的事件持续时间,例如“PT1H”表示事件持续1小时的状态, “P2W”指明2周的持续时间
ALL_DAY
1指明这个事件会占用整天时间(由本地时区定义的时间);0指明它是一个普通的事件,可以在一天的任何时间开始和结束
RRULE
格式化的事件复发规则(RFC5545)。如“FREQ=WEEKLY;COUNT=10;WKST=SU”
RDATE
事件的复发日期。通常RDATE要联合RRULE一起使用来定义一个重复发生的事件的合集。
AVAILABILITY
事件的标题
GUESTS_CAN_MODIFY
参与者是否能够修改事件
GUESTS_CAN_INVITE_OTHERS
参与者是否能够邀请其他参与者
GUESTS_CAN_SEE_GUESTS
参与者是否能够看到与会者列表
Events基本上就是这么多了,我们操作的话只需要根据对应的字段进行数据的组装然后再通过ContentResolver将其插入到系统的表中。
组装数据:
/**
* 组装日历事件
*
* @param startTime 开始时间
* @param endTime 结束时间
* @param eventTitle 事件标题
* @param eventDes 事件描述
* @param eventLocation 事件地点
* @param event 组装的事件
*/
private static void setupEvent(long startTime, long endTime, String eventTitle, String eventDes,
String eventLocation, ContentValues event) {
// 事件开始时间
event.put(CalendarContract.Events.DTSTART, startTime);
// 事件结束时间
event.put(CalendarContract.Events.DTEND, endTime);
// 事件标题
event.put(CalendarContract.Events.TITLE, eventTitle);
// 事件描述(对应手机系统日历备注栏)
event.put(CalendarContract.Events.DESCRIPTION, eventDes);
// 事件地点
event.put(CalendarContract.Events.EVENT_LOCATION, eventLocation);
// 事件时区
event.put(CalendarContract.Events.EVENT_TIMEZONE, TimeZone.getDefault().getID());
// 定义事件的显示,默认即可
event.put(CalendarContract.Events.ACCESS_LEVEL, CalendarContract.Events.ACCESS_DEFAULT);
// 事件的状态
event.put(CalendarContract.Events.STATUS, 0);
// 设置事件提醒警报可用
event.put(CalendarContract.Events.HAS_ALARM, 1);
// 设置事件忙
event.put(CalendarContract.Events.AVAILABILITY, CalendarContract.Events.AVAILABILITY_BUSY);
// 设置事件重复规则
// event.put(CalendarContract.Events.RRULE, );
}
插入事件:
Uri eventUri = context.getContentResolver().insert(uri1, event);
其中第二个参数event就是上面组装出的数据。
其他的更新和删除操作都类似,就是通过ID在Events表中找到与之对应的事件实体,再调用update方法或delete将其更新或是删除。
更新事件:
context.getContentResolver().update(uri, event, selection, selectionArgs);
删除事件:
context.getContentResolver().delete(uri1, selection, selectionArgs);
其中最后两个参数selection和selectionArgs就是数据的匹配条件了,熟悉数据库的同学肯定都很了解,这里我就不再介绍了。😀
其实最主要的还是了解表的各个字段的含义,了解了这些字段,再将他们都组装起来插入到系统表中就可以了,总体实现起来没有什么难点,相对来说还是比较简单的。😇
最后,不要忘了在注册清单中加入读写系统日历的权限哦,不然是无法实现功能滴。😊
总结
啊啊啊!第一次写技术文章,真的是太太太兴奋啦!!!🤣以此作为自己成长的第一步,加油!!!💪😉
涉及到的知识点主要有:
如果你仅仅只是想使用,快速提供这样一个功能的话,直接copy一份源码到自己的项目中即可使用。