Load Atom Cue Sheet
Identifier
LoadAtomCueSheet
Description
指定Atom Cue Sheet对象参照并加载ACB数据(启用Atom Cue Sheet对象)。
Atom Cue Sheet Asset在音频播放开始时自动加载,但也可以使用本函数显式加载。
用本函数加载的Atom Cue Sheet在离开持续关卡时自动释放。
作为例外,符合以下情况时,即使离开持续关卡也不释放Atom Cue Sheet。
・应用程序将函数的返回值以UPROPERTY形式保存。
・启用Persist Across Level Transition,并用UAtomStatics::SpawnSound2D 播放Cue Sheet中包含的Cue时。

例如,您可以通过以下方式控制USoundAtomCueSheet对象的生命周期: ・(1) 调用本函数时,将参数[Add to Level]指定为false ・(2) 应用程序将本函数返回的 Atom Cue Sheet 以UPROPERTY形式保存 ・(3) 在任意时间释放本函数返回的 Atom Cue Sheet

注意: 本函数是异步函数。成功调用此函数时,将返回USoundAtomCueSheet指针。 调用此函数后,USoundAtomCueSheet指针所指向的对象不会立即持有有效的ACB句柄。 当内部完成加载ACB数据时,将为ACB句柄设置有效值,并且可以引用Cue。 USoundAtomCueSheet提供OnLoadCompleted委托来检测应用程序何时完成ACB数据加载。 也可以通过调用 USoundAtomCueSheet::IsLoaded() 函数来确认加载完成。

Target is Sound Atom Cue Sheet

nd_img_SoundAtomCueSheet_LoadAtomCueSheet.png
Inputs
Arg Description
In
Exec
Cue Sheet
Sound Atom Cue Sheet Object Reference
指定要加载的Atom Cue Sheet Asset。
Add to Level
Boolean
指定是否将Cue Sheet关联至持续关卡。
Outputs
Arg Description
Out
Exec
Return Value
Sound Atom Cue Sheet Object Reference
返回USoundAtomCueSheet对象的参照。