Wwise SDK 2024.1.4

リモート・プロシージャの呼び出し

Wwise Authoring API は、AK::Wwise::Plugin::Host::WaapiCall() メソッドを使用して、Wwiseプラグインからリモート・プロシージャ・コールを発行するために使用できます。このメソッドはHostコンポーネントによって提供され、 AK::Wwise::Plugin::RequestHost から継承することでこれをリクエストできます。

info 注釈: AK::Wwise::Plugin::Host::WaapiCall()メソッドへの呼び出しは常にブロックされます。

ユーティリティクラスが提供されていますので、呼び出し側がメモリ割り当ての方策を提供できるようになります。AK::Wwise::Mallocator は、 malloc 、 free 、 realloc などCライブラリの関数を使ったデフォルトの実装を提供します。 AK::IAkPluginMemAlloc を実装するクラスを定義することで、カスタムストラテジーを簡単に提供できます。最後に、タイプセーフと自動メモリ管理を確かにするために、ラッパークラスAK::Wwise::SafeAllocatorを使用します。

例：

#include <AK/Tools/Common/AkAllocator.h>
#include <rapidjson/document.h>
 
// Use the default allocation strategy for results and errors
AK::Wwise::Mallocator alloc;
 
AK::Wwise::SafeAllocator<char> szResults(&alloc);
AK::Wwise::SafeAllocator<char> szError(&alloc);
 
// Issue a remote procedure call to the Wwise Authoring API
m_host.WaapiCall("ak.wwise.core.getInfo", NULL, NULL, alloc, szResults, szError);
if (!szError)
{
    // Parse the results JSON string
    rapidjson::Document results;
    results.Parse(szResults);
 
    // ...
}

#include <AK/Tools/Common/AkAllocator.h>
#include <rapidjson/document.h>
#include <rapidjson/stringbuffer.h>
#include <rapidjson/writer.h>
 
// Use the default allocation strategy for results and errors
AK::Wwise::Mallocator alloc;
 
AK::Wwise::SafeAllocator<char> szResults(&alloc);
AK::Wwise::SafeAllocator<char> szError(&alloc);
 
// Build a JSON object that contains the procedure's parameters
rapidjson::Document args;
args.SetObject();
args.AddMember("classId", 8192003, args.GetAllocator());
args.AddMember("property", "ModDepth", args.GetAllocator());
 
// Stringify the JSON object
rapidjson::StringBuffer buffer;
rapidjson::Writer<rapidjson::StringBuffer> writer(buffer);
args.Accept(writer);
 
// Issue a remote procedure call to the Wwise Authoring API
m_host.WaapiCall("ak.wwise.core.plugin.getProperty", buffer.GetString(), NULL, alloc, szResults, szError);
if (!szError)
{
    // Parse the results JSON string
    rapidjson::Document results;
    results.Parse(szResults);
 
    // ...
}