Creazione di trucco in esperienza

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Puoi pubblicare un'esperienza che consente ai giocatori di creare, personalizzare e acquistare asset di trucco in tempo reale, oltre alla creazione del corpo dell'avatar in esperienza. Quando acquistati, gli asset di trucco vengono salvati direttamente nell'inventario Roblox del giocatore.

I proprietari dell'esperienza che implementano la creazione di trucco in esperienza beneficiano delle commissioni del Marketplace come pubblicatore dell'asset di trucco, mentre il giocatore che lo crea è il creatore dell'asset.

Come implementare la creazione di trucco in esperienza

Utilizza le seguenti istruzioni e riferimenti al codice per invitare i giocatori a dipingere, assemblare e acquistare asset di trucco sulla testa del loro avatar.

Prima di iniziare, familiarizzati con i seguenti elementi:

  • Token di creazione avatar — Le esperienze che implementano la creazione di trucco richiedono almeno un token di creazione il cui tipo di creazione corrisponde al tipo di asset di trucco che intendi creare.
  • Classi API
    • AvatarCreationService — Gestisce l'invito alla creazione di asset per avatar e la validazione.
    • EditableImage — Gestisce la creazione e la manipolazione di texture in tempo reale.
    • EditableMesh — Gestisce la manipolazione della geometria della mesh in tempo reale.
    • WrapDeformer — Gestisce la manipolazione della geometria invisibile della gabbia esterna che consente ai personaggi avatar di equipaggiare abbigliamento e accessori 3D, inclusi mesh per sopracciglia e ciglia a strati.
    • WrapTarget — Rappresenta il legame tra una mesh di gabbia e una mesh di destinazione, ed espone la conversione dello spazio texture tra le due.
    • WrapTextureTransfer — Facilita un decal, incluso un decal di trucco, che si avvolge attorno a una mesh genitore in base al suo WrapTarget.

Scegli un flusso di asset singolo o multiplo

La creazione di trucco supporta due inviti, a seconda che tu stia creando un asset di trucco singolo o componendo più strati in un unico outfit:

PromptCreateMakeupAsync() accetta un elenco di voci di asset di trucco, dove ogni voce include:

  • Un ID di token di creazione per quello strato.
  • L'istanza da cui creare l'asset.
  • Il AvatarAssetType dello strato come Enum.AvatarAssetType.
  • Un ordine di ordinamento che controlla la composizione quando più strati si sovrappongono.

Restituisce un Enum.PromptCreateMakeupResult per l'outfit nel suo complesso (Success, PartialSuccess, CreationFailure, PermissionDenied, Timeout, NoUserInput, o UnknownFailure), più un risultato per asset in modo da poter sapere quali strati individuali hanno avuto successo quando il risultato complessivo è PartialSuccess.

Genera un token di creazione avatar

Ogni tipo di asset di trucco richiede il proprio token di creazione avatar il cui tipo di creazione corrisponde all'Enum.AvatarAssetType che passi a PromptCreateAvatarAssetAsync(), o corrisponde a ciascun tipo di asset dello strato quando utilizzi PromptCreateMakeupAsync(). Genera i token richiesti prima di costruire le voci di invio, quindi copia ciascun ID di token per l'invito lato server.

Seleziona il tipo di token dal menu a discesa impostato su Trucco per occhi, con un menu contestuale di un token aperto che mostra un'opzione per Copia ID token

I passaggi che seguono utilizzano la pittura proiettata sulla testa del giocatore come percorso principale. Se invece dipingi una testa di autore o un'altra mesh di proprietà dell'esperienza nel suo spazio UV nativo, segui Sposta una texture tra lo spazio della gabbia e lo spazio di destinazione, quindi riunisciti al percorso principale in Crea il decal e invia per la creazione.

Dipingi una texture di trucco sulla testa del giocatore

A differenza della pittura su un asset completamente nuovo, in genere non puoi leggere un EditableMesh direttamente dalla testa del giocatore locale per dipingere — la mesh della testa è soggetta allo stesso modello di autorizzazione di altre istanze di proprietà del giocatore. L'eccezione è quando l'esperienza possiede la mesh della testa (ad esempio, un NPC di proprietà dell'esperienza o un corpo creato dall'esperienza stessa); in tal caso puoi utilizzare EditableMesh direttamente, nello stesso modo in cui faresti per la creazione del corpo dell'avatar. Altrimenti, prepara un WrapTextureTransfer e usalo come obiettivo di proiezione quando disegni:

  1. Chiama WrapTextureTransfer:PrepareProjectionMeshDataAsync() per preparare e memorizzare nella cache i dati della mesh di proiezione per la testa del giocatore. Questo deve completarsi prima di effettuare qualsiasi chiamata di disegno o campionamento proiettato contro quel trasferimento. Se la mesh della testa sottostante cambia, riprepara il WrapTextureTransfer prima di continuare a dipingere.
  2. Passa il WrapTextureTransfer preparato come sorgente di proiezione a DrawImageProjected() o SampleImageProjected(). Questi metodi accettano un WrapTextureTransfer come alternativa a un EditableMesh, consentendoti di dipingere direttamente sulla forma reale della testa del giocatore invece di una mesh generica.
local AssetService = game:GetService("AssetService")
-- Passa un WrapTextureTransfer che hai già creato per la testa del giocatore.
local function paintMakeupLayer(textureTransfer: WrapTextureTransfer, brushConfig, projectionParams)
local success, err = pcall(function()
textureTransfer:PrepareProjectionMeshDataAsync()
end)
if not success then
warn("Impossibile preparare i dati della mesh di proiezione:", err)
return
end
local makeupTexture = AssetService:CreateEditableImage()
if not makeupTexture then
warn("Memoria editabile insufficiente per creare una texture di trucco")
return
end
makeupTexture:DrawImageProjected(textureTransfer, projectionParams, brushConfig)
return makeupTexture
end

Sposta una texture tra lo spazio della gabbia e lo spazio di destinazione

Pitturare direttamente su una testa di proprietà del giocatore attraverso un WrapTextureTransfer preparato, come descritto in Dipingi una texture di trucco sulla testa del giocatore, non inizia nello spazio UV di destinazione della mesh della testa — il percorso di proiezione funziona nel layout UV della gabbia condivisa tutto il tempo, quindi il risultato è già una texture nello spazio della gabbia pronta per essere inviata.

La conversione gabbia/destinazione è invece importante quando stai lavorando con una testa di autore o una mesh di proprietà dell'esperienza che puoi dipingere direttamente nel suo spazio UV di destinazione nativo:

Utilizza CreateTextureInTargetSpaceAsync() per portare una texture di trucco nello spazio della gabbia riutilizzabile nello spazio di destinazione di quella mesh per la modifica, quindi utilizza CreateTextureInCageSpaceAsync() per convertire il risultato modificato di nuovo nello spazio della gabbia prima di inviarlo come asset di trucco.

Per il trucco, limita la conversione nello spazio della gabbia alla regione del trucco invece che all'intera gabbia. Chiama AvatarCreationService:GetValidationRules() e leggi MakeupRules.WrapTextureTransferUVBounds, che fornisce MinBound e MaxBound come valori Vector2. Passali a CreateTextureInCageSpaceAsync() come MinUVBounds e MaxUVBounds. Senza queste opzioni, il metodo deriva i limiti dall'intera gabbia invece di utilizzare la regione del trucco. Ogni limite deve essere finito e il massimo deve essere maggiore del minimo su entrambi gli assi.

local AvatarCreationService = game:GetService("AvatarCreationService")
local validationRules = AvatarCreationService:GetValidationRules()
local makeupBounds = validationRules.MakeupRules.WrapTextureTransferUVBounds
local cageSpaceTexture = wrapTarget:CreateTextureInCageSpaceAsync(targetSpaceTexture, {
MinUVBounds = makeupBounds.MinBound,
MaxUVBounds = makeupBounds.MaxBound,
})

Crea il decal e invia per la creazione

Il trucco per il viso, le labbra e gli occhi sono texture dipinte, mentre le sopracciglia e le ciglia sono accessori mesh a strati creati individualmente, nello stesso modo di altri abbigliamenti e accessori 3D. Costruisci ciascuna voce di invio dello strato di conseguenza:

Combina l'istanza risultante con l'ID di token corrispondente da Genera un token di creazione avatar, il suo tipo di asset e il suo ordine di strato. Il seguente campione prende quelle voci, di entrambi i tipi, e sceglie automaticamente la giusta API: AvatarCreationService:PromptCreateAvatarAssetAsync() per una singola voce, o AvatarCreationService:PromptCreateMakeupAsync() quando componi due o più strati in un unico outfit.

Entrambi gli inviti mostrano al giocatore una schermata di conferma finale prima di inviare l'asset per la creazione e la moderazione.

local AssetService = game:GetService("AssetService")
local AvatarCreationService = game:GetService("AvatarCreationService")
type MakeupEntry = {
tokenId: string,
instance: Instance,
assetType: Enum.AvatarAssetType,
sortOrder: number,
}
-- Trucco per il viso, labbra e occhi: avvolgi la texture finita in un Decal e genitore il
-- WrapTextureTransfer usato per dipingerlo, come unico figlio del Decal.
local function createMakeupTextureEntry(
tokenId: string,
texture: EditableImage,
textureTransfer: WrapTextureTransfer,
assetType: Enum.AvatarAssetType,
sortOrder: number
): MakeupEntry
local decal = AssetService:CreateDecalAsync({
TextureContent = Content.fromObject(texture),
})
decal.Face = Enum.NormalId.Front
textureTransfer.Parent = decal
return {
tokenId = tokenId,
instance = decal,
assetType = assetType,
sortOrder = sortOrder,
}
end
-- Sopracciglia e ciglia: passa direttamente l'accessorio mesh a strati creato.
local function createMakeupAccessoryEntry(
tokenId: string,
accessory: Accessory,
assetType: Enum.AvatarAssetType,
sortOrder: number
): MakeupEntry
return {
tokenId = tokenId,
instance = accessory,
assetType = assetType,
sortOrder = sortOrder,
}
end
local function submitMakeupEntries(entries: {MakeupEntry}, player: Player, headColor: Color3?)
local assetEntries = {}
for _, entry in entries do
table.insert(assetEntries, {
TokenId = entry.tokenId,
Instance = entry.instance,
AvatarAssetType = entry.assetType,
SortOrder = entry.sortOrder,
})
end
if #assetEntries == 1 then
local entry = assetEntries[1]
local success, result, assetIdOrErrorMessage = pcall(function()
return AvatarCreationService:PromptCreateAvatarAssetAsync(
entry.TokenId,
player,
entry.Instance,
entry.AvatarAssetType
)
end)
if success and result == Enum.PromptCreateAssetResult.Success then
print("Caricamento riuscito con AssetId:", assetIdOrErrorMessage)
else
print("Creazione dell'asset di trucco non riuscita:", assetIdOrErrorMessage)
end
else
local success, result, perAssetResults = pcall(function()
return AvatarCreationService:PromptCreateMakeupAsync(player, assetEntries, headColor)
end)
if success and result == Enum.PromptCreateMakeupResult.Success then
print("Outfit di trucco creato con successo")
else
print("Risultato della creazione dell'outfit di trucco:", result, perAssetResults)
end
end
end

Gestisci la moderazione

Dopo che un asset di trucco è stato creato, passa attraverso la moderazione prima che sia sicuro utilizzarlo in esperienza.

  • Ascolta AvatarAssetModerationCompleted per sapere quando un singolo asset di trucco creato con PromptCreateAvatarAssetAsync() termina la moderazione.
  • Per un outfit a più strati creato con PromptCreateMakeupAsync(), AvatarAssetModerationCompleted si attiva comunque una volta per ogni singolo asset di trucco nell'outfit, e AvatarOutfitModerationCompleted si attiva inoltre una volta per l'outfit nel suo complesso. Ascolta entrambi: utilizza l'evento per asset se hai bisogno di conoscere il risultato della moderazione di uno strato specifico, e l'evento a livello di outfit per sapere quando l'intero look è sicuro da usare in esperienza.
© 2026 Roblox Corporation. Roblox, il logo Roblox e Powering Imagination sono tra i nostri marchi registrati e non registrati negli Stati Uniti. e altri paesi.