Android日历事件管理器,是时候为你的APP添加一个事件提示功能啦!

作者 : 开心源码 本文共3543个字,预计阅读时间需要9分钟 发布时间: 2022-05-12 共141人阅读

前言

很多时候,我们需要向APP中增加一个事件提示功能,一般的话都是通过微信公众号或者是发送手机短信的方式来实现,但这样假如对于个人开发者的话,想通过这两种方法来实现通知提示功能就有些限制了。你以为我们就要就此止步了???别焦急,还有办法!幸运的是Android系统为我们提供了CalendarContract这个类,系统有关于日历的操作等等都是通过他实现哒!所以我们可以借助CalendarContract来实现向系统日历中插入事件。而且既然是插入到系统日历中,所以我们当然也就不用担心服务会由于内存不够被系统杀掉而导致提示不及时的问题!哇!开心辣么大??!

继续前进,这次给大家带来的就是通过Android系统的CalendarContract类来封装实现的一个日历事件工具类,目前实现的功能有向系统日历插入日历账户、查询日历账户、增加、修改、删除日历事件以及事件提示等功能。废话少说,看效果图:(整个工程的代码还是比较多的,为了节省篇幅,这里只截取一小部分的代码,假如想查看完整代码,结尾有附源码链接)

效果预览.gif

怎样样?心不心动?!赶快借此给自己的APP加上一个事件提示功能吧!

CalendarContract.Events

这是什么?Google代码遵循的见其名知其意相信大家看到这个名字就应该大概猜到了他的作用吧?这张表保存了特定的事件信息。在这个表中每一行都有单一事件的信息,如事件的标题、位置、开始时间、结束时间等。这个事件能够发生一次或者重复发生屡次。会议、提示和扩展的属性被保存的独立的表中,它们都有一个EVENT_ID跟Events表中的_ID进行关联。最终事件也就是插入到系统的这张表中,还有一个CalendarContract.Reminders,它主要是用来保存事件的提示参数的,比方说设置提前15分钟、使用系统通知提示作为提示方式,这两个参数的值就是保存在CalendarContract.Reminders中的

下面来看张日历事件的数据模型图(素材来自网络):

image

Events表

既然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_DAY1指明这个事件会占用终日时间(由本地时区定义的时间);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就是数据的匹配条件了,熟习数据库的同学一定都很理解,这里我就不再详情了。??

其实最主要的还是理解表的各个字段的含义,理解了这些字段,再将他们都组装起来插入到系统表中即可以了,总体实现起来没有什么难点,相对来说还是比较简单的。??

这里我就只简单详情下其中的CalendarContract.Events表啦。有关与CalendarContract的更多操作,有兴趣的同学可以参考下Android 日历CalendarProvider这篇文章,详细的讲解了有关CalendarContract的各个表以及含义。

最后,不要忘了在注册清单中加入读写系统日历的权限哦,不然是无法实现功能滴。??

<uses-permission android:name="android.permission.WRITE_CALENDAR" /><uses-permission android:name="android.permission.READ_CALENDAR" />

总结

啊啊啊!第一次写技术文章,真的是太太太兴奋啦!!!??以此作为自己成长的第一步,加油!!!????
涉及到的知识点主要有:

  • CalendarContract.Events
  • CalendarContract.Reminders
  • CalendarContract.Calendars
  • 一丢丢的数据库 Cursor

假如你仅仅只是想使用,快速提供这样一个功能的话,直接copy一份源码到自己的项目中即用。

【参考】Android 日历CalendarProvider

戳我看源码

说明
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » Android日历事件管理器,是时候为你的APP添加一个事件提示功能啦!

发表回复