Vlastní datové kanály s Holographic Remotingem a rozhraním API OpenXR

Poznámka

Tyto pokyny jsou specifické pro Holographic Remoting na HoloLens 2 a Windows počítačích se systémem Windows Mixed Reality.

Vlastní datové kanály můžete použít k odesílání vlastních dat přes navázáno připojení vzdálené komunikace.

Důležité

Vlastní datové kanály vyžadují vlastní vzdálenou aplikaci a vlastní aplikaci přehrávače. To umožňuje komunikaci mezi těmito dvěma vlastními aplikacemi.

Tip

Jednoduchý příklad příkazu ping-na najdete v ukázky vzdálených zařízení a přehrávačů v úložišti GitHub s ukázkami pro vzdálenou komunikace Holographic. Odkomentování #define ENABLE_CUSTOM_DATA_CHANNEL_SAMPLE v souborech OpenXrProgramm.cpp a SamplePlayerMain.h povolte vzorový kód.

Důležité

Podrobnou specifikaci najdete v úložišti GitHub s ukázkou holografické vzdálené komunikace.

Vytvoření vlastního datového kanálu

Po úspěšném vytvoření připojení je možné prostřednictvím funkce vytvořit nové datové xrCreateRemotingDataChannelMSFT kanály. Vlastní datové kanály je možné vytvářet z přehrávače a vzdálené aplikace i v případě, že se moduly runtime liší. Pokud datový kanál vytvoří strana přehrávače, na vzdálenou stranu se upozorní struktura XrEventDataRemotingDataChannelCreatedMSFT události.

Počáteční stav XrRemotingDataChannelStatusMSFT po volání xrCreateRemotingDataChannelMSFT je XR_REMOTING_DATA_CHANNEL_STATUS_OPEN_PENDING_MSFT . Po úplném nastavení datového kanálu se stav kanálu přepne na XR_REMOTING_DATA_CHANNEL_STATUS_OPENED_MSFT . Struktura událostí se umístí do fronty událostí, když se stav dříve vytvořeného datového XrEventDataRemotingDataChannelOpenedMSFT kanálu přepne z XR_REMOTING_DATA_CHANNEL_STATUS_OPEN_PENDING_MSFT na XR_REMOTING_DATA_CHANNEL_STATUS_OPENED_MSFT .

Odeslání dat

Funkce xrSendRemotingDataMSFT se používá k odesílání dat na stranu přehrávače.

Načtení dat

Pokaždé, když data dorazí přes datový kanál, se do fronty událostí umístí XrEventDataRemotingDataChannelDataReceivedMSFT struktura událostí. Přijaté pakety je možné načíst pomocí xrRetrieveRemotingDataMSFT funkce .

Získání stavu kanálu

Funkci xrGetRemotingDataChannelStateMSFT lze použít k dotazování na stav datového kanálu.

Zničení datového kanálu

Datový kanál můžete zničíte pomocí xrDestroyRemotingDataChannelMSFT . Popisovač je po volání neplatný a popisovač datového kanálu se nesmí XrRemotingDataChannelMSFTxrDestroyRemotingDataChannelMSFT použít později.

Objekt XrEventDataRemotingDataChannelClosedMSFT se umístí do fronty událostí pro případ, že se strana přehrávače zavře nebo zničí datový kanál. Stav datového kanálu se přepne na XR_REMOTING_DATA_CHANNEL_STATUS_CLOSED_MSFT . U zavřené datového kanálu XrRemotingDataChannelMSFT zůstane popisovač platný.

Viz také