Il Gestore degli Asset, accessibile dal menu Finestra di Studio o dalla scheda Home, ti consente di gestire luoghi e importare in massa asset nel tuo gioco, tra cui immagini, mesh, pacchetti, audio e modelli.
Corrente
Le seguenti sezioni descrivono il Gestore degli Asset attuale. Il V2 Beta è documentato di seguito.
Cartelle asset
Gli asset sono organizzati all'interno di cartelle in base al loro tipo. Puoi passare dalla visualizzazione a griglia alla visualizzazione a elenco facendo clic sul pulsante di commutazione della visualizzazione.
Importazione degli asset
Lo strumento legacy di importazione in massa è ideale per importare fino a 50 file in un solo lotto. Gli asset importati entrano nella coda di moderazione e sono visibili solo per te all'interno della rispettiva cartella e nella scheda Inventario dell'Toolbox. Questo strumento di importazione in massa è disponibile solo nella versione attuale del Gestore degli Asset. L'ultima versione del Gestore degli Asset utilizza l'Importatore.
| Tipo di Asset | Dettagli |
|---|---|
| Immagine | Puoi importare immagini in formato .png, .jpg, .gif, .tga o .bmp da utilizzare come texture/decalcomanie su parti, etichette immagine, texture mesh, texture per materiali personalizzati, texture per effetti speciali e altro ancora. |
| Mesh | Puoi importare in massa mesh in formato .fbx o .obj, anche se questo flusso di lavoro non supporta mesh complesse come quelle con rigging, skinning o dati di animazione. Per mesh complesse, si consiglia di utilizzare l'Importatore. |
| Audio | Puoi importare asset audio di cui sei certo di avere il permesso di utilizzare nei formati .ogg, .mp3, .flac o .wav. Se non sei sicuro di avere il permesso di utilizzare un file audio, il Creator Store ha una varietà di audio liberi da utilizzare, inclusi oltre 100.000 asset audio prodotti professionalmente. Vedi Asset Audio per dettagli. |
Inserisci asset
Puoi inserire asset nella gerarchia della finestra Explorer trascinando e rilasciando o facendo clic con il tasto destro sul nome/tile dell'asset e selezionando Inserisci.
Il comportamento di trascinamento e rilascio nel viewport 3D varia a seconda del tipo di asset:
| Tipo di Asset | Comportamento Drag-and-Drop |
|---|---|
| Immagine | Se si sovrappone a un oggetto padre valido come BasePart, crea un nuovo Decal all'interno di quel padre con la sua proprietà ColorMapContent impostata all'ID asset. |
| Mesh | Inserisce l'asset come un nuovo MeshPart nel workspace con la sua proprietà MeshId impostata all'ID asset. |
| Audio | Crea un nuovo oggetto Sound nel workspace con la sua proprietà SoundId impostata all'ID asset. |
| Pacchetto | Inserisce una copia del pacchetto nel workspace. |
Azioni rapide
Le azioni rapide sono accessibili facendo clic con il tasto destro sul nome/tile di un asset e selezionando un'opzione contestuale.
| Azione Rapida | Descrizione |
|---|---|
| Rinomina | Consente di inserire un nuovo nome per il luogo. |
| Copia ID negli Appunti | Copia l'ID del luogo negli appunti. |
| Visualizza Cronologia | Si apre la cronologia delle versioni del luogo, consentendoti di visualizzare le precedenti modifiche (azioni di pubblicazione) e la loro data/ora. Se desideri, puoi tornare a una versione precedente selezionandola e facendo clic sul pulsante Apri. |
| Rimuovi dal Gioco | Rimuove completamente il luogo dal gioco. Non applicabile al luogo iniziale. |
Ispezione degli asset
Puoi ispezionare attentamente un'immagine, una mesh, un pacchetto o un file audio sovrapponendoti alla sua miniatura in visualizzazione a griglia e facendo clic sull'icona di "ingrandimento", o facendo clic con il tasto destro sul suo nome in visualizzazione a elenco e selezionando Anteprima Asset.
Quando si visualizzano anteprime di asset 3D come le mesh, puoi spostare la camera virtuale per ottenere una migliore vista da tutti gli angoli. Per i video, puoi visualizzare l'intero video nel popup.
| Azione | Descrizione |
|---|---|
| Click sinistro + trascina | Ruota attorno all'oggetto. |
| Click destro + trascina | Pan a sinistra, destra, sopra o sotto. |
| Rotella del mouse | Ingrandisci o rimpicciolisci. |
Nell'angolo in basso a destra del riquadro di anteprima, il pulsante composizione rivela l'intera gerarchia dell'asset, inclusi Scripts, MeshParts, Animations e altro.
V2 Beta
Ordinamento inventario
Gli asset sono ordinati per vari inventari come selezionato tramite il menu a scomparsa sul lato sinistro della finestra. Se non vedi l'elenco di ordinamento, fai clic sul pulsante di espansione/contrazione nell'area in basso a sinistra della finestra.
<Nome dell'Esperienza> — L'inventario del gioco aperto, visualizzato con il suo nome, con asset condivisi con il gioco elencati sotto Progetto.
Luoghi Nell'Esperienza — I luoghi del gioco.
Il Mio Inventario — Asset importati nel tuo account utente, condivisi con te, o acquisiti dal Creator Store.
Inventari di Gruppo — Asset importati nei gruppi che possiedi o ai gruppi a cui appartieni (supponendo tu abbia sufficienti permessi all'interno del gruppo), o asset condivisi con i gruppi. Facendo clic con il tasto destro su un gruppo si rivela un menu contestuale con le seguenti opzioni:
Nascondi Gruppo Nasconde il gruppo dalla barra laterale. Personalizza Gruppi Consente di scegliere i gruppi che compaiono nella barra laterale e nelle opzioni di filtro di ricerca. Aggiorna Gruppi Aggiorna l'elenco dei gruppi che sei idoneo a mostrare o nascondere.
Cartelle
Le cartelle ti permettono di organizzare asset e altre cartelle in una gerarchia all'interno di un inventario. Puoi creare cartelle all'interno di Il Mio Inventario, all'interno di Inventari di Gruppo che supportano operazioni di cartella, e all'interno dell'inventario di un gioco aperto sotto Progetto.
Le cartelle hanno i seguenti limiti:
- Fino a 50.000 cartelle per account o inventario radice.
- Fino a 100 cartelle figlie in qualsiasi cartella o inventario radice.
- Fino a 20.000 asset per cartella.
- Fino a 20 livelli di annidamento delle cartelle.
La prima volta che le cartelle sono inizializzate per un account, potrebbe essere necessario un breve periodo di configurazione. Se le operazioni delle cartelle non sono ancora disponibili, la barra laterale mostra un'icona di avviso accanto all'account interessato; fai clic su di essa per aggiornare la prontezza. La configurazione di solito si completa entro pochi minuti.
Crea, rinomina ed elimina
Fai clic con il tasto destro nel pannello laterale o nella vista principale per accedere alle azioni delle cartelle.
| Azione | Descrizione |
|---|---|
| Crea Cartella | Consente di creare una nuova cartella vuota nella posizione attuale. Appare una nuova voce con un campo nome inline; digita un nome e premi Invio per confermare o Esc per annullare. |
| Raggruppa Selezione come Cartella | Disponibile quando uno o più asset sono selezionati. Crea una nuova cartella e sposta gli asset selezionati all'interno. |
| Rinomina | Sostituisce il nome della cartella con un campo modificabile inline precompilato con il nome attuale. Premi Esc per annullare senza confermare le modifiche. |
| Elimina Cartella | Rimuove la cartella. Le cartelle devono essere vuote prima di poter essere eliminate; sposta o elimina prima i contenuti. Quando sono selezionate più cartelle vuote, il menu mostra Elimina Cartelle. |
I nomi delle cartelle non possono contenere \, /, :, *, ?, ", <, > o |, e non possono terminare con un punto. I nomi che iniziano con un punto (ad esempio, .nascosto) sono consentiti.
Naviga
Puoi navigare nella gerarchia delle cartelle da entrambi i pannelli:
- Barra Laterale — Usa la freccia di espansione per rivelare le sotto-cartelle, o fai clic singolarmente su una cartella per aprirla.
- Vista Principale — Fai doppio clic su una cartella per accedervi. Fai clic sulla voce padre nella barra laterale, o usa la freccia indietro, per tornare indietro.
Sposta elementi
Puoi spostare sia asset che cartelle, ma solo all'interno dello stesso inventario. I trasferimenti tra inventari (ad esempio, da Il Mio Inventario a un inventario di gruppo) non sono supportati.
| Metodo | Descrizione |
|---|---|
| Trascina e rilascia | Trascina gli elementi selezionati su una cartella di destinazione nella vista principale o nell'albero della barra laterale. I validi target di rilascio si evidenziano mentre ci sopra. |
| Dialogo di spostamento | Fai clic con il tasto destro su una selezione e scegli Sposta per aprire un selettore di cartelle. Usa la freccia di accesso o il doppio click per entrare in una cartella, Indietro per tornare a un livello superiore, quindi seleziona una destinazione e fai clic su Sposta. Aggiorna recupera nuovamente l'elenco delle cartelle dal server. |
Puoi spostare più elementi contemporaneamente. Spostare una cartella al suo interno o in una delle sue discendenti è bloccato, e destinazioni non valide non sono evidenziate come target di rilascio o sono grigiate nel dialogo di Sposta.
Ricerca e cartelle
Quando digiti una query di ricerca, i risultati includono una sezione Cartelle separata con elenchi di cartelle corrispondenti accanto ai risultati degli asset. Fai doppio clic su un risultato di cartella per uscire dalla modalità di ricerca e navigare in quella cartella.
Il drag-and-drop e il dialogo di Sposta sono disabilitati mentre visualizzi i risultati di ricerca. Naviga prima in una cartella o in un inventario, poi riorganizza.
Scopi non supportati
Le operazioni sulle cartelle non sono disponibili nelle seguenti visualizzazioni:
- Luoghi Nell'Esperienza — I luoghi non possono essere organizzati in cartelle.
- Caricamenti Recenti — In sola lettura per scopi organizzativi.
Opzioni di visualizzazione degli asset
Nel pannello principale, gli asset per l'inventario selezionato vengono visualizzati. Per alternare il tipo di visualizzazione, fai clic sul pulsante tipo di visualizzazione e seleziona Elenco o Griglia. Mentre sei in visualizzazione a griglia, le tessere degli asset possono essere ridimensionate tramite il widget cursore.
In visualizzazione Elenco, fai clic su un'intestazione di colonna per ordinare gli asset in base a quel dettaglio e ridimensiona le colonne trascinando la barra di separazione tra di esse.
Le colonne possono essere attivate o disattivate facendo clic con il tasto destro nella regione della barra di intestazione. Anche se le colonne non possono essere riordinate trascinandole, puoi disattivare qualsiasi colonna e poi riattivarla per aggiungerla come ultima colonna a destra.
Nella visualizzazione Griglia, l'ordinamento è controllato tramite il pulsante ordina:
Filtri per tipo di asset
Il pulsante filtra elementi ti consente di controllare quali asset vengono visualizzati.
| Tipo di Filtro | Opzioni |
|---|---|
| Tipo di Asset | Animazione | Audio | Decal | FontFamily | Immagine | Mesh | MeshPart | Modello | Luogo | Plugin | Video |
| Creatore | |
| Fonte | Creator Store | Condiviso con me | Caricato |
| È un Pacchetto | |
| Solo Archiviati |
Importazione di asset
Il pulsante importa asset ti consente di importare uno o più asset di qualsiasi tipo. Gli asset importati entrano nella coda di moderazione e, una volta approvati, vengono aggiunti all'inventario dell'utente/gruppo che possiede il gioco.
Per ulteriori informazioni sui tipi di file supportati e altre funzionalità, vedere Importatore.
Inserisci e azioni rapide
Le azioni rapide sono accessibili facendo clic con il tasto destro sul nome/tile di un asset e selezionando un'opzione dal menu contestuale. Si noti che i luoghi offrono azioni uniche rispetto ad altri asset.
| Azione | Descrizione |
|---|---|
| Inserisci | Ti consente di scegliere tra Inserisci in Camera o Inserisci in Posizione Asset per asset 3D spaziali (asset non spaziali come l'audio vengono semplicemente inseriti nel Workspace o nell'istanza Explorer attualmente selezionata). Non appare per asset FontFamily o Plugin. |
| Modifica Asset | Si apre la finestra di configurazione dell'asset per modificare dettagli come il titolo dell'asset, la descrizione e altro. Non appare per asset FontFamily o Plugin. |
| Sposta | Si apre il dialogo di spostamento per spostare l'asset in una cartella all'interno dello stesso inventario. Disabilitato mentre visualizzi i risultati di ricerca. |
| Copia ID Asset | Copia l'ID dell'asset negli appunti, comodo per incollare l'ID nel valore della proprietà di un oggetto come AudioPlayer.AssetId o MeshPart.MeshId. |
| Visualizza nel Browser | Apre il tuo browser alla pagina dell'asset. |
| Installa / Aggiorna / Riporta | Applicabile solo per asset Plugin. Installa, aggiorna o riporta il plugin, rispettivamente. |
Linguaggio di query di ricerca
Utilizza il linguaggio di query di ricerca per affinare come trovi gli asset nel tuo inventario del Gestore degli Asset. Puoi combinare parole chiave, operatori e tag per filtrare, dare priorità o escludere risultati.
Quando combini più funzionalità, i termini di ricerca vengono elaborati nel seguente ordine (dal più alto al più basso): Ricerca esatta → Termini esclusi → Termini opzionali → Tag ID asset → Creato prima → Creato dopo → Aggiornato prima → Aggiornato dopo → Nome creatore → ID creatore → Nome gruppo → ID gruppo → ID asset numerico → Tipo audio.
Caratteristiche della query
Le seguenti caratteristiche possono essere combinate in un'unica query:
| Caratteristica | Sintassi | Come funziona |
|---|---|---|
| Ricerca esatta | "..." | Corrisponde a una frase esattamente. Le corrispondenze esatte hanno la priorità più alta e bypassano altre elaborazioni dei tag. |
| Escludi termini | -termine escludi:termine | Esclude risultati che contengono termini specifici. |
| Termini opzionali | termine? termine! opzionale:termine | Per impostazione predefinita, tutti i termini sono richiesti. I termini opzionali aumentano i risultati corrispondenti senza escludere risultati che non li contengono. |
| Ricerca ID asset | asset_id:123456 assetId:123456 123456 | Fissa gli asset corrispondenti in cima ai risultati. |
| Filtri di data | creato_prima creato_dopo aggiornato_prima aggiornato_dopo | Filtra i risultati in base alla data di creazione o aggiornamento. |
| Filtri del creatore | nome_creatore id_creatore nome_gruppo id_gruppo | Filtra i risultati in base all'utente creatore o al gruppo creatore in base al loro nome o ID. Quando vengono forniti più filtri per creatore o gruppo, i risultati che corrispondono a uno di essi sono inclusi. |
| Tipo audio | musica sfx effetti sonori | Filtra gli asset audio per tipo. Per limitare i risultati a un tipo audio specifico, aggiungi il tipo alla fine della tua query. |
Tag
I tag modificano il funzionamento della ricerca, ma non vengono trattati come termini di ricerca stessi. Filtrano o classificano solo i tuoi risultati. Se un tag ha un errore di battitura o una data non valida, viene trattato come un normale termine di ricerca.
I tag possono utilizzare i formati tag:valore o tag=valore, e non sono sensibili alla maiuscole.
Alcuni tag accettano più valori quando usi le parentesi quadre. Ad esempio, escludi:[arrugginito, rotto] e asset_id:[123, 456].
Formati di data
I filtri di data supportano i seguenti formati:
| Formato | Esempio |
|---|---|
| ISO 8601 | 2026-03-10 |
| ISO con tempo | 2026-03-10T14:30:00Z |
| Formato statunitense | 03/10/2026 |
| Forma lunga (richiede parentesi quadre) | [10 marzo 2026] |
| Con tempo (richiede parentesi quadre) | [03/10/2026 2:30 PM] |
Esempi di query
"crate di legno" asset_id:99887766 creato_dopo:2023-06-01 -danneggiato opzionale:pitturato: Corrisponde esattamente a "crate di legno", fissa un asset specifico tramite ID, filtra per data, esclude "danneggiato" e classifica più in alto i risultati "pitturato".
esplosione sfx -loop creato_prima:[31 dicembre 2023]: Filtra gli effetti sonori chiamati "esplosione", esclude le varianti in loop e limita i risultati per data.
125447393891114 spada lampeggiante? -arrugginita: Fissa un asset specifico tramite ID, cerca "spada", aumenta la priorità "lampeggiante" ed esclude "arrugginita".
albero nome_creatore:costruttore gruppo_id:9876543: Cerca "albero", filtrato per asset del creatore "costruttore" o del gruppo con ID 9876543.
spada id_creatore:1000001,2000002 nome_gruppo:[Studio Costruttori]: Cerca "spada", filtrato per asset di creatori con ID 1000001 o 2000002, o il gruppo "Studio Costruttori".