24 lines
3.9 KiB
Markdown
24 lines
3.9 KiB
Markdown
---
|
||
kind: changes
|
||
title: 업로드 빌드별 WebGL 플레이 화면
|
||
owner: bibimbap
|
||
stability: stable
|
||
last_reviewed: 2026-10-14
|
||
---
|
||
|
||
# 업로드 빌드별 WebGL 플레이 화면
|
||
|
||
기존 상세 실행 영역은 16:9와 최대 높이 520px로 고정되어 세로 게임을 좁은 가로 영역에 넣었다. 이제 업로드한 빌드마다 선언된 기준 폭·높이를 감지·저장하고, 상세 플레이어가 가용 폭·높이 양쪽에 비율을 유지하여 맞춘다. 특정 예시 게임에 따른 크기 상수는 없다.
|
||
|
||
등록·수정에 자동/직접 지정 크기 설정이 추가되었다. 미확인 빌드는 자동 등록을 계속 허용하며 16:9 fallback을 사용한다. 기존 null 메타 게임은 파일에서 읽기 전용 감지하고 수정 시 교정할 수 있다. 크게 보기와 전체화면은 기존 iframe을 유지해 게임 재시작을 피한다. 전체화면 실패는 크게 보기로 전환한다. Unity 내부 레이아웃 재배치는 빌드 개발자의 영역이다.
|
||
|
||
추가 DB 마이그레이션은 `20261014-game-display-metadata.sql`이다. 배포 전 nullable 세 컬럼과 CHECK를 적용한다. 기존 행 백필·원본 ZIP/HTML 수정·앱 자동 DDL은 없다. 정적 감지는 안전한 선언 신호만 사용하며 JS style 대입은 지원하지 않는다. 전체 계약은 [화면 메타](../contracts/webgl-display-metadata.md), 운영 절차는 [등록·실행 가이드](../usage/webgl-display.md)에 있다.
|
||
|
||
2026-10-14 격리 검증에서 Java 21을 명시한 `bash scripts/verify-webgl-display.sh all`은 성공했다. Java 377건은 실패·오류 0, 일반 실행에서 opt-in L2 1건 skip이었다. Node 11/11과 WAR package가 통과했고, disposable PostgreSQL에서 별도로 활성화한 실제 MyBatis L2는 1/1 통과하여 생략하지 않았다. 등록·상세·수정 JSP 경로 5개가 인증 후 HTTP 200이었다.
|
||
|
||
실제 390×844 ZIP과 별도 이름의 1280×720·800×800 빌드에 대해 320×844, 1440×900, 844×390, 640×300 viewport 12/12가 stage 경계와 1px 이내 비율 조건을 통과했다. 실제 Unity instance는 준비 상태였으며 CSS client 크기와 drawing buffer를 구분해 기록했다(데스크톱 일반 291×630/582×1260, 전체화면 388×840/776×1680, 모바일 emulation 273×591/273×591). Resize·크게 보기·전체화면/복귀·API 거절 fallback 동안 같은 iframe DOM/src와 Unity instance를 유지하고 추가 load는 0이었다. 원본 ZIP 및 저장·HTTP 제공 entry HTML의 SHA-256은 변하지 않았다. 브라우저 console error와 앱 stacktrace는 없었다.
|
||
|
||
최종 정적 UI detect에서 기존 소개 패널 accent border와 숨겨진 thumbnail preview만 지적되었다. 후자는 src를 먼저 설정한 뒤 표시하므로 broken-image 오탐이다. 변경된 플레이어·크기 설정에서 확인된 새 UI 결함은 없었다. 실제 HEAD 이전 JSP를 임시 복사본에 대입한 동일 SSR regression은 실패(exit 1), 현재 JSP는 통과(exit 0)했다. 이는 markup 회귀 증거이며 이전 브라우저 geometry 실행 증거는 아니다.
|
||
|
||
보완 검증에서는 CDP touch 이벤트의 pointerType=touch, isTrusted=true와 실제 Unity 메뉴 전환을 함께 확인했다. 세로 일반 화면의 Shop, 가로 확대·resize 후 Open Upgrades가 입력 좌표에 맞게 전환되었고 같은 iframe/Unity 상태를 유지했다. 실제 물리 터치 기기의 스모크는 별도 사용자 확인 항목이다. [보완 검증 보고서](../../.atp/work-session/20261014-091658/supplemental-verification.md), [최초 검증 보고서](../../.atp/work-session/20261014-091658/verification.md), [최종 문서·UI 감사](../../.atp/work-session/20261014-091658/artifacts/final-doc-ui-audit.md)에 근거와 한계를 남겼다. 재현 절차는 [등록·실행 가이드](../usage/webgl-display.md)에 있다. 공유·운영 DB 적용과 배포는 검증 harness에 포함하지 않는다.
|