PlayDrop의 게임 에셋: 포함 파일, 소유 에셋, 공유 팩
PlayDrop 게임에 이미지, 사운드, 동영상, 3D를 담아 보내세요. 포함 파일, catalogue.json에 선언한 게임 소유 에셋, 공개 에셋과 팩, sdk.assets 런타임 조회를 다룹니다.
게임에 아트와 사운드를 담는 방법은 세 가지입니다. 필요한 일을 해내는 가장 간단한 방법을 고르세요.
| 방법 | 적합한 용도 | 사용법 |
|---|---|---|
| 포함 파일 | 그 게임에서만 쓰는 모든 것 | 패키지에 넣어 보내고 상대 경로로 불러오기 |
| 게임 소유 에셋 | PlayDrop에 등록하거나, 재사용하거나, 판매하고 싶은 에셋 | ownedAssets에 선언하기 |
| 공개 에셋과 팩 | 다른 크리에이터가 게시한 에셋 재사용 | uses에서 참조하기 |
포함 파일
게임 소유 에셋
게임이 소유하는 에셋은 게임의 카탈로그 항목에 선언하세요. 각 에셋은 이 게임에 연결된, 자체 페이지가 있는 PlayDrop 에셋이 됩니다.
{
"ownedAssets": [
{ "name": "moon-theme", "runtimeKey": "music.main", "displayName": "Moon theme",
"category": "AUDIO", "files": { "primary": "assets/moon-theme.mp3" } },
{ "name": "astronaut", "runtimeKey": "sprites.player", "displayName": "Astronaut",
"category": "SPRITESHEET", "files": { "atlas": "assets/astronaut.png", "manifest": "assets/astronaut.json" } }
]
}category는IMAGE,VIDEO,AUDIO,SPRITESHEET,MODEL_3D또는CUSTOM이며,subcategory와format으로 더 세분화합니다.files는 역할을 경로에 연결합니다. 오디오에는primary가, 스프라이트시트에는atlas와manifest가 필요합니다.runtimeKey는 게임이 런타임에 에셋을 찾을 때 쓰는 이름입니다.- 선택 사항:
visibility,license,tags, 그리고 판매하려면shopPriceCredits와 함께shopListed.
공개 에셋과 팩
게시된 에셋은 정확한 리비전으로, 팩은 버전으로 참조하세요.
{
"uses": {
"assets": [{ "ref": "asset:someone/forest-tiles@r3", "runtimeKey": "tiles.forest" }],
"packs": ["pack:someone/ui-kit@1.2.0"]
}
}PlayDrop 에셋에서 둘러보거나 sdk.assets.catalog.listPublic(), sdk.assets.packs.listPublic(), sdk.search.query()로 찾아보세요. 공개 게임은 공개 에셋과 팩만 사용할 수 있습니다. 각 에셋의 라이선스를 지키세요.
런타임에 에셋 찾기
const music = sdk.assets.resolveAppAsset("music.main");
const file = music.files.find((entry) => entry.role === "primary");
audioElement.src = file.url;
for (const asset of sdk.assets.listAppAssets()) console.log(asset.runtimeKey, asset.sourceType);각 결과에는 assetRef, runtimeKey, sourceType(OWNED, DIRECT 또는 PACK)과 role, url, contentType, sizeBytes가 담긴 files가 있습니다.
커넥터가 받는 것
AI 앱은 이미지, 동영상, 오디오, 스프라이트시트, 미리 구운 3D 모델을 업로드할 수 있으며, 미리 구운 절차적 이미지와 스프라이트시트도 포함됩니다. 실행 가능한 3D 모델(procedural 하위 카테고리나 CUSTOM 형식을 쓰는 MODEL_3D)은 PlayDrop 자체 도구에서는 실행되지만, API가 이를 검증하려고 크리에이터 코드를 실행하지 않기 때문에 커넥터에서는 거부됩니다. GLB 같은 표준 형식으로 구워서 올리거나, PlayDrop에 이미 게시된 버전을 참조하세요.
새 아트와 사운드는 AI 에셋 생성으로 만드세요. PlayDrop이 모르는 형식은 사용자 지정 에셋 형식을 참고하세요.