버전

menu_open
Wwise SDK 2023.1.2
오디오 파일 가져오기 및 구조체 생성하기

Wwise Authoring API로 Wwise 오브젝트를 생성하는 방식에는 다양한 방법이 있습니다.

Wwise 오브젝트 생성하기

It is possible to create most Wwise Objects using ak.wwise.core.object.set and ak.wwise.core.object.create. To learn more about the limitations, refer to ak.wwise.core.object.create 사용의 한계점 and Limitations with ak.wwise.core.object.create and ak.wwise.core.object.set.

참고: ak.wwise.core.object.set offers a superset of the functionalities offered in ak.wwise.core.object.create. We recommend using ak.wwise.core.object.set.

Advantages of ak.wwise.core.object.set over ak.wwise.core.object.create :

  • Support for creating and modifying objects
  • Support for batch operations
  • Support for importing audio files

이름 충돌 모드 이해하기

When calling ak.wwise.core.object.create, or ak.wwise.core.object.set, it is possible to specify one of the four name conflict modes.

동일한 이름의 오브젝트가 이미 존재할 경우,

  • fail: The create function returns an error. (default)
  • replace: The object at destination is deleted (including its children), and a new object is created.
  • rename: A new unique name is automatically assigned for the new object, appending numbers to it.
  • merge: The object at destination is re-used, and the specified properties, references and children are merged to the destination leaving untouched the rest of the object.

Understanding lists and list modes

Lists are generic containers for storing objects. The objects in a given list are typically of the same type. Lists provide a convenient mechanism for populating and retrieving objects through WAAPI that are "owned" by another object. For example, the RTPCs for a given object are contained in the "RTPC" list of that object.

When calling ak.wwise.core.object.set, it is possible to specify one of two list modes.

If a list already contains objects:

  • append: Add the new objects to the list if possible, keeping existing objects. Some lists might not permit duplicate equivalent objects: e.g., some properties of RTPCs in the RTPC list are exclusive so there can only be one RTPC with that property.
  • replaceAll: Remove all existing objects and add the new objects, with the duplicate restriction.

For empty lists the behavior is to append.

ak.wwise.core.object.create 사용의 한계점

Sound

ak.wwise.core.object.create 를 이용해 Sound 오브젝트를 생성할 수 있습니다. However, there are significant limitations:

  • It is not possible to associate an original WAV or MIDI file with a child Audio File Source object.
  • It is not possible to associate a language with a child Audio File Source object.

For this reason, we don't recommend using ak.wwise.core.object.create to create Sound objects that use WAV or MIDI files.

Instead, refer to:

Plug-ins

It is not possible to create plug-ins of the type Source, Effect, or Metadata with ak.wwise.core.object.create. Use ak.wwise.core.object.set instead.

Limitations with ak.wwise.core.object.create and ak.wwise.core.object.set

Work Unit

Creating Work Units with ak.wwise.core.object.create and ak.wwise.core.object.set requires the undo/redo history and the clipboard to be cleared. Work Unit는 또한 생성과 함께 저장되기 때문에 프로젝트에 해당 WWU 파일을 효과적으로 생성하게 됩니다.

  • The onNameConflict argument must be either 'fail', 'merge' or 'rename'. The 'replace' mode is not supported.

Query

It is possible to create Query objects with ak.wwise.core.object.create and ak.wwise.core.object.set. However, the criteria objects need to be created with a specific GUID as the name. The name of the criteria must contain the GUID of the SearchOperationID attribute as found in the WWU files. Each criteria type has a unique GUID.

To find the correct GUID to use in the name, you will need to reverse engineer the WWU files:

  • Create a Query object in the Query Editor
  • Add the Criteria you wish from the Criteria Browser
  • Modify the property fields in the Criteria Editor
  • Save the project
  • Open the Work Unit in a text editor
  • Look for SearchOperationID and use it for the SearchCriteria name in ak.wwise.core.object.set.
  • Look for the properties in the WWU file as examples and set them in ak.wwise.core.object.set.

Lists

It is not possible to create objects to populate the "Metadata" and "Clips" lists with ak.wwise.core.object.set.

  • Metadata are plug-ins which cannot be created.
  • Clips require an AudioSourceRef which cannot be specified.

Due to the limitations below we do not recommend creating objects in the "Sequences" and "Stingers" lists with ak.wwise.core.object.set.

  • Without the ability to assign a Segment to a stinger through WAAPI we do not recommend creating a Stinger in the "Stingers" list.
  • Without the ability to create a MusicClip through WAAPI we do not recommend creating a MusicSequence in the "Sequences" list.

Using ak.wwise.core.object.set to import audio files and create a hierarchy of objects

Refer to ak.wwise.core.object.set for more information.

{
"objects": [
{
"object": "\\Actor-Mixer Hierarchy\\Default Work Unit",
"children": [
{
"type": "ActorMixer",
"name": "FootSteps",
"@Volume": "-2",
"children": [
{
"type": "RandomSequenceContainer",
"name": "FootStep_Concrete",
"@RandomOrSequence": "1",
"children": [
{
"type": "Sound",
"name": "FootStep_Concrete_01",
"import":{ "files":[ { "audioFile":"C:\\wave\\cues\\FootStep_Concrete_01.wav" } ],}
},
{
"type": "Sound",
"name": "FootStep_Concrete_02",
"import":{ "files":[ { "audioFile":"C:\\wave\\cues\\FootStep_Concrete_02.wav" } ],}
}
]
}
]
}
]
}
]
}


참고: The object field indicates where to create the object in the project. The object field, like most Wwise object fields, supports object IDs (GUID) and object paths. 오브젝트 ID를 가져오는 방법은 ak.wwise.core.object.get 을 참고하세요. 예를 들어 해당 프로젝트 경로에서 오브젝트 ID를 가져올 수 있습니다.
참고: To retrieve an object ID from a Wwise project, you can hold the Shift key while right-clicking an object, then select Copy GUID(s) to clipboard.

More examples using ak.wwise.core.object.set to import audio files:

오디오 파일 가져오기

Audio files can be imported using the Wwise Authoring API by means of the same import processor available through the Tab Delimited import in the Audio File Importer.

Using the Wwise Authoring API allows complete automation of the import process and provides direct control in the programming language of your choice.

가져올 때 사용할 수 있는 포맷은 매우 다양합니다. 다음의 포맷을 가져올 수 있습니다.

At a glance, the audio file importation allows:

  • 오디오 파일 가져오기 및 현지화
  • Actor-Mixer 계층 구조 생성 자동화
  • Event 생성
  • Volume과 같은 Property Value 할당
  • Output Bus와 같은 참조 할당

더 많은 정보는 https://www.audiokinetic.com/library/edge/?source=Help&id=importing_media_files_from_tab_delimited_text_file를 참고하세요.

참고: ak.wwise.core.audio.importTabDelimited and ak.wwise.core.audio.import are the preferred ways to create Sound objects and import audio files at the same time. We do not recommend using ak.wwise.core.object.create or \ ref ak_wwise_core_object_set because it is currently not possible to associate an audio file and a language to created objects.

예제:

참고: 자신의 프로젝트에 반드시 해당 언어가 존재하는지 확인하고 대문자/소문자가 동일한지 확인합니다.

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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요