본문으로 바로 가기

세션

세션이란 무엇입니까?​

세션은WebSocket 클라이언트가 포트 10001에 연결하면 자동으로 생성됩니다. 하나의 연결은 하나의 세션에 해당합니다. 연결이 종료되면 세션이 삭제되고 해당 구성도 폐기됩니다.

각 세션은 다음을 포함합니다:

  • 번호 ID(서비스에서 자동으로 할당)
  • 선택적 프로필 이름(직접 설정)
  • 모든 디바이스에 대한 고유한 뷰: basis, mount, preset, filters, 워크스페이스 변환

여러 세션이 동시에 존재할 수 있습니다. 예를 들어, 한 세션에서는 사용자의 Unity 앱을, 다른 세션에서는 ‘ Haply Hub’를 볼 수 있습니다. 두 세션 모두 동일한 물리적 장치를 보고 있지만, 각자 고유한 좌표 설정을 사용합니다.

프로필 이름 설정​

첫 번째 메시지에서 프로필 이름을 설정하시기를 강력히 권장합니다:

{
  "session": {
    "configure": {
      "profile": {
        "name": "co.mycompany.myapp:main-scene"
      }
    }
  }
}

중요한 이유:

  • Haply Hub는 프로필 이름을 사용하여 시뮬레이션을 식별하며, 해당 UI에서 장치 설정(워크스페이스, 베이스, 마운트, 필터)을 조정할 수 있게 합니다.
  • 이러한 조정 사항은 영구적으로 저장됩니다. 나중에 같은 앱을 실행하면 Hub가 코드를 변경하지 않고도 자동으로 다시 적용합니다.
  • 다른 세션(또는 HTTP 클라이언트)은 세션 선택기를 사용하여 프로필 이름으로 사용자의 세션을 지정할 수 있습니다: ?session=myapp:0. 프로필 선택기는 * / ? 글롭 와일드카드도 지원하므로, ?session=co.haply.hub::*:0이와 같은 패턴은 전체 프로필 이름을 알 필요 없이 작동합니다.

원격 제어 (세션 간 구성)​

세션의 디바이스는 외부에서 재구성할 수 있습니다. 다른 WebSocket 세션이나, WebSocket 연결이 전혀 없는 HTTP 클라이언트를 통해서도 가능합니다. 이것이 바로 Haply Hub가 앱의 설정을 조정하는 방식입니다.

HTTP 클라이언트는 올바른 세션을 지정하기 위해 세션 선택기를사용합니다:

# List all sessions
curl http://localhost:10001/sessions

# Look up a single session directly (path-form of the selector — same
# expressions as `?session=`, see Selectors for the full grammar)
curl http://localhost:10001/sessions/:myapp:0

# Change the basis on session with profile "myapp" (first match)
curl -X POST "http://localhost:10001/inverse3/0/config/basis?session=myapp:0" \
     -H "Content-Type: application/json" \
     -d '{"permutation": "XZY"}'

# Same, but target the first session in a namespace (profile wildcard)
curl -X POST "http://localhost:10001/inverse3/0/config/basis?session=co.haply.hub::*:0" \
     -H "Content-Type: application/json" \
     -d '{"permutation": "XZY"}'

세션 간 HTTP 제어의 전체 작동 예시는 HTTP Remote Config 튜토리얼을참조하십시오.