Aprenda
Classe do mecanismo
AvatarEditorService
Não criável
Serviço

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Resumo
Métodos
GetBatchItemDetails(itemIds: {any},itemType: Enum.AvatarItemType):{any}
Obsoleto
GetFavorite(itemId: number,itemType: Enum.AvatarItemType):boolean
Obsoleto
GetInventory(assetTypes: {any}):InventoryPages
Obsoleto
GetOutfitDetails(outfitId: number):Dictionary
Obsoleto
GetOutfits(outfitSource: Enum.OutfitSource,outfitType: Enum.OutfitType):OutfitPages
Obsoleto
GetRecommendedAssets(assetType: Enum.AvatarAssetType,contextAssetId: number):{any}
Obsoleto
GetRecommendedBundles(bundleId: number):{any}
Obsoleto
PromptCreateOutfit(outfit: HumanoidDescription,rigType: Enum.HumanoidRigType,outfitOptions: Dictionary,outfitType: Variant):()
PromptSetFavorite(itemId: number,itemType: Enum.AvatarItemType,shouldFavorite: boolean):()
SearchCatalog(searchParameters: CatalogSearchParams):CatalogPages
Obsoleto
Membros herdados

Referência API
Métodos
CheckApplyDefaultClothing
Obsoleto

CheckApplyDefaultClothingAsync
Rendimentos
Recursos: AvatarAppearance
AvatarEditorService:CheckApplyDefaultClothingAsync(humanoidDescription:HumanoidDescription):HumanoidDescription
Parâmetros
humanoidDescription:HumanoidDescription

ConformToAvatarRules
Obsoleto

ConformToAvatarRulesAsync
Rendimentos
Recursos: AvatarAppearance
AvatarEditorService:ConformToAvatarRulesAsync(humanoidDescription:HumanoidDescription):HumanoidDescription
Parâmetros
humanoidDescription:HumanoidDescription

GetAccessoryType
AvatarEditorService:GetAccessoryType(avatarAssetType:Enum.AvatarAssetType):Enum.AccessoryType
Parâmetros
avatarAssetType:Enum.AvatarAssetType

GetAvatarRules
Obsoleto

GetAvatarRulesAsync
Rendimentos
AvatarEditorService:GetAvatarRulesAsync():Dictionary
Devolução

GetBatchItemDetails
Obsoleto

GetBatchItemDetailsAsync
Rendimentos
Recursos: AssetRead
AvatarEditorService:GetBatchItemDetailsAsync(
itemIds:{any}, itemType:Enum.AvatarItemType
Parâmetros
itemIds:{any}
Devolução

GetBundlesByAssetIdAsync
Rendimentos
Recursos: AssetRead
AvatarEditorService:GetBundlesByAssetIdAsync(
assetId:number, limit:number
Parâmetros
assetId:number
limit:number
Valor Padrão: 10
Devolução

GetFavorite
Obsoleto

GetFavoriteAsync
Rendimentos
Recursos: Players, AssetRead
AvatarEditorService:GetFavoriteAsync(
itemId:number, itemType:Enum.AvatarItemType
Parâmetros
itemId:number
Devolução

GetHeadShapesAsync
Rendimentos
Recursos: Players, AssetRead
AvatarEditorService:GetHeadShapesAsync():{any}
Devolução
Amostras de código
Obtendo formas de cabeça possuídas
TESTE
local AvatarEditorService = game:GetService("AvatarEditorService")
AvatarEditorService:PromptAllowInventoryReadAccess()
local result = AvatarEditorService.PromptAllowInventoryReadAccessCompleted:Wait()
if result == Enum.AvatarPromptResult.Success then
local shapes = AvatarEditorService:GetHeadShapesAsync()
for i, shape in ipairs(shapes) do
print(i, shape)
end
end

GetInventory
Obsoleto

GetInventoryAsync
Rendimentos
Recursos: Players, AssetRead
AvatarEditorService:GetInventoryAsync(assetTypes:{any}):InventoryPages
Parâmetros
assetTypes:{any}
Devolução
Amostras de código
Encontrando Itens que Expiram
local AvatarEditorService = game:GetService("AvatarEditorService")
local pages = AvatarEditorService:GetInventoryAsync({ Enum.AvatarAssetType.Hat })
local currentPage = pages:GetCurrentPage()
for _, item in currentPage do
if item.ExpirationTime then
local secondsLeft = item.ExpirationTime.UnixTimestamp - DateTime.now().UnixTimestamp
local hoursLeft = math.floor(secondsLeft / 3600)
if hoursLeft < 24 then
warn(string.format("%s expira em %d horas", item.Name, hoursLeft))
end
end
end

GetItemDetails
Obsoleto

GetItemDetailsAsync
Rendimentos
Recursos: AssetRead
AvatarEditorService:GetItemDetailsAsync(
itemId:number, itemType:Enum.AvatarItemType
Parâmetros
itemId:number
Devolução
Amostras de código
Verificando a Expiração do Item
local AvatarEditorService = game:GetService("AvatarEditorService")
local details = AvatarEditorService:GetItemDetailsAsync(105589844216517, Enum.AvatarItemType.Asset)
if details.ExpirationTime then
local secondsLeft = details.ExpirationTime.UnixTimestamp - DateTime.now().UnixTimestamp
local hoursLeft = math.floor(secondsLeft / 3600)
if hoursLeft < 24 then
warn(details.Name .. " expira em menos de 24 horas!")
end
end

GetOutfitDetails
Obsoleto

GetOutfitDetailsAsync
Rendimentos
Recursos: AssetRead
AvatarEditorService:GetOutfitDetailsAsync(outfitId:number):Dictionary
Parâmetros
outfitId:number
Devolução

GetOutfits
Obsoleto

GetOutfitsAsync
Rendimentos
Recursos: Players, AssetRead
AvatarEditorService:GetOutfitsAsync(
outfitSource:Enum.OutfitSource, outfitType:Enum.OutfitType
Parâmetros
outfitSource:Enum.OutfitSource
Valor Padrão: "All"
outfitType:Enum.OutfitType
Valor Padrão: "All"
Devolução

GetRecommendedAssets
Obsoleto

GetRecommendedAssetsAsync
Rendimentos
Recursos: AssetRead
AvatarEditorService:GetRecommendedAssetsAsync(
assetType:Enum.AvatarAssetType, contextAssetId:number
Parâmetros
contextAssetId:number
Valor Padrão: 0
Devolução
Amostras de código
Recebendo uma Recomendação de Chapéu
local AvatarEditorService = game:GetService("AvatarEditorService")
-- Obtém os ativos recomendados para o tipo de ativo especificado
local assets = AvatarEditorService:GetRecommendedAssetsAsync(Enum.AvatarAssetType.Hat, 9255093)
for _, asset in ipairs(assets) do
print(asset.Item.Name) -- Imprime o nome do ativo
end

GetRecommendedBundles
Obsoleto

GetRecommendedBundlesAsync
Rendimentos
Recursos: AssetRead
AvatarEditorService:GetRecommendedBundlesAsync(bundleId:number):{any}
Parâmetros
bundleId:number
Devolução

PromptAllowInventoryReadAccess
Recursos: Players, AssetRead
AvatarEditorService:PromptAllowInventoryReadAccess():()
Devolução
()

PromptCreateOutfit
Recursos: Players, PlatformAvatarEditing
AvatarEditorService:PromptCreateOutfit(
outfit:HumanoidDescription, rigType:Enum.HumanoidRigType, outfitOptions:Dictionary, outfitType:Variant
):()
Parâmetros
outfitOptions:Dictionary
Valor Padrão: "nil"
outfitType:Variant
Devolução
()

PromptDeleteOutfit
Recursos: Players, PlatformAvatarEditing
AvatarEditorService:PromptDeleteOutfit(outfitId:number):()
Parâmetros
outfitId:number
Devolução
()

PromptRenameOutfit
Recursos: Players, PlatformAvatarEditing
AvatarEditorService:PromptRenameOutfit(outfitId:number):()
Parâmetros
outfitId:number
Devolução
()

PromptSaveAvatar
Recursos: Players, PlatformAvatarEditing
AvatarEditorService:PromptSaveAvatar(
humanoidDescription:HumanoidDescription, rigType:Enum.HumanoidRigType
):()
Parâmetros
humanoidDescription:HumanoidDescription
Devolução
()

PromptSetFavorite
Recursos: Players, PlatformAvatarEditing
AvatarEditorService:PromptSetFavorite(
itemId:number, itemType:Enum.AvatarItemType, shouldFavorite:boolean
):()
Parâmetros
itemId:number
shouldFavorite:boolean
Devolução
()

PromptUpdateOutfit
Recursos: Players, PlatformAvatarEditing
AvatarEditorService:PromptUpdateOutfit(
outfitId:number, updatedOutfit:HumanoidDescription, rigType:Enum.HumanoidRigType
):()
Parâmetros
outfitId:number
updatedOutfit:HumanoidDescription
Devolução
()

SearchCatalog
Obsoleto

SearchCatalogAsync
Rendimentos
Recursos: AssetRead
AvatarEditorService:SearchCatalogAsync(searchParameters:CatalogSearchParams):CatalogPages
Parâmetros
searchParameters:CatalogSearchParams
Devolução
Amostras de código
Buscando Itens com Opções Temporizadas
local AvatarEditorService = game:GetService("AvatarEditorService")
local params = CatalogSearchParams.new()
params.SalesTypeFilter = Enum.SalesTypeFilter.TimedOptions
params.Limit = 10
local pages = AvatarEditorService:SearchCatalogAsync(params)
local results = pages:GetCurrentPage()
for _, item in results do
if item.TimedOptions then
for _, option in item.TimedOptions do
local days = option.Duration / 86400
print(string.format("%s: %d dias por %d R$", item.Name, days, option.Price))
end
end
end

Eventos
PromptAllowInventoryReadAccessCompleted
Recursos: Players, AssetRead
AvatarEditorService.PromptAllowInventoryReadAccessCompleted(result:Enum.AvatarPromptResult):RBXScriptSignal
Parâmetros

PromptCreateOutfitCompleted
Recursos: Players, PlatformAvatarEditing
AvatarEditorService.PromptCreateOutfitCompleted(
result:Enum.AvatarPromptResult, failureType:Variant
Parâmetros
failureType:Variant

PromptDeleteOutfitCompleted
Recursos: Players, PlatformAvatarEditing
AvatarEditorService.PromptDeleteOutfitCompleted(result:Enum.AvatarPromptResult):RBXScriptSignal
Parâmetros

PromptRenameOutfitCompleted
Recursos: Players, PlatformAvatarEditing
AvatarEditorService.PromptRenameOutfitCompleted(result:Enum.AvatarPromptResult):RBXScriptSignal
Parâmetros

PromptSaveAvatarCompleted
Recursos: Players, PlatformAvatarEditing
AvatarEditorService.PromptSaveAvatarCompleted(
result:Enum.AvatarPromptResult, humanoidDescription:HumanoidDescription
Parâmetros
humanoidDescription:HumanoidDescription

PromptSetFavoriteCompleted
Recursos: Players, PlatformAvatarEditing
AvatarEditorService.PromptSetFavoriteCompleted(result:Enum.AvatarPromptResult):RBXScriptSignal
Parâmetros

PromptUpdateOutfitCompleted
Recursos: Players, PlatformAvatarEditing
AvatarEditorService.PromptUpdateOutfitCompleted(result:Enum.AvatarPromptResult):RBXScriptSignal
Parâmetros

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.