Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Motore epico Unreal

Unreal Engine è uno strumento di creazione 3D in tempo reale per immagini fotorealistiche ed esperienze immersive. Unreal Engine è supportato da Deadline Cloud con submitter, pacchetti conda e un adattatore per migliorare le prestazioni di rendering. Questa guida fornisce istruzioni dettagliate per utilizzare Deadline Cloud con Unreal Engine per renderizzare più velocemente i progetti Movie Render Queue distribuendo le attività di rendering su più macchine.

Panoramica del supporto

Unreal Engine è supportato dai seguenti componenti:

Compatibilità delle versioni di Unreal Engine

La tabella seguente mostra gli attuali livelli di supporto per le versioni di Unreal Engine:

Canale Deadline Cloud Conda

La tabella seguente elenca tutti i pacchetti conda applicabili a Unreal Engine disponibili per le Service-managed flotte nel canale conda: deadline-cloud

Nozioni di base

Prerequisiti

Prima di installare il submitter di Unreal Engine, assicurati di avere quanto segue:

Installazione del mittente

Il submitter di Unreal Engine aggiunge la funzionalità Deadline Cloud come plug-in a Unreal Engine, consentendoti di inviare i lavori di Movie Render Queue direttamente a Deadline Cloud per il rendering.

Scelta della filiale

Seleziona la filiale appropriata per la tua distribuzione:

Creazione di una nuova istanza Amazon EC2 di Windows su cui installare Unreal (opzionale)

Se stai configurando una nuova istanza Windows Amazon Elastic Compute Cloud (Amazon EC2) come mittente, un'istanza g5.2xlarge con 200 GB di spazio di archiviazione è un minimo ragionevole:

Percorsi lunghi di Windows

Molti dei passaggi seguenti possono creare file che superano la lunghezza massima del percorso predefinita di Windows. Prima di creare e installare il trasmettitore o l'adattatore Deadline Cloud for Unreal Engine su un computer Windows, ti consigliamo di abilitare il supporto per i percorsi lunghi di Windows. A tale scopo, segui le istruzioni nella pagina Limitazione massima del percorso dei file, ad esempio eseguendo il comando. PowerShell

C'è anche un problema aperto sul worker agent causato da una dipendenza che non viene fornita configurata per supportare i percorsi lunghi di Windows. Quando configuri i tuoi worker, segui i passaggi per la soluzione alternativa indicati nel problema collegato per supportare completamente i percorsi lunghi di Windows fino alla risoluzione del problema.

Installazione degli strumenti di compilazione

Il plugin Unreal submitter attualmente deve essere compilato localmente.

Installazione del monitor Deadline Cloud

Il monitor Deadline Cloud viene utilizzato sia per gestire le credenziali per l'invio di lavori a Deadline Cloud sia per monitorare lo stato dei lavori.

Configurazione dell'ambiente

Installazione del software Deadline Cloud

Clona o scarica deadline-cloud-for-unreal-engine dal ramo di rilascio o dalla linea principale, a seconda che tu voglia la versione testata più recente o tutti i commit più recenti.

git clone https://github.com/aws-deadline/deadline-cloud-for-unreal-engine.git
cd deadline-cloud-for-unreal-engine
git switch release

Facoltativo: crea e installa il plug-in con script

scripts/build_plugin.pyFacoltativamente, uno script di supporto automatizza i due passaggi successivi. Tenta di trovare l'ultima versione di Unreal, crea il plugin e le dipendenze di Python e li installa nelle posizioni corrette. Puoi sovrascrivere impostazioni come la versione Unreal. Per visualizzare l'elenco completo della guida, esegui:

python scripts/build_plugin.py -h

Per creare e installare la tua copia attuale di deadline-cloud-for-unreal-engine come mittente con l'ultima installazione di Unreal Engine, esegui:

python scripts/build_plugin.py --install

Se l'installazione con questo script è avvenuta correttamente, puoi passare a. Creare una flotta

Crea il plugin

Modifica i primi due percorsi seguenti in base a dove si trova l'installazione di Unreal e a dove l'hai installatadeadline-cloud-for-unreal-engine.

Dalla cartella Unreal Install Batchfiles (il package parametro può essere qualsiasi nuova directory, tuttavia ti consigliamo di richiamarla in seguito): UnrealDeadlineCloudService

cd C:\Program Files\Epic Games\UE_5.5\Engine\Build\BatchFiles
runuat.bat BuildPlugin -plugin="C:\deadline\deadline-cloud-for-unreal-engine\src\unreal_plugin\UnrealDeadlineCloudService.uplugin" -package="C:\UnrealDeadlineCloudService"

Copia la cartella «package» qui sopra nella cartella Plugins della tua installazione di Unreal (ad esempio,). C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService

Dipendenze Python

Esistono 4 modi per installare le dipendenze Python richieste.

1. Se hai creato e installato il plugin dal ramo di rilascio precedente, puoi installarlo da pip. Usa il seguente comando di installazione, modificando i percorsi della tua installazione di Unreal:

"C:\Program Files\Epic Games\UE_5.5\Engine\Binaries\ThirdParty\Python3\Win64\python" -m pip install deadline-cloud-for-unreal-engine --target "C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\Content\Python\libraries"

2. In alternativa, puoi aggiungere nel tuo .uplugin file (nei passaggi precedentiC:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\UnrealDeadlineCloudService.uplugin) una PythonRequirements sezione che corrisponda all'ultima versione di deadline-cloud-for-unreal-engine in GitHub/PyPI, ad esempio:

"PythonRequirements":
[
    {
        "Platform": "All",
        "Requirements":
        [
            "deadline-cloud-for-unreal-engine>=0.5.0"
        ]
    }
]

Potresti voler disattivare la funzione «strict hash» nelle impostazioni Python di Unreal o aggiungere impostazioni hash per specifiche versioni di librerie e dipendenze che desideri utilizzare.

3. Se state utilizzando la versione principale potreste avere delle dipendenze Python che non sono ancora state rilasciate su PyPI: dovrete creare e installare la vostra copia locale, operazione che può essere eseguita con hatch. Il .whl file dovrà essere modificato per riflettere la versione emessa da hatch build:

pip install hatch
hatch build
"C:\Program Files\Epic Games\UE_5.5\Engine\Binaries\ThirdParty\Python3\Win64\python" -m pip install dist\deadline_cloud_for_unreal_engine-0.2.2.post21-py3-none-any.whl --target "C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\Content\Python\libraries"

4. Infine, le dipendenze Python possono essere installate dal programma di installazione del mittente. Queste potrebbero non essere aggiornate rispetto al codice riportato sopra nella release o nel ramo principale e questo metodo al momento non dovrebbe essere preferito.

Notifiche di aggiornamento

Il plug-in submitter verifica automaticamente le versioni più recenti all'avvio di Unreal GitHub Editor. Se è disponibile un aggiornamento, una finestra di dialogo ti chiederà di visitare la pagina delle versioni.

Per disattivare le notifiche di aggiornamento, deseleziona Mostra notifiche di aggiornamento agli inviatori in Impostazioni generali nel pannello delle impostazioni di Deadline Cloud (Modifica > Impostazioni del progetto > Plugin > Deadline Cloud).

In alternativa, puoi usare la CLI:

deadline config set settings.submitter_update_notification false

Per riattivare:

deadline config set settings.submitter_update_notification true

Creare una flotta

Se disponi già di un parco macchine Windows e non hai bisogno di configurarne uno nuovo, puoi passare direttamente aInvio di un rendering di prova.

Creazione di un parco veicoli gestito dai servizi (SMF)

Segui la guida per l'utente delle flotte gestite dai servizi per creare un SMF se non ne hai già uno. Sulle flotte gestite da servizi (SMF), l'Unreal Engine e l'adattatore sono automaticamente disponibili utilizzando il canale conda con l'ambiente di coda predefinito. deadline-cloud https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-queue-environment.html#conda-queue-environment Sei pronto per iniziare il rendering. Continuate con Invio di un rendering di prova quanto segue per inviare un lavoro di rendering di prova.

Creazione di una flotta gestita dal cliente (CMF)

Invio di un rendering di prova

Questo esempio utilizza la demo di Meerkat di Unreal Marketplace:

Configurazione di un addetto alla flotta gestito dal cliente (CMF)

Questa sezione illustra come configurare un'istanza Amazon EC2 come lavoratore CMF per Deadline Cloud con Unreal Engine.

Panoramica di

Di seguito sono riportate le principali differenze tra CMF e SMF:

Scelta della filiale

Seleziona la filiale appropriata per la tua distribuzione:

Configurazione dell'istanza Amazon EC2

Di seguito è riportata la configurazione dell'istanza consigliata:

Installazione del software

1. Installa Unreal Engine:

2. Installa i driver NVIDIA GRID:

Installazione degli strumenti di compilazione

Il plugin Unreal attualmente deve essere compilato localmente.

Installazione del software Deadline Cloud

Clona o scarica deadline-cloud-for-unreal-engine dal ramo di rilascio o dalla linea principale. Assicurati che la tua versione worker delle librerie sia compatibile con la versione utilizzata dai mittenti.

git clone https://github.com/aws-deadline/deadline-cloud-for-unreal-engine.git
cd deadline-cloud-for-unreal-engine
git switch release

Facoltativo: crea e installa plugin e dipendenze con script:

Esiste uno script di supporto in grado di automatizzare scripts/build_plugin.py i passaggi di installazione rimanenti. Tenta di trovare l'ultima versione di Unreal, creare le dipendenze del plugin e di Python e installarle nelle posizioni corrette. È possibile sovrascrivere impostazioni come la versione Unreal da utilizzare. Per visualizzare l'elenco completo della guida, esegui:

python scripts/build_plugin.py -h

Per creare e installare la tua copia attuale di deadline-cloud-for-unreal-engine as a worker con l'ultima installazione di Unreal Engine, esegui:

python scripts/build_plugin.py --install --worker

Configura l'agente worker di Deadline Cloud eseguendo:

install-deadline-worker ^
  --farm-id FARM_ID ^
  --fleet-id FLEET_ID ^
  --region REGION ^
  --allow-shutdown

Se hai installato con questo script e configurato correttamente il worker agent, puoi passare aAvvio del servizio Deadline Cloud worker agent.

python -m pip install deadline-cloud-worker-agent

È necessario installare la versione corretta dell'adattatore a seconda della versione del mittente utilizzata. Se stai usando la versione del mittente del ramo release in GitHub, puoi semplicemente installarla con pip:

python -m pip install deadline-cloud-for-unreal-engine

Se stai usando la versione principale o una versione personalizzata in fase di sviluppo del mittente, per evitare problemi di compatibilità, ti consigliamo di compilare e installare dalla stessa versione di codice o di trasferire il file dalla build del mittente: .whl

pip install hatch
hatch build
python -m pip install dist\my-built-wheel.whl

Creazione del plugin

Modifica i primi due percorsi seguenti in base a dove si trova l'installazione di Unreal e a dove l'hai installatadeadline-cloud-for-unreal-engine.

Dalla cartella Unreal Install Batchfiles (il package parametro può essere qualsiasi nuova directory, tuttavia ti consigliamo di richiamarla in seguito): UnrealDeadlineCloudService

cd C:\Program Files\Epic Games\UE_5.5\Engine\Build\BatchFiles
runuat.bat BuildPlugin -plugin="C:\deadline\deadline-cloud-for-unreal-engine\src\unreal_plugin\UnrealDeadlineCloudService.uplugin" -package="C:\UnrealDeadlineCloudService"

Copia la cartella «package» qui sopra nella cartella Plugins della tua installazione di Unreal (ad esempio,). C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService

pywin32

La versione di Python di Unreal avrà bisogno di pywin32. Installazione Pip utilizzando una copia dell'installazione Python di terze parti di Unreal:

"C:\Program Files\Epic Games\UE_5.5\Engine\Binaries\ThirdParty\Python3\Win64\python" -m pip install pywin32

Avvio del servizio Deadline Cloud worker agent

Sulla tua istanza di lavoro CMF:

Gestione delle credenziali Perforce

Questa sezione tratta la gestione sicura delle credenziali per l'integrazione di Perforce con i lavoratori di Deadline Cloud.

Panoramica di

Esistono diversi approcci per configurare le credenziali di Perforce per i lavoratori di Deadline Cloud. Ogni metodo ha implicazioni di sicurezza e casi d'uso diversi:

Nozioni di base sulle credenziali P4

Per recuperare le impostazioni di connessione, inclusi l'URL e la porta del server Perforce, il nome utente e la password, Perforce segue la seguente priorità:

Con queste priorità, se hai la seguente configurazione:

La connessione Perforce risultante sarà:

Port = ssl:perforce.from.env:1666
User = user.from.registry
Password = password.from.connection

Secrets Manager (consigliato)

Secrets Manager offre la soluzione più sicura e scalabile per le implementazioni CMF e SMF.

Questa funzionalità fornisce i seguenti vantaggi:

Fase 1: Crea un segreto in Secrets Manager

Crea un segreto contenente i parametri di connessione di Perforce.

Coppie chiave-valore richieste:

Esempio di segreto:

{
   "P4PORT": "ssl:your-perforce-server.com:1666",
   "P4USER": "your-perforce-username",
   "P4PASSWD": "your-perforce-password"
}

Per creare il segreto:

Fase 2: concedere al lavoratore l'accesso al segreto

I lavoratori devono avere secretsmanager:GetSecretValue il permesso di accedere al segreto. Questa procedura segue lo stesso schema utilizzato per la gestione dei segreti utente delle attività di Windows.

Per concedere l'accesso:

Variabili dell'ambiente di lavoro

È possibile passare le credenziali di connessione all'interno dell'ambiente di lavoro in cui avviene la creazione dello spazio di lavoro, ad esempio in p4_sync_smf_environment, ugs_sync_smf_environment o ambienti simili per CMF. https://github.com/aws-deadline/deadline-cloud-for-unreal-engine/blob/mainline/src/unreal_plugin/Content/Python/openjd_templates/ugs/ugs_sync_smf_environment.yml In alternativa, crea un nuovo modello di ambiente e aggiungilo al tuo lavoro.

name: P4Credentials
variables:
  P4PORT: ssl:my-perforce.com:1666
  P4USER: j.doe
  P4PASSWD: MyVeRyS3cretP4ssW0rd

Questo approccio presenta i seguenti rischi per la sicurezza:

Variabili di ambiente di coda

Secondo la guida per l'utente di Deadline Cloud, puoi utilizzare gli ambienti di coda per fornire applicazioni software, variabili di ambiente e altre risorse ai lavori in coda. Gli esempi di ambiente di coda sono disponibili nella cartella queue_environments in deadline-cloud-samples. https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/queue_environments

Aggiungi un ambiente di coda utilizzando il monitor o la console Deadline Cloud

Aggiungi un ambiente di coda usando la CLI

Registro di Windows (solo CMF)

Il registro di Windows fornisce l'archiviazione locale delle credenziali sui computer di lavoro. Questo metodo utilizza il sistema di priorità standard Perforce in cui le credenziali sono archiviate in:

Questo approccio è adatto solo per le distribuzioni CMF in cui è possibile accedere direttamente alla configurazione delle macchine di lavoro.

Pre-configured utente amministratore (solo CMF)

Crea un utente P4 dedicato per i nodi di rendering con una connessione senza scadenza per eliminare la necessità di passare dati segreti come nomi utente e password. In questo caso, è possibile utilizzare un singolo utente P4 dedicato per connettersi a tutti i server P4, inclusi i server Commit (Master) ed Edge in cui è accessibile il deposito del progetto.

Pertanto, è sufficiente passare la porta a cui connettersi, se l'impostazione predefinita non è configurata sui worker. È possibile passare la porta aggiungendo quanto segue in un ambiente di lavoro o in un ambiente di coda simile ai passaggi documentati sopra:

name: P4Sync
variables:
  P4PORT: ssl:my-perforce.com:1666

Creazione di un lavoro di rendering in Perforce

Questa sezione illustra come configurare le risorse di dati dei lavori di Perforce-integrated rendering in modo da Perforce-integrated poterli inviare a Deadline Cloud da Unreal Engine.

Prerequisiti

Prima di inviare un lavoro Movie Render Queue (MRQ) da Unreal Engine in un repository Perforce:

Configurazione del progetto Unreal:

Configurazione Deadline Cloud:

Requisiti Perforce:

Architettura del lavoro di rendering Perforce

I lavori di rendering P4 estendono il lavoro di rendering standard con le funzionalità di sincronizzazione di Perforce:

Deadline Cloud Perforce render job
├── Environments
│   ├── Apply Perforce Credentials from Secrets Manager
│   ├── Sync Perforce Environment (CMF/SMF)
│   │   └── Initializes Perforce workspace and syncs repository on workers
│   └── Launch UE Environment
│       └── Starts Unreal Engine with Perforce workspace paths
└── Steps
    └── Render Step
        └── Executes Movie Render Queue process

Principali differenze rispetto ai lavori standard:

Come si ridimensiona la sincronizzazione di Perforce per i progetti di produzione

I progetti Unreal Engine di produzione possono raggiungere centinaia di gigabyte su decine di migliaia di file. L'Perforceintegrazione mantiene il tempo di sincronizzazione proporzionale a ciò che è cambiato piuttosto che alle dimensioni del progetto:

Per trarre vantaggio dal riutilizzo dello spazio di lavoro del cliente su una flotta gestita dal servizio, abilita lo storage persistente in modo che il volume contenente lo spazio di lavoro sincronizzato venga ricollegato ai lavoratori futuri.

Se il percorso di rete tra la regione della flotta e il Perforce server ha un throughput basso o una latenza elevata, un server Perforce perimetrale nella regione del parco veicoli può fungere da cache regionale per i dati di deposito. Per ulteriori informazioni, consulta il controllo del codice sorgente di Perforce nella Deadline Cloud Developer Guide.

Configurazione dei componenti del lavoro di rendering di Perforce

Segui questi passaggi per creare le risorse di dati richieste per i lavori di Perforce-integrated rendering.

1. Crea una risorsa di dati Apply Perforce Credentials

Configura un ambiente OpenJD per recuperare le credenziali di Perforce da Secrets Manager e applicarle alla connessione Perforce.

Fasi di configurazione:

2. Crea una risorsa di dati dell'ambiente di sincronizzazione Perforce

Configura un ambiente OpenJD per creare uno spazio di lavoro Perforce, sincronizzare i file dal server Perforce e ripulire lo spazio di lavoro dopo il rendering.

Fasi di configurazione:

3. Crea una risorsa di dati di ambiente Perforce Launch UE

Configura un ambiente OpenJD per il lancio di Unreal Engine con l'integrazione di Perforce. Questo fa riferimento automaticamente allo spazio di lavoro Perforce creato dall'ambiente di sincronizzazione.

Fasi di configurazione:

4. Crea una risorsa di dati della fase di rendering di Perforce

Imposta una fase di rendering OpenJD per eseguire il processo di rendering.

Fasi di configurazione:

5. Crea una risorsa di dati per il lavoro di rendering di Perforce

Configura un processo di rendering OpenJD che orchestra l'intero flusso di lavoro di rendering.

Fasi di configurazione:

Invio degli output di rendering a Perforce

Per impostazione predefinita, un processo di Perforce rendering carica gli output solo tramite gli allegati del lavoro. Il parametro SubmitMode job consente Perforce invece di inviare gli output renderizzati, in modo che i frame finiti arrivino nel deposito insieme al progetto.

Solo i file che sono stati modificati dopo l'ultima sincronizzazione finiscono nell'elenco delle modifiche. Ogni operazione riconcilia esattamente i file prodotti e l'integrazione ripristina i file il cui contenuto è identico alla revisione del depot, quindi il nuovo rendering di un frame invariato non produce alcuna voce nell'elenco delle modifiche.

Configura i tuoi dipendenti in modo che si autentichino con lo stesso Perforce utente per tutte le attività di un lavoro, poiché la fase di aggregazione trova gli scaffali delle attività in base al proprietario. Perforce L'impostazione consigliata delle credenzialiGestione delle credenziali Perforce, un singolo segreto condiviso in Secrets Manager, soddisfa già tale requisito.

Best practice

Pre-submission lista di controllo

Ottimizzazione delle prestazioni

La tabella seguente mostra in che modo l'ShotsPerTaskimpostazione influisce sulle prestazioni:

Considerate le seguenti ottimizzazioni aggiuntive:

Monitoraggio e debug

Risoluzione dei problemi

Problemi e soluzioni comuni

Fasi di debug

Requisiti host personalizzati

Questa sezione descrive come creare e utilizzare requisiti host personalizzati per il rendering di Deadline Cloud in Unreal Engine.

Panoramica di

I requisiti degli host definiscono quale parco macchine è idoneo a eseguire una particolare fase di rendering. Sono archiviati all'interno di una UDeadlineCloudHostRequirements risorsa, a cui fa poi riferimento una DeadlineCloudRenderStep risorsa.

Fase 1: Creare la risorsa relativa ai requisiti dell'host

Passaggio 2: carica il modello YAML predefinito

Questo carica requisiti di base come CPU, memoria, GPU, sistema operativo e architettura.

Fase 3: Configurazione dei requisiti di base (di sistema)

Se Max = 0, non esiste un limite massimo per tale requisito.

Fase 4: Aggiungere requisiti di importo personalizzati

Utilizzato quando il requisito è numerico (ad esempio, numero di licenze, limiti di concorrenza).

Fase 5: Aggiungere requisiti per gli attributi personalizzati

Utilizzato per filtrare i lavoratori in base a tag ed etichette.

Fase 6: Visibilità in MRQ (opzionale)

Ogni voce relativa ai requisiti è contrassegnata da un'icona a forma di occhio.

Questa impostazione è utile per semplificare l'interfaccia utente per gli artisti preservando i vincoli tecnici.

Fase 7: Allega i requisiti a una fase di rendering

Tutti gli invii MRQ che utilizzano questo passaggio ora applicano la logica di selezione dell'host.

Riepilogo

Utilizzando la risorsa relativa ai requisiti dell'host, puoi:

Questa configurazione migliora la coerenza del routing dei lavori e garantisce che il rendering avvenga sull'hardware corretto.

Configurazioni avanzate.

Service-managed flotte e flotte gestite dai clienti

Service-managed flotte (SMF)

Nelle flotte gestite dai servizi, l'Unreal Engine e l'adattatore sono automaticamente disponibili utilizzando il canale deadline-cloud conda con l'ambiente di coda predefinito. Questa configurazione offre l'esperienza più semplice.

Customer-managed flotte (CMF)

Per le flotte gestite dai clienti, Unreal Engine e l'adattatore devono essere installati manualmente sugli host di lavoro. Questa configurazione offre un maggiore controllo e supporta funzionalità aggiuntive come l'integrazione con Perforce. Per istruzioni dettagliate, vedi Configurazione di un addetto alla flotta gestito dal cliente (CMF).

Funzionalità di rendering di Unreal Engine

Il sistema di rendering di Unreal Engine fornisce un supporto completo per:

Tutte le funzionalità di rendering vengono rilevate e configurate automaticamente dal submitter integrato di Unreal Engine. L'adattatore mantiene una corretta gestione delle dipendenze e supporta un efficiente rendering multi-shot senza riavviare Unreal Engine.

Risorse open source

Il mittente e l'adattatore sono open source e disponibili su: GitHub