게임플레이 JS SDK 다운로드

게임플레이 JS SDK 는 베타 버전입니다. 베타 테스트 기간 동안 스펙이 변경될 수 있습니다.

베타 기간 중 변경 사항은 릴리즈 노트의 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>

integrity 와 crossorigin 을 함께 씁니다

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

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

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

초기화 방법은 시작하기를 참고하세요.

파일 목록

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

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

파일	용도	`integrity`
`gameplay-sdk.min.js`	운영에 사용합니다	`sha384-k8LvGmvy9kgexX2MYPieQBWbeZ5CImAejmHHtQjpA0MSRAp2XyeU7c9wp34Rv6RT`
`gameplay-sdk.d.ts`	TypeScript 선언. `<script>` 로 로드하지 않고 내려받아 프로젝트에 둡니다	해당 없음

같은 값이 CDN 의 integrity.json에도 배포됩니다.

TypeScript

gameplay-sdk.d.ts 를 내려받아 프로젝트에 두고 tsconfig.json 의 include 에 추가합니다.

json

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

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

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

const options: GameplayTalkShareOptions = {templateId: 123456};

선언 파일과 스크립트의 버전을 맞춥니다

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

버전 이력

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

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

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

각 버전이 파트너사에 어떤 조치를 요구하는지는 릴리즈 노트의 SDK 탭에서 확인하세요.

참고 문서

게임플레이 JS SDK: 설치 이후의 초기화와 사용 흐름
전체 메서드: 메서드와 에러 코드 전체 명세
릴리즈 노트: 버전별 변경 사항
기술 문의: 카카오디벨로퍼스 데브톡

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

최신 버전 ​

파일 목록 ​

TypeScript ​