Holographic Remoting ve OpenXR API ile özel veri kanalları

Not

bu kılavuz, Windows Mixed Realityçalıştıran HoloLens 2 ve Windows bilgisayarlarda Holographic Remoting 'e özgüdür.

Özel veri kanallarını kullanarak, belirlenen bir uzaktan bağlantı bağlantısı üzerinden özel veri gönderebilirsiniz.

Önemli

Özel veri kanalları özel bir uzak uygulama ve özel bir oynatıcı uygulaması gerektirir. Bu, iki özel uygulama arasında iletişime olanak sağlar.

İpucu

Basit bir ping-pong örneği, holographic Remoting Samples GitHub deposununiçindeki uzak ve oynatıcı örneklerinde bulunabilir. #define ENABLE_CUSTOM_DATA_CHANNEL_SAMPLEÖrnek kodu etkinleştirmek Için OpenXrProgramm. cpp ve SamplePlayerMain. h dosyalarının içinde Açıklama kaldırın.

Özel veri kanalı oluşturma

Bağlantı başarıyla kurulduktan sonra, işlev aracılığıyla yeni veri kanalları oluşturulabilir xrCreateRemotingDataChannelMSFT . Çalışma zamanları farklı olsa bile Player 'dan ve uzak uygulamadan özel veri kanalları oluşturulabilir. Oynatıcı tarafı tarafından bir veri kanalı oluşturulduysa, uzak tarafa XrEventDataRemotingDataChannelCreatedMSFT olay yapısıyla bildirilir.

Çağrıldıktan XrRemotingDataChannelStatusMSFT sonra ilk durum xrCreateRemotingDataChannelMSFTXR_REMOTING_DATA_CHANNEL_STATUS_OPEN_PENDING_MSFT . Veri kanalı tam olarak kurulduktan sonra, kanalın durumu öğesine geçer XR_REMOTING_DATA_CHANNEL_STATUS_OPENED_MSFT . XrEventDataRemotingDataChannelOpenedMSFTOlay yapısı, daha önce oluşturulmuş bir veri kanalının durumu ' den ' a geçtiğinde olay kuyruğuna yerleştirilir XR_REMOTING_DATA_CHANNEL_STATUS_OPEN_PENDING_MSFTXR_REMOTING_DATA_CHANNEL_STATUS_OPENED_MSFT .

Veri Gönder

xrSendRemotingDataMSFTİşlevi, oynatıcı tarafına veri göndermek için kullanılır.

Veri alma

Verilerin bir veri kanalı aracılığıyla her ulaştığında, olay XrEventDataRemotingDataChannelDataReceivedMSFT yapısı olay kuyruğuna yerleştirilir. Alınan paketleri işleviyle elde edilebilir xrRetrieveRemotingDataMSFT .

Kanal durumunu al

xrGetRemotingDataChannelStateMSFTİşlevi, veri kanalı durumunu sorgulamak için kullanılabilir.

Veri kanalını yok etme

Bir veri kanalını ile yok edebilirsiniz xrDestroyRemotingDataChannelMSFT . XrRemotingDataChannelMSFTÇağrıdan sonra tanıtıcı geçersizdir xrDestroyRemotingDataChannelMSFT ve veri kanalı tutamacı daha sonra kullanılmamalıdır.

, XrEventDataRemotingDataChannelClosedMSFT Player 'ın veri kanalını kapatması veya yok etmek durumunda olay kuyruğuna yerleştirilir. Veri kanalı durumu öğesine geçer XR_REMOTING_DATA_CHANNEL_STATUS_CLOSED_MSFT . Kapalı bir veri kanalı için, XrRemotingDataChannelMSFT tanıtıcı geçerli kalır.

Ayrıca Bkz.