Snabbstart: Konvertera en modell för rendering

I Snabbstart: Rendera en modell med Unityhar du lärt dig hur du använder Unity-exempelprojektet för att rendera en inbyggd modell. Den här guiden visar hur du konverterar dina egna modeller.

Du lär dig följande:

Förutsättningar

• Fullständig snabbstart: Rendera en modell med Unity
• För konvertering med Hjälp av PowerShell-skriptet: Installera Azure PowerShell (dokumentation)
  • Öppna ett PowerShell med administratörsrättigheter
  • Köra: Install-Module -Name Az -AllowClobber

Översikt

Renderaren på servern kan inte fungera direkt med källmodellformat som FBX eller RENDERTF. I stället måste modellen ha ett egenutvecklat binärt format. Konverteringstjänsten förbrukar modeller från Azure Blob Storage och skriver konverterade modeller tillbaka till en azure blobblagringscontainer.

Du behöver:

• En Azure-prenumeration
• Ett StorageV2-konto i din prenumeration
• En bloblagringscontainer för din indatamodell
• En bloblagringscontainer för dina utdata
• En modell som ska konverteras finns i exempelmodeller
  • Se listan över källformat som stöds
  • Om du vill använda exempelkonverteringsskriptet måste du förbereda en indatamapp som innehåller modellen och alla externa beroenden (till exempel externa strukturer eller geometri)

Azure-konfiguration

Om du inte har något konto än går du till https://azure.microsoft.com/get-started/ , klickar på alternativet för kostnadsfritt konto och följer instruktionerna.

När du har ett Azure-konto går du till https://ms.portal.azure.com/#home .

Storage skapa konto

Om du vill skapa bloblagring behöver du först ett lagringskonto. Skapa en genom att klicka på knappen "Skapa en resurs":

På den nya skärmen väljer Storage på vänster sida och sedan Storage konto – blob, fil, tabell, kö från nästa kolumn:

Om du klickar på den här knappen visas följande skärm med lagringsegenskaper som du kan fylla i:

Fyll i formuläret på följande sätt:

• Skapa en ny resursgrupp från länken under listrutan och ge den namnet ARR_Tutorial
• Ange Storage ett unikt namn för namnet på kontot. Det här namnet måste vara globalt unikt, annars visas en uppmaning som informerar dig om att namnet redan har tagits. I omfånget för den här snabbstarten ger vi den namnet arrtutorialstorage. Därför måste du ersätta den med ditt namn för alla förekomster i den här snabbstarten.
• Välj en plats nära dig. Använd helst samma plats som används för att konfigurera renderingen i den andra snabbstarten.
• Prestanda inställt på "Standard"
• Typ av konto inställd på StorageV2 (generell användning v2)"
• Replikering inställd på "Read-access geo-redundant storage (RA-GRS)"
• Åtkomstnivå inställd på "Hot"

Ingen av egenskaperna på andra flikar behöver ändras, så du kan fortsätta med "Granska + skapa" och sedan följa stegen för att slutföra konfigurationen.

Webbplatsen informerar dig nu om förloppet för distributionen och rapporterar "Distributionen är klar" så småningom. Klicka på knappen "Gå till resurs" för nästa steg:

Skapa Blob Storage

Därefter behöver vi två blobcontainrar, en för indata och en för utdata.

Från knappen "Gå till resurs" ovan kommer du till en sida med en panel till vänster som innehåller en listmeny. I listan under kategorin "Blob Service" klickar du på knappen "Containrar":

Tryck på knappen "+ Container" för att skapa bloblagringscontainern för indata. Använd följande inställningar när du skapar den:

• Namn = arrinput
• Offentlig åtkomstnivå = Privat

När containern har skapats klickar du på + Container igen och upprepar med dessa inställningar för utdatacontainern:

• Namn = arroutput
• Offentlig åtkomstnivå = Privat

Nu bör du ha två bloblagringscontainrar:

Köra konverteringen

Det finns tre olika sätt att utlösa en modellkonvertering:

1. Konvertering via ARRT-verktyget

Det finns ett ui-baserat verktyg som kallas ARRT för att starta konverteringar och interagera med det renderade resultatet.

2. Konvertering via ett PowerShell-skript

För att göra det enklare att anropa tillgångskonverteringstjänsten tillhandahåller vi ett verktygsskript. Den finns i mappen Skript och kallas för Conversion.ps1.

I synnerhet det här skriptet

1. laddar upp alla filer i en viss katalog från den lokala disken till lagringscontainern för indata
2. anropar tillgångskonverteringen REST API, som hämtar data från lagringscontainern för indata och startar en konvertering, vilket returnerar ett konverterings-ID
3. avsök konverteringsstatus-API:et med det hämtade konverterings-ID:t tills konverteringsprocessen avslutas med lyckat eller misslyckat
4. hämtar en länk till den konverterade tillgången i utdatalagringen

Skriptet läser dess konfiguration från filen Scripts\arrconfig.json. Öppna JSON-filen i en textredigerare.

{
    "accountSettings": {
        "arrAccountId": "8*******-****-****-****-*********d7e",
        "arrAccountKey": "R***************************************l04=",
        "region": "<your-region>"
    },
    "renderingSessionSettings": {
        "vmSize": "standard",
        "maxLeaseTime": "1:00:00"
    },
    "assetConversionSettings": {
        "localAssetDirectoryPath": "D:\\tmp\\robot",
        "resourceGroup": "ARR_Tutorial",
        "storageAccountName": "arrexamplestorage",
        "blobInputContainerName": "arrinput",
        "inputFolderPath": "robotConversion",
        "inputAssetPath": "robot.fbx",
        "blobOutputContainerName": "arroutput",
        "outputFolderPath":"converted/robot",
        "outputAssetFileName": "robot.arrAsset"
    }
}

Konfigurationen i gruppen accountSettings (konto-ID och nyckel) ska fyllas i på samma sätt som autentiseringsuppgifterna i snabbstarten renderaen modell med Unity.

I gruppen assetConversionSettings ser du till att ändra resourceGroup, blobInputContainerName och blobOutputContainerName enligt ovan. Observera att värdet för arrtutorialstorage måste ersättas med det unika namn som du valde när du skapade lagringskontot.

Ändra localAssetDirectoryPath så att det pekar på katalogen på disken, som innehåller den modell som du tänker konvertera. Var noga med att undvika omsnedstreck (" \ ") i sökvägen med dubbla omsnedstreck (" \ \ ").

Alla data från sökvägen som anges i localAssetDirectoryPath laddas upp till blobInputContainerName-blobcontainern under en undersökväg som anges av inputFolderPath. Så i exempelkonfigurationen ovanför innehållet i katalogen "D: tmp robot" laddas upp till blobcontainern "arrinput" för lagringskontot \ \ "arrtutorialstorage" under sökvägen "robotConversion". Befintliga filer skrivs över.

Ändra inputAssetPath till sökvägen för modellen som ska konverteras – sökvägen är relativ till localAssetDirectoryPath. Använd "/" i stället för \ " som sökvägsavgränsare. Så för en "robot.fbx"-fil som finns direkt i "D: \ tmp \ robot" använder du "robot.fbx".

När modellen har konverterats skrivs den tillbaka till lagringscontainern som ges av blobOutputContainerName. Du kan ange en underökväg genom att ange den valfria outputFolderPath. I exemplet ovan kopieras resulterande "robot.arrAsset" till blobcontainern för utdata under "konverterad/robot".

Konfigurationsinställningen outputAssetFileName avgör namnet på den konverterade tillgången – parametern är valfri och utdatafilnamnet kommer att härledas från namnet på indatafilen annars.

Öppna ett PowerShell och kontrollera att du har Azure PowerShell som anges i förutsättningarna. Logga sedan in på din prenumeration med följande kommando och följ anvisningarna på skärmen:

Connect-AzAccount

Ändra till katalogen azure-remote-rendering\Scripts och kör konverteringsskriptet:

.\Conversion.ps1 -UseContainerSas

Du bör se något som liknar följande:

3. Konvertering via API-anrop

Både C# och C++-API:et ger en startpunkt för att interagera med tjänsten:

• C# RemoteRenderingClient.StartAssetConversionAsync()
• C++ RemoteRenderingClient::StartAssetConversionAsync()

Infoga ny modell i snabbstartsexempelappen

Konverteringsskriptet genererar en SAS-URI (signatur för delad åtkomst) för den konverterade modellen. Nu kan du kopiera den här URI:n som modellnamn till snabbstartsexempelappen (se Snabbstart: Rendera en modell med Unity).

Exemplet ska nu läsa in och rendera din anpassade modell!

Valfritt: Återskapa en SAS-URI

SAS-URI:en som skapades av konverteringsskriptet är endast giltig i 24 timmar. När den har upphört att gälla behöver du dock inte konvertera modellen igen. I stället kan du skapa en ny SAS i portalen enligt beskrivningen i nästa steg:

1. Gå till Azure Portal
2. Klicka på din Storage kontoresurs:
3. På följande skärm klickar du på Storage explorer i den vänstra panelen och hittar utdatamodellen (.arrAsset-filen) i bloblagringscontainern för arroutput. Högerklicka på filen och välj Hämta signatur för delad åtkomst på snabbmenyn:
4. En ny skärm öppnas där du kan välja ett förfallodatum. Tryck på Skapa och kopiera den URI som visas i nästa dialogruta. Den här nya URI:en ersätter den tillfälliga URI som skriptet skapade.

Nästa steg

Nu när du känner till grunderna kan du ta en titt på våra självstudier för att få mer djupgående kunskap.

Om du vill lära dig mer om modellkonvertering kan du kolla in modellkonverteringen REST API.