SDK 방법

요구 사항 항목 1.19

얀덱스 게임즈 SDK 초기화 및 메서드 사용은 문서 및 게임 요구 사항과 엄격히 일치하여야 합니다:

  1. SDK는 SDK 설치 및 사용 페이지에 명시된 대로 엄격하게 초기화됩니다.

  2. 사용자가 게임을 시작할 수 있는 시점에, gameReadyAPI의 ready() 메서드 호출이 이루어져야 합니다.

  3. GameplayAPI의 사용은 선택적이며, 게임 내에서 GameplayAPI 메서드를 사용하는 경우, start() 및 stop() 이벤트 전송 시기는 게임플레이 섹션에 명시된 대로 엄격히 준수되어야 합니다.

  4. game_api_pause 및 game_api_resume 이벤트 추적은 선택 사항이지만, 게임에서 ysdk.on() 및 ysdk.off() 메소드를 사용하는 경우, 이벤트 처리 로직은 게임 일시 중지 및 재개 이벤트 섹션에 설명된 대로 엄격하게 준수해야 합니다.

SDK 초기화

1.19.1. SDK는 SDK 설치 및 사용 페이지에 명시된 대로 엄격하게 초기화됩니다. 요구 사항이 충족되려면, 최신 로더가 사용되어야 합니다.

로더의 최신성 확인

  1. 디버그 패널과 함께 게임을 시작합니다.

    1. Yandex Games 콘솔을 엽니다.
    2. 필요한 게임을 선택합니다.
    3. 왼쪽 상단에 있는 Open with debug panel을 클릭합니다.
    1. 원하는 게임을 엽니다.
    2. 브라우저의 주소 창 끝에 &debug-mode=16을 추가합니다.

  2. 디버그 패널 왼쪽에서 Game Ready 지시기 옆에 두 글자를 찾습니다:

    • IF (init false) — 게임이 오래된 로더를 지원합니다. IF 위에 마우스를 올리면 Is loader: false 라는 표시가 나타납니다.

    • IT (init true) — 게임이 새로운 로더를 지원합니다. IT 위에 마우스를 올리면 Is loader: true 라는 표시가 나타납니다.

예시

로더

코멘트

구 로더. 디버그 패널에 IF가 표시됩니다.

구 로더. 디버그 패널에 IF가 표시됩니다.

신 로더. 디버그 패널에 IT가 표시됩니다.

신 로더. 디버그 패널에 IT가 표시됩니다.

게임 준비

1.19.2. 사용자가 게임을 시작할 수 있게 되면, LoadingAPI.ready() 메서드를 호출하세요.

이 요구 사항이 충족되려면 LoadingAPI.ready() 메서드는 적절한 시점에 호출되어야 합니다.

게임 준비 로직 검사

준비

  1. 게임을 디버그 패널과 함께 시작합니다.

    1. Yandex Games 콘솔을 엽니다.
    2. 필요한 게임을 선택합니다.
    3. 왼쪽 상단에 있는 Open with debug panel을 클릭합니다.
    1. 원하는 게임을 엽니다.
    2. 브라우저의 주소 창 끝에 &debug-mode=16을 추가합니다.

  2. 디버그 패널에서 Game Ready 인디케이터 를 찾습니다.

일반 검사 원칙

  1. 90초 이내에 파란 인디케이터 가 초록색으로 바뀌는지 확인하세요.
  2. 게임을 다시 로드합니다.
  3. 인디케이터가 색상을 바꾸는 시점을 다시 확인하세요.

게임 준비가 올바르게 작동합니다

파란 인디케이터 가 초록색 으로 바뀌는 순간:

  • 메뉴가 사용 가능할 때;

  • 게임이 상호 작용할 수 있는 상태일 때(초기 애니메이션 포함).

게임 준비 완료

코멘트

메뉴가 사용 가능할 때 녹색 표시기가 나타납니다.

메뉴가 사용 가능할 때 녹색 표시기가 나타납니다.

메뉴가 사용 가능할 때 녹색 표시기가 나타납니다.

게임이 상호작용을 위해 준비되는 순간, 녹색 지시등이 나타납니다.

게임이 상호작용을 위해 준비되는 순간, 녹색 지시등이 나타납니다.

게임이 상호작용을 위해 준비되는 순간, 녹색 지시등이 나타납니다.

게임 준비가 제대로 작동하지 않음

파란색 인디케이터 이(가) 녹색 인디케이터 로 변경되었습니다:

  • 게임이 상호 작용할 수 있게 되기 전에(프로그레스 바, 로딩 애니메이션, 검은 화면 등이 있음);

  • 게임이 상호작용할 준비가 된 후 몇 초 후.

게임 준비 완료

코멘트

게임이 상호작용할 수 있게 되기 전에 녹색 표시등이 나타납니다.

게임이 상호작용할 수 있게 되기 전에 녹색 표시등이 나타납니다.

게임이 상호작용할 수 있게 되기 전에 녹색 표시등이 나타납니다.

게임이 상호 작용할 준비가 된 후 몇 초 뒤에만 녹색 표시등이 나타났습니다.

게임이 상호 작용할 준비가 된 후 몇 초 뒤에만 녹색 표시등이 나타났습니다.

게임 준비가 내장되지 않음

90초 후에 표시기가 빨간색으로 변합니다 .

게임 준비 완료

코멘트

표시기가 빨간색으로 변했습니다 — 게임 준비가 내장되지 않았습니다.

게임플레이 마크업

1.19.3. GameplayAPI.start() 및 GameplayAPI.stop() 메소드는 게임플레이의 시작과 정지를 마크업하는 데 사용됩니다. 이 메소드가 게임에서 사용되는 경우, 이벤트 전송 시점은 게임플레이 섹션에 설명된 바와 정확히 일치합니다.

게임플레이 마크업 검사

준비

  1. 디버그 패널과 함께 게임을 실행합니다.

    1. Yandex Games 콘솔을 엽니다.
    2. 필요한 게임을 선택합니다.
    3. 왼쪽 상단에 있는 Open with debug panel을 클릭합니다.
    1. 원하는 게임을 엽니다.
    2. 브라우저의 주소 창 끝에 &debug-mode=16을 추가합니다.

  2. 디버그 패널에서 게임패드 버튼 🎮을 찾습니다.

검사의 일반 원칙

다음 행동에 따라 게임플레이 지시등의 상태를 관찰하세요:

  • 플레이어가 게임플레이를 시작하거나 일시정지 후 다시 시작할 때, GameplayAPI.start() 메소드가 호출되어야 합니다. 게임플레이 지시등이 초록색으로 변해야 합니다 — 게임플레이 진행 중.

  • 플레이어가 게임플레이를 종료하거나 일시정지할 때, GameplayAPI.stop() 메소드가 호출되어야 합니다. 게임플레이 지시등이 빨간색으로 변해야 합니다 — 게임플레이 일시정지.

검사 시 고려되는 시나리오:

  • 레벨의 시작과 종료.

  • 게임 메뉴의 열기와 닫기.

  • 구매 메뉴의 열기와 닫기.

  • 광고의 시작과 종료.

  • 게임에 대한 포커스 손실 및 게임으로의 복귀 (브라우저의 다른 탭이나 다른 창으로의 전환).

팁

게임에 포커스가 있는지 또는 다른 창에 있을 때, 이벤트 game_api_resume 및 game_api_pause를 관찰하세요.

게임플레이 정확하게 표시됨

시나리오에 따라 지시등 색상이 변경됩니다.

게임

코멘트

새로운 레벨이 시작될 때 지시등이 녹색으로 바뀝니다.

레벨이 끝나면 지시등이 빨간색으로 바뀝니다.

메뉴로 이동한 후 게임 과정으로 돌아오면 지시등 색상이 변경됩니다.

메뉴로 이동한 후 게임 과정으로 돌아오면 지시등 색상이 변경됩니다.

상품 구매 메뉴로 이동한 후 게임 과정으로 돌아오면 지시등 색상이 변경됩니다.

광고가 닫히면 지시등 색상이 빨간색에서 녹색으로 변경됩니다.

브라우저 탭에서 다른 창으로 포커스가 이동한 다음 게임 과정으로 돌아오면 지시등 색상이 변경됩니다.

게임플레이 잘못 표시됨

시나리오에 따라 지시등 색상이 변경되지 않습니다.

게임

코멘트

레벨이 끝났지만 지시등 색상이 녹색에서 빨간색으로 변경되지 않았습니다.

메뉴로 이동했을 때 지시등 색상이 녹색에서 빨간색으로 변경되지 않았습니다.

광고가 닫혔지만 지시등 색상이 빨간색에서 녹색으로 변경되지 않았습니다.

브라우저 탭에서 다른 창으로 포커스가 이동했지만 지시등 색상이 변경되지 않았습니다.

모더레이션에 연락하기

SDK의 메소드를 올바르게 사용하고 있다고 생각되는데 게임이 출판에서 제외되었거나 실수로 인해 출판되지 않았다면 아래 양식을 작성하세요.

모더레이션 품질 관리 서비스가 결정을 재검토하고 게임이 부당하게 차단되었다면 게임을 복원할 것입니다.

폼을 열기
Previous
기본 위반 사항
Next
게임 메커닉