설치 및 사용 방법
Yandex Games SDK는 타사 개발자가 만든 게임을 Yandex Games 플랫폼에 쉽게 통합하는 데 사용할 수 있는 라이브러리입니다.
SDK 추가는 검토를 통과하기 위한 전제 조건입니다.
SDK를 사용하면 다음을 수행할 수 있습니다.
- 광고 게재를 통합합니다.
- 전체 화면으로 자동 전환 설정.
- 게임 중 화면 방향을 설정하고 기기 방향 회전 힌트 추가.
설치
제한
동기식 또는 비동기식으로 Yandex Games SDK를 추가할 수 있습니다. 두 옵션 모두 동일합니다. 하지만 비동기 메서드를 사용하면 콜백 함수를 사용하여 설치를 제어할 수 있습니다. 필요에 가장 적합한 방법을 선택하세요.
Yandex 서버
참고
개발 중 /sdk.js를 프록시하는 경우 로컬 서버를 사용하세요.
HTML 페이지의 head 태그에 다음과 같은 줄을 추가하세요:
<!-- Yandex Games SDK -->
<script src="/sdk.js"></script>
이 방법에서 async, defer, onload와 같은 속성을 스크립트에 사용할 수 있습니다. 예를 들어:
<script async src="/sdk.js" onload="initSDK()"></script>
HTML 페이지에 다음 코드를 추가하세요:
<!-- Yandex Games SDK -->
<script>
(function(d) {
var s = d.createElement('script');
s.src = '/sdk.js';
s.async = true;
s.onload = initSDK;
d.body.append(s);
})(document);
</script>
자체 도메인
HTML 페이지의 head 태그에 다음 문자열을 추가합니다.
<!-- Yandex Games SDK -->
<script src="https://sdk.games.s3.yandex.net/sdk.js"></script>
HTML 페이지에 다음 코드를 추가합니다.
<!-- Yandex Games SDK -->
<script>
(function(d) {
var s = d.createElement('script');
s.src = "https://sdk.games.s3.yandex.net/sdk.js";
s.async = true;
s.onload = initSDK;
d.body.append(s);
})(document);
</script>
사용
시작하려면 YaGames 객체의 init 메서드를 사용하여 SDK를 초기화합니다.
제한
YaGames.init()와 ysdk.getPayments()에는 선택적 매개변수 signed: boolean을 전달할 수 있으며, 이는 사기 방지를 위해 사용됩니다. 값 선택은 결제 처리가 어디서 이루어지는지에 따라 달라집니다:
-
클라이언트 측에서 처리하는 경우 — 매개변수 없이 메서드를 호출하거나
signed: false를 전달하세요. 결제 메서드들은 데이터를 오픈된 형태로 반환합니다. -
서버 측에서 처리하는 경우 —
signed: true를 전달하세요. 이 경우 payments.getPurchases()와 payments.purchase() 메서드의 응답에서 모든 데이터는 signature 매개변수 안에서만 암호화된 형태로 반환됩니다.
기본 매개변수(signed: false)로 초기화.
YaGames
.init()
.then(ysdk => {
console.log('Yandex SDK initialized');
window.ysdk = ysdk;
});
signed: true 매개변수로 초기화.
YaGames
.init({ signed: true })
.then(ysdk => {
console.log('Yandex SDK initialized');
window.ysdk = ysdk;
});
발생 가능한 문제
잡히지 않은 참조 오류: YaGames가 정의되지 않음
sdk 스크립트 연결 순서에 주의하세요: YaGames.init()을 실행하기 전에 연결해야 합니다.
잡히지 않은 참조 오류: ysdk가 정의되지 않음
SDK가 초기화되기 전에 SDK 메소드(광고 또는 구매 등)를 사용하려고 시도했습니다(콘솔에 Yandex SDK initialized 메시지가 표시되어야 함).
호출 순서를 보장하는 방법을 모르는 경우 SDK 사용 위치를 다시 작성하세요. 이렇게 하려면 줄을 다음과 같이 교체합니다.
ysdk.adv.showFullscreenAdv()
대상:
YaGames.init().then(ysdk => ysdk.adv.showFullscreenAdv())
SDK 설치 예제
<!-- Yandex Games SDK -->
<script src="/sdk.js"></script>
<script>
YaGames.init().then(ysdk => {
// ...
});
</script>
참고
지원팀은 완성된 게임을 Yandex Games에 게시하는 데 도움을 드릴 수 있습니다. 개발이나 테스트에 대해 궁금한 점이 있다면, Discord 채널에서 질문해 주세요.
지원 서비스는 얀덱스 게임에서 완성 된 게임을 게시 할 수 있습니다. 개발 또는 테스트에 대한 질문이 있는 경우
Yandex Games SDK 사용과 관련하여 문제가 발생하거나 질문이 있는 경우 다음 방법으로 지원팀에 문의하세요.