본문으로 건너뛰기

변경 내역

3.2.0​

2025년 4월

이번 업데이트에서는 페이로드 관리를 위한 새로운 DevicesCache 컴포넌트를 도입하여 디바이스 컨트롤러용 Unity 인스펙터 표시를 개선하는 한편, 성능 최적화를 진행하고 있습니다.

  • DevicesCache 을 추가하여 페이로드에 대한 통합된 접근을 가능하게 했습니다.
  • Inverse3 또한 VerseGrip 컨트롤러의 인스펙터 표시를 수정했습니다.
  • 성능 향상을 위해 출력 페이로드의 크기를 줄였습니다.
  • SDK 3.x.x용 Haptics and Physics Engine 샘플을 업데이트했습니다.

자세한 내용은변경 내역을참조해 주세요.

3.1.0​

2024년 12월

Haply Inverse Unity 3.1.0은,무선 VerseGrip 스타일러스 ...에 대한 지원을 추가하고,Inverse SDK 3.x.x 통신 프로토콜과의 호환성을 확보하기 위한 중요한 이정표입니다.

이번 릴리스에는 디바이스 프로빙 기능 강화, 명확성과 일관성 향상을 목표로 한 API 개선, 그리고 이벤트 처리의 효율화가 포함되어 있습니다.

호환성에 관한 중요한 주의사항​

Inverse SDK 3.0.x JSON 형식의 페이로드가 도입됨에 따라, SDK 3.0.x와 호환되는 Unity 패키지는 존재하지 않습니다. 3.x SDK에서 Unity를 사용하려면,Inverse SDK 3.1.x 이후에 업그레이드해야 합니다.

새로운 기능​

  • 새로운 무선 VerseGrip 스타일러스에 대한 지원을 추가했습니다.
  • Inverse SDK 3.x.x 버전에 대응하기 위해 ClientConnection을 업그레이드했습니다.
  • 장치 매핑 및 관리 기능을 강화했습니다.
  • 커서 및 각도 위치 측정 기능을 개선했습니다.
  • 좌표 처리를 개선하기 위해 Inverse3Gizmos를 업데이트했습니다.

API 개선​

  • 컴포넌트 및 이벤트 이름 변경:

    • 가독성을 높이기 위해 명칭을 간소화하고 통일했습니다:
      • DeviceBehaviour → DeviceControllerBase。
      • CursorBehaviour → CursorBase。
      • Inverse3 → Inverse3Controller。
      • VerseGrip → VerseGripController。
    • 이에 따라 에디터 클래스도 업데이트했습니다(예: DeviceBehaviourEditor → DeviceControllerBaseEditor).

  • 이벤트 처리 개선:

    • Inverse3Controller 그리고 VerseGripController 의 DeviceStateChanged 이벤트를 전용 EventArgs(Inverse3EventArgs、VerseGripEventArgs)를 사용한다 EventHandler 로 전환되었습니다.

개발 중인 기능​

  • 다음 기능은 아직 준비가 완료되지 않아 일시적으로 삭제되었습니다. 향후 업데이트에서 복원될 예정입니다:
    • 연결 모니터 창
    • 클라이언트 구성
    • 성능데이터
    • 바디의 방향과 관련된 메서드 및 관련 이벤트를 삭제했습니다.

이번 릴리스는 Haply Inverse Unity 개발의 중요한 이정표이며, 기능 확충, 명확성 제고, 그리고 향후 기능 강화를 위한 기반을 마련해 줍니다.

자세한 내용은변경 내역을참조해 주세요.

2.2.0​

2024년 8월

이번 릴리스에서는Inverse3 및 VerseGrip 장치의 사용자 경험을 개선하는 데 중점을 두고, 몇 가지 새로운 기능과 개선 사항을 제공합니다. 주요 업데이트 내용으로는 스무딩 옵션 추가, 작업 공간 관리를 위한 새로운 속성, 그리고 장치 준비 완료 관련 이벤트 처리 개선이 있습니다. 또한, 여러 가지 수정 및 개선 사항을 통해 안정성과 성능이 향상되었으며, 이전 버전의 Unity와의 호환성도 복원되었습니다.

의존 관계​

  • 이번 릴리스에서는 2.1.1 버전에서 손상되었던 Unity 버전 >= 2021.3.0f1과의 호환성을 복원했습니다.
  • 이 패키지는 Haply Inverse SDK 2.0.0 이후 버전과 호환되지만, 완벽한 호환성을 위해서는 Haply Inverse SDK(>=2.2)가 필요합니다.

새로운 기능​

  • 스무딩 기능 강화:
    • Inverse3Cursor 그리고 VerseGripCursor 컴포넌트가 평활화된 위치와 회전을 지원하게 되었습니다.
  • 작업 공간 관리:
    • Inverse3 장치에, 공간 인식 능력을 향상시키기 위한 WorkspaceCenterPosition、WorkspaceRadius、WorkspaceScaledRadius 속성이 추가되었습니다.
    • 공간 변환 행렬의 업데이트를 제어하는 새로운 SpaceTransformationUpdateEnabled 필드가 추가되었습니다.
  • 이벤트 처리:
    • Inverse3 그리고 VerseGrip 양쪽 모두에 Ready 이벤트가 추가되었습니다. 기기의 초기화가 완료되어 사용 가능해졌음을 알립니다.
  • 디바이스 매퍼:
    • GetInverse3(handedness) 기본 매개변수를 추가하여 장치 검색 기능을 강화하고, 관련 그립을 검색한다 GetVerseGrip(handedness) 새로운 기능을 추가했습니다.

수정 및 개선​

  • 오류를 방지하고 안정성을 높이기 위해,ClientConnection、DeviceMapper, 그리고 커서 동작과 관련된 문제를 해결했습니다.
  • 특히 오류 발생 시의 장치 연결 및 폴링 처리를 개선했습니다.
  • 편집기에서 HapticOrigin 의 균일 스케일 계산을 안정화했습니다.

더 이상 권장되지 않는 기능 및 해당 대체 방법을 포함한 변경 사항에 대한 자세한 목록은 전체 변경 내역을 참조해 주십시오.

자세한 내용은변경 내역을참조해 주세요.

2.1.1​

2024년 6월

이번 릴리스에서는Inverse3 기기의 본체 방향과 관련된 새로운 메서드 및 컴포넌트의 도입, 전원 정보 제공, 기기 출력 및 제어 모드에 대한 향상된 제어 기능, 그리고 다양한 기기 위치를 관리하기 위한 좌표 변환기의 개선에 중점을 두었습니다.

또한, DeviceMapper는 필터링된 장치 검색 기능 및 개선된 장치 매핑 기능 등 새로운 기능을 통해 크게 개선되었습니다.

의존 관계​

이 패키지는 Haply Inverse SDK 2.0.0 이후 버전과 호환되지만, 완벽한 호환성을 위해서는 Haply Inverse SDK(>=2.1)이 필요합니다.

경고

이 릴리스는 Unity 2021.3.0f1 이전 버전과는 호환되지 않습니다. 호환성 문제가 발생하면 더 최신 버전으로 업데이트해 주십시오.

파괴적 변경 및 사용 중단 예정 기능​

이번 릴리스에서는 새로운 업데이트 및 기능 개선에 따라 일부 기능이 변경되거나 사용이 권장되지 않게 되었습니다. 개발자 여러분께서는 사용이 권장되지 않는 기능과 그 대체 방법에 대한 전체 목록을 확인하시려면, 자세한 변경 내역을 참조하시기 바랍니다.

새로운 기능​

  • Inverse3Body 컴포넌트: Inverse3 디바이스의 본체 방향을 지정된 GameObject에 적용합니다.
  • Inverse3 기능 강화: 본체 방향, 전원, 제어 모드 및 장치로 전송되는 출력과 관련된 새로운 속성과 이벤트를 추가했습니다.
  • VerseGrip 기능 강화: 좌표 변환 설정 및 ErrorEvent 지원이 추가되었습니다.
  • 검사관: ControlMode 또한 최근의 기기 출력 내역도 표시되도록 변경되었습니다.
  • DeviceMapper 개선: 동적 장치 매핑, 상태 폴링 및 연결 끊김 후 장치 재연결 기능이 추가되었습니다.
  • OrientationSettings: VerseGripCursor 및 Inverse3Body 컴포넌트에 추가되었습니다.
  • 명시적 캐시 유형: 데이터 처리를 개선하기 위한 Inverse3Data 그리고 VerseGripData。
  • CoordinateConverter: 서로 다른 기기 위치에 따른 좌표 변환 설정을 정의할 수 있게 되었습니다.

수정 및 개선​

  • 다양한 버그 수정 및 안정성 개선.
  • 씬 언로드/로드 후의 디바이스 매핑 기능을 강화했습니다.
  • 기기 연결이 끊어진 후 자동으로 다시 연결되도록 설정했습니다.
  • 빌드 종료 시 클라이언트의 폴링 스레드가 적절하게 종료되도록 수정했습니다.

자세한 내용은변경 내역을참조해 주세요.

2.0.1​

2024년 3월

이번 업데이트에서는 이전 버전에서 확인된 여러 문제를 해결하여,Haply Inverse Unity를 더욱 쾌적하게 이용하실 수 있도록 했습니다.

수정 사항에는 빌드 완료 시 보다 깔끔하게 시스템을 종료할 수 있도록 클라이언트 폴링 스레드를 개선한 내용과, 패키지 이름으로 설치할 때 메타 파일이 누락되는 문제를 해결한 내용이 포함됩니다.

의존 관계​

호환성 요구 사항은 2.0.0과 동일합니다.

자세한 내용은변경 내역을참조해 주세요.

2.0.0​

2024년 1월

Haply Inverse Unity 버전 2.0.0 릴리스에서는 기기 관리, 시각화 및 씬 설정을 효율화하는 몇 가지 기능 개선 사항이 도입되었습니다.

새로운 기능으로는 연결된 장치의 상태를 시각화할 수 있는 모니터링 창, 씬을 간편하게 설정할 수 있는 ‘ Haply ’ 생성 메뉴, 그리고 ‘ Inverse3 ’와 ‘VerseGrip’ 장치를 자동으로 매핑해 주는 ‘DeviceMapper’가 포함됩니다.

의존 관계​

이 패키지를 사용하려면 컴퓨터에 Haply Inverse SDK(>=2.0.0)이 설치되어 있어야 합니다.

새로운 기능​

  • 모니터링 창: 연결된 장치의 상태를 확인할 수 있는 새로운 창을 추가했습니다.
  • Haply 생성 메뉴: 필요한 모든 GameObject를 추가할 수 있는 새로운 메뉴를 통해 씬 설정을 간소화했습니다.
  • DeviceMapper: Inverse3 및 VerseGrip 장치를 자동으로 할당합니다.
  • 클라이언트 구성: 햅틱 루프의 주파수와 연결 관련 사용 사례를 제어할 수 있게 되었습니다.
  • Inverse3 구성 요소: 장치의 위치 결정 및 힘 제어를 위해 HapticThread를 대체하는 것입니다. 빈번한 조작을 위한 새로운 메서드와 이벤트를 포함합니다.
  • VerseGrip 컴포넌트: HandleThread를 대체하는 컴포넌트입니다. 버튼 상태 및 부착 상태를 위한 메서드와, 씬 상호 작용을 위한 새로운 Unity 이벤트를 포함하고 있습니다.
  • 커서 컴포넌트: 장치의 위치와 방향을 시각화하기 위한 Inverse3Cursor 및 VerseGripCursor.
  • HapticOrigin GameObject: 작업 공간의 크기 조정 및 배치를 용이하게 합니다.
  • 기즈모: 장치의 위치, 방향 및 접근 가능한 작업 공간을 시각화합니다.

파괴적인 변경​

  • 대체: HapticThread와 HandleThread는 각각 Inverse3 및 VerseGrip으로 대체되었습니다.
  • 새로운 이벤트: DeviceStateChanged 이벤트는 Run(callback) 메서드를 대체합니다.
  • DeviceOpened 이벤트: onInitialized 이벤트를 Inverse3.DeviceOpened 및 VerseGrip.DeviceOpened로 대체했습니다.
  • 햅틱 콜백의 매개변수: 커서 위치 및 속도 전달 기능을 제거했습니다.
  • AdditionalData: 스레드 안전성이 보장되는 관리 대상 AdditionalData를 제거하고, 사용자 정의 데이터 처리 방식으로 대체했습니다.

버그 수정 및 개선​

  • 주 손 감지: 기기를 열지 않아도 기기 감지 시 해당 기능이 제공됩니다.
  • 자동 장치 감지: Haply Inverse Service 및 DeviceMapper를 통해 기능이 강화되었습니다.
  • 주파수 향상: 햅틱 루프의 주파수를 약 1000Hz에서 약 4000kHz로 높였습니다.
  • 안정성 및 성능: 안정성을 개선하고, 그 밖에도 수많은 수정 및 개선 사항을 적용했습니다.

자세한 내용은 변경 내역을 참조해 주세요.