게임 다운로드 및 게임플레이 마크업

게임 다운로드

Yandex 게임은 전 세계적으로 운영되므로, 통계 수집은 게임의 다운로드 속도와 접근성을 개선하기 위해 중요합니다. 예를 들어, 이 데이터를 바탕으로 새로운 데이터 센터를 어디에 배치할지 결정합니다.

게임이 언제 다운로드되는지를 이해하는 것은 모든 게임에 공통적인 로딩 화면, 게임 스크린샷 또는 리뷰를 표시하는 새로운 기능을 추가할 수 있게 합니다. 이는 게임의 매력을 높일 것입니다.

ysdk.features.LoadingAPI.ready()

ysdk.features.LoadingAPI.ready() 메서드는 게임이 모든 리소스를 로드하고 사용자와 상호작용할 준비가 되었을 때 호출해야 합니다.

게임 호출 시점에 다음을 확신하세요:

• 모든 요소가 플레이어와의 상호 작용에 준비되었음;
• 로딩 화면이 없음.

예시

const ysdk = await YaGames.init();

// 플랫폼에 게임이 로드되어 플레이를 시작할 준비가 되었음을 알립니다.
ysdk.features.LoadingAPI?.ready()

YaGames.init()
    .then((ysdk) => {
        // 플랫폼에 게임이 로드되어 플레이를 시작할 준비가 되었음을 알립니다.
        ysdk.features.LoadingAPI?.ready()
    })
    .catch(console.error);

게임플레이

사용자가 게임과 어떻게 상호 작용하는지, 언제 상호 작용하는지 추적하는 것이 중요합니다. 이를 위해 SDK에는 게임플레이 시작과 중지를 표시하는 특별한 메서드가 있습니다. 이러한 사용은 카탈로그에서 추천의 정확도를 높이고, 더 많은 플랫폼에 게임을 배포하며, 개발자 콘솔에 추가 지표를 형성하는 데 도움이 됩니다.

ysdk.features.GameplayAPI.start()

플레이어가 게임플레이를 시작하거나 재개하는 경우에 ysdk.features.GameplayAPI.start() 메서드를 호출해야 합니다:

• 레벨 시작;
• 메뉴 닫기;
• 일시 정지 해제;
• 광고 보여준 후 게임 재개;
• 현재 탭으로 돌아오기.

GameplayAPI.start() 이벤트를 보낸 후에 게임플레이가 바로 시작되었는지 확인하세요.

ysdk.features.GameplayAPI.stop()

플레이어가 게임플레이를 일시 중지하거나 종료하는 경우에 ysdk.features.GameplayAPI.stop() 메서드를 호출해야 합니다:

• 레벨을 통과하거나 실패;
• 메뉴 호출;
• 게임 일시 중지;
• 전체 화면 또는 리워드 광고 보여주기;
• 다른 탭으로 전환.

GameplayAPI.stop() 이벤트를 보낸 후에 게임플레이가 중단되었는지 확인하세요.

예시

const ysdk = await YaGames.init();

// 게임플레이 시작을 알립니다.
ysdk.features.GameplayAPI?.start()

// 게임플레이가 활성화되었습니다.

// 게임플레이 중단을 알립니다:
// 플레이어가 메뉴로 나갔거나, 레벨을 통과하거나, 광고를 보여줄 예정입니다.
ysdk.features.GameplayAPI?.stop()

YaGames.init()
    .then((ysdk) => {
        // 게임플레이 시작을 알립니다.
        ysdk.features.GameplayAPI?.start()

        // 게임플레이가 활성화되었습니다.

        // 게임플레이 중단을 알립니다:
        // 플레이어가 메뉴로 나갔거나, 레벨을 통과하거나, 광고를 보여줄 예정입니다.
        ysdk.features.GameplayAPI?.stop()
    });

지원 서비스는 얀덱스 게임에서 완성 된 게임을 게시 할 수 있습니다. 개발 또는 테스트에 대한 질문이 있는 경우

Yandex Games SDK 사용과 관련하여 문제가 발생하거나 질문이 있는 경우 다음 방법으로 지원팀에 문의하세요.