Quản lý tài nguyên trong thư mục dự án

Một video Hyperframes được ghép từ nhiều tài nguyên (asset): các đoạn video, ảnh và audio. Để Hyperframes tìm thấy và hiển thị đúng các tài nguyên này khi xem trước (preview) lẫn khi render, bạn cần giữ tất cả chúng ở chung một chỗ trong dự án — gọi là folder assets/.

Gom mọi tài nguyên vào một folder assets/

Hãy để tất cả tài nguyên media — đoạn video, ảnh, và audio — chung trong một thư mục assets/ của dự án Hyperframes. Đừng rải chúng ở nhiều nơi trên máy: gom về một chỗ giúp đường dẫn trong Composition ngắn gọn, nhất quán và luôn phân giải được.

Một dự án Hyperframes điển hình có cấu trúc như sau, với assets/ nằm ngay trong thư mục dự án, cạnh các file Composition:

my-video-project/
├── compositions/
│   └── main.html          # Composition tham chiếu tài nguyên trong assets/
├── assets/                # ← folder `assets/`: gom mọi media tại đây
│   ├── intro-clip.mp4     # video
│   ├── background.png     # ảnh
│   └── voiceover.mp3      # audio
└── package.json

Tất cả video, ảnh và audio của video đều nằm gọn trong assets/ — đó chính là folder assets/ của dự án.

Composition tham chiếu tài nguyên bằng đường dẫn

Trong một Composition, mỗi tài nguyên media được tham chiếu bằng đường dẫn của nó trong folder assets/. Ví dụ, một thẻ ảnh hoặc video trong Composition trỏ tới file bên trong assets/:

<img src="../assets/background.png" />
<video src="../assets/intro-clip.mp4"></video>
<audio src="../assets/voiceover.mp3"></audio>

Chính vì các tài nguyên được giữ trong folder assets/ nên những đường dẫn này phân giải được trong cả hai giai đoạn: khi bạn xem trước video với live reload và khi Hyperframes render ra file MP4 cuối cùng. Nếu file nằm ngoài thư mục dự án, đường dẫn có thể hỏng ở một trong hai giai đoạn đó.

Lưu mọi tài nguyên tạo ra vào folder assets/

Khi bạn tạo tài nguyên bằng các nguồn khác nhau, hãy luôn lưu kết quả vào folder assets/ để Composition dùng được ngay:

• Đầu ra của MCP Services — ảnh (imagegen), audio lồng tiếng (tts), và tài nguyên stock tải về qua mediasearch — đều lưu vào folder assets/.
• Các đoạn clip từ công cụ tạo video bên ngoài (ví dụ Grok Imagine, Google Flow) cũng tải về và lưu vào folder assets/ trước khi tham chiếu.

Nói cách khác, bất kể tài nguyên đến từ đâu, điểm đến cuối cùng của nó luôn là folder assets/ của dự án.

Đường dẫn phải khớp với file đã lưu

Đường dẫn hoặc tên file mà một Composition tham chiếu phải khớp chính xác với file thực sự được lưu trong folder assets/. Nếu Composition trỏ tới ../assets/intro-clip.mp4 thì trong assets/ phải tồn tại đúng file tên intro-clip.mp4. Sai tên, sai phần mở rộng, hay sai thư mục con đều khiến tài nguyên không phân giải được.

Tài nguyên không xuất hiện trong video?

Nếu một tài nguyên media được Composition tham chiếu nhưng không có mặt trong folder assets/, tài nguyên đó sẽ không xuất hiện trong bản xem trước lẫn video đã render. Để khắc phục, hãy đặt đúng file còn thiếu vào folder assets/ (và đảm bảo tên/đường dẫn khớp với những gì Composition tham chiếu), rồi xem trước hoặc render lại.

Tiếp theoTạo asset bằng MCP & công cụ ngoài →