VerseGripポジションコントロール・チュートリアル

このチュートリアルでは、Inverse3デバイスのカーソルの位置を直接制御するためにVerseGripの回転を使用する方法を示します。

はじめに

で示した方法とは異なる。 クイックスタートガイドこのチュートリアルでは、標準的な更新周波数（60Hz）で動作するInverse3カーソルの位置を、より高い周波数（1～4kHz）でVerseGripデバイスの回転に基づいて動的に調整することを目的としています。 これは DeviceStateChanged イベントが発生する。

シーン設定

まず、Haptic Rigを作成します：GameObject > Haply > Haptic Rig (片手)を作成します。

VerseGripPositionControl コンポーネント

という名前の新しいC#スクリプトを作成する。 VerseGripPositionControl.cs に貼り付ける。 ハプティック・オリジン GameObject。 以下のプロパティを VerseGripPositionControl クラスである：

public Inverse3 inverse3;
public VerseGrip verseGrip;

[Range(0, 1)]
public float speed = 0.5f;

[Range(0, 0.2f)]
public float movementLimitRadius = 0.2f;

private Vector3 _targetPosition;

• inverse3：インスペクタで設定するInverse3デバイスへの参照。
• verseGrip：カーソルコントロールに使用されるVerseGripデバイスへの参照。
• speed: カーソルの移動速度。
• 移動限界半径：カーソルが初期位置から移動できる最大距離。
• _targetPosition：カーソルが移動するターゲット位置。

を実施する。 OnDeviceStateChanged メソッドを使用して、VerseGripの回転とボタン入力に基づいてカーソルの目標位置を計算します：

private void OnDeviceStateChanged(VerseGrip grip)
{
    // Calculate the direction based on the VerseGrip's rotation
    var direction = grip.Orientation * Vector3.forward;

    // Check if the VerseGrip button is pressed down
    if (grip.GetButtonDown())
    {
        // Initialize target position
        _targetPosition = inverse3.CursorLocalPosition;
    }

    // Check if the VerseGrip button is being held down
    if (grip.GetButton())
    {
        // Move the target position toward the grip direction
        _targetPosition += direction * (0.0025f * speed);

        // Clamp the target position within the movement limit radius
        var workspaceCenter = inverse3.WorkspaceCenter;
        _targetPosition = Vector3.ClampMagnitude(_targetPosition - workspaceCenter, movementLimitRadius)
            + workspaceCenter;

        // Move cursor to new position
        inverse3.CursorSetLocalPosition(_targetPosition);
    }
}

登録と登録解除 DeviceStateChanged イベント OnEnable そして OnDisable.

/// Subscribes to the DeviceStateChanged event.
private void OnEnable()
{
    verseGrip.DeviceStateChanged += OnDeviceStateChanged;
}

/// Unsubscribes from the DeviceStateChanged event.
private void OnDisable()
{
    verseGrip.DeviceStateChanged -= OnDeviceStateChanged;
}

オプションだ： の中で Update メソッドで、Inverse3の力をリセットできるようにしよう。

private void Update()
{
    // Check for space key to disable position control
    if (Input.GetKeyDown(KeyCode.Space))
    {
        // Reset cursor force to disable position control
        inverse3.Release();
    }
}

ゲームプレイ

• Inverse3デバイスを固定し、移動に十分なスペースを確保してください。
• プレイモードに入り、Inverse3カーソルをホールドする。
• VerseGripを回転させて、Unityシーン内のカーソルの動きを観察します。これは、VerseGripの向きに直接対応します。
• VerseGripのボタンを押すと、Inverse3のカーソルがVerseGripの回転方向に移動し、リアルタイムのコントロールを見せる。

画像は、カーソル・モデルを分かりやすくするために前方の軸を強調したものである。 カーソル・モデルのカスタマイズの詳細については、カーソルのドキュメントを参照してください。

ソースファイル

この例で使用する最終的なシーンとすべての関連ファイルは、Unity のパッケージマネージャでTutorialsサンプルからインポートできます。

VerseGripPositionControl.cs

/*
 * Copyright 2024 Haply Robotics Inc. All rights reserved.
 */

using Haply.Inverse.Unity;
using UnityEngine;

namespace Haply.Samples.Tutorials._6_VerseGripPositionControl
{
    /// <summary>
    /// Demonstrates how to control the device cursor position using the VerseGrip.
    /// </summary>
    public class VerseGripPositionControl : MonoBehaviour
    {
        // Must be assigned in inspector
        public Inverse3 inverse3;
        public VerseGrip verseGrip;

        [Tooltip("Cursor moving speed")]
        [Range(0, 1)]
        public float speed = 0.5f;

        [Tooltip("Maximum radius for cursor movement")]
        [Range(0, 0.2f)]
        public float movementLimitRadius = 0.2f;

        private Vector3 _targetPosition; // Target position for the cursor

        /// <summary>
        /// Subscribes to the DeviceStateChanged event.
        /// </summary>
        private void OnEnable()
        {
            verseGrip.DeviceStateChanged += OnDeviceStateChanged;
        }

        /// <summary>
        /// Unsubscribes from the DeviceStateChanged event.
        /// </summary>
        private void OnDisable()
        {
            verseGrip.DeviceStateChanged -= OnDeviceStateChanged;
        }

        private void Update()
        {
            // Check for space key to disable position control
            if (Input.GetKeyDown(KeyCode.Space))
            {
                // Reset cursor force to disable position control
                inverse3.Release();
            }
        }

        private void OnDeviceStateChanged(VerseGrip grip)
        {
            // Calculate the direction based on the VerseGrip's rotation
            var direction = grip.Orientation * Vector3.forward;

            // Check if the VerseGrip button is pressed down
            if (grip.GetButtonDown())
            {
                // Initialize target position
                _targetPosition = inverse3.CursorLocalPosition;
            }

            // Check if the VerseGrip button is being held down
            if (grip.GetButton())
            {
                // Move the target position toward the grip direction
                _targetPosition += direction * (0.0025f * speed);

                // Clamp the target position within the movement limit radius
                var workspaceCenter = inverse3.WorkspaceCenter;
                _targetPosition = Vector3.ClampMagnitude(_targetPosition - workspaceCenter, movementLimitRadius)
                    + workspaceCenter;

                // Move cursor to new position
                inverse3.CursorSetLocalPosition(_targetPosition);
            }
        }
    }