Holographic Remoting 및 OpenXR API를 사용 하는 사용자 지정 데이터 채널

참고

이 지침은 HoloLens 2의 Holographic 원격 및 Windows Mixed Reality를 실행 하는 pc Windows에만 적용 됩니다.

사용자 지정 데이터 채널을 사용 하 여 설정 된 원격 연결을 통해 사용자 지정 데이터를 전송 합니다.

중요

사용자 지정 데이터 채널에는 사용자 지정 원격 앱 및 사용자 지정 플레이어 앱이 필요 합니다. 이렇게 하면 두 사용자 지정 앱 간의 통신을 허용 합니다.

간단한 ping-ping 예제는 Holographic Remoting 샘플 github 리포지토리내부의 원격 및 플레이어 샘플에서 찾을 수 있습니다. #define ENABLE_CUSTOM_DATA_CHANNEL_SAMPLE샘플 코드를 사용 하도록 설정 하려면 OpenxrSamplePlayerMain 및 파일 내에서 주석 처리를 제거 합니다.

중요

자세한 사양은Holographic Remoting 샘플 github 리포지토리에서 찾을 수 있습니다.

사용자 지정 데이터 채널 만들기

연결이 성공적으로 설정 되 면 함수를 통해 새 데이터 채널을 만들 수 있습니다 xrCreateRemotingDataChannelMSFT . 사용자 지정 데이터 채널은 런타임과 원격 응용 프로그램에서 만들 수 있습니다. 플레이어 쪽에서 데이터 채널을 만드는 경우 원격 쪽에는 이벤트 구조와 함께 알림이 전달 됩니다 XrEventDataRemotingDataChannelCreatedMSFT .

XrRemotingDataChannelStatusMSFT를 호출한 후의 초기 상태는 xrCreateRemotingDataChannelMSFTXR_REMOTING_DATA_CHANNEL_STATUS_OPEN_PENDING_MSFT 입니다. 데이터 채널이 완전히 설정 되 면 채널의 상태가로 전환 XR_REMOTING_DATA_CHANNEL_STATUS_OPENED_MSFT 됩니다. XrEventDataRemotingDataChannelOpenedMSFT이전에 만든 데이터 채널의 상태가에서로 전환 되 면 이벤트 구조가 이벤트 큐에 배치 됩니다 XR_REMOTING_DATA_CHANNEL_STATUS_OPEN_PENDING_MSFTXR_REMOTING_DATA_CHANNEL_STATUS_OPENED_MSFT .

데이터 보내기

xrSendRemotingDataMSFT함수는 플레이어 쪽에 데이터를 보내는 데 사용 됩니다.

데이터 검색

데이터 채널을 통해 데이터가 도착할 때마다 이벤트 XrEventDataRemotingDataChannelDataReceivedMSFT 구조가 이벤트 큐에 배치 됩니다. 수신 된 패킷은 함수를 사용 하 여 검색할 수 있습니다 xrRetrieveRemotingDataMSFT .

채널 상태 가져오기

xrGetRemotingDataChannelStateMSFT함수를 사용 하 여 데이터 채널 상태를 쿼리할 수 있습니다.

데이터 채널 제거

를 사용 하 여 데이터 채널을 제거할 수 있습니다 xrDestroyRemotingDataChannelMSFT . XrRemotingDataChannelMSFT호출 후에는 핸들이 유효 하지 xrDestroyRemotingDataChannelMSFT 않으며 나중에 데이터 채널 핸들을 사용 하지 않아야 합니다.

XrEventDataRemotingDataChannelClosedMSFT플레이어 쪽에서 데이터 채널을 닫거나 소멸 시키는 경우이 이벤트 큐에 배치 됩니다. 데이터 채널 상태는로 전환 XR_REMOTING_DATA_CHANNEL_STATUS_CLOSED_MSFT 됩니다. 닫힌 데이터 채널의 경우 XrRemotingDataChannelMSFT 핸들이 유효한 상태로 유지 됩니다.

참고 항목