GS2-Schedule API 레퍼런스

게임 내 이벤트의 일정을 관리합니다.

이 서비스는 단독으로 사용하지 않고, GS2-Showcase나 GS2-Quest 등과 연계하여 이벤트 개최 기간에만 스토어에 진열되는 상품이나 퀘스트를 구현합니다.

이벤트 개최 기간에는 두 가지 종류가 있습니다.

• 절대 기간은 모든 플레이어가 동일한 기간을 공유합니다. “1월 1일~1월 3일에 뉴이어 이벤트를 개최한다"와 같은 경우에 사용하며, absoluteBegin / absoluteEnd 를 마스터 데이터에서 지정합니다.
• 상대 기간은 플레이어마다 기간이 다릅니다. “게임 시작으로부터 1주일"이나 “처음 보스를 쓰러뜨린 후 24시간"과 같은 경우에 사용합니다. 트리거를 당길 때 이미 트리거가 당겨져 있는 경우 이벤트 기간을 지정하는 방식에는 여러 가지가 있습니다.

절대 기간·상대 기간 모두, RepeatSetting 을 조합함으로써 “특정 요일이나 시간대에만 유효”, “며칠 주기로 유효·무효를 전환"과 같은 반복 스케줄을 표현할 수 있습니다.

반복 설정을 가진 이벤트에 대해서는 현재 및 직전 반복 주기의 시작 일시·종료 일시를 RepeatSchedule 로 취득할 수 있습니다.
이를 통해 현재 주기 내에서 보상을 몇 번 수령했는지에 대한 집계나, 다음 주기까지의 남은 시간 표시가 가능합니다.