웹숍 제한 참조
Unity 웹숍에 적용되는 구조, 명명, 미디어, 런타임 제한을 확인합니다.
읽는 시간 5분최근 업데이트: 한 달 전
이 페이지에는 Unity 웹숍에 적용되는 제한이 나열되어 있습니다. 이러한 제한이 제한하는 개념은 웹숍 소개 및 웹숍 테마 및 브랜드 지정을 참조하십시오.
구조적 한계
다음 제한은 웹숍, 환경, 스튜디오를 생성할 수 있는 수에 적용됩니다.
object | limit | 참고 사항 |
|---|---|---|
| Unity Cloud 프로젝트당 웹숍 | 1 | 동일한 프로젝트에 대한 두 번째 웹숍을 생성하면 충돌 리스폰스가 반환됩니다. |
| 웹숍당 환경 | 25 | 프로덕션 환경을 포함합니다. |
| 퍼블리싱 환경 | 제작 전용 | 비프로덕션 환경은 드래프트 전용이며, Apply to production을 사용하여 비프로덕션 드래프트를 프로덕션으로 복사합니다. |
| 스튜디오 범위 | Unity 조직당 하나 | 첫 번째 웹숍 생성 시 설정. 조직 설정에서 이름을 변경할 수 있지만 조직 간에 전송할 수는 없습니다. |
명명 규칙
다음 규칙은 설정한 스튜디오 이름, 슬러그 및 기타 식별자에 적용됩니다.
Field | 규칙 |
|---|---|
| 스튜디오 이름: | |
| 슬러그 | |
| Display name | 1~255자입니다. |
| 딥 링크 | 최대 31자(34, 후속 |
| 딥 링크 | 최대 512자. |
미디어 제한
Unity Dashboard는 웹숍용 다음 이미지 업로드 타입을 지원합니다.
- 영웅 배너: 웹숍에서 플레이어에게 표시됩니다.
- Thumbnails: 웹숍에서 플레이어에게 표시됩니다.
- Screenshots: AI 테마 생성을 위한 레퍼런스 입력으로 사용되며, 웹숍에 표시되지 않습니다.
모든 이미지 업로드 타입은 PNG, JPEG, WebP 포맷을 지원합니다. Unity Dashboard는 업로드를 저장하기 전에 각 업로드를 다시 인코딩합니다.
Upload: | 목적 | 최대 파일 크기 | 요청당 파일 수 | 참고 사항 |
|---|---|---|---|---|
| 영웅 배너 | 상점 상단에 표시됨 | 5MB | 1 | 대시보드가 이를 1920 × 384px(5:1) WebP로 다시 인코딩합니다. 잘라내지 않도록 이 종횡비 또는 더 넓게 업로드한다. |
| 썸네일 | 링크 미리보기 및 링크 카드에 사용 | 5MB | 1 | 대시보드가 이를 48 × 48 px(제곱) WebP로 다시 인코딩합니다. |
| 스크린샷 | AI 테마 생성 레퍼런스 | 파일당 2MB | 요청당 최대 6개 | 스토어에 표시되지 않으며, 테마 제너레이터의 추가 입력으로만 사용됩니다. 단일 업로드 요청은 모든 스크린샷에 총 최대 10MB를 전송할 수 있습니다. |
런타임 제한
다음 제한은 실시간 트래픽 및 API 호출에 적용됩니다.
값 | limit | 참고 사항 |
|---|---|---|
| 대시보드 미리보기 링크 토큰 | 발행일로부터 72시간입니다. | Dev 미리보기 URL( |
| SDK 드래프트 프리뷰 링크 | 발행 시 약 1시간 후 | 게임이 드래프트를 확인할 때 storefront-link 엔드포인트가 반환하는 수명이 짧은 드래프트 URL입니다. SDK는 이를 실행할 때마다 다시 확인하므로 짧은 수명이 플레이어에게 보이지 않습니다. |
| 플레이어 세션 토큰 | 수명이 짧고 단일 사용 | 제한된 플레이어 Auth는 게임 미닛( |
| 플레이어 ID 토큰 | 1시간, 자동으로 새로고침됩니다. | 상점에서는 플레이어의 ID 토큰이 만료되기 직전에 새로 고침하므로 플레이어가 세션 중에 다시 인증하지 않습니다. |
| 플레이어 세션 | 고정 만료가 없습니다. | 플레이어 세션은 서버에서 취소할 때까지 유효하게 유지됩니다. 웹숍은 브라우저에서 그것을 유지합니다 - 라이브 스토어에서 |
| 관리자 API 속도 제한 | 소스 IP당 요청이 초당 40개입니다. | 모든 내부 API 호출에 적용됩니다(대시보드 요청, 서비스 계정 프로그래머틱 호출). 한계를 초과하는 폭발적인 자동화는 |
| 플레이어 카탈로그 요청 속도 제한 | 분당 요청(플레이어, 프로젝트, 환경) 600개, IP당 백스톱(초당 요청 20개, 분당 요청 300개) | 플레이어 프런트엔드의 런타임 카탈로그 페치에 적용됩니다. 두 제한이 스태킹되므로, 오작동 중인 플레이어 하나만이 IP 할당량을 소진할 수 없습니다. |
| 플레이어 셸 트래픽 | 서비스에서 속도 제한이 없습니다. | 스토어의 HTML 셸과 미디어는 콘텐츠 전송 네트워크에서 제공되며 대시보드 서비스에는 도달하지 않습니다. |
액세스 및 가시성
웹숍은 업로드된 미디어와 개발 미리보기 링크를 공개 웹 콘텐츠로 제공합니다. 콘텐츠 전송 네트워크는 모든 정적 에셋을 제공하는 것과 동일한 방식입니다. URL이 있는 사용자는 로그인하지 않고도 열 수 있습니다. URL은 읽을 수 없는 식별자를 사용하며 스토어에서 연결되어 있지 않으므로 쉽게 찾을 수 없지만 액세스 제어도 가능합니다. 무엇을 업로드할지, 미리보기 링크를 누구와 공유할지 선택할 때 이러한 점에 유의하십시오.
Resource | 액세스 권한이 있는 사람 | 참고 사항 |
|---|---|---|
| 개발 미리보기 URL | 토큰 만료 전까지 링크가 있는 사용자 | 웹숍은 |
| 업로드된 미디어(영웅 배너, 썸네일, 스크린샷) | URL이 있는 사용자 | 업로드하는 미디어는 WebP에 다시 인코딩되고 스토어의 |
AI 테마 생성
다음 값은 AI 테마 생성에 적용됩니다.
Detail | 현재 값 |
|---|---|
| 테마 생성에 사용되는 모델 | 대규모 언어 모델입니다(더 나은 모델이 제공될수록 변경될 수 있습니다). |
| 생성 입력의 소스 | Apple 앱 스토어 나열 URL, 업로드한 스크린샷 또는 둘 다. 대시보드가 아이콘, 스크린샷, 컬러 팔레트에 대한 제공된 목록을 스크레이핑합니다. |
| 테마 생성 속도 제한 | 오용 방지로 프로젝트당 속도 제한 이 제한은 대시보드가 허용하는 만큼 빠르게 테마를 생성하고 다듬는 것이 제한에 도달하지 않으므로 일반적인 인터랙티브 사용보다 훨씬 더 높게 설정되어 있으므로 실행 중인 자동화에서만 사용할 수 있습니다. 요청을 초과하여 반환 |
| 테마 생성 예산 | 프로젝트당 일일 및 주별 테마 생성 지출 한도입니다. 프로젝트가 한계에 도달하면 창이 초기화될 때까지 추가 생성이 차단됩니다. 한도는 프로젝트별로 추적되며, 웹숍을 삭제하거나 다시 생성해도 재설정되지 않습니다. |
이 제너레이터를 사용하는 사용자에 대한 절차는 AI를 사용하여 웹숍 테마 생성을 참조하십시오.