バージョン

    その他のドキュメント

menu_open
Wwise SDK 2023.1.2
Wwise プラグインID

Wwise プラグインは、Company ID ならびに Plug-in IDで認識されます。これらのIDはplugin.xmlファイルで定義されます。

  • Company ID: 特定のCompanyを識別するために使います。
    • attribute CompanyID on tags EffectPlugin, SourcePlugin, ConversionPlugin.
    • 12-bit unsigned integer、範囲は0-4095。
    • 0-63は、Audiokinetic用に予約されます。
    • 64-255は、社内プラグイン開発に使えます。
    • 256-4095は、Audiokineticがプラグインプログラマーにアサインします。
  • Plug-in ID: 指定のCompany ID用の特定のプラグインを識別するために使います。
    • attribute PluginID on tags EffectPlugin, SourcePlugin, ConversionPlugin.
    • 16-bit unsigned integer、範囲は0-32767。
    • プラグインプログラマーが任意で設定します
注釈: Company IDとPlug-in IDの組み合わせは、必ず固有のものとします。

Wwise とサウンドエンジン内では、Company ID ならびに Plug-in ID は4ビットプラグイン値を組み合わせ、32ビットの一意の認識子を形成します。プラグインタイプ値は、AkPluginType enum (IAkEffect.h) が次のように定義されます:

  • AkPluginTypeNone = 0、Audiokineticが内部的に使用
  • AkPluginTypeCodec = 1、変換プラグイン
  • AkPluginTypeSource = 2、ソースプラグイン
  • AkPluginTypeEffect = 3、エフェクトプラグイン
  • Audiokinetic Company ID ならびに Plug-in ID
注釈: 4ビットは、IDが異なっていることを「助ける」訳ではありません: WwiseのPlug-in Manager は、プラグインの種類に関係なく、重複した Company ID ならびに Plug-in ID の組み合わせがないように管理します。

Packed 32-bit Class ID (圧縮された 32ビット クラス ID) は次のような組み合わせになっています: Plug-in ID + Company ID + Plug-in Type == Packed 32-bit Class ID. よって Plug-in ID が 1、Company ID が 0、Plug-in Type が 1の場合、Packed 32-bit Class ID は 0x00010001となります。

注釈: Audiokineticのプラグイン (Conversion, Source, and Effect plug-ins) に使用された Company IDは0で、 AKCOMPANYID_AUDIOKINETIC で、 AkTypes.h に定義されています。

以下は、架空のエフェクトプラグインの例です:

  • Company ID: 72
  • Plugin ID: 5

XML:

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (C) 2020 Audiokinetic Inc. -->
<PluginModule>
<EffectPlugin Name="FictionalDelay" CompanyID="72" PluginID="5">
...

Plugin Factory:

...
AK_IMPLEMENT_PLUGIN_FACTORY(FictionalDelayFX, AkPluginTypeEffect, 72, 5)
...
@ AkPluginTypeEffect
Effect plug-in: applies processing to audio data.
Definition: AkTypes.h:1253

このページはお役に立ちましたか?

サポートは必要ですか?

ご質問や問題、ご不明点はございますか?お気軽にお問い合わせください。

サポートページをご確認ください

あなたのプロジェクトについて教えてください。ご不明な点はありませんか。

プロジェクトを登録していただくことで、ご利用開始のサポートをいたします。

Wwiseからはじめよう