Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.
안정성 및 성능 요구사항
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 섹션에서는 Playables의 안정성과 성능을 다룹니다.
중요: 번역된 요구사항은 참고용으로만 제공됩니다. 확정적인 안내는 요구사항의
영어 버전을 참고하세요.
1 초기 번들 크기
이 요구사항을 제대로 테스트하려면 개발자 포털에서 게임을 수집한 후 테스트 모음 에서 테스트해야 할 수 있습니다. 또는 압축을 사용한 호스팅이나 초기 로드된 모든 콘텐츠를 압축하면 적절한 근사치를 제공할 수 있습니다.
게임 초기 번들 크기는 30MiB 미만이어야 합니다 .
게임 초기 번들 크기는 15MiB 미만이어야 합니다 .
주요 용어: 초기 번들 크기 - 게임을 시작하기 위해 Playable에서
다운로드해야 하는 데이터 양입니다. 페이지
로드 시작부터 게임에서 gameReady 를 호출하는 순간까지 측정됩니다. 긴 로드를 방지하고 사용자가 게임을 포기할 위험을 줄이려면 초기 번들
크기를 최대한 작게 유지하는 것이 좋습니다. 참고: HTTP 압축을 사용하므로 게임 애셋의 전송 크기가 애셋의 저장된 크기보다 작은 경우가 있습니다. 자세한 내용은
FAQ 를 참고하세요.
2 총 번들 크기
기본적으로 게임 총 번들 크기는 250MiB 미만이어야 합니다 .
이에 대한 예외는 FAQ 에서 확인할 수 있습니다.
게임은 상호작용을 사용 설정하는 데 필요한 최소한의 데이터만 로드하고 필요에 따라 다른 데이터를 지연 로드 해야 합니다 .
**주요 용어:** _총 번들 크기_ \- YouTube에서 호스팅하는 모든 게임 파일의 합계입니다.
3 개별 파일 크기
게임 내 모든 개별 파일은 30MiB 미만이어야 합니다 .
게임 내 모든 개별 파일은 512KiB 미만이어야 합니다 .
주요 용어: 개별 파일 크기 - HTML, JavaScript, WASM 또는 미디어 파일과 같이
YouTube에서 호스팅하는 단일 게임 파일의 크기입니다.
4 저장된 게임 크기
저장된 게임 크기는 3MiB 미만이어야 합니다 .
저장된 게임 크기는 500KiB 미만이어야 합니다 .
5 로드 시간
게임은 5초 이내에 로드를 완료하고 사용자 상호작용을 허용해야 합니다 .
6 비정상 종료
게임에서 일관되게 재현 가능한 비정상 종료가 발생해서는 안 됩니다 .
게임은 최대 JavaScript 힙 크기가 512MB를 초과해서는 안 됩니다 . 이로 인해 iPhone에서 비정상 종료가 발생하는 이유는 메모리 사용량 제한 FAQ 를 참고하세요.
게임으로 인해 YouTube 앱, YouTube 웹사이트 또는 기타 사용자 소프트웨어가 비정상 종료되어서는 안 됩니다 .
7 사용되는 기술
게임은 표준 기관 (예: W3C, WHATWG)에서 정의한 표준 호환 웹 API (예: JavaScript, Canvas, WebGL)를 기반으로 해야 합니다 .
Playables는 YouTube에서 지원하는 모든 브라우저(Edge, Chrome, Firefox 등)와 호환되어야 합니다 .
Playables는 Android 및 iOS의 YouTube 앱과 호환되어야 합니다 .
8 파일 참조
게임은 게임 번들에서 다른 파일을 참조할 때 상대 경로만 사용해야 합니다 .
게임은 절대 경로를 사용해서는 안 됩니다 . 로드에 실패하기 때문입니다.
9 파일 이름
게임 번들의 파일에는 영숫자와 몇 가지 특수문자(_, -, .)만 포함되어야 합니다 .
10 파일 개수
게임 번들의 총 파일 수는 최대 8,000개여야 합니다 .
Playables 번들 분석기 를 사용하여
게임 번들의 초기 유효성 검사를 실행할 수 있습니다. 이 유효성 검사에서는 각 개별 파일의 크기, 전체 번들 크기, 잠재적인 파일 이름 불일치를 평가합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-09-11(UTC)
[null,null,["최종 업데이트: 2026-09-11(UTC)"],[],["Playables' initial bundle size must be under 15 MiB, ideally under 5 MiB, to ensure quick loading. The total bundle size should be below 15 MiB, with a maximum of 250 MiB allowed in some cases. Individual files must not exceed 30 MiB, ideally staying below 512 KiB. Saved game sizes should be kept below 500 KiB, with a limit of 3 MiB, and load time should be under 5 seconds. Games must avoid crashes, adhere to standard web APIs, use relative file paths, and utilize permitted file names.\n"]]