Version
menu_open
Wwise SDK 2024.1.4
FirstTimeCreationMessage.h
Go to the documentation of this file.
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) 2025 Audiokinetic Inc.
25 *******************************************************************************/
26 
27 /**
28  * \brief Wwise Authoring Plug-ins - Plug-in that provides a special usage message when first instantiated.
29  * \file AK/Wwise/Plugin/FirstTimeCreationMessage.h
30  */
31 
32 #pragma once
33 
34 #include "PluginInfoGenerator.h"
35 
36 
37 /**
38  * \brief Plug-in that provides a special usage message when first instantiated.
39  */
40 struct ak_wwise_plugin_first_time_creation_message_v1
41 #ifdef __cplusplus
42  : public ak_wwise_plugin_base_interface
43 #endif
44 {
45 #ifndef __cplusplus
46  ak_wwise_plugin_base_interface m_baseInterface;
47 #endif
48 
49 #ifdef __cplusplus
50  /// Base instance type for providing a message shown the first time an instance is created.
51  using Instance = ak_wwise_plugin_first_time_creation_message_instance_v1;
52 
53  ak_wwise_plugin_first_time_creation_message_v1() :
54  ak_wwise_plugin_base_interface(AK_WWISE_PLUGIN_INTERFACE_TYPE_FIRST_TIME_CREATION_MESSAGE, 1)
55  {}
56 #endif
57 
58  /**
59  * \brief Returns a unique key used in the .wproj to indicate whether the licensing message was shown.
60  *
61  * The key should be representative of the plug-in or plug-in family, as well as user readable. Even if a GUID
62  * would be unique, it would not be helpful to the user.
63  *
64  * \param[in] in_this Current instance of this interface.
65  * \return Null-terminated string uniquely representing this plug-in or plug-in family.
66  */
67  const char*(*GetKey)(const struct ak_wwise_plugin_first_time_creation_message_instance_v1* in_this);
68 
69  /**
70  * \brief Returns a unique creation message shown to the user.
71  *
72  * Shown when the plug-in is first created and the key is not present in the .wproj yet.
73  *
74  * \param[in] in_this Current instance of this interface.
75  * \return Null-terminated string containing the text to show to the end user.
76  */
77  const char*(*GetCreationMessage)(const struct ak_wwise_plugin_first_time_creation_message_instance_v1* in_this);
78 };
79 
80 
81 #define AK_WWISE_PLUGIN_FIRST_TIME_CREATION_MESSAGE_V1_ID() \
82  AK_WWISE_PLUGIN_BASE_INTERFACE_FROM_ID(AK_WWISE_PLUGIN_INTERFACE_TYPE_FIRST_TIME_CREATION_MESSAGE, 1)
83 #define AK_WWISE_PLUGIN_FIRST_TIME_CREATION_MESSAGE_V1_CTOR(/* ak_wwise_plugin_info* */ in_pluginInfo, /* void* */ in_data) \
84 { \
85  .m_baseInterface = AK_WWISE_PLUGIN_BASE_INTERFACE_CTOR(AK_WWISE_PLUGIN_FIRST_TIME_CREATION_MESSAGE_V1_ID(), in_pluginInfo, in_data) \
86 }
87 
88 
89 #ifdef __cplusplus
90 namespace AK::Wwise::Plugin
91 {
92  namespace V1
93  {
94  using CFirstTimeCreationMessage = ak_wwise_plugin_first_time_creation_message_v1;
95  class FirstTimeCreationMessage : public CFirstTimeCreationMessage::Instance
96  {
97  public:
98  /**
99  * \copydoc CFirstTimeCreationMessage::Instance
100  */
101  using Instance = CFirstTimeCreationMessage::Instance;
102 
103  /**
104  * \brief The interface type, as provided by this plug-in.
105  */
106  enum : InterfaceTypeValue
107  {
108  /**
109  * \brief The interface type, as provided by this plug-in.
110  */
111  k_interfaceType = AK_WWISE_PLUGIN_INTERFACE_TYPE_FIRST_TIME_CREATION_MESSAGE
112  };
113  /**
114  * \brief The interface version, as provided by this plug-in.
115  */
116  enum : InterfaceVersion
117  {
118  /**
119  * \brief The interface version, as provided by this plug-in.
120  */
121  k_interfaceVersion = 1
122  };
123 
124  /**
125  * \brief The C interface, fulfilled by your plug-in.
126  */
127  struct Interface : public CFirstTimeCreationMessage
128  {
129  using Instance = FirstTimeCreationMessage;
130  Interface()
131  {
132  CFirstTimeCreationMessage::GetKey = [](const struct ak_wwise_plugin_first_time_creation_message_instance_v1* in_this) { return static_cast<const Instance*>(in_this)->GetKey(); };
133  CFirstTimeCreationMessage::GetCreationMessage = [](const struct ak_wwise_plugin_first_time_creation_message_instance_v1* in_this) { return static_cast<const Instance*>(in_this)->GetCreationMessage(); };
134  }
135  };
136 
137  InterfacePtr GetInterfacePointer() {
138  static Interface g_interface;
139  return &g_interface;
140  }
141  CFirstTimeCreationMessage::Instance* GetInstancePointer() {
142  return this;
143  }
144  const CFirstTimeCreationMessage::Instance* GetInstancePointer() const {
145  return this;
146  }
147 
148  FirstTimeCreationMessage() :
149  CFirstTimeCreationMessage::Instance()
150  {
151  }
152 
153  virtual ~FirstTimeCreationMessage() {}
154 
155  /**
156  * \brief Returns a unique key used in the .wproj to indicate whether the licensing message was shown.
157  *
158  * The key should be representative of the plug-in or plug-in family, as well as user readable. Even if a GUID
159  * would be unique, it would not be helpful to the user.
160  *
161  * \return Null-terminated string uniquely representing this plug-in or plug-in family.
162  */
163  virtual const char* GetKey() const = 0;
164 
165  /**
166  * \brief Returns a unique creation message shown to the user.
167  *
168  * Shown when the plug-in is first created and the key is not present in the .wproj yet.
169  *
170  * \return Null-terminated string containing the text to show to the end user.
171  */
172  virtual const char* GetCreationMessage() const = 0;
173  };
174  } // of namespace V1
175 
176  /// Latest version of the C FirstTimeCreationMessage interface.
177  using CFirstTimeCreationMessage = V1::CFirstTimeCreationMessage;
178  /// Latest version of the C++ FirstTimeCreationMessage interface.
179  using FirstTimeCreationMessage = V1::FirstTimeCreationMessage;
180 
181  AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS(FirstTimeCreationMessage);
182  AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(FirstTimeCreationMessage);
183 } // of namespace AK::Wwise::Plugin
184 
185 #endif
AK.Wwise::Plugin::FirstTimeCreationMessage
V1::FirstTimeCreationMessage FirstTimeCreationMessage
Latest version of the C++ FirstTimeCreationMessage interface.
Definition: FirstTimeCreationMessage.h:179
ak_wwise_plugin_first_time_creation_message_v1::GetCreationMessage
const char *(* GetCreationMessage)(const struct ak_wwise_plugin_first_time_creation_message_instance_v1 *in_this)
Returns a unique creation message shown to the user.
Definition: FirstTimeCreationMessage.h:77
ak_wwise_plugin_first_time_creation_message_v1::GetKey
const char *(* GetKey)(const struct ak_wwise_plugin_first_time_creation_message_instance_v1 *in_this)
Returns a unique key used in the .wproj to indicate whether the licensing message was shown.
Definition: FirstTimeCreationMessage.h:67
AK.Wwise::Plugin::V1::FirstTimeCreationMessage::k_interfaceType
@ k_interfaceType
The interface type, as provided by this plug-in.
Definition: FirstTimeCreationMessage.h:111
AK.Wwise::Plugin::InterfaceVersion
decltype(BaseInterface::m_version) InterfaceVersion
PluginInfoGenerator: Type for the m_version value in BaseInterface.
Definition: PluginInfoGenerator.h:50
ak_wwise_plugin_first_time_creation_message_instance_v1
Base instance type for providing a message shown the first time an instance is created through ak_wwi...
Definition: PluginDef.h:925
ak_wwise_plugin_first_time_creation_message_v1
Plug-in that provides a special usage message when first instantiated.
Definition: FirstTimeCreationMessage.h:44
PluginInfoGenerator.h
Wwise Authoring Plug-ins - C++ class helper to automatically determine the plug-in interfaces used in...
AK.Wwise::Plugin::V1::CFirstTimeCreationMessage
ak_wwise_plugin_first_time_creation_message_v1 CFirstTimeCreationMessage
Definition: FirstTimeCreationMessage.h:94
AK.Wwise::Plugin::InterfacePtr
CInterfacePtr InterfacePtr
Definition: PluginDef.h:1057
AK.Wwise::Plugin::V1::FirstTimeCreationMessage::GetInstancePointer
CFirstTimeCreationMessage::Instance * GetInstancePointer()
Definition: FirstTimeCreationMessage.h:141
AK.Wwise::Plugin::V1::FirstTimeCreationMessage::GetKey
virtual const char * GetKey() const =0
Returns a unique key used in the .wproj to indicate whether the licensing message was shown.
AK.Wwise::Plugin::InterfaceTypeValue
std::underlying_type< InterfaceType >::type InterfaceTypeValue
PluginInfoGenerator: Underlying storage type for the m_interface value in BaseInterface.
Definition: PluginInfoGenerator.h:49
AK_WWISE_PLUGIN_INTERFACE_TYPE_FIRST_TIME_CREATION_MESSAGE
@ AK_WWISE_PLUGIN_INTERFACE_TYPE_FIRST_TIME_CREATION_MESSAGE
2021.1 First Time Creation Message plug-in. ak_wwise_plugin_first_time_creation_message_v1
Definition: PluginBaseInterface.h:60
AK.Wwise::Plugin::AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION
AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_VERSION(AudioPlugin)
ak_wwise_plugin_base_interface
Interface description and base class for every Wwise Authoring plug-in interface.
Definition: PluginBaseInterface.h:120
ak_wwise_plugin_first_time_creation_message_v1::ak_wwise_plugin_first_time_creation_message_v1
ak_wwise_plugin_first_time_creation_message_v1()
Definition: FirstTimeCreationMessage.h:53
AK.Wwise::Plugin::V1::FirstTimeCreationMessage::GetInstancePointer
const CFirstTimeCreationMessage::Instance * GetInstancePointer() const
Definition: FirstTimeCreationMessage.h:144
AK.Wwise::Plugin::V1::FirstTimeCreationMessage::k_interfaceVersion
@ k_interfaceVersion
The interface version, as provided by this plug-in.
Definition: FirstTimeCreationMessage.h:121
AK.Wwise::Plugin::V1::FirstTimeCreationMessage::GetCreationMessage
virtual const char * GetCreationMessage() const =0
Returns a unique creation message shown to the user.
ak_wwise_plugin_first_time_creation_message_v1::Instance
ak_wwise_plugin_first_time_creation_message_instance_v1 Instance
Base instance type for providing a message shown the first time an instance is created.
Definition: FirstTimeCreationMessage.h:51
AK.Wwise::Plugin::AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS
AK_WWISE_PLUGIN_SPECIALIZE_INTERFACE_CLASS(AudioPlugin)

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise