七、EKEvent与EKReminder
EKEvent与EKReminder类在设计上是平行的两个类，前面的示例代码中也有介绍。EKEvent对应系统日历中的事件，EKReminder对应系统提醒应用中的事件。他们都继承自EKCalendarItem类，EKCalendarItem也是EKObject的子类，这个类解析如下：
@interface EKCalendarItem : EKObject
// UUID 事件的唯一标识
@property(nonatomic, readonly) NSString *UUID;
// 事件所属于的日历
@property(nonatomic, strong, null_unspecified) EKCalendar *calendar;
// 事件的ID
@property(nonatomic, readonly) NSString *calendarItemIdentifier;
// 事件的标题
@property(nonatomic, copy, null_unspecified) NSString *title;
// 地理位置
@property(nonatomic, copy, nullable) NSString *location;
// 备注信息
@property(nonatomic, copy, nullable) NSString *notes;
// 网址URL
@property(nonatomic, copy, nullable) NSURL *URL;
// 最后一次更改时间
@property(nonatomic, readonly, nullable) NSDate *lastModifiedDate;
// 事件创建的时间
@property(nonatomic, readonly, nullable, strong) NSDate *creationDate;
// 时区
@property(nonatomic, copy, nullable) NSTimeZone *timeZone;
// 是否有闹钟提醒
@property(nonatomic, readonly) BOOL hasAlarms;
// 是否包含重复提醒的规则
@property(nonatomic, readonly) BOOL hasRecurrenceRules;
// 是否包含参会人信息
@property(nonatomic, readonly) BOOL hasAttendees;
// 是否包含备注
@property(nonatomic, readonly) BOOL hasNotes;
// 参会人信息
@property(nonatomic, readonly, nullable) NSArray<__kindof EKParticipant *> *attendees;
// 闹钟提醒信息
@property(nonatomic, copy, nullable) NSArray<EKAlarm *> *alarms;
// 添加闹钟规则
- (void)addAlarm:(EKAlarm *)alarm;
// 删除闹钟规则
- (void)removeAlarm:(EKAlarm *)alarm;
// 包含的定期规则
@property(nonatomic, copy, nullable) NSArray<EKRecurrenceRule *> *recurrenceRules;
// 添加定期规则
- (void)addRecurrenceRule:(EKRecurrenceRule *)rule;
// 删除定期规则
- (void)removeRecurrenceRule:(EKRecurrenceRule *)rule;
@end
上面类中有引用到一些其他的核心类，如EKParticipant、EKAlarm和EKRecurrenceRule，后面会介绍。
EKEvent是EKCalendarItem的子类，其对应日历应用中的事件，解析如下：
@interface EKEvent : EKCalendarItem
// 创建一个新的事件对象
+ (EKEvent *)eventWithEventStore:(EKEventStore *)eventStore;
// 系统分类的事件ID
@property(null_unspecified, nonatomic, readonly) NSString *eventIdentifier;
// 是否是一个全天事件
@property(nonatomic, getter=isAllDay) BOOL allDay;
// 事件开始日期
@property(null_unspecified, nonatomic, copy) NSDate *startDate;
// 事件结束日期
@property(null_unspecified, nonatomic, copy) NSDate *endDate;
// 触发型事件 到达某个地理位置后触发
@property(nonatomic, copy, nullable) EKStructuredLocation *structuredLocation;
// 与另一个事件的开始事件进行比较
- (NSComparisonResult)compareStartDateWithEvent:(EKEvent *)other;
// 事件的组织者
@property(nonatomic, readonly, nullable) EKParticipant *organizer;
// 事件行为状态
@property(nonatomic) EKEventAvailability availability;
// 事件确认状态
/*
typedef NS_ENUM(NSInteger, EKEventStatus) {
EKEventStatusNone = 0,
EKEventStatusConfirmed,
EKEventStatusTentative,
EKEventStatusCanceled,
};
*/
@property(nonatomic, readonly) EKEventStatus status;
// 事件是否是独立的
@property(nonatomic, readonly) BOOL isDetached;
// 事件发生时间
@property(null_unspecified, nonatomic, readonly) NSDate *occurrenceDate;
// 刷新
- (BOOL)refresh;
// 对于生日事件 对应的生日联系人ID
@property(nonatomic, readonly, nullable) NSString *birthdayContactIdentifier;
@end
EKReminder与EKEvent类似，其对应系统的提醒事宜应用中的事件：
@interface EKReminder : EKCalendarItem
// 新建提醒事件
+ (EKReminder *)reminderWithEventStore:(EKEventStore *)eventStore;
// 开始时间
@property(nonatomic, copy, nullable) NSDateComponents *startDateComponents;
// 发生时间
@property(nonatomic, copy, nullable) NSDateComponents *dueDateComponents;
// 是否已完成
@property(nonatomic, getter=isCompleted) BOOL completed;
// 完成时间
@property(nonatomic, copy, nullable) NSDate *completionDate;
// 优先级 1-4 为高 5 为中 6-9为低
@property(nonatomic) NSUInteger priority;
@end
八、EKAlarm与EKStructuredLocation
EKAlarm对应闹钟对象，事件可以绑定闹钟提醒，解析如下：
@interface EKAlarm : EKObject
// 通过绝对时间创建闹钟
+ (EKAlarm *)alarmWithAbsoluteDate:(NSDate *)date;
// 通过与现在的相对事件创建闹钟
+ (EKAlarm *)alarmWithRelativeOffset:(NSTimeInterval)offset;
// 与现在的相对时间
@property(nonatomic) NSTimeInterval relativeOffset;
// 绝对时间
@property(nonatomic, copy, nullable) NSDate *absoluteDate;
// 地理位置触发的闹钟，对应的地理位置
@property(nonatomic, copy, nullable) EKStructuredLocation *structuredLocation;
// 触发方式
/*
typedef NS_ENUM(NSInteger, EKAlarmProximity) {
EKAlarmProximityNone,
EKAlarmProximityEnter, // 进入触发条件
EKAlarmProximityLeave // 离开触发条件
};
*/
@property(nonatomic) EKAlarmProximity proximity;
// 闹钟类型
/*
typedef NS_ENUM(NSInteger, EKAlarmType) {
EKAlarmTypeDisplay,
EKAlarmTypeAudio,
EKAlarmTypeProcedure,
EKAlarmTypeEmail
};
*/
@property(nonatomic, readonly) EKAlarmType type;
// 提醒的邮件地址
@property(nonatomic, copy, nullable) NSString *emailAddress;
// 提醒的音效名称
@property(nonatomic, copy, nullable) NSString *soundName;
// 提醒后打开的网页
@property(nonatomic, copy, nullable) NSURL *url;
@end
EKStructuredLocation用来描述地区区域结构，如下：
@interface EKStructuredLocation : EKObject
// 通过标题创建
+ (instancetype)locationWithTitle:(NSString *)title;
// 通过地图点创建
+ (instancetype)locationWithMapItem:(MKMapItem *)mapItem NS_AVAILABLE(10_11, 9_0);
// 标题
@property(nullable, nonatomic, strong) NSString *title;
// 经纬度地理信息
@property(nonatomic, strong, nullable) CLLocation *geoLocation;
// 半径
@property(nonatomic) double radius;
@end
九、EKParticipant类详解
EKParticipant类是与事件相关的联系人数据类，解析如下：
@interface EKParticipant : EKObject
// 网址
@property(nonatomic, readonly) NSURL *URL;
// 姓名
@property(nonatomic, readonly, nullable) NSString *name;
// 状态
/*
typedef NS_ENUM(NSInteger, EKParticipantStatus) {
EKParticipantStatusUnknown, // 未知
EKParticipantStatusPending, // 等待处理
EKParticipantStatusAccepted, // 接收
EKParticipantStatusDeclined, // 拒绝
EKParticipantStatusTentative,// 尝试
EKParticipantStatusDelegated,// 代理
EKParticipantStatusCompleted,// 完成
EKParticipantStatusInProcess // 进行中
};
*/
@property(nonatomic, readonly) EKParticipantStatus participantStatus;
// 人员的角色
/*
typedef NS_ENUM(NSInteger, EKParticipantRole) {
EKParticipantRoleUnknown, // 未知
EKParticipantRoleRequired, // 必要的
EKParticipantRoleOptional, // 可选参与的
EKParticipantRoleChair, // 主持人
EKParticipantRoleNonParticipant // 参与者
};
*/
@property(nonatomic, readonly) EKParticipantRole participantRole;
// 参与人类型
/*
typedef NS_ENUM(NSInteger, EKParticipantType) {
EKParticipantTypeUnknown,
EKParticipantTypePerson,
EKParticipantTypeRoom,
EKParticipantTypeResource,
EKParticipantTypeGroup
};
*/
@property(nonatomic, readonly) EKParticipantType participantType;
// 是否是当前用户
@property(nonatomic, readonly, getter=isCurrentUser) BOOL currentUser;
// 用来查找联系人的NSPredicate对象
@property(nonatomic, readonly) NSPredicate *contactPredicate;
