---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.4
alternate:
  - https://yandex.com/dev/games/doc/en/sdk/sdk-shortcut.md
  - https://yandex.com/dev/games/doc/hi/sdk/sdk-shortcut.md
  - https://yandex.com/dev/games/doc/ko/sdk/sdk-shortcut.md
  - https://yandex.com/dev/games/doc/ru/sdk/sdk-shortcut.md
  - https://yandex.com/dev/games/doc/tr/sdk/sdk-shortcut.md
  - https://yandex.com/dev/games/doc/vi/sdk/sdk-shortcut.md
  - https://yandex.com/dev/games/doc/zh/sdk/sdk-shortcut.md
  - href: ko/sdk/sdk-shortcut.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

# 바탕 화면 바로 가기

기본 대화 상자를 사용하여 사용자에게 게임 링크를 바탕화면 바로 가기로 추가하도록 제공할 수 있습니다.


대화 상자를 표시하기 전에 해당 옵션을 사용할 수 있는지 확인하세요.


## 바로 가기 추가가 가능한지 확인하기 {#can-add-shortcut}

옵션의 사용 가능 여부는 플랫폼, 내부 브라우저 규칙, [Yandex Games](https://yandex.com/games/) 제한에 따라 달라집니다. 바로가기를 추가할 수 있는지 확인하려면 `ysdk.shortcut.canShowPrompt()` 메서드를 사용합니다.

```javascript
YaGames.init().then(ysdk => ysdk.shortcut.canShowPrompt()).then(prompt => {
  console.log('Shortcut is allowed?:', prompt);
  if (prompt.canShow) {
    // 여기에 바로 가기 추가 버튼을 표시할 수 있습니다
  }
});
```

## 대화 상자 열기 {#dialog-add-shortcut}

확인 후 게임에서 버튼(또는 다른 인터페이스 요소)을 클릭하면 바로가기를 추가하기 위한 대화 상자를 호출하는 버튼(또는 다른 인터페이스 요소)을 표시할 수 있습니다. 대화 상자를 호출하려면 `ysdk.shortcut.showPrompt()` 메서드를 사용합니다.

```javascript
YaGames.init().then(ysdk => ysdk.shortcut.showPrompt()).then(result => {
  console.log('Shortcut created?:', result);
  if (result.outcome === 'accepted') {
    // 여기에서 바로 가기 추가에 대한 보상을 부여할 수 있습니다
  }
});
```

메서드를 처음 호출하면 [Yandex Games](https://yandex.com/games/) 카탈로그에 대한 바로 가기가 만들어집니다. 이미 존재하는 경우 게임 링크가 포함된 바로 가기가 생성됩니다.


---

<!-- source: ko/_includes/concepts/troubleshooting/id-troubleshooting/support.md -->
{% note info "참고" %}

지원팀은 완성된 게임을 Yandex Games에 게시하는 데 도움을 드릴 수 있습니다. 개발이나 테스트에 대해 궁금한 점이 있다면, [Discord 채널](https://discord.com/invite/wU4p3whr4T)에서 질문해 주세요.

{% endnote %}


지원 서비스는 얀덱스 게임에서 완성 된 게임을 게시 할 수 있습니다. 개발 또는 테스트에 대한 질문이 있는 경우
<!-- endsource: ko/_includes/concepts/troubleshooting/id-troubleshooting/support.md -->

<!-- source: ko/_includes/button-fos.md -->
Yandex Games SDK 사용과 관련하여 문제가 발생하거나 질문이 있는 경우 다음 방법으로 지원팀에 문의하세요.


<a href="https://yandex.com/chat/#/user/a4fa5c06-75db-9b38-6eea-b1673785f7d5">
  <span class="button">채팅 상담</span>
</a>
<!-- endsource: ko/_includes/button-fos.md -->
