|
Wwise SDK 2023.1.8
|
此页面将详细介绍 Windows 图形用户界面 (GUI) 实现的各种元素。
 | 备注: 在 macOS 上，可通过基于开源工程 Wine 的 Crossover 桥接层运行 Wwise 设计工具。 通过为 Windows 创建 GUI 实现，可利用该解决方案在 macOS 上运行这一实现。 |
基类 AK::Wwise::Plugin::GUIWindows 可提供相应的实现方法，以便 Wwise 将特定类型的对话框实例化，并将控件与插件的属性绑定。同时还可提供标准 Win32 窗口程序 (WindowProc)，来允许插件对基于插件视图实例的 Windows 事件作出响应。
Wwise 设计工具采用以下方式将插件 GUI 实例化：
- Wwise 通过调用
AK::Wwise::Plugin::GUIWindows::GetDialog()，请求插件将某种类型的对话框实例化（参见 获取对话框 章节）。 - 若插件的前端支持对话框类型，则插件返回与类型对应的资源对话框 ID 及可选的属性绑定列表，来将控件 ID 和属性集中的属性键之间的对应关系（由插件 XML 定义，详见 Wwise 插件 XML 描述文件 章节）告知 Wwise。
- Wwise 使用插件所提供的资源句柄将对话框实例化（参见 资源句柄 章节）。
- Windows 通过事件（如 WM_INITDIALOG）调用 WindowProc。
以下章节阐述了如何实现各种方法。
使用 MFC
在 Windows 上，通过 Microsoft Foundation Classes (MFC) 构建 Wwise Authoring GUI。 若选择将 MFC 用于插件，则需初始化相应的库。 该库通过服务 AK::Wwise::Plugin::PluginMFCWindows 提供。务必将它作为第一个基类以确保最先对其进行初始化。
| 备注: 不要在插件的后端部分从此基类获取其他类，因为其应当不需要 MFC 或其他任何与 GUI 相关的库。 |
资源句柄
资源句柄的类型为 HINSTANCE，其与保存 .rc 文件所编译资源数据的动态库对应。它可以使用 Microsoft Visual Studio 创建，并保存自定义对话框及其内容。 如需进一步了解资源文件，请参阅 the Microsoft 文档中有关如何创建资源文件的章节。
默认实现通过 MSVC 链接器所注入的 builtin 提供模块实例。
除非其他模块拥有对话框资源，否则不需要实现此函数。
若要创建资源文件 (.rc)，请参阅 Creating Resource Files for Your Plug-in 章节。
获取对话框
Wwise 目前在 AK::Wwise::Plugin::eDialog 中定义有两种对话框类型：
SettingsDialog：Source Editor 或 Effect Editor 所用的主插件对话框ContentsEditorDialog：源插件所用的小对话框（仅 Contents Editor 中）
随后会使用给定的 资源句柄 将返给 Wwise 的对话框实例化。 若要将属性与对话框的控件绑定，可使用列表将控件 ID 映射至插件 XML 定义中的属性名称。该列表使用以下宏创建：
在本例中，列表将控件 IDC_MYPROPERTY_EDIT（来自与 .rc 文件配套的 resource.h 文件）映射到了属性 MyProperty。该 ID 必须与插件 XML 定义中的属性对应。
藉此，可将变量 PropertyTable 实例化，进而在 GetDialog() 时转发给 Wwise 设计工具：
若在此函数中返回 false，则将默认对话框而非自定义对话框实例化。
如需详细了解插件中都可使用哪些控件以及如何将其与属性绑定， 请参阅 Wwise 插件对话框参考文档 章节。
通过 WindowProc 处理 Windows 事件
您可以通过解析 AK::Wwise::Plugin::GUIWindows::WindowProc() 函数中接收的窗口消息，来针对 UI 更改执行特定的操作（比如启用或禁用控件）。
显示插件的帮助
在 Wwise 用户单击插件对话框标题栏中的 ? 图标时，将在插件的前端调用 AK::Wwise::Plugin::GUIWindows::Help() 。您可以使用包括 HTMLHelp、WinHelp 或第三方帮助浏览器等各种工具来提供帮助。此函数用于接收窗口句柄，此句柄可以用作您要显示的任何窗口的父类。 AK::Wwise::Plugin::eDialog 参数可以让您选择具体的帮助主题，来匹配 音频设计师当前打开的对话框。如果您已处理帮助请求，此函数则必须返回 true，否则返回 false，在后一种情况下，Wwise 将显示与 Plug-in Manager 相关的帮助主题。
| 备注: 如前所述，源插件具有两个对话框。 如果源插件两个对话框的帮助主题不同，则应使用 AK::Wwise::Plugin::eDialog 参数。 |
以下示例展示了使用 HTML 帮助的源插件，其中由 MFC 提供文件的路径：
 | 注意: AK::Wwise::Plugin::GUIWindows::Help() 方法不应调用 AfxGetApp()->HtmlHelp()。 它将从错误的父窗口中启动帮助窗口，导致悬浮窗口行为异常。 应使用带 Null 窗口语柄的 HtmlHelp() ，如上文示例中所示。 |