• 关于Android 日历事件的实现

    经常购买火车票，机票的同学就知道，当我们买下一张票的时候，票的行程日期会被写入系统日历中，当火车开动或者飞机启航的前30分钟，手机会有提醒信息，这条信息是由系统日历发出的，提醒用户，别错过时间啦。

    像这种系统日历提醒功能，实现起来并不难，毕竟Android 系统已经提供API给我们调用了，不需要重新造轮子，下面我们来实现这个功能。

    一、先获取读写日历的权限

    系统怎么会提醒，是因为我们告诉了它时间，那么我们如何告诉日历，那就是像日历写入火车票的开动日期，一般都是读写权限都申请

    在AndroidManifest.xml申请

    1. "android.permission.READ_CALENDAR" />
    2. "android.permission.WRITE_CALENDAR" />

    6.0以上系统需要动态申请

    1. if ((ActivityCompat.checkSelfPermission(getActivity(), Manifest.permission.WRITE_CALENDAR) != PackageManager.PERMISSION_GRANTED)&&(ActivityCompat.checkSelfPermission(getActivity(), Manifest.permission.READ_CALENDAR) != PackageManager.PERMISSION_GRANTED)) {
    2. 	flag = false;
    3. }else{
    4. 	flag = true;
    5. }

    二、获取日历账户

    这里分两步，先检查是否存在日历账户，没有则添加新的日历账户，有则直接获取原有日历账户。

    检查日历账号代码如下：

    1. /**
    2.      * 检查是否存在现有账户，存在则返回账户id，否则返回-1
    3.      */
    4.     private int checkCalendarAccount(Context context) {
    5.         Cursor userCursor = context.getContentResolver().query(Uri.parse(CALENDER_URL), null, null, null, null);
    6.         try {
    7.             if (userCursor == null) { //查询返回空值
    8.                 return -1;
    9.             }
    10.             int count = userCursor.getCount();
    11.             if (count > 0) { //存在现有账户，取第一个账户的id返回
    12.                 userCursor.moveToFirst();
    13.                 return userCursor.getInt(userCursor.getColumnIndex(CalendarContract.Calendars._ID));
    14.             } else {
    15.                 return -1;
    16.             }
    17.         } finally {
    18.             if (userCursor != null) {
    19.                 userCursor.close();
    20.             }
    21.         }
    22.     }

    根据检查返回结果是否是-1来判读，如果是-1，则添加日历账户

    1. /**
    2.      * 添加日历账户，账户创建成功则返回账户id，否则返回-1
    3.      */
    4.     private long addCalendarAccount(Context context) {
    5.         TimeZone timeZone = TimeZone.getDefault();
    6.         ContentValues value = new ContentValues();
    7.         value.put(CalendarContract.Calendars.NAME, CALENDARS_NAME);
    8.         value.put(CalendarContract.Calendars.ACCOUNT_NAME, CALENDARS_ACCOUNT_NAME);
    9.         value.put(CalendarContract.Calendars.ACCOUNT_TYPE, CALENDARS_ACCOUNT_TYPE);
    10.         value.put(CalendarContract.Calendars.CALENDAR_DISPLAY_NAME, CALENDARS_DISPLAY_NAME);
    11.         value.put(CalendarContract.Calendars.VISIBLE, 1);
    12.         value.put(CalendarContract.Calendars.CALENDAR_COLOR, Color.BLUE);
    13.         value.put(CalendarContract.Calendars.CALENDAR_ACCESS_LEVEL, CalendarContract.Calendars.CAL_ACCESS_OWNER);
    14.         value.put(CalendarContract.Calendars.SYNC_EVENTS, 1);
    15.         value.put(CalendarContract.Calendars.CALENDAR_TIME_ZONE, timeZone.getID());
    16.         value.put(CalendarContract.Calendars.OWNER_ACCOUNT, CALENDARS_ACCOUNT_NAME);
    17.         value.put(CalendarContract.Calendars.CAN_ORGANIZER_RESPOND, 0);
    18.  
    19.         Uri calendarUri = Uri.parse(CALENDER_URL);
    20.         calendarUri = calendarUri.buildUpon()
    21.                 .appendQueryParameter(CalendarContract.CALLER_IS_SYNCADAPTER, "true")
    22.                 .appendQueryParameter(CalendarContract.Calendars.ACCOUNT_NAME, CALENDARS_ACCOUNT_NAME)
    23.                 .appendQueryParameter(CalendarContract.Calendars.ACCOUNT_TYPE, CALENDARS_ACCOUNT_TYPE)
    24.                 .build();
    25.  
    26.         Uri result = context.getContentResolver().insert(calendarUri, value);
    27.         long id = result == null ? -1 : ContentUris.parseId(result);
    28.         return id;
    29.     }

    三、添加日历事件，也就是先系统日历写入日期

    这个过程可以添加日历事件的名称、描述、开始时间，结束时间、以及在开始时间前多少分钟提醒（通过测试，这个提前几分钟提醒至少是5分钟），设置是否开启闹钟提醒，提醒方法等。

    1. /**
    2.      * 添加日历事件
    3.      *
    4.      * @param context
    5.      * @param title        标题
    6.      * @param description  内容
    7.      * @param reminderTime 提醒时间的时间戳
    8.      * @param endTime      事件结束时间戳
    9.      * @param previousDate 提前多少分钟提醒
    10.      */
    11.     public boolean addCalendarEvent(Context context, String title, String description, long reminderTime, long endTime, int previousDate) {
    12.         if (context == null) {
    13.             return false;
    14.         }
    15.         int calId = checkAndAddCalendarAccount(context); //获取日历账户的id
    16.         if (calId < 0) { //获取账户id失败直接返回，添加日历事件失败
    17.             return false;
    18.         }
    19.         //添加日历事件
    20.         ContentValues event = new ContentValues();
    21.         event.put(CalendarContract.Events.TITLE, title);
    22.         event.put(CalendarContract.Events.DESCRIPTION, description);
    23.         event.put(CalendarContract.Events.CALENDAR_ID, calId); //插入账户的id
    24.         event.put(CalendarContract.Events.DTSTART, reminderTime);
    25.         event.put(CalendarContract.Events.DTEND, endTime);
    26.         event.put(CalendarContract.Events.HAS_ALARM, 1);//设置有闹钟提醒
    27.         event.put(CalendarContract.Events.EVENT_TIMEZONE, TimeZone.getDefault().getDisplayName());//这个是时区，必须有
    28.         Uri newEvent = context.getContentResolver().insert(Uri.parse(CALENDER_EVENT_URL), event); //添加事件
    29.         if (newEvent == null) { //添加日历事件失败直接返回
    30.             return false;
    31.         }
    32.  
    33.         //事件提醒的设定
    34.         ContentValues values = new ContentValues();
    35.         values.put(CalendarContract.Reminders.EVENT_ID, ContentUris.parseId(newEvent));
    36.         values.put(CalendarContract.Reminders.MINUTES, previousDate);
    37.         values.put(CalendarContract.Reminders.METHOD, CalendarContract.Reminders.METHOD_ALERT);
    38.         Uri uri = context.getContentResolver().insert(Uri.parse(CALENDER_REMINDER_URL), values);
    39.         if (uri == null) { //添加事件提醒失败直接返回
    40.             return false;
    41.         }
    42.         return true;
    43.     }

    四、删除日历事件，既然可以添加，那就可以删除，删除的方法有两种，一种是直接打开手机日历，找到添加的日历事件，直接删除即可，另外一种是通过代码去删除添加过的日历事件，传入一个title参数，匹配到相应的标题，就删除掉它，这里会存在删除相同标题的情况，因为添加日历事件的时候，是可以添加两个相同标题的事件的。

    1. /**
    2.      * 删除日历事件
    3.      */
    4.     public void deleteCalendarEvent(Context context, String title) {
    5.         if (context == null) {
    6.             return;
    7.         }
    8.         Cursor eventCursor = context.getContentResolver().query(Uri.parse(CALENDER_EVENT_URL), null, null, null, null);
    9.         try {
    10.             if (eventCursor == null) { //查询返回空值
    11.                 return;
    12.             }
    13.             if (eventCursor.getCount() > 0) {
    14.                 //遍历所有事件，找到title跟需要查询的title一样的项
    15.                 for (eventCursor.moveToFirst(); !eventCursor.isAfterLast(); eventCursor.moveToNext()) {
    16.                     String eventTitle = eventCursor.getString(eventCursor.getColumnIndex("title"));
    17.                     if (!TextUtils.isEmpty(title) && title.equals(eventTitle)) {
    18.                         int id = eventCursor.getInt(eventCursor.getColumnIndex(CalendarContract.Calendars._ID));//取得id
    19.                         Uri deleteUri = ContentUris.withAppendedId(Uri.parse(CALENDER_EVENT_URL), id);
    20.                         int rows = context.getContentResolver().delete(deleteUri, null, null);
    21.                         if (rows == -1) { //事件删除失败
    22.                             return;
    23.                         }
    24.                     }
    25.                 }
    26.             }
    27.         } finally {
    28.             if (eventCursor != null) {
    29.                 eventCursor.close();
    30.             }
    31.         }
    32.     }
    33. }

    以上就是所有的内容，我把代码封装成一个工具类，使用的时候直接调用添加日历事件方法跟删除日历事件方法即可。举个添加的栗子

    1. Calendar beginTime = Calendar.getInstance();
    2. beginTime.set(2022, 4, 20, 12, 0);
    3. long startMillis = beginTime.getTimeInMillis();
    4. Calendar endTime = Calendar.getInstance();
    5. endTime.set(2022, 4, 20, 15, 0);
    6. long endMillis = endTime.getTimeInMillis();
    7. CalendarEventsUtils.getInstance().addCalendarEvent(this,"火车票","别拖拖拉拉的，还有5分钟火车就开动了，抓紧～",startMillis,endMillis,5);

    以下是完整代码：

    1. public class CalendarEventsUtils {
    2.  
    3.     private final String CALENDER_URL = "content://com.android.calendar/calendars";
    4.     private final String CALENDER_EVENT_URL = "content://com.android.calendar/events";
    5.     private final String CALENDER_REMINDER_URL = "content://com.android.calendar/reminders";
    6.  
    7.     private final String CALENDARS_NAME = "日历";
    8.     private final String CALENDARS_ACCOUNT_NAME = "calendar";
    9.     private final String CALENDARS_ACCOUNT_TYPE = "com.example.calendar";
    10.     private final String CALENDARS_DISPLAY_NAME = "日历";
    11.  
    12.  
    13.     /**
    14.      * instance 单例
    15.      * INSTANCE_LOCK 互斥锁
    16.      */
    17.     private static CalendarEventsUtils instance;
    18.     private static final Object INSTANCE_LOCK = new Object();
    19.  
    20.     /**
    21.      * 获取单例
    22.      *
    23.      */
    24.     public static CalendarEventsUtils getInstance() {
    25.         if (instance == null) {
    26.             synchronized (INSTANCE_LOCK) {
    27.                 if (instance == null) {
    28.                     instance = new CalendarEventsUtils();
    29.                 }
    30.             }
    31.         }
    32.         return instance;
    33.     }
    34.  
    35.     /**
    36.      * 检查是否已经添加了日历账户，如果没有添加先添加一个日历账户再查询
    37.      * 获取账户成功返回账户id，否则返回-1
    38.      */
    39.     private int checkAndAddCalendarAccount(Context context) {
    40.         int oldId = checkCalendarAccount(context);
    41.         if (oldId >= 0) {
    42.             return oldId;
    43.         } else {
    44.             long addId = addCalendarAccount(context);
    45.             if (addId >= 0) {
    46.                 return checkCalendarAccount(context);
    47.             } else {
    48.                 return -1;
    49.             }
    50.         }
    51.     }
    52.  
    53.     /**
    54.      * 检查是否存在现有账户，存在则返回账户id，否则返回-1
    55.      */
    56.     private int checkCalendarAccount(Context context) {
    57.         Cursor userCursor = context.getContentResolver().query(Uri.parse(CALENDER_URL), null, null, null, null);
    58.         try {
    59.             if (userCursor == null) { //查询返回空值
    60.                 return -1;
    61.             }
    62.             int count = userCursor.getCount();
    63.             if (count > 0) { //存在现有账户，取第一个账户的id返回
    64.                 userCursor.moveToFirst();
    65.                 return userCursor.getInt(userCursor.getColumnIndex(CalendarContract.Calendars._ID));
    66.             } else {
    67.                 return -1;
    68.             }
    69.         } finally {
    70.             if (userCursor != null) {
    71.                 userCursor.close();
    72.             }
    73.         }
    74.     }
    75.  
    76.     /**
    77.      * 添加日历账户，账户创建成功则返回账户id，否则返回-1
    78.      */
    79.     private long addCalendarAccount(Context context) {
    80.         TimeZone timeZone = TimeZone.getDefault();
    81.         ContentValues value = new ContentValues();
    82.         value.put(CalendarContract.Calendars.NAME, CALENDARS_NAME);
    83.         value.put(CalendarContract.Calendars.ACCOUNT_NAME, CALENDARS_ACCOUNT_NAME);
    84.         value.put(CalendarContract.Calendars.ACCOUNT_TYPE, CALENDARS_ACCOUNT_TYPE);
    85.         value.put(CalendarContract.Calendars.CALENDAR_DISPLAY_NAME, CALENDARS_DISPLAY_NAME);
    86.         value.put(CalendarContract.Calendars.VISIBLE, 1);
    87.         value.put(CalendarContract.Calendars.CALENDAR_COLOR, Color.BLUE);
    88.         value.put(CalendarContract.Calendars.CALENDAR_ACCESS_LEVEL, CalendarContract.Calendars.CAL_ACCESS_OWNER);
    89.         value.put(CalendarContract.Calendars.SYNC_EVENTS, 1);
    90.         value.put(CalendarContract.Calendars.CALENDAR_TIME_ZONE, timeZone.getID());
    91.         value.put(CalendarContract.Calendars.OWNER_ACCOUNT, CALENDARS_ACCOUNT_NAME);
    92.         value.put(CalendarContract.Calendars.CAN_ORGANIZER_RESPOND, 0);
    93.  
    94.         Uri calendarUri = Uri.parse(CALENDER_URL);
    95.         calendarUri = calendarUri.buildUpon()
    96.                 .appendQueryParameter(CalendarContract.CALLER_IS_SYNCADAPTER, "true")
    97.                 .appendQueryParameter(CalendarContract.Calendars.ACCOUNT_NAME, CALENDARS_ACCOUNT_NAME)
    98.                 .appendQueryParameter(CalendarContract.Calendars.ACCOUNT_TYPE, CALENDARS_ACCOUNT_TYPE)
    99.                 .build();
    100.  
    101.         Uri result = context.getContentResolver().insert(calendarUri, value);
    102.         long id = result == null ? -1 : ContentUris.parseId(result);
    103.         return id;
    104.     }
    105.  
    106.     /**
    107.      * 添加日历事件
    108.      *
    109.      * @param context
    110.      * @param title        标题
    111.      * @param description  内容
    112.      * @param reminderTime 提醒时间的时间戳
    113.      * @param endTime      事件结束时间戳
    114.      * @param previousDate 提前多少分钟提醒
    115.      */
    116.     public boolean addCalendarEvent(Context context, String title, String description, long reminderTime, long endTime, int previousDate) {
    117.         if (context == null) {
    118.             return false;
    119.         }
    120.         int calId = checkAndAddCalendarAccount(context); //获取日历账户的id
    121.         if (calId < 0) { //获取账户id失败直接返回，添加日历事件失败
    122.             return false;
    123.         }
    124.         //添加日历事件
    125.         ContentValues event = new ContentValues();
    126.         event.put(CalendarContract.Events.TITLE, title);
    127.         event.put(CalendarContract.Events.DESCRIPTION, description);
    128.         event.put(CalendarContract.Events.CALENDAR_ID, calId); //插入账户的id
    129.         event.put(CalendarContract.Events.DTSTART, reminderTime);
    130.         event.put(CalendarContract.Events.DTEND, endTime);
    131.         event.put(CalendarContract.Events.HAS_ALARM, 1);//设置有闹钟提醒
    132.         event.put(CalendarContract.Events.EVENT_TIMEZONE, TimeZone.getDefault().getDisplayName());//这个是时区，必须有
    133.         Uri newEvent = context.getContentResolver().insert(Uri.parse(CALENDER_EVENT_URL), event); //添加事件
    134.         if (newEvent == null) { //添加日历事件失败直接返回
    135.             return false;
    136.         }
    137.  
    138.         //事件提醒的设定
    139.         ContentValues values = new ContentValues();
    140.         values.put(CalendarContract.Reminders.EVENT_ID, ContentUris.parseId(newEvent));
    141.         values.put(CalendarContract.Reminders.MINUTES, previousDate);
    142.         values.put(CalendarContract.Reminders.METHOD, CalendarContract.Reminders.METHOD_ALERT);
    143.         Uri uri = context.getContentResolver().insert(Uri.parse(CALENDER_REMINDER_URL), values);
    144.         if (uri == null) { //添加事件提醒失败直接返回
    145.             return false;
    146.         }
    147.         return true;
    148.     }
    149.  
    150.     /**
    151.      * 删除日历事件
    152.      */
    153.     public void deleteCalendarEvent(Context context, String title) {
    154.         if (context == null) {
    155.             return;
    156.         }
    157.         Cursor eventCursor = context.getContentResolver().query(Uri.parse(CALENDER_EVENT_URL), null, null, null, null);
    158.         try {
    159.             if (eventCursor == null) { //查询返回空值
    160.                 return;
    161.             }
    162.             if (eventCursor.getCount() > 0) {
    163.                 //遍历所有事件，找到title跟需要查询的title一样的项
    164.                 for (eventCursor.moveToFirst(); !eventCursor.isAfterLast(); eventCursor.moveToNext()) {
    165.                     String eventTitle = eventCursor.getString(eventCursor.getColumnIndex("title"));
    166.                     if (!TextUtils.isEmpty(title) && title.equals(eventTitle)) {
    167.                         int id = eventCursor.getInt(eventCursor.getColumnIndex(CalendarContract.Calendars._ID));//取得id
    168.                         Uri deleteUri = ContentUris.withAppendedId(Uri.parse(CALENDER_EVENT_URL), id);
    169.                         int rows = context.getContentResolver().delete(deleteUri, null, null);
    170.                         if (rows == -1) { //事件删除失败
    171.                             return;
    172.                         }
    173.                     }
    174.                 }
    175.             }
    176.         } finally {
    177.             if (eventCursor != null) {
    178.                 eventCursor.close();
    179.             }
    180.         }
    181.     }
    182. }

  • 相关阅读:
    从开发到部署微服务保姆级视频教程
    C++11 - 4 -万能引用
    艾美捷山羊抗人IgG-AP化学性质&曲线展示
    AtCoder Beginner Contest 278 F
    三维重建_使用OpenMVG/OpenMVS重建场景
    Nginx负载均衡和动静分离实例
    FineBI 项目资源迁移
    计算机的总线
    Java内存模型基础(JMM)
    Request的总结
  • 原文地址：https://blog.csdn.net/taoyuxin1314/article/details/126348862