Remote Rendering-sessies

  • Artikel
  • 7 minuten om te lezen

In azure remote rendering (ARR) is een sessie een belang rijk concept. In dit artikel wordt uitgelegd wat een sessie precies is.

Overzicht

Externe rendering van Azure werkt door het offloaden van complexe weergave taken in de Cloud. Deze rendering-taken kunnen niet worden afgehandeld door alleen een server, omdat de meeste Cloud servers geen Gpu's hebben. Vanwege de hoeveelheid betrokken gegevens en de harde nood zaak van het produceren van resultaten met een interactieve frame snelheid, kan de verantwoordelijkheid die de server afhandelt dat de gebruikers aanvraag ook niet aan een andere computer kan worden verstrekt, op voor waarde dat dit mogelijk is voor veelvoorkomende webverkeer.

Dit betekent dat wanneer u de externe rendering van Azure gebruikt, een Cloud Server met de benodigde hardware-functionaliteit alleen moet worden gereserveerd om uw rendering-aanvragen af te handelen. Een sessie verwijst naar alles met betrekking tot de interactie met deze server. Het begint met de eerste aanvraag om een computer te reserveren (leasen) voor uw gebruik, gaat door met alle opdrachten voor het laden en bewerken van modellen en eindigt met het vrijgeven van de lease op de Cloud Server.

Sessies beheren

Er zijn meerdere manieren om sessies te beheren en te gebruiken. De taal onafhankelijke manier om sessies te maken, bij te werken en af te sluiten, is via de sessie beheer rest API. In C# en C++ worden deze bewerkingen weer gegeven via de klassen RemoteRenderingClient en RenderingSession . Voor Unity-toepassingen zijn er verdere hulp functies van het ARRServiceUnity onderdeel beschikbaar.

Zodra u verbinding hebt gemaakt met een actieve sessie, worden bewerkingen zoals het laden van modellen en interactie met de scène weer gegeven via de- RenderingSession klasse.

Meerdere sessies tegelijk beheren

Het is niet mogelijk om volledig verbinding te maken met meerdere sessies vanaf één apparaat. U kunt echter zoveel sessies maken, observeren en afsluiten als u maar wilt van één toepassing. Zolang de app niet is bedoeld om ooit verbinding te maken met een sessie, hoeft deze niet te worden uitgevoerd op een apparaat zoals HoloLens 2. Een gebruiks voorbeeld voor een dergelijke implementatie is mogelijk als u sessies wilt beheren via een centraal mechanisme. Een voor beeld: een web-app waarmee meerdere Tablets en HoloLens-apparaten zich kunnen aanmelden. Vervolgens kan de app opties weer geven op de tablets, zoals welk CAD-model u wilt weer geven. Als een gebruiker een selectie maakt, wordt deze informatie gecommuniceerd naar alle HoloLens-apparaten om een gedeelde ervaring te creëren.

Sessie fasen

Elke sessie ondergaat meerdere fasen.

Sessie starten

Wanneer u ARR vraagt om een nieuwe sessie te maken, is het voor de eerste keer dat u een sessie- uuidretourneert. Met deze UUID kunt u informatie opvragen over de sessie. De UUID en enkele basis informatie over de sessie worden gedurende 30 dagen bewaard, zodat u deze gegevens zelfs nadat de sessie is gestopt, kunt opvragen. Op dit moment wordt de sessie status gerapporteerd als starten.

Vervolgens probeert de externe rendering van Azure een server te vinden die uw sessie kan hosten. Er zijn twee para meters voor deze zoek opdracht. Eerst worden alleen servers in uw regiogereserveerd. Dat komt doordat de netwerk latentie voor verschillende regio's te hoog is om een goede ervaring te garanderen. De tweede factor is de gewenste grootte die u hebt opgegeven. In elke regio is er een beperkt aantal servers dat kan voldoen aan de aanvraag voor de standaard -of Premium -grootte. Als alle servers van de gevraagde grootte momenteel worden gebruikt in uw regio, mislukt het maken van de sessie. De reden voor de fout kan worden opgevraagd.

Belangrijk

Als u een standaard server grootte aanvraagt en de aanvraag mislukt als gevolg van een hoge vraag, is dat niet het geval dat het aanvragen van een Premium -server mislukt. Als dit een optie voor u is, kunt u proberen terug te gaan naar een Premium -server grootte.

Wanneer de service een geschikte server vindt, moet de juiste virtuele machine (VM) ernaar worden gekopieerd om deze in te scha kelen op een externe rendering-host van Azure. Dit proces duurt enkele minuten. Daarna wordt de virtuele machine opgestart en verandert de sessie status in gereed.

Op dit moment wacht de server alleen op uw invoer. Dit is ook het punt van waaruit de service wordt gefactureerd.

Verbinding maken met een sessie

Zodra de sessie is voltooid, kunt u er verbinding mee maken . Tijdens de verbinding kan het apparaat opdrachten verzenden om modellen te laden en te wijzigen. Elke ARR-host fungeert nooit altijd één client apparaat tegelijk, dus wanneer een client verbinding maakt met een sessie, heeft deze exclusieve controle over de gerenderde inhoud. Dit betekent ook dat de prestatie van de rendering nooit kan verschillen voor de oorzaken van het besturings element.

Belangrijk

Hoewel er slechts één client verbinding kan maken met een sessie, kan basis informatie over sessies, zoals de huidige status, worden opgevraagd zonder verbinding te maken.

Wanneer een apparaat is verbonden met een sessie, mislukken pogingen van andere apparaten om verbinding te maken. Wanneer het aangesloten apparaat echter wordt losgekoppeld, hetzij vrijwillig of als gevolg van een soort fout, accepteert de sessie een andere verbindings aanvraag. Alle vorige statussen (geladen modellen en dergelijke) worden verwijderd, waardoor het volgende aangesloten apparaat een schone pastel krijgt. Sessies kunnen daarom vaak opnieuw worden gebruikt, door verschillende apparaten. het is mogelijk dat de opstart overhead van de sessie van de eind gebruiker in de meeste gevallen kan worden verborgen.

Belangrijk

De externe server wijzigt nooit de status van client-side gegevens. Alle mutaties van gegevens (zoals updates voor trans formatie en laad aanvragen) moeten worden uitgevoerd door de client toepassing. Alle acties werken onmiddellijk de client status bij.

Einde van sessie

Wanneer u een nieuwe sessie aanvraagt, geeft u een maximum lease tijd op, meestal binnen het bereik van een tot acht uur. Dit is de duur waarin de host uw invoer accepteert.

Er zijn twee regel matige redenen om een sessie te beëindigen. U vraagt de sessie hand matig te stoppen of de maximale lease tijd verloopt. In beide gevallen wordt een actieve verbinding met de host meteen gesloten en wordt de service afgesloten op die server. De server wordt vervolgens teruggegeven aan de Azure-groep en kan worden gevraagd voor andere doel einden. Het stoppen van een sessie kan niet ongedaan worden gemaakt of worden geannuleerd. Het uitvoeren van een query op de sessie status van een gestopte sessie is gestopt of verlopen, afhankelijk van of deze hand matig is afgesloten of omdat de maximale lease tijd is bereikt.

Een sessie kan ook worden gestopt wegens een storing.

In alle gevallen wordt u niet meer gefactureerd wanneer een sessie wordt gestopt.

Waarschuwing

Hiermee wordt aangegeven of u verbinding maakt met een sessie en hoe lang dit geen invloed heeft op de facturering. Wat u betaalt voor de service is afhankelijk van de sessie duur, dat wil zeggen de tijd dat een server uitsluitend voor u is gereserveerd en de aangevraagde hardware-mogelijkheden (de toegewezen grootte). Als u een sessie start, maakt u vijf minuten verbinding en stopt u de sessie, zodat deze actief blijft totdat de lease verloopt, wordt u gefactureerd voor de volledige sessie lease tijd. De maximale lease tijd is daarentegen doorgaans een veiligheids-net. Het maakt niet uit of u een sessie met een lease tijd van acht uur aanvraagt en deze vervolgens vijf minuten gebruikt, als u de sessie later hand matig stopt.

De lease tijd van een sessie verlengen

U kunt de lease tijd van een actieve sessie verlengen als deze uitvalt.

Voorbeeldcode

In de volgende code ziet u een eenvoudige implementatie van het starten van een sessie, het wachten op de status gereed , verbinding maken en de verbinding verbreken en vervolgens opnieuw.

RemoteRenderingInitialization init = new RemoteRenderingInitialization();
// fill out RemoteRenderingInitialization parameters...

RemoteManagerStatic.StartupRemoteRendering(init);

SessionConfiguration sessionConfig = new SessionConfiguration();
// fill out sessionConfig details...

RemoteRenderingClient client = new RemoteRenderingClient(sessionConfig);

RenderingSessionCreationOptions rendererOptions = new RenderingSessionCreationOptions();
// fill out rendererOptions...

CreateRenderingSessionResult result = await client.CreateNewRenderingSessionAsync(rendererOptions);

RenderingSession session = result.Session;
RenderingSessionProperties sessionProperties;
while (true)
{
    var propertiesResult = await session.GetPropertiesAsync();
    sessionProperties = propertiesResult.SessionProperties;
    if (sessionProperties.Status != RenderingSessionStatus.Starting &&
        sessionProperties.Status != RenderingSessionStatus.Unknown)
    {
        break;
    }
    // REST calls must not be issued too frequently, otherwise the server returns failure code 429 ("too many requests"). So we insert the recommended delay of 10s
    await Task.Delay(TimeSpan.FromSeconds(10));
}

if (sessionProperties.Status != RenderingSessionStatus.Ready)
{
    // Do some error handling and either terminate or retry.
}

// Connect to server
ConnectionStatus connectStatus = await session.ConnectAsync(new RendererInitOptions());

// Connected!

while (...)
{
    // per frame update

    session.Connection.Update();
}

// Disconnect
session.Disconnect();

// stop the session
await session.StopAsync();

// shut down the remote rendering SDK
RemoteManagerStatic.ShutdownRemoteRendering();

Meerdere RemoteRenderingClient en RenderingSession exemplaren kunnen worden onderhouden, gemanipuleerd en uit code worden opgevraagd. Maar er kan slechts één apparaat tegelijk verbinding maken RenderingSession .

De levens duur van een virtuele machine is niet gekoppeld aan het RemoteRenderingClient exemplaar of het RenderingSession exemplaar. RenderingSession.StopAsync moet worden aangeroepen om een sessie te stoppen.

De permanente sessie-ID kan worden opgevraagd RenderingSession.SessionUuid() en lokaal in de cache worden opgeslagen. Met deze ID kan een toepassing een RemoteRenderingClient.OpenRenderingSessionAsync binding met die sessie aanroepen.

Wanneer RenderingSession.IsConnected True is, RenderingSession.Connection retourneert een exemplaar van RenderingConnection , dat de functies bevat voor het laden van modellen, het bewerken van entiteitenen het opvragen van informatie over de gerenderde scène.

API-documentatie

Volgende stappen