Universal KATSDK (1.0系) 導入ガイド

SDK概要とユニバーサル化の変更点

新しい「Universal / KATSDK」では、内部構造とインターフェイスを再設計し、旧個別SDKの機種依存APIを統合しました。

クイックスタート (Unity)

「C2CORE Unity SDK（Universal SDK系）」を前提に、OpenXR + XR Interaction Toolkit構成での最低限の導入パスを想定します。

1. SDKの入手とインポート

   KATVR公式サイトのダウンロードページから最新のKAT Unity SDKを入手しインポート。
   (KATSDKWarpper.dll, KATNativeSDK.cs, KATXRWalker.cs等が含まれます)

2. プロジェクト設定（XR）

   XR Plug-in ManagementでOpenXRを有効化し、XR Interaction Toolkitを導入してXR Originを配置します。

3. KATトレッドミルコンポーネントの追加

   空のGameObject「KAT Treadmill」を作成し、KATXRWalkerをアタッチ。XR OriginのTransformを参照設定します。

4. ネイティブSDK初期化の確認

   再生前にKAT Gatewayを起動しデバイス接続を確認。プレイ時にコンソール等でTreadMillDataの更新を確認します。

クイックスタート (Unreal Engine 5.x)

1. プラグイン配置と有効化

   ダウンロードしたKAT Unreal SDKをプロジェクトの Plugins/KATSDK フォルダに配置し、Edit → Pluginsで有効化して再起動。

2. KATコンポーネントの追加

   KATTreadmillComponentをレベルに配置し、プレイヤーのBlueprintに「KAT移動同期用」ノード（GetTreadmillData → AddMovementInput）を追加します。

主要APIリファレンス (Unity想定)

共通データ構造

代表的な関数 (KATSDKクラス)

サンプルコード

Unity / C# (最小構成)

using UnityEngine;

public class SimpleKATWalker : MonoBehaviour
{
    public Transform rigRoot; // XR Originのルート
    public float speedScale = 1.0f;

    void Start()
    {
        KATSDK.Initialize();
    }

    void Update()
    {
        if (!KATSDK.IsDeviceConnected()) return;

        TreadMillData data = KATSDK.GetTreadMillData();
        Vector3 move = new Vector3(data.velocity.x, 0f, data.velocity.z) * speedScale * Time.deltaTime;
        rigRoot.position += move;

        float yaw = KATSDK.GetYawCorrection();
        rigRoot.rotation = Quaternion.Euler(0f, yaw, 0f);
    }

    void OnDestroy()
    {
        KATSDK.Shutdown();
    }
}

Unreal Engine / C++ (イメージ)

// MyKATCharacter.cpp
#include "MyKATCharacter.h"
#include "KATSDK.h" 

void AMyKATCharacter::BeginPlay()
{
    Super::BeginPlay();
    bKATInitialized = KATSDK::Initialize();
}

void AMyKATCharacter::Tick(float DeltaSeconds)
{
    Super::Tick(DeltaSeconds);
    if (!bKATInitialized || !KATSDK::IsDeviceConnected()) return;

    FTreadMillData Data;
    if (KATSDK::GetTreadMillData(Data))
    {
        const FVector Forward = GetActorForwardVector();
        const FVector Move = Forward * Data.Velocity * DeltaSeconds;
        AddMovementInput(Move);
    }
}

よくある落とし穴 (FAQ)