Cocos2 게임 연결과 종료

1. 게임 시작 시 연결하기

플랫폼 호스트와 엔진 ZIP을 같은 웹 문서에 적용한 뒤, Cocos2 엔진이 시작된 시점에 연결합니다.

다음 두 가지 연결 방법 중 하나를 선택합니다. 한 게임에서는 한 가지 방식만 사용합니다.

• ZIP 컴포넌트 사용: EasterAdActions.js 스크립트를 장면 노드에 연결합니다. 게임 이벤트와 보상 버튼에서 해당 컴포넌트의 action()과 requestReward()를 호출합니다.
• 직접 연결: 공개 API를 직접 호출합니다. window.EasterAdCocos2Platform.attach()로 연결 인스턴스를 얻고, 장면 준비가 완료되면 ready()를 호출합니다.

export async function connectGame() {
  const actions = window.EasterAdCocos2Platform.attach();
  await actions.ready();
  return actions;
}

2. 게임 이벤트 보내기

1. 레벨 시작과 완료 시점에 actions.action('level_started')와 actions.action('level_completed')를 호출합니다. 광고가 없거나 준비되지 않아도 게임 진행은 중단 없이 이어집니다.
2. 보상 버튼을 누르면 동기 호출 스택에서 actions.requestReward('revive')를 먼저 호출하고 반환된 결과를 기다립니다.
3. 반환된 결과에 맞춰 보상 판정을 적용하여 게임 보상을 지급합니다.

3. 게임 연결 종료하기

연결 방식에 맞춰 자원을 정리합니다.

• 직접 연결: 장면이나 게임을 종료할 때 await actions.destroy()를 호출하여 연결을 해제합니다.
• ZIP 컴포넌트 사용: await component.shutdown()을 호출하여 연결 정리를 완료합니다. 다시 연결할 때는 새 컴포넌트를 사용합니다.

광고 표시 중 일시정지·복원은 SDK에 맡기고 게임 고유의 일시정지 상태를 유지합니다.