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 coinvolgenti. Unreal Engine è supportato da Deadline Cloud con mittenti, pacchetti conda e un adattatore per migliorare le prestazioni di rendering. Questa guida fornisce istruzioni dettagliate per utilizzare Deadline Cloud con Unreal Engine per rendere 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à della versione 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 l'Unreal Engine submitter, assicurati di avere quanto segue:

Installazione del mittente

Il mittente di Unreal Engine aggiunge la funzionalità Deadline Cloud come plug-in per 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 implementazione:

Creazione di una nuova istanza Windows Amazon EC2 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 mittente o l'adattatore Deadline Cloud for Unreal Engine su un computer Windows, ti consigliamo di abilitare il supporto a lungo termine di Windows. A tale scopo, segui le istruzioni nella pagina Limitazione massima del percorso dei file, ad esempio eseguendo il comando. PowerShell

Esiste anche un problema aperto sul worker agent causato da una dipendenza che non viene fornita configurata per supportare percorsi lunghi di Windows. Quando configuri i tuoi worker, segui i passaggi alternativi 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

Deadline Cloud monitor 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 desideri 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 plugin con lo script

Uno script di supporto scripts/build_plugin.py facoltativo automatizza i due passaggi successivi. Tenta di trovare l'ultima versione di Unreal, crea le dipendenze del plugin e di Python e le installa nelle posizioni corrette. Puoi sovrascrivere impostazioni come la versione Unreal. Per vedere l'elenco completo degli aiuti, 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 hai eseguito correttamente l'installazione con questo script, puoi passare a. Creare una flotta

Crea il plugin

Modifica i primi due percorsi seguenti in base a dove risiede 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 vorrai che venga chiamata 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 dell'installazione di Unreal (ad esempio,). C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService

Dipendenze in 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, regolando i percorsi dell'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, nel tuo .uplugin file (nei passaggi precedenti si potrebbe usareC:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\UnrealDeadlineCloudService.uplugin) puoi aggiungere 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 libreria e dipendenze che desideri utilizzare.

3. Se state usando la linea principale potreste avere dipendenze da Python che non sono ancora state rilasciate a PyPI: dovrete creare e installare la vostra copia locale, che può essere eseguita con hatch. Il .whl file dovrà essere modificato per riflettere la versione generata 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 submitter. Queste potrebbero non essere aggiornate rispetto al codice riportato sopra, proveniente dalla release o dal ramo mainline, e questo metodo al momento non dovrebbe essere preferito.

Notifiche di aggiornamento

Il plugin submitter verifica automaticamente la presenza di nuove versioni all'avvio di Unreal GitHub Editor. Se è disponibile un aggiornamento, una finestra di dialogo ti chiederà di visitare la pagina di rilascio.

Per disattivare le notifiche di aggiornamento, deseleziona Mostra notifiche di aggiornamento del mittente 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 sistemi Windows e non hai bisogno di configurarne uno nuovo, puoi passare aInvio di un rendering di prova.

Creazione di una flotta gestita dai servizi (SMF)

Segui la guida per l'utente delle flotte gestite dai servizi per creare una SMF se non ne hai già una. Nelle flotte gestite dai servizi (SMF), l'Unreal Engine e l'adattatore sono automaticamente disponibili utilizzando il canale conda con l'ambiente di coda predefinito. deadline-cloud Sei pronto per iniziare il rendering. Continua con la Invio di un rendering di prova pagina seguente 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 dell'Unreal Marketplace:

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

Questa sezione illustra come configurare un'istanza Amazon EC2 come worker 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 implementazione:

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 di lavoro 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 lo script:

Esiste uno script di supporto scripts/build_plugin.py che può automatizzare i passaggi di installazione rimanenti. Tenta di trovare l'ultima versione di Unreal, creare le dipendenze tra plugin e python e installarle nelle posizioni corrette. Impostazioni come la versione di Unreal da utilizzare possono essere sovrascritte. Per vedere l'elenco completo degli aiuti, esegui:

python scripts/build_plugin.py -h

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

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

Configura l'agente di lavoro 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 a. Avvio del servizio worker agent di Deadline Cloud

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 dalla filiale di rilascio GitHub, puoi semplicemente installarla con pip:

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

Se utilizzi 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 risiede 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 vorrai che venga chiamata 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 dell'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 di 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 worker agent di Deadline Cloud

Sulla tua istanza di lavoro CMF:

Gestione delle credenziali Force

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 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 fornisce la soluzione più sicura e scalabile per le implementazioni CMF e SMF.

Questa funzionalità fornisce i seguenti vantaggi:

Fase 1: Creare un segreto in Secrets Manager

Crea un segreto contenente i parametri di connessione Perforce.

Coppie chiave-valore richieste:

Esempio 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 hanno bisogno secretsmanager:GetSecretValue dell'autorizzazione per accedere al segreto. Ciò segue lo stesso schema utilizzato per la gestione dei segreti degli utenti dei job di Windows.

Per concedere l'accesso:

Variabili dell'ambiente Job

È possibile passare le credenziali di connessione all'interno dell'ambiente di lavoro in cui avviene la creazione dell'area di lavoro, ad esempio in p4_sync_smf_environment, ugs_sync_smf_environment o ambienti simili per CMF. In alternativa, create un nuovo modello di ambiente e aggiungetelo al vostro 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.

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

Aggiungi un ambiente di coda tramite CLI

Registro di Windows (solo CMF)

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

Questo approccio è adatto solo per le implementazioni 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 depot del progetto.

Pertanto, è sufficiente passare la porta a cui connettersi, se l'impostazione predefinita non è configurata sui worker. Ciò può essere ottenuto aggiungendo quanto segue nell'ambiente di lavoro o nell'ambiente di coda, in modo simile ai passaggi documentati sopra:

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

Creazione di un lavoro di rendering Perforce

Questa sezione illustra la configurazione degli asset di dati dei lavori di Perforce-integrated rendering in modo da poter inviare i lavori di Perforce-integrated rendering 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 obbligatori:

Architettura del lavoro di rendering Perforce

I lavori di rendering P4 estendono il lavoro di rendering standard con funzionalità di sincronizzazione 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:

Configurazione dei componenti del processo di rendering Perforce

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

1. Crea la risorsa dati Apply Perforce Credentials

Configura un ambiente OpenJD per recuperare le credenziali 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 l'area di lavoro dopo il rendering.

Passaggi di configurazione:

3. Crea una risorsa di dati ambientali Perforce Launch UE

Configura un ambiente OpenJD per il lancio di Unreal Engine con l'integrazione di Perforce. Questo fa automaticamente riferimento all'area di lavoro Perforce creata dall'ambiente di sincronizzazione.

Fasi di configurazione:

4. Crea una risorsa di dati Perforce Render Step

Imposta una fase di rendering di OpenJD per l'esecuzione del processo di rendering.

Fasi di configurazione:

5. Crea una risorsa di dati del processo di rendering Perforce

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

Fasi di configurazione:

Best practice

Pre-submission lista di controllo

Ottimizzazione delle prestazioni

Configurazione della dimensione del blocco:

Considerate le seguenti ottimizzazioni aggiuntive:

Monitoraggio e debug

Risoluzione dei problemi

Problemi e soluzioni comuni

Fasi di debug

Requisiti di host personalizzati

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

Panoramica di

I requisiti dell'host definiscono quale flotta è idonea 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 Host Requirements

Fase 2: Caricare 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 di attributo personalizzati

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

Fase 6: Visibilità in MRQ (opzionale)

Ogni immissione del requisito ha un'icona a forma di occhio.

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

Fase 7: Allegare 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 Host Requirements, 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 dei lavoratori. 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 gestita 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 mittente integrato di Unreal Engine. L'adattatore mantiene la corretta gestione delle dipendenze e supporta un rendering efficiente in più riprese senza riavviare Unreal Engine.

Risorse open source

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