버전
menu_open
link
Wwise SDK 2023.1.2
AkDynamicDialogue.h
이 파일의 문서화 페이지로 가기
1 /*******************************************************************************
2 The content of this file includes portions of the AUDIOKINETIC Wwise Technology
3 released in source code form as part of the SDK installer package.
4 
5 Commercial License Usage
6 
7 Licensees holding valid commercial licenses to the AUDIOKINETIC Wwise Technology
8 may use this file in accordance with the end user license agreement provided
9 with the software or, alternatively, in accordance with the terms contained in a
10 written agreement between you and Audiokinetic Inc.
11 
12 Apache License Usage
13 
14 Alternatively, this file may be used under the Apache License, Version 2.0 (the
15 "Apache License"); you may not use this file except in compliance with the
16 Apache License. You may obtain a copy of the Apache License at
17 http://www.apache.org/licenses/LICENSE-2.0.
18 
19 Unless required by applicable law or agreed to in writing, software distributed
20 under the Apache License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
21 OR CONDITIONS OF ANY KIND, either express or implied. See the Apache License for
22 the specific language governing permissions and limitations under the License.
23 
24  Copyright (c) 2024 Audiokinetic Inc.
25 *******************************************************************************/
26 
27 #ifndef _AK_SOUNDENGINE_AKDYNAMICDIALOGUE_H
28 #define _AK_SOUNDENGINE_AKDYNAMICDIALOGUE_H
29 
31 
32 /// Callback prototype used with dialogue event resolution. This function is called
33 /// for every candidate in a ResolveDialogueEvent execution.
34 /// \return true to accept candidate, false to reject.
35 /// \sa
36 /// - AK::SoundEngine::DynamicDialogue::ResolveDialogueEvent()
38  AkUniqueID in_idEvent,
39  AkUniqueID in_idCandidate,
40  void* in_cookie
41  );
42 
43 namespace AK
44 {
45  namespace SoundEngine
46  {
47  /// Dynamic Dialogue namespace
48  /// \remarks The functions in this namespace are thread-safe, unless stated otherwise.
49  namespace DynamicDialogue
50  {
51  /// Resolve a dialogue event into an audio node ID based on the specified argument path.
52  /// \return Unique ID of audio node, or AK_INVALID_UNIQUE_ID if no audio node is defined for specified argument path
54  AkUniqueID in_eventID, ///< Unique ID of dialogue event
55  AkArgumentValueID* in_aArgumentValues, ///< Argument path, as array of argument value IDs. AK_FALLBACK_ARGUMENTVALUE_ID indicates a fallback argument value
56  AkUInt32 in_uNumArguments, ///< Number of argument value IDs in in_aArgumentValues
57  AkPlayingID in_idSequence = AK_INVALID_PLAYING_ID, ///< Optional sequence ID in which the token will be inserted (for profiling purposes)
58  AkCandidateCallbackFunc in_candidateCallbackFunc = NULL, ///< Optional callback for candidate validation based on custom criteria
59  void* in_pCookie = NULL ///< Callback cookie (reserved to user, passed to the callback function)
60  );
61 
62 #ifdef AK_SUPPORT_WCHAR
63  /// Resolve a dialogue event into an audio node ID based on the specified argument path.
64  /// \return Unique ID of audio node, or AK_INVALID_UNIQUE_ID if no audio node is defined for specified argument path
66  const wchar_t* in_pszEventName, ///< Name of dialogue event
67  const wchar_t** in_aArgumentValueNames, ///< Argument path, as array of argument value names. L"" indicates a fallback argument value
68  AkUInt32 in_uNumArguments, ///< Number of argument value names in in_aArgumentValueNames
69  AkPlayingID in_idSequence = AK_INVALID_PLAYING_ID, ///< Optional sequence ID in which the token will be inserted (for profiling purposes)
70  AkCandidateCallbackFunc in_candidateCallbackFunc = NULL, ///< Optional callback for candidate validation based on custom criteria
71  void* in_pCookie = NULL ///< Callback cookie (reserved to user, passed to the callback function)
72  );
73 #endif //AK_SUPPORT_WCHAR
74 
75  /// Resolve a dialogue event into an audio node ID based on the specified argument path.
76  /// \return Unique ID of audio node, or AK_INVALID_UNIQUE_ID if no audio node is defined for specified argument path
78  const char* in_pszEventName, ///< Name of dialogue event
79  const char** in_aArgumentValueNames, ///< Argument path, as array of argument value names. "" indicates a fallback argument value
80  AkUInt32 in_uNumArguments, ///< Number of argument value names in in_aArgumentValueNames
81  AkPlayingID in_idSequence = AK_INVALID_PLAYING_ID, ///< Optional sequence ID in which the token will be inserted (for profiling purposes)
82  AkCandidateCallbackFunc in_candidateCallbackFunc = NULL, ///< Optional callback for candidate validation based on custom criteria
83  void* in_pCookie = NULL ///< Callback cookie (reserved to user, passed to the callback function)
84  );
85 
86  /// Get the value of a custom property of integer or boolean type.
87  /// \return
88  /// - AK_Success if the value is found
89  /// - AK_PartialSuccess if the event was found but no matching custom property was found on this object. Note that it could mean this value is the default value.
90  /// - AK_IDNotFound if the EventID is unknown (not loaded or typo in the id)
92  AkUniqueID in_eventID, ///< Unique ID of dialogue event
93  AkUInt32 in_uPropID, ///< Property ID of your custom property found under the Custom Properties tab of the Wwise project settings.
94  AkInt32& out_iValue ///< Property Value
95  );
96 
97  /// Get the value of a custom property of real type.
98  /// \return
99  /// - AK_Success if the value is found
100  /// - AK_PartialSuccess if the event was found but no matching custom property was found on this object. Note that it could mean this value is the default value.
101  /// - AK_IDNotFound if the EventID is unknown (not loaded or typo in the id)
103  AkUniqueID in_eventID, ///< Unique ID of dialogue event
104  AkUInt32 in_uPropID, ///< Property ID of your custom property found under the Custom Properties tab of the Wwise project settings.
105  AkReal32& out_fValue ///< Property Value
106  );
107  }
108  }
109 }
110 
111 #endif // _AK_SOUNDENGINE_AKDYNAMICDIALOGUE_H
AKSOUNDENGINE_API AkUniqueID ResolveDialogueEvent(AkUniqueID in_eventID, AkArgumentValueID *in_aArgumentValues, AkUInt32 in_uNumArguments, AkPlayingID in_idSequence=AK_INVALID_PLAYING_ID, AkCandidateCallbackFunc in_candidateCallbackFunc=NULL, void *in_pCookie=NULL)
Audiokinetic namespace
#define AK_EXTERNAPIFUNC(_type, _name)
AKRESULT
Standard function call result.
Definition: AkTypes.h:213
AkUInt32 AkArgumentValueID
Argument value ID
Definition: AkTypes.h:162
#define NULL
Definition: AkTypes.h:46
float AkReal32
32-bit floating point
int32_t AkInt32
Signed 32-bit integer
AKSOUNDENGINE_API AKRESULT GetDialogueEventCustomPropertyValue(AkUniqueID in_eventID, AkUInt32 in_uPropID, AkInt32 &out_iValue)
AkUInt32 AkUniqueID
Unique 32-bit ID
Definition: AkTypes.h:134
#define AK_CALLBACK(_type, _name)
static const AkPlayingID AK_INVALID_PLAYING_ID
Invalid playing ID
Definition: AkTypes.h:179
uint32_t AkUInt32
Unsigned 32-bit integer
bool(* AkCandidateCallbackFunc)(AkUniqueID in_idEvent, AkUniqueID in_idCandidate, void *in_cookie)
AkUInt32 AkPlayingID
Playing ID
Definition: AkTypes.h:137

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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요