AvatarEditorService
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
O AvatarEditorService é um serviço para suportar editores de avatar de desenvolvedores.Ele fornece métodos para modificar o avatar da plataforma do jogador, solicitar informações sobre o inventário de um usuário e solicitar informações sobre o catálogo.
Para mais informações sobre o Editor de Avatar, veja Serviço de Editor de Avatar.
Aceleração
Os seguintes pontos finais em AvatarEditorService têm aceleração de nível de experiência:
Para cada experiência, esse aceleramento permite que você envie até 100 solicitações por segundo para esses AvatarEditorService pontos finais, independentemente do número de servidores ou contagem de usuários.Exceder esses limites retorna um erro 429 Too Many Requests de exceção.
Se você encontrar que sua experiência requer um ajuste a esse atraso, você pode enviar um pedido de recurso de característica.
Resumo
Métodos
Solicita ao Players.LocalPlayer para permitir que o desenvolvedor leia quais itens o usuário tem em seu inventário e outras informações relacionadas ao editor de avatar.
Solicita ao Players.LocalPlayer para salvar o dado HumanoidDescription como uma roupa.
Solicita ao Players.LocalPlayer que exclua o conjunto dado.
Solicita ao Players.LocalPlayer que renomeie o traje dado.
Solicita ao Players.LocalPlayer para atualizar seu avatar com base no dado HumanoidDescription e Enum.RigType de R6 ou R15.
Solicita ao Players.LocalPlayer favoritar ou desfavoritar o recurso ou pacote dado.
- PromptUpdateOutfit(outfitId : number,updatedOutfit : HumanoidDescription,rigType : Enum.HumanoidRigType):()
Solicita ao Players.LocalPlayer atualizar o traje dado.
Usado para aplicar roupas padrão ao HumanoidDescription se necessário.
Retorna as regras do Avatar da plataforma para coisas como escalonamento, camisas e calças padrão, número de recursos vestíveis.
Obtém os detalhes do item para uma lista de itens de uma vez.
Retorna se o Players.LocalPlayer tiver favorecido o pacote ou recurso dado.
Retorna um objeto InventoryPages com informações sobre itens possuídos no inventário dos usuários com os tipos de avatar dados.
Retorna os detalhes do item para o item dado.
Retorna os detalhes da roupa para a roupa dada.
Retorna dados de roupa para o Players.LocalPlayer .
Retorna uma lista de recursos recomendados com base em um determinado Enum.AssetType e ID de recurso.
Retorna uma lista de pacotes recomendados para um ID de pacote dado.
Retorna um objeto CatalogPages que contém o resultado da busca dada.
Eventos
Incêndios quando o AvatarEditorService:PromptAllowInventoryReadAccess() prompt é respondido pelo usuário.
Incêndios quando a operação Save Outfit Prompt é concluída.
Incêndios quando a operação PromptDeleteOutfit é concluída.
Incêndios quando a operação PromptRenameOutfit é concluída.
- PromptSaveAvatarCompleted(result : Enum.AvatarPromptResult,humanoidDescription : HumanoidDescription):RBXScriptSignal
Incêndios quando a operação AvatarEditorService:PromptSaveAvatar() é concluída.
Incêndios quando a operação AvatarEditorService:PromptSetFavorite() é concluída.
Incêndios quando a operação AvatarEditorService:PromptUpdateOutfit() é concluída.
Propriedades
Métodos
GetAccessoryType
Parâmetros
Devolução
PromptAllowInventoryReadAccess
Devolução
PromptCreateOutfit
Parâmetros
Devolução
PromptSaveAvatar
Parâmetros
Devolução
PromptSetFavorite
Parâmetros
Devolução
PromptUpdateOutfit
Parâmetros
Devolução
CheckApplyDefaultClothing
Parâmetros
Devolução
ConformToAvatarRules
Parâmetros
Devolução
GetBatchItemDetails
Parâmetros
Devolução
GetFavorite
Parâmetros
Devolução
GetItemDetails
Parâmetros
Devolução
GetOutfits
Parâmetros
Devolução
GetRecommendedAssets
Parâmetros
Devolução
Amostras de código
local AvatarEditorService = game:GetService("AvatarEditorService")
local assets = AvatarEditorService:GetRecommendedAssets(Enum.AvatarAssetType.Hat, 9255093)
for _, asset in ipairs(assets) do
print(asset.Item.Name)
end