SAAT - Audio API và Toolkit

API âm thanh và Quản lý âm thanh cho SMAPI mà không cần sử dụng HarmonyLib.
Thêm nhạc tùy chỉnh vào bản mod của bạn!

Bản mod này có tác dụng gì?

SAAT là một framework nhằm mục đích thêm, quản lý và chỉnh sửa các track âm thanh trong Stardew Valley. Ngoài ra, nó còn hướng đến việc cải thiện engine âm thanh sau này, vì engine âm thanh của XNA/MonoGame còn yếu về mặt quản lý và hỗ trợ bộ nhớ. Mục tiêu của nó là loại bỏ sự hài hòa.

Bạn có thể xem các ví dụ về cách thêm các bản âm thanh tùy chỉnh từTài liệu trên Github


Mới trong v1.1.2:
- Đã sửa lỗi dẫn đến thông báo cảnh báo "Không tìm thấy CueDefinition có tên 'title_day'"

Mới trong v1.1.1:
- Tính năng an toàn để ngăn trò chơi bị sập khi tín hiệu được gọi không đúng hoặc không tìm thấy.
-- Khi thất bại, tín hiệu "Defaulting Cue" sẽ được phát ra. Tín hiệu này sẽ im lặng.
- Khả năng thêm bản nhạc vào máy hát tự động. Xem lệnh "addtojukebox".
-- Điều này bao gồm việc di chuyển. Các bản mod đã di chuyển từ Nhạc Tùy Chỉnh sang SAAT sẽ xóa tất cả các bản nhạc tùy chỉnh khỏi danh sách phát jukebox do yêu cầu ký hiệu tiền tố (cm:) CM. SAAT sẽ xác thực tất cả các bản nhạc trong jukebox và xóa những bản nhạc bị thiếu để ngăn chặn việc này.

Mới trong v1.1.0:
- Thêm Cài đặt Bản âm thanh.
-- Bây giờ bạn có thể thiết lập một mục trong tracks.json để lặp liên tục.
-- Bây giờ bạn có thể thiết lập một mục để tự động thêm vào hộp nhạc khi một trò chơi mới được tạo.
- Lệnh "setdebug" đã được đổi tên thành "audiodebug" vì có khả năng xung đột cao với các bản mod khác.
- Lệnh "gen_track_json" đã được đổi tên thành "tracktemplate".
- Lệnh "audio_allocs" đã được đổi tên thành "audioallocs".
- Lệnh audioallocs đã có một số sửa lỗi định dạng.
- Lệnh audioallocs hiện có tham số tùy chọn. Việc thêm ID track sẽ cung cấp thêm thông tin chi tiết cho một track cụ thể.
- Một số tái cấu trúc nội bộ đã được thực hiện.
- Cập nhật tài liệu.

Chức năng hiện tại:
Cho phép thêm nhạc và hiệu ứng âm thanh hoàn toàn mới vào Stardew Valley
Cho phép thêm nhạc vào máy hát tự động.

Chưa triển khai / Các tính năng sắp ra mắt:

Thay thế / Ghi đè bản âm thanh
Một cá nhân có thể thay thế các bản âm thanh hiện có bằng một bản khác, ghi đè lên các tài sản gốc theo cách không thể phá hủy.

Xử lý tín hiệu âm thanh (APS hoặc DPS)

Tính năng sắp ra mắt cho phép âm thanh trải qua các hiệu ứng thông thấp, thông cao, thay đổi cao độ, v.v. mà không cần phải tạo một bản nhạc khác.

Quản lý bộ nhớ hợp lý

Đây sẽ là tính năng chính của API. Hiện tại, Stardew Valley dựa vào XNA/MonoGame để xử lý việc quản lý bộ nhớ cho âm thanh. Việc quản lý bộ nhớ được thiết kế kém, vì nó tải tất cả hoặc không tải gì cả. Thông thường, âm thanh được chia nhỏ vào bộ nhớ thay vì lưu trữ tất cả cùng một lúc. Điều này dẫn đến việc tiêu thụ bộ nhớ rất lớn.

Ví dụ, các bản nhạc mùa đông được tải vào bộ nhớ khi bắt đầu trò chơi. Ngay cả khi đó là mùa xuân. Bạn sẽ không nghe thấy bản nhạc trong 3/4 thời lượng trò chơi, nhưng nó vẫn chiếm dụng bộ nhớ.

Lưu ý: Tập hợp con API/Mod này sẽ được viết bằng C. Cần phải có ngôn ngữ gốc để đảm bảo hiệu suất.

Định dạng âm thanh đóng gói

Kết hợp với việc quản lý bộ nhớ hợp lý, âm thanh sẽ được nén thành các tệp nhị phân theo từng mod. Điều này cho phép tải/dỡ/tải lại nhanh hơn.

Nó sẽkhông được yêu cầunhưng nó sẽ tối ưu hóa hiệu suất. Đặc biệt đối với các tệp âm thanh lớn hơn.

Bộ công cụ cho định dạng âm thanh đóng gói

Để hỗ trợ và khuyến khích người sáng tạo nội dung tối ưu hóa âm thanh để nâng cao hiệu suất, một công cụ sẽ được cung cấp để tạo định dạng âm thanh đóng gói được đề cập ở trên.

Mã nguồn và Tài liệu