前言
我们可以使用系统提供的EventKit框架来访问和操作用户的日历日程和提醒(虽然日历和提醒是两个独立的app,但是是用同一个框架来处理数据)。同样地,日历和提醒的数据的数据,都是存储在同一个叫做Calendar Database的数据库中:
EventKit不仅能获取已存在的日程和提醒,还能在自己的app中创建、编辑、删除用户的日程和提醒,还能添加提醒、监听变化等。
在iOS10+中,若要访问用户日程或提醒,需要在info.plist中分别添加NSRemindersUsageDescription和NSCalendarsUsageDescription
一. 读取日程
我们可以通过EKEventStore类来对用户的Calendar database进行查询、创建、编辑、删除等操作。我们可以使用条件来获取符合条件的一组日程,也可以用唯一标识来获取指定的一条日程。获取到的每一条日程都是一个EKEvent的实例对象,因此我们修改EKEvent对象的属性即可实现修改日程信息。
1.创建连接
#import... EKEventStore *store = [[EKEventStore alloc] init];
EKEventStore对象的创建和释放会比较耗时,因此我们一般会在app加载后只创建一个event store对象。
2.通过条件获取日程
如果要获取一个时间段内的日程,可以使用EKEventStore对象的eventsMatchingPredicate: 方法。下面代码演示如何获取昨天至一年后的所有日程:
// 获取日历对象 NSCalendar *calendar = [NSCalendar currentCalendar]; // 创建开始时间 NSDateComponents *oneDayAgoComponents = [[NSDateComponents alloc] init]; oneDayAgoComponents.day = -1; NSDate *oneDayAgo = [calendar dateByAddingComponents:oneDayAgoComponents toDate:[NSDate date] options:0]; // 创建结束时间 NSDateComponents *oneYearFromNowComponents = [[NSDateComponents alloc] init]; oneYearFromNowComponents.year = 1; NSDate *oneYearFromNow = [calendar dateByAddingComponents:oneYearFromNowComponents toDate:[NSDate date] options:0]; // 创建条件 NSPredicate *predicate = [store predicateForEventsWithStartDate:oneDayAgo endDate:oneYearFromNow calendars:nil]; // 获得符合条件的所有日程 NSArray *events = [store eventsMatchingPredicate:predicate];
3.批量处理日程
如果需要批量处理得到的日程,可以用EKEventStore
实例的enumerateEventsMatchingPredicate:usingBlock:方法(同步方法,为了不阻塞主线程建议在其它线程中执行),例如打印出所有符合条件的日程标题:
[store enumerateEventsMatchingPredicate:predicate usingBlock:^(EKEvent * _Nonnull event, BOOL * _Nonnull stop) { NSLog(@"event:%@",event.title); }];
4.通过唯一标识获取日程
每一个日程都有只读的唯一标识属性eventIdentifier,我们可以通过EKEventStore对象的eventWithIdentifier:方法,传入唯一标识获取指定的一个日程(这个标识是只读属性,由系统指定,可以通过前面的条件查询获取,也可以在创建新的日程时保存这个唯一标识),例如我们已经知道一个日程的eventIdentifier值为”D8574A98-A929-4A92-8E9F-048F46FB5DE7:717c8b40-44e3-31ab-8243-2d5918e266ef”:
EKEvent *event = [store eventWithIdentifier:@"D8574A98-A929-4A92-8E9F-048F46FB5DE7:717c8b40-44e3-31ab-8243-2d5918e266ef"]; NSLog(@"event:%@",event);
二.创建日程
1.通过代码创建
通过EKEvent对象的eventWithEventStore:来创建一个日程,并通过对应的属性编辑日程详细信息,部分属性如:
- title - 日程的标题
- startDate - 日程的开始日期
- endDate - 日程的结束日期
- calendar - 日程对应的日历
- alarms - 日程的提醒时间
- recurrenceRules - 重复规则
实例代码:
EKEvent *event = [EKEvent eventWithEventStore:store]; event.title = @"代码创建的日程"; event.calendar = [store defaultCalendarForNewEvents]; NSCalendar *calendar = [NSCalendar currentCalendar]; NSDateComponents *components = [[NSDateComponents alloc] init]; components.hour = 1; NSDate *endTime = [calendar dateByAddingComponents:components toDate:[NSDate date] options:0]; event.startDate = [NSDate date]; event.endDate = endTime; event.notes = @"档期详情:hyaction://hunyu-music"; [event addAlarm:[EKAlarm alarmWithRelativeOffset:-10*60]]; NSError *error; [store saveEvent:event span:EKSpanFutureEvents commit:YES error:&error]; if (!error) { NSLog(@"添加成功!"); }else{ NSLog(@"添加失败:%@",error); }
2.通过系统日历ui添加日程
#import... EKEventEditViewController *vc = [[EKEventEditViewController alloc] init]; vc.eventStore = store; vc.editViewDelegate = self; [self presentViewController:vc animated:YES completion:nil];
通过实现EKEventEditViewDelegate代理事件获得结果:
- (void)eventEditViewController:(EKEventEditViewController *)controller didCompleteWithAction:(EKEventEditViewAction)action{ NSLog(@"添加日程结果:%zd",action); [self dismissViewControllerAnimated:YES completion:nil]; }
三.编辑和删除日程
我们可以通过修改event的属性值来对日程进行编辑,最后需要调用EKEventStore的实例方法saveEvent:span:commit:error:进行持久化保存:
event.title = @"修改后的标题"; NSError *error; [store saveEvent:event span:EKSpanFutureEvents commit:YES error:&error];
通过EKEventStore的实例方法removeEvent:span:commit:error:.来删除日程:
NSError *error; [store removeEvent:event span:EKSpanFutureEvents error:&error];
四.添加提醒
我们可以给日程添加本地推送提醒,在指定的时间或地点给用户进行提醒。
1.基于时间的提醒
我们可以通过event的 addAlarm:方法为一个日程添加提醒。我们可以指定一个确切时间或一个相对时间(只能是日程开始时间之前)。通过removeAlarm: 方法可将提醒移除。
如在开始时间前10分钟提醒:
[event addAlarm:[EKAlarm alarmWithRelativeOffset:-10*60]];
2.基于地理位置的提醒
我们可以设定当用户进入或离开指定的地理位置区域时,触发日程提醒。例如当用户离开公司,提醒用户需要到超市购买日用品,作为开发者,需要确定一个经纬度以及一个半径范围。
EKAlarm *alarm = [[EKAlarm alloc] init]; EKStructuredLocation *location = [EKStructuredLocation locationWithTitle:@"Current Location"]; location.geoLocation = [[CLLocation alloc] initWithLatitude:23.1754700000 longitude:113.4147400000]; alarm.structuredLocation = location; alarm.proximity = EKAlarmProximityEnter; [event addAlarm:alarm];
参考苹果官方文档
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。