---
url: /api-sdk/sdk/gameplay-js/download.md
description: 게임플레이 JS SDK 의 CDN 주소와 버전별 integrity 값, TypeScript 선언 파일
---

# 게임플레이 JS SDK 다운로드

CDN 에서 `<script>` 로 로드합니다. npm 패키지는 제공하지 않습니다.

## 최신 버전

| 항목 | 값 |
| --- | --- |
| 버전 | `1.0.0-beta.3` |
| 주소 | <https://t1.kakaocdn.net/gameplay/gameplay-sdk/1.0.0-beta.3/gameplay-sdk.min.js> |
| `integrity` | `sha384-k8LvGmvy9kgexX2MYPieQBWbeZ5CImAejmHHtQjpA0MSRAp2XyeU7c9wp34Rv6RT` |

```html
<script
  src="https://t1.kakaocdn.net/gameplay/gameplay-sdk/1.0.0-beta.3/gameplay-sdk.min.js"
  integrity="sha384-k8LvGmvy9kgexX2MYPieQBWbeZ5CImAejmHHtQjpA0MSRAp2XyeU7c9wp34Rv6RT"
  crossorigin="anonymous"></script>
```

::: danger integrity 와 crossorigin 을 함께 씁니다
`integrity` 는 그 버전의 값과 **일치해야** 합니다. 어긋나면 브라우저가 스크립트 실행을 거부하고, `Gameplay` 객체가 만들어지지 않아 `Gameplay.init()` 에서 `ReferenceError` 가 납니다.

`crossorigin="anonymous"` 가 없으면 브라우저가 검증 자체를 수행하지 못합니다.
:::

버전 경로는 한 번 배포되면 내용이 바뀌지 않습니다. 새 버전은 새 경로로 올라가므로 URL 과 `integrity` 를 함께 바꿉니다.

초기화 방법은 [시작하기](/api-sdk/sdk/gameplay-js/getting-started#초기화)를 참고하세요.

## 파일 목록

같은 경로에 두 파일이 함께 배포됩니다.

파일명을 누르면 주소가 열립니다. `min.js` 는 **태그 복사**로 `integrity` 가 채워진 `<script>` 태그를 클립보드에 담고, `d.ts` 는 **다운로드**로 파일을 저장합니다.

| 파일 | 용도 | `integrity` |
| --- | --- | --- |
| [`gameplay-sdk.min.js`](https://t1.kakaocdn.net/gameplay/gameplay-sdk/1.0.0-beta.3/gameplay-sdk.min.js)  | 운영에 사용합니다 | `sha384-k8LvGmvy9kgexX2MYPieQBWbeZ5CImAejmHHtQjpA0MSRAp2XyeU7c9wp34Rv6RT` |
| [`gameplay-sdk.d.ts`](https://t1.kakaocdn.net/gameplay/gameplay-sdk/1.0.0-beta.3/gameplay-sdk.d.ts)  | TypeScript 선언. `<script>` 로 로드하지 않고 내려받아 프로젝트에 둡니다 | 해당 없음 |

같은 값이 CDN 의 [`integrity.json`](https://t1.kakaocdn.net/gameplay/gameplay-sdk/1.0.0-beta.3/integrity.json)에도 배포됩니다.

## TypeScript

[`gameplay-sdk.d.ts`](https://t1.kakaocdn.net/gameplay/gameplay-sdk/1.0.0-beta.3/gameplay-sdk.d.ts) 를 내려받아 프로젝트에 두고 `tsconfig.json` 의 `include` 에 추가합니다.

```json
{
  "include": ["src/**/*", "./gameplay-sdk.d.ts"]
}
```

전역 선언이므로 `import` 하지 않습니다. 파일 하나에 SDK 가 노출하는 모든 타입과 `Gameplay` 선언이 들어 있고, 별도 `@types/...` 패키지는 없습니다.

```ts
await Gameplay.init({
  gameName: '게임 이름',
  gameCode: 'sample-game',
  appId: 1234567,
});

const options: GameplayTalkShareOptions = {templateId: 123456};
```

::: tip 선언 파일과 스크립트의 버전을 맞춥니다
버전이 다르면 타입 검사는 통과하는데 런타임에 없는 메서드를 부르게 됩니다. 선언 파일 첫 줄 주석에 버전이 적혀 있습니다.
:::

## 버전 이력

| 버전 | 날짜 | 파일 | 변경 |
| --- | --- | --- | --- |
| `1.0.0-beta.3` | 2026-09-16 |   [integrity](https://t1.kakaocdn.net/gameplay/gameplay-sdk/1.0.0-beta.3/integrity.json) | 내비게이션을 게임 영역 안에 두는 `ui.navigation.contentElement` 추가. 태블릿처럼 레터박스가 생기는 화면에서 버튼이 검은 여백 위에 놓이지 않습니다. SDK 가 스스로 발견한 문제를 카카오로 보내는 오류 진단이 포함됩니다 — 게임 자체의 오류는 수집하지 않습니다 |
| `1.0.0-beta.2` | 2026-09-15 |   [integrity](https://t1.kakaocdn.net/gameplay/gameplay-sdk/1.0.0-beta.2/integrity.json) | `ui.bootstrap` 제거. 내비게이션 표시는 `ui.navigation.visible` 과 `UI.Navigation.show()`·`hide()` 로 다룹니다. 안전영역을 내비게이션 표시 여부와 무관하게 조회하고, 값이 바뀌면 다시 반영합니다 |
| `1.0.0-beta.1` | 2026-09-11 |   [integrity](https://t1.kakaocdn.net/gameplay/gameplay-sdk/1.0.0-beta.1/integrity.json) | `Gameplay.version` 추가. 로드된 SDK 버전을 런타임에 읽습니다 |
| `1.0.0-beta.0` | 2026-09-11 |   [integrity](https://t1.kakaocdn.net/gameplay/gameplay-sdk/1.0.0-beta.0/integrity.json) | 공개 베타 시작. UI 레이아웃을 기기 기준으로 바로잡고, 전면광고가 SDK UI 위에 오도록 겹침 순서를 고쳤습니다 |

**태그 복사**를 누르면 그 버전의 `integrity` 가 채워진 `<script>` 태그가 클립보드에 담깁니다. `min.js` 는 내려받아 쓰는 파일이 아니라 CDN 주소를 그대로 거는 파일이라, 버전을 되돌릴 때 이 태그를 그대로 붙여넣으면 됩니다.

버전 경로는 한 번 배포되면 내용이 바뀌지 않으므로 과거 버전도 그대로 씁니다. `integrity` 는 버전마다 다르니 값을 직접 확인하려면 그 버전의 `integrity.json` 을 여세요.

각 버전이 파트너사에 어떤 조치를 요구하는지는 [릴리즈 노트](/release-notes/)의 SDK 탭에서 확인하세요.

## 참고 문서

* [게임플레이 JS SDK](/api-sdk/sdk/gameplay-js/): 설치 이후의 초기화와 사용 흐름
* [전체 메서드](/api-sdk/sdk/gameplay-js/reference): 메서드와 에러 코드 전체 명세
* [릴리즈 노트](/release-notes/): 버전별 변경 사항
* 기술 문의: [카카오디벨로퍼스 데브톡](https://devtalk.kakao.com/c/game-play/353)