Wwise SDK 2021.1.14

원격 프로시저 호출하기

The Wwise Authoring API can be used to issue remote procedure calls from within a Wwise plug-in using the AK::Wwise::Plugin::Host::WaapiCall() method. This method is provided by the Host component, which you can request by inheriting from AK::Wwise::Plugin::RequestHost.

info 참고: Calls to the AK::Wwise::Plugin::Host::WaapiCall() method are always blocking.

호출자가 메모리 할당 전략을 수립할 수 있게 유틸리티 클래스가 제공됩니다. AK::Wwise::Mallocator offers a default implementation using functions from the C library, such as malloc, free and realloc. A custom strategy can easily be provided by defining a class that implements AK::IAkPluginMemAlloc. Finally, a wrapper class AK::Wwise::SafeAllocator is used to ensure type-safety and automatic memory management.

예시:

#include <AK/Tools/Common/AkAllocator.h>
#include <rapidjson/document.h>
 
// 결과와 오류에 대해 기본 할당 계획을 사용

AK::Wwise::Mallocator alloc;
 

AK::Wwise::SafeAllocator<char> szResults(&alloc);

AK::Wwise::SafeAllocator<char> szError(&alloc);
 
// 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>
 
// 결과와 오류에 대해 기본 할당 계획을 사용

AK::Wwise::Mallocator alloc;
 

AK::Wwise::SafeAllocator<char> szResults(&alloc);

AK::Wwise::SafeAllocator<char> szError(&alloc);
 
// 프로시저의 매개 변수를 포함하고 있는 JSON 객체를 빌드
rapidjson::Document args;
args.SetObject();
args.AddMember("classId", 8192003, args.GetAllocator());
args.AddMember("property", "ModDepth", args.GetAllocator());
 
// JSON 객체를 문자열로 나타냄
rapidjson::StringBuffer buffer;
rapidjson::Writer<rapidjson::StringBuffer> writer(buffer);
args.Accept(writer);
 
// 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);
 
    // ...
}