SAAT - 오디오 API 및 도구 키트

HarmonyLib을 활용하지 않고도 SMAPI를 위한 오디오 API 및 오디오 관리를 제공합니다.
모드에 사용자 정의 음악을 추가하세요!

이 모드는 무슨 역할을 하나요?

SAAT는 스타듀 밸리에서 오디오 트랙을 추가, 관리 및 수정하는 프레임워크입니다. 또한, XNA/MonoGame의 오디오 엔진이 메모리 관리 및 지원 측면에서 미흡하기 때문에 향후 오디오 엔진을 개선하고자 합니다. SAAT는 조화로움을 추구하는 프레임워크입니다.

사용자 정의 오디오 트랙을 추가하는 방법의 예를 볼 수 있습니다.Github의 문서


v1.1.2의 새로운 기능:
- "이름이 'title_day'인 CueDefinition을 찾을 수 없습니다."라는 경고 메시지가 발생하는 버그를 수정했습니다.

v1.1.1의 새로운 기능:
- 큐를 잘못 호출하거나 큐를 찾을 수 없을 때 게임이 충돌하는 것을 방지하는 안전 장치입니다.
-- 실패 시, "기본 큐"가 재생됩니다. 이 큐는 무음을 재생합니다.
- 주크박스에 오디오 트랙을 강제로 추가하는 기능입니다. "addtojukebox" 명령을 참조하세요.
-- 이는 마이그레이션에 대한 내용입니다. Custom Music에서 SAAT로 마이그레이션한 모드는 CM에 필요한 접두사(cm:) 표기법으로 인해 주크박스 플레이리스트에서 모든 커스텀 트랙이 제거됩니다. SAAT는 주크박스의 모든 트랙을 검증하고, 누락된 트랙을 제거하여 이러한 문제를 방지합니다.

v1.1.0의 새로운 기능:
- 오디오 트랙 설정을 추가합니다.
-- 이제 tracks.json에 항목을 설정하여 계속 반복할 수 있습니다.
-- 이제 새로운 게임이 생성되면 항목이 주크박스에 즉시 추가되도록 설정할 수 있습니다.
- "setdebug" 명령어는 다른 모드와 충돌할 가능성이 높으므로 "audiodebug"로 이름이 변경되었습니다.
- 명령 "gen_track_json"이 "tracktemplate"으로 이름이 바뀌었습니다.
- 명령 "audio_allocs"가 "audioallocs"로 이름이 바뀌었습니다.
- audioallocs 명령어의 일부 서식이 수정되었습니다.
- audioallocs 명령에 이제 선택적 매개변수가 추가되었습니다. 트랙 ID를 추가하면 특정 트랙에 대한 자세한 정보를 얻을 수 있습니다.
- 일부 내부 구조 조정이 이루어졌습니다.
- 문서 업데이트.

현재 기능:
Stardew Valley에 새로운 음악과 사운드 효과를 추가할 수 있습니다.
주크박스에 음악을 추가할 수 있습니다.

아직 구현되지 않음 / 곧 출시될 기능:

오디오 트랙 교체/재정의
개인은 기존 오디오 트랙을 다른 오디오 트랙으로 교체하여 파괴 불가능한 방식으로 바닐라 에셋을 재정의할 수 있습니다.

오디오 신호 처리(APS 또는 DPS)

새로운 트랙을 만들지 않고도 오디오에 저역통과, 고역통과, 피치 변경, 효과 등을 적용할 수 있는 기능이 곧 출시됩니다.

적절한 메모리 관리

이것이 API의 핵심 기능이 될 것입니다. 현재 Stardew Valley는 XNA/MonoGame을 사용하여 오디오 메모리 관리를 처리합니다. 이 메모리 관리 방식은 모든 것을 로드하거나 아무것도 로드하지 않기 때문에 설계상 좋지 않습니다. 일반적으로 오디오는 한꺼번에 모두 로드하는 대신 메모리에 덩어리로 저장됩니다. 이로 인해 메모리 사용량이 매우 증가합니다.

예를 들어, 겨울 음악 트랙은 게임 시작 시 메모리에 로드됩니다. 설령 봄이라 하더라도, 게임 플레이 시간의 3/4 동안은 오디오 트랙이 들리지 않지만, 여전히 메모리를 소모하고 있습니다.

참고: API/Mod의 하위 집합은 C로 작성됩니다. 성능을 보장하려면 네이티브가 필요합니다.

압축 오디오 포맷

적절한 메모리 관리와 함께, 오디오는 각 모드별로 바이너리 파일로 압축됩니다. 이를 통해 로드/언로드/리로드 작업이 더욱 빨라집니다.

그것은 할 것이다필요하지 않다하지만 성능이 최적화됩니다. 특히 대용량 오디오 파일의 경우 더욱 그렇습니다.

압축 오디오 포맷을 위한 툴킷

콘텐츠 제작자가 성능을 위해 오디오를 최적화하도록 돕고 장려하기 위해 위에 언급된 압축 오디오 형식을 만드는 도구가 제공됩니다.

소스 코드 및 문서