用途:为《魔兽世界》正式服插件开发提供游戏内日历与事件调度系统的 API 参考,来源为 WoW API 文档,适用版本为 Patch 12.0.0(Build 65655),仅限正式服。
主要能力:C_Calendar 覆盖完整日历系统(50 余个函数),包括打开与导航日历(OpenCalendar、SetAbsMonth、SetMonth、GetMonthInfo、GetMinDate、GetMaxDate)、读取某日事件(GetNumDayEvents、GetDayEvent)与公会事件(GetNumGuildEvents、GetGuildEventInfo);创建与编辑事件(CreatePlayerEvent、CreateGuildAnnouncement、CreateGuildSignUpEvent、CreateCommunitySignUpEvent、AddEvent、UpdateEvent、RemoveEvent、OpenEvent、CanAddEvent),以及标题、描述、日期、时间、类型、重复选项、锁定状态、俱乐部等属性的读写;邀请管理(EventGetNumInvites、EventGetInvite、EventInvite、EventRemoveInvite、EventSetInviteStatus、EventSignUp、EventDecline、EventTentative、EventAvailable、MassInviteGuild、MassInviteCommunity 等);节日信息(GetHolidayInfo、GetNumHolidayTextures);筛选事件与团队副本重置(GetNumRaidResets、GetRaidReset);事件类型贴图(GetEventTypeTexture、EventGetTypesDisplayOrdered)。C_EventScheduler 提供 GetScheduledEvents、GetEventInfo、IsEventActive。
使用方式:需先调用 C_Calendar.OpenCalendar() 才能使用其他日历函数;多数日期与月份参数为相对当前时间的偏移量而非绝对值;日历数据为异步,打开后应等待 CALENDAR_UPDATE_EVENT_LIST 等事件。资料给出列出当日事件、创建公会活动、查询节日等示例代码,以及 CALENDAR_UPDATE_EVENT_LIST、CALENDAR_NEW_EVENT、CALENDAR_EVENT_ALARM 等关键事件。
适用场景:编写日历、活动报名、公会活动、节日与副本重置相关插件。
限制:仅正式服;节日信息只读;邀请管理需事件所有者或主持人权限;群体邀请受等级与排名过滤限制;AddEvent() 通常需要用户交互;资料未提供收费、价格或平台信息。