--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/games/doc/en/sdk/sdk-about.md - https://yandex.com/dev/games/doc/hi/sdk/sdk-about.md - https://yandex.com/dev/games/doc/ko/sdk/sdk-about.md - https://yandex.com/dev/games/doc/ru/sdk/sdk-about.md - https://yandex.com/dev/games/doc/tr/sdk/sdk-about.md - https://yandex.com/dev/games/doc/vi/sdk/sdk-about.md - https://yandex.com/dev/games/doc/zh/sdk/sdk-about.md - href: ko/sdk/sdk-about.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/games/doc/ko/llms.txt # 설치 및 사용 방법 Yandex Games SDK는 타사 개발자가 만든 게임을 Yandex Games 플랫폼에 쉽게 통합하는 데 사용할 수 있는 라이브러리입니다. SDK 추가는 검토를 통과하기 위한 전제 조건입니다. SDK를 사용하면 다음을 수행할 수 있습니다. - 광고 게재를 통합합니다. - 전체 화면으로 자동 전환 설정. - 게임 중 화면 방향을 설정하고 기기 방향 회전 힌트 추가. ## 설치 {#connect} {% note alert "제한" %} 귀하의 게임이 검수를 성공적으로 통과하기 위해서는, 배치 방법에 따라 야냑스 게임 SDK를 연결하기 위한 최신 경로를 지정해야 합니다: - 게임 아카이브를 [개발자 콘솔](https://games.yandex.ru/console)에 업로드하는 경우, [상대 경로](#yandex-server)를 지정하십시오. 이 방법을 권장합니다. - `iframe`을 통한 통합을 사용하는 경우, [절대 경로](#iframe)를 지정하세요. {% endnote %} 동기식 또는 비동기식으로 Yandex Games SDK를 추가할 수 있습니다. 두 옵션 모두 동일합니다. 하지만 비동기 메서드를 사용하면 콜백 함수를 사용하여 설치를 제어할 수 있습니다. 필요에 가장 적합한 방법을 선택하세요. ### Yandex 서버 {#yandex-server} {% note info "참고" %} 개발 중 `/sdk.js`를 프록시하는 경우 [로컬 서버](https://yandex.com/dev/games/doc/ko/concepts/local-launch.md)를 사용하세요. {% endnote %} {% list tabs %} * 동기식 HTML 페이지의 `head` 태그에 다음과 같은 줄을 추가하세요: ```javascript ``` 이 방법에서 `async`, `defer`, `onload`와 같은 속성을 스크립트에 사용할 수 있습니다. 예를 들어: ```javascript ``` * 비동기식 HTML 페이지에 다음 코드를 추가하세요: ```javascript ``` {% endlist %} ### 자체 도메인 {#iframe} {% list tabs %} * 동기식 HTML 페이지의 `head` 태그에 다음 문자열을 추가합니다. ```javascript ``` * 비동기식 HTML 페이지에 다음 코드를 추가합니다. ```javascript ``` {% endlist %} ## 사용 {#use} 시작하려면 `YaGames` 객체의 `init` 메서드를 사용하여 SDK를 초기화합니다. {% note alert "제한" %} `YaGames.init()`와 [ysdk.getPayments()](https://yandex.com/dev/games/doc/ko/sdk/sdk-purchases.md#install)에는 선택적 매개변수 `signed: boolean`을 전달할 수 있으며, 이는 [사기 방지](https://yandex.com/dev/games/doc/ko/sdk/sdk-purchases.md#signature)를 위해 사용됩니다. 값 선택은 결제 처리가 어디서 이루어지는지에 따라 달라집니다: - 클라이언트 측에서 처리하는 경우 — 매개변수 없이 메서드를 호출하거나 `signed: false`를 전달하세요. 결제 메서드들은 데이터를 오픈된 형태로 반환합니다. - 서버 측에서 처리하는 경우 — `signed: true`를 전달하세요. 이 경우 [payments.getPurchases()](https://yandex.com/dev/games/doc/ko/sdk/sdk-purchases.md#getpurchases)와 [payments.purchase()](https://yandex.com/dev/games/doc/ko/sdk/sdk-purchases.md#payments-purchase) 메서드의 응답에서 모든 데이터는 _signature_ 매개변수 안에서만 암호화된 형태로 반환됩니다. {% endnote %} {% list tabs %} - 클라이언트 측 처리 기본 매개변수(`signed: false`)로 초기화. ```javascript YaGames .init() .then(ysdk => { console.log('Yandex SDK initialized'); window.ysdk = ysdk; }); ``` - 서버 측 처리 `signed: true` 매개변수로 초기화. ```javascript YaGames .init({ signed: true }) .then(ysdk => { console.log('Yandex SDK initialized'); window.ysdk = ysdk; }); ``` {% endlist %}   {.empty} ## 발생 가능한 문제 {#faq} #### 잡히지 않은 참조 오류: YaGames가 정의되지 않음 `sdk` 스크립트 연결 순서에 주의하세요: `YaGames.init()`을 실행하기 전에 연결해야 합니다. #### 잡히지 않은 참조 오류: ysdk가 정의되지 않음 SDK가 초기화되기 전에 SDK 메소드(광고 또는 구매 등)를 사용하려고 시도했습니다(콘솔에 `Yandex SDK initialized` 메시지가 표시되어야 함). 호출 순서를 보장하는 방법을 모르는 경우 SDK 사용 위치를 다시 작성하세요. 이렇게 하려면 줄을 다음과 같이 교체합니다. ```javascript ysdk.adv.showFullscreenAdv() ``` 대상: ```javascript YaGames.init().then(ysdk => ysdk.adv.showFullscreenAdv()) ``` #### SDK 설치 예제 ```javascript ``` --- {% note info "참고" %} 지원팀은 완성된 게임을 Yandex Games에 게시하는 데 도움을 드릴 수 있습니다. 개발이나 테스트에 대해 궁금한 점이 있다면, [Discord 채널](https://discord.com/invite/wU4p3whr4T)에서 질문해 주세요. {% endnote %} 지원 서비스는 얀덱스 게임에서 완성 된 게임을 게시 할 수 있습니다. 개발 또는 테스트에 대한 질문이 있는 경우 Yandex Games SDK 사용과 관련하여 문제가 발생하거나 질문이 있는 경우 다음 방법으로 지원팀에 문의하세요. 채팅 상담