버전
menu

Wwise SDK 2025.1.2
AkCmd_ControlEventStreamCache 구조체 참조

#include <AkCommandTypes.h>

Public 속성

AkUniqueID eventID
 ID of event. Stream caching state will be updated for all streaming files referenced by this event. 더 자세히 ...
 
AkUInt8 isCached
 Activate or de-activate stream caching. When false, any cache buffers previously associated with the event are released. 더 자세히 ...
 
AkPriority activePriority
 Priority of active stream caching I/O 더 자세히 ...
 
AkPriority inactivePriority
 Priority of inactive stream caching I/O 더 자세히 ...
 

상세한 설명

Allows streaming the first part of all streamed files referenced by an Event into a cache buffer.

Caching streams are serviced when no other streams require the available bandwidth. The files will remain cached until a command disables caching, or a higher priority pinned file needs the space and the limit set by uMaxCachePinnedBytes is exceeded.

Remarks
The amount of data from the start of the file that will be pinned to cache is determined by the prefetch size. The prefetch size is set via the authoring tool and stored in the sound banks.
It is possible to override the prefetch size stored in the sound bank via the low level IO. For more information see AK::StreamMgr::IAkLowLevelIOHook::BatchOpen() and AkFileSystemFlags.
If this function is called additional times with the same event, then the priority of the caching streams are updated. Note however that priority is passed down to the stream manager on a file-by-file basis, and if another event is pinned to cache that references the same file but with a different priority, then the first priority will be updated with the most recent value.
If the event references files that are chosen based on a State Group (via a switch container), all files in all states will be cached. Those in the current active state will get cached with active priority, while all other files will get cached with inactive priority.
inactivePriority is only relevant for events that reference switch containers that are assigned to State Groups. This parameter is ignored for all other events, including events that only reference switch containers that are assigned to Switch Groups. Files that are chosen based on a Switch Group have a different switch value per game object, and are all effectively considered active by the pin-to-cache system.

This command can fail for the following reasons:

  • AK_InvalidParameter if eventID is invalid
  • AK_IDNotFound if eventID refers to an unknown event
참고

AkCommandTypes.h 파일의 1249 번째 라인에서 정의되었습니다.


이 페이지가 도움이 되었나요?

지원이 필요하신가요?

질문이 있으신가요? 문제를 겪고 계신가요? 더 많은 정보가 필요하신가요? 저희에게 문의해주시면 도와드리겠습니다!

지원 페이지를 방문해 주세요

작업하는 프로젝트에 대해 알려주세요. 언제든지 도와드릴 준비가 되어 있습니다.

프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.

Wwise를 시작해 보세요