Tải Lên Tài Nguyên
Tìm hiểu cách tải lên hình ảnh, âm thanh và file dữ liệu vào thư viện tài nguyên PlayableLabs
Tổng quan
Tài nguyên là các file media tạo nên quảng cáo playable -- texture, sprite, âm thanh và file dữ liệu. PlayableLabs lưu trữ tất cả tài nguyên trên Cloudflare R2 với CDN delivery, được phân tách theo tổ chức để đảm bảo bảo mật và cô lập dữ liệu.
Định dạng hỗ trợ
| Danh mục | Định dạng | Mục đích sử dụng |
|---|---|---|
| Hình ảnh | PNG, JPG, WebP, SVG | Texture, sprite, hình nền, thành phần UI |
| Âm thanh | MP3, OGG, WAV | Nhạc nền, hiệu ứng âm thanh, giọng đọc |
| Video | MP4, WebM | Nền video, cutscene, nội dung quảng bá |
| Font chữ | TTF, OTF, WOFF, WOFF2 | Kiểu chữ tùy chỉnh cho UI và văn bản |
| Mô hình 3D | GLB, GLTF, OBJ, FBX, DAE | Tài nguyên 3D cho game có render 3D |
| Dữ liệu | JSON | Cấu hình, dữ liệu màn chơi, định nghĩa animation |
Giới hạn dung lượng
- Tất cả loại file: Tối đa 100 MB mỗi file (có thể cấu hình bởi quản trị viên tổ chức)
Mẹo: Sử dụng định dạng nén (WebP cho hình ảnh, MP3/OGG cho âm thanh) để giữ quảng cáo playable xuất ra nằm trong giới hạn dung lượng của mạng quảng cáo.
Tải lên file
Có hai cách để tải tài nguyên lên.
Kéo và thả
- Chuyển đến mục Tài nguyên từ thanh bên (hoặc tab Tài nguyên bên trong một game)
- Kéo file từ trình quản lý file trực tiếp vào vùng tải lên
- PlayableLabs tự động kiểm tra định dạng và dung lượng
- File xuất hiện trong thư viện tài nguyên khi tải lên hoàn tất
Nhấn để tải lên
- Nhấn nút Tải lên trong thư viện tài nguyên
- Chọn một hoặc nhiều file từ cửa sổ chọn file
- Chọn thư mục đích (tùy chọn)
- Thêm metadata trước khi tải lên:
- Tên — Tên hiển thị tài nguyên (tự động điền từ tên file)
- Mô tả — Ghi chú tùy chọn về tài nguyên
- Loại — Tự động phát hiện từ phần mở rộng file và MIME type
- Nhấn Tải lên để bắt đầu chuyển file
Tải lên hàng loạt
Bạn có thể tải nhiều file cùng lúc bằng cả hai cách. Chọn hoặc kéo nhiều file và PlayableLabs xử lý song song. Thanh tiến trình hiển thị trạng thái của từng file.
Lưu ý: Các lô lớn (50+ file) có thể mất nhiều thời gian hơn tùy theo kết nối. Mỗi file tải lên độc lập, nên một file lỗi không ảnh hưởng đến các file còn lại.
Cách lưu trữ hoạt động
Khi bạn tải file lên, PlayableLabs:
- Kiểm tra định dạng và dung lượng file
- Tải lên file vào Cloudflare R2, phân tách theo organization ID
- Tạo bản ghi tài nguyên trong database với metadata và URL R2
- Phân phối file qua CDN để tải preview nhanh
Tài nguyên được lưu dưới dạng URL nội bộ. Khi xuất, nền tảng tự động chuyển đổi sang base64 để tạo file HTML đơn. Bạn không cần xử lý chuyển đổi này thủ công.
Tải lên trong Game
Bạn cũng có thể tải tài nguyên trực tiếp từ tab Tài nguyên của game. Tài nguyên tải lên theo cách này tự động liên kết với game đó, giúp dễ tìm khi cấu hình version và variant.
- Mở game từ danh sách Games
- Chuyển đến tab Tài nguyên
- Tải file bằng kéo thả hoặc nút tải lên
- Tài nguyên xuất hiện trong cả tab game và thư viện tài nguyên chung
Bước tiếp theo
- Tổ chức tài nguyên vào bộ sưu tập để quản lý dễ dàng hơn
- Chỉnh sửa, thay thế hoặc xóa tài nguyên khi dự án phát triển