Tài nguyên game PlayDrop: tệp đi kèm, tài nguyên sở hữu, gói tài nguyên
Đưa hình ảnh, âm thanh, video và 3D vào game PlayDrop: tệp đi kèm, tài nguyên do game sở hữu, tài nguyên và gói tài nguyên công khai, tra cứu lúc chạy bằng sdk.assets.
Một game có thể mang theo hình ảnh và âm thanh theo ba cách. Hãy chọn cách đơn giản nhất đáp ứng được nhu cầu của bạn.
| Cách | Phù hợp để | Thực hiện |
|---|---|---|
| Tệp đi kèm | Mọi thứ chỉ riêng game này dùng | Đưa chúng vào gói và tải bằng đường dẫn tương đối |
| Tài nguyên do game sở hữu | Tài nguyên bạn muốn liệt kê trên PlayDrop, dùng lại được hoặc bán được | Khai báo chúng trong ownedAssets |
| Tài nguyên và gói tài nguyên công khai | Dùng lại tài nguyên mà các nhà sáng tạo khác đã xuất bản | Tham chiếu chúng trong uses |
Tệp đi kèm
Đặt các tệp cạnh game và tải chúng bằng đường dẫn tương đối, chẳng hạn assets/music.mp3. Chúng được tải lên cùng gói và được trình duyệt cũng như các ứng dụng lưu vào bộ nhớ đệm. Liệt kê những tệp cần để khởi động trong prefetch.required để các ứng dụng có thể tải chúng sớm (vòng đời). Một game HTML đơn giản thì phải nhúng trực tiếp tài nguyên vào tệp.
Tài nguyên do game sở hữu
Khai báo các tài nguyên mà game sở hữu trong mục catalogue của game. Mỗi tài nguyên trở thành một tài nguyên PlayDrop có trang riêng, gắn với game này:
{
"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" } }
]
}categorylàIMAGE,VIDEO,AUDIO,SPRITESHEET,MODEL_3DhoặcCUSTOM;subcategoryvàformatlàm rõ thêm.filesánh xạ vai trò tới đường dẫn. Âm thanh cầnprimary; spritesheet cầnatlasvàmanifest.runtimeKeylà tên mà game dùng để tìm tài nguyên lúc chạy.- Tùy chọn:
visibility,license,tags, vàshopListedkèmshopPriceCreditsđể bán tài nguyên.
Tài nguyên và gói tài nguyên công khai
Tham chiếu tài nguyên đã xuất bản theo bản sửa đổi chính xác, và gói tài nguyên theo phiên bản:
{
"uses": {
"assets": [{ "ref": "asset:someone/forest-tiles@r3", "runtimeKey": "tiles.forest" }],
"packs": ["pack:someone/ui-kit@1.2.0"]
}
}Duyệt chúng trên tài nguyên PlayDrop hoặc bằng sdk.assets.catalog.listPublic(), sdk.assets.packs.listPublic() và sdk.search.query(). Một game công khai chỉ có thể dùng tài nguyên và gói tài nguyên công khai; hãy tôn trọng giấy phép của từng tài nguyên.
Tìm tài nguyên lúc chạy
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);Mỗi kết quả có assetRef, runtimeKey, sourceType (OWNED, DIRECT hoặc PACK) và files với role, url, contentType và sizeBytes.
Những gì connector chấp nhận
Ứng dụng AI của bạn có thể tải lên hình ảnh, video, âm thanh, spritesheet và mô hình 3D đã bake, kể cả hình ảnh và spritesheet procedural đã bake. Mô hình 3D thực thi được (MODEL_3D có danh mục con procedural hoặc định dạng CUSTOM) chạy được trong các công cụ riêng của PlayDrop nhưng bị connector từ chối, vì API không chạy mã của nhà sáng tạo để xác thực chúng. Hãy bake chúng sang một định dạng chuẩn như GLB, hoặc tham chiếu một phiên bản đã được xuất bản trên PlayDrop.
Tạo hình ảnh và âm thanh mới bằng tạo tài nguyên bằng AI. Với những định dạng PlayDrop chưa biết, hãy xem định dạng tài nguyên tùy chỉnh.