---
url: /release-notes.md
description: 게임플레이 파트너 가이드의 제품·API·SDK 변경 이력
---

# 릴리즈 노트

게임플레이 파트너사에 영향을 줄 수 있는 변경 이력을 **제품 · API · SDK** 세 갈래로 나누어 최신순으로 정리합니다. 파트너사가 액션을 취해야 하는 항목만 다루며, 문서 개선이나 오탈자 수정은 포함하지 않습니다.

\<ReleaseTabs
:tabs="\[
{ key: 'product', label: '제품 업데이트' },
{ key: 'api', label: 'API 업데이트' },
{ key: 'sdk', label: 'SDK 업데이트' },
]"

>

\<template #product>

### 2026-09-11

게임플레이 파트너 가이드를 정식 오픈합니다. 이제 입점 준비부터 개발 연동, 심사, 출시·운영까지 필요한 정보를 이 사이트에서 한 번에 확인할 수 있습니다. 앞으로는 기존 개별 PDF와 공유 문서 대신 파트너 가이드에서 최신 정보를 확인하세요.

**주요 추가·변경 내용**

* **입점·심사 절차 안내**
  게임플레이에 처음 입점하는 파트너사도 필요한 작업을 쉽게 확인할 수 있도록 입점 협의부터 개발 연동, 심사 요청, 출시·운영까지 순서대로 안내합니다.
  심사는 출시 심사와 업데이트 심사로 구분하고, 심사 전에 확인할 항목을 체크리스트로 제공합니다.
  관련 문서: [입점 안내](/docs/checklist/start-guide), [심사 가이드](/docs/checklist/review-guide), [심사 체크리스트](/docs/checklist/review-checklist)

* **게임플레이 파트너센터 오픈 예정**
  게임 정보 등록·관리, 출시·업데이트 심사, 게임 통계를 제공하는 게임플레이 파트너센터를 2026년 10월 오픈할 예정입니다.
  현재 파트너 가이드는 파트너센터 오픈 이후의 입점·심사 절차를 기준으로 작성했습니다.
  오픈 전까지 기존 파트너사는 기존 방식으로 게임 심사를 진행하세요.
  신규 파트너사는 파트너 가이드를 기준으로 입점을 준비한 뒤, 파트너센터 오픈 이후 게임을 등록하고 출시 심사를 요청할 수 있습니다.

* **게임플레이 JS SDK 베타 버전 출시**
  게임웹뷰·카카오 로그인·카카오톡 공유·애드핏 광고 기능을 하나의 인터페이스로 제공하는 게임플레이 JS SDK 베타 버전을 출시합니다. 자세한 내용은 [SDK 업데이트 탭](/release-notes/?tab=sdk)을 확인하세요.

* **API·데이터 연동 가이드 업데이트**
  게임 화면과 랭킹에 게임플레이 닉네임을 표시할 수 있도록 사용자 닉네임 목록 조회 API를 새로 제공합니다.
  기존 파트너사는 약관 동의 철회 통지가 카카오 로그인 계정 상태 변경 웹훅으로 바뀌는 점을 확인하세요.
  메타데이터 API는 파트너센터 오픈과 함께 사용이 중지될 예정입니다.
  게임 로그 설정 가이드도 새로 제공합니다.
  자세한 API 변경 내용은 [API 업데이트 탭](/release-notes/?tab=api)을 확인하세요.
  관련 문서: [게임 로그 설정](/api-sdk/sdk/tiara-game-logs)

\<template #api>

### 2026-09-11

회원번호(`user_ids`) 목록으로 사용자의 게임플레이 프로필 닉네임을 한 번에 조회하는 API를 추가했습니다. 게임 화면이나 랭킹에 게임플레이 닉네임을 표시할 때 파트너사 서버에서 호출해 사용합니다. 관련 문서: [사용자 닉네임 목록 조회 API](/api-sdk/data/user-nicknames)

기존 자체 콜백 방식의 약관 동의 철회 통지를 카카오 로그인 **계정 상태 변경 웹훅** 수신 방식으로 전환했습니다. 기존 방식으로 연동한 파트너사는 웹훅 수신·SET 검증·`reason`별 분기 처리를 새로 구현해야 합니다. 관련 문서: [계정 상태 변경 웹훅 연동](/api-sdk/data/terms-withdrawal), [마이그레이션 가이드](/api-sdk/data/terms-withdrawal-migration)

게임 정보 등록·수정은 2026년 10월 게임플레이 파트너센터 오픈 이후 파트너센터로 일원화되므로 메타데이터 API의 신규 연동을 중단합니다. 파트너센터가 오픈하면 이 API 호출은 오류로 응답되며, 게임 정보 변경은 업데이트 심사를 거쳐야 합니다. 신규 파트너사는 현재 가이드에 따라 입점을 준비하고, 기존 연동 파트너사는 오픈 전까지 기존 API와 기존 심사 절차를 사용합니다. 관련 문서: [메타데이터 API](/api-sdk/data/metadata)

\<template #sdk>

### 2026-09-16

`ui.navigation.contentElement` 에 게임 영역 요소를 넘기면, 내비게이션이 기기 화면이 아니라 **그 영역의 우측 상단**에 놓입니다(`1.0.0-beta.3` 부터). 태블릿처럼 가로가 긴 기기에서 좌우에 검은 레터박스가 생기면 어두운 톤의 버튼이 묻히는데, 그런 게임에서 씁니다. 값을 넘기지 않으면 지금과 같습니다. 관련 문서: [UI 컴포넌트](/api-sdk/sdk/gameplay-js/ui)

SDK 가 스스로 발견한 문제(설정 누락, 잘못된 인자, SDK 내부 오류)를 카카오로 보내 확인할 수 있게 했습니다. 기기 웹뷰에는 개발자 도구가 없어, 연동이 잘못돼도 알아차릴 방법이 없었습니다. **게임 자체의 오류는 수집하지 않습니다** — 전역 오류 핸들러를 달지 않으므로 파트너사가 쓰는 오류 수집 도구와 겹치지 않습니다. 사용자를 식별할 수 있는 값은 보내지 않습니다.

### 2026-09-15

`init()` 의 `ui.bootstrap` 옵션을 제거하고, 내비게이션 표시 여부를 `ui.navigation.visible` 로 옮겼습니다. `bootstrap: 'manual'` 은 이름과 달리 UI 전체를 수동으로 다루는 옵션이 아니라 **내비게이션만** 끄는 옵션이었고, 모달·토스트는 그대로 떴습니다. 축이 하나뿐이므로 `navigation` 옵션 안으로 넣었습니다. **`bootstrap: 'manual'` 을 쓰던 게임은 `ui: {navigation: {visible: false}}` 로 바꾸세요.** `bootstrap: 'auto'` 였다면 그 줄을 지우면 됩니다 — 기본값이 노출입니다. 관련 문서: [전체 메서드](/api-sdk/sdk/gameplay-js/reference), [UI 컴포넌트](/api-sdk/sdk/gameplay-js/ui)

`Gameplay.UI.Navigation.show()` · `hide()` 가 추가되어, 초기화 이후에도 내비게이션을 켜고 끌 수 있습니다. 전체화면 연출이나 자체 UI 를 쓰는 구간에서 잠시 숨겼다가 되돌리는 용도입니다. **숨긴 동안에는 사용자가 닫기 버튼을 누를 수 없습니다.** 게임웹뷰를 벗어날 유일한 경로이므로, 숨겼다면 반드시 다시 `show()` 로 되돌리거나 게임 자체 이탈 경로를 제공하세요. 관련 문서: [UI 컴포넌트](/api-sdk/sdk/gameplay-js/ui)

내비게이션을 끄고 시작하면 안전영역 조회 자체를 건너뛰어, 이후에 띄우는 모달·토스트가 노치·홈 인디케이터 영역에 겹쳐 앉는 문제가 있었습니다. 이제 내비게이션 표시 여부와 상관없이 안전영역을 조회하고, 값이 바뀌면 다시 반영합니다. 특히 `viewport-fit=cover` 를 쓰지 않는 게임에서 차이가 큽니다 — `env()` 만으로는 값이 0 이라 SDK 가 조회한 값이 유일한 기준이었습니다.

### 2026-09-11

`Gameplay.version` 이 추가되어 지금 로드된 SDK 의 버전을 코드에서 읽을 수 있습니다(`1.0.0-beta.1` 부터). `init()` 전에도 읽히며, 값이라 호출하지 않습니다. 평소에는 쓸 일이 없습니다 — 버전 경로를 `<script>` 에 직접 적고 `integrity` 로 고정하므로 적은 것과 다른 버전이 로드될 수 없습니다. **쓰임은 장애 대응입니다.** 문의를 남길 때 이 값을 함께 적어 주시면 어느 빌드에서 생긴 문제인지 바로 좁혀집니다. 기능 분기에는 쓰지 마세요 — SDK 버전이 같아도 카카오톡 버전에 따라 쓸 수 있는 기능이 다르므로 `isAvailable()` 로 확인합니다. 관련 문서: [전체 메서드](/api-sdk/sdk/gameplay-js/reference#version), [다운로드](/api-sdk/sdk/gameplay-js/download)

게임플레이 JS SDK 공개 베타를 시작합니다. UI 컴포넌트 레이아웃을 기기 기준으로 바로잡고, 전면광고가 SDK UI 위에 표시되도록 겹침 순서를 고쳤습니다. **이전 버전(`0.2.0`)을 연동한 게임은 스크립트 주소와 `integrity` 값을 함께 교체해야 합니다.** 두 값이 맞지 않으면 브라우저가 스크립트를 거부합니다. **베타 기간 동안 스펙이 변경될 수 있습니다.** 버전을 고정해 연동하세요. 관련 문서: [다운로드](/api-sdk/sdk/gameplay-js/download), [설치·초기화](/api-sdk/sdk/gameplay-js/)

게임웹뷰 브리지(`window.kakaotalkGamePlay`)·카카오 로그인·카카오톡 공유·애드핏 광고를 하나의 `Gameplay` 객체로 다루는 통합 SDK의 베타 버전을 출시합니다. 닫기 버튼·더보기 메뉴·이탈 확인 창을 포함한 UI 컴포넌트를 SDK 번들에서 함께 제공합니다. **베타 기간 동안 스펙이 변경될 수 있습니다.** 배포 버전과 `integrity` 값은 [다운로드](/api-sdk/sdk/gameplay-js/download)에서 확인하고, 버전을 고정해 연동하세요. 관련 문서: [설치·초기화](/api-sdk/sdk/gameplay-js/), [다운로드](/api-sdk/sdk/gameplay-js/download), [전체 메서드](/api-sdk/sdk/gameplay-js/reference), [UI 컴포넌트](/api-sdk/sdk/gameplay-js/ui)

Tiara Web SDK 필수 게임 로그를 14종에서 11종으로 조정했습니다. `SDK_게임_로딩완료` · `게임시작_클릭` · `게임시작_바로실행`은 필수 게임 로그에서 제외하며, 이미 전송 중인 게임은 별도 조치가 필요하지 않습니다. 관련 문서: [게임 로그 설정](/api-sdk/sdk/tiara-game-logs)

게임플레이 JS SDK가 네비게이션·드롭다운 메뉴·로딩·바텀시트·팝업을 직접 제공하므로, 파트너사가 이 컴포넌트들을 직접 만드는 기준은 지원 종료를 예고합니다. **지원 종료일은 아직 정해지지 않았습니다.** 확정되면 이 릴리즈 노트로 미리 안내하며, 그때까지 기존 기준은 그대로 유효합니다. SDK를 적용하지 않은 게임은 계속 기존 기준으로 제작하세요. 관련 문서: [웹뷰 컴포넌트 가이드](/docs/design/webview-component-guide), [UI 컴포넌트](/api-sdk/sdk/gameplay-js/ui)