Aprenda
Classe do mecanismo
HumanoidDescription

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



Referência API
Propriedades
AccessoryBlob
Não replicado
Não scriptável
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.AccessoryBlob:string

BackAccessory
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.BackAccessory:string

BodyTypeScale
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.BodyTypeScale:number

ClimbAnimation
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.ClimbAnimation:number

DepthScale
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.DepthScale:number

Face
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.Face:number

FaceAccessory
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.FaceAccessory:string

FallAnimation
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.FallAnimation:number

FrontAccessory
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.FrontAccessory:string

GraphicTShirt
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.GraphicTShirt:number

HairAccessory
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.HairAccessory:string

HatAccessory
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.HatAccessory:string

Head
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.Head:number

HeadColor
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.HeadColor:Color3

HeadScale
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.HeadScale:number

HeightScale
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.HeightScale:number

IdleAnimation
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.IdleAnimation:number

JumpAnimation
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.JumpAnimation:number

LeftArm
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.LeftArm:number

LeftArmColor
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.LeftArmColor:Color3

LeftLeg
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.LeftLeg:number

LeftLegColor
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.LeftLegColor:Color3

MoodAnimation
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.MoodAnimation:number

NeckAccessory
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.NeckAccessory:string

Pants
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.Pants:number

ProportionScale
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.ProportionScale:number

RightArm
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.RightArm:number

RightArmColor
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.RightArmColor:Color3

RightLeg
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.RightLeg:number

RightLegColor
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.RightLegColor:Color3

RunAnimation
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.RunAnimation:number

Shirt
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.Shirt:number

ShouldersAccessory
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.ShouldersAccessory:string

StaticFacialAnimation
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.StaticFacialAnimation:boolean

SwimAnimation
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.SwimAnimation:number

Torso
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.Torso:number

TorsoColor
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.TorsoColor:Color3

UseAvatarSettings
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.UseAvatarSettings:boolean

WaistAccessory
Não replicado
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.WaistAccessory:string

WalkAnimation
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.WalkAnimation:number

WidthScale
Ler Parallel
Recursos: AvatarAppearance
HumanoidDescription.WidthScale:number

Métodos
AddEmote
Recursos: AvatarAppearance
HumanoidDescription:AddEmote(
name:string, assetId:number
):()
Parâmetros
name:string
assetId:number
Devolução
()

GetAccessories
Recursos: AvatarAppearance
HumanoidDescription:GetAccessories(includeRigidAccessories:boolean):{AccessoriesInfo}
Parâmetros
includeRigidAccessories:boolean
Devolução
{AccessoriesInfo}
Amostras de código
Obter Acessórios
local includeRigidAccessories = true
local accessoriesTable =
game:GetService("Players"):GetHumanoidDescriptionFromUserIdAsync(1):GetAccessories(includeRigidAccessories)
for _, accessoryInfo in ipairs(accessoriesTable) do
print(tostring(accessoryInfo.AssetId) .. " " .. tostring(accessoryInfo.AccessoryType))
end

GetEmotes
Recursos: AvatarAppearance
HumanoidDescription:GetEmotes():Dictionary
Devolução

GetEquippedEmotes
Recursos: AvatarAppearance
HumanoidDescription:GetEquippedEmotes():{any}
Devolução

RemoveEmote
Recursos: AvatarAppearance
HumanoidDescription:RemoveEmote(name:string):()
Parâmetros
name:string
Devolução
()

SetAccessories
Recursos: AvatarAppearance
HumanoidDescription:SetAccessories(
accessories:{any}, includeRigidAccessories:boolean
):()
Parâmetros
accessories:{any}
includeRigidAccessories:boolean
Devolução
()
Amostras de código
Adicionar Acessórios
local humanoidDescription = Instance.new("HumanoidDescription")
local originalSpecifications = {
{
Order = 1,
AssetId = 123456789,
Puffiness = 0.5,
AccessoryType = Enum.AccessoryType.Sweater,
},
}
humanoidDescription:SetAccessories(originalSpecifications)
local updatedSpecifications = humanoidDescription:GetAccessories(false)
local newIndividualSpecification = {
Order = 2,
AssetId = 987654321,
Puffiness = 0.7,
AccessoryType = Enum.AccessoryType.Jacket,
IsLayered = true,
}
updatedSpecifications[#updatedSpecifications + 1] = newIndividualSpecification
humanoidDescription:SetAccessories(updatedSpecifications)

SetEmotes
Recursos: AvatarAppearance
HumanoidDescription:SetEmotes(emotes:Dictionary):()
Parâmetros
emotes:Dictionary
Devolução
()

SetEquippedEmotes
Recursos: AvatarAppearance
HumanoidDescription:SetEquippedEmotes(equippedEmotes:{any}):()
Parâmetros
equippedEmotes:{any}
Devolução
()

Eventos
EmotesChanged
Recursos: AvatarAppearance
HumanoidDescription.EmotesChanged(newEmotes:Dictionary):RBXScriptSignal
Parâmetros
newEmotes:Dictionary

EquippedEmotesChanged
Recursos: AvatarAppearance
HumanoidDescription.EquippedEmotesChanged(newEquippedEmotes:{any}):RBXScriptSignal
Parâmetros
newEquippedEmotes:{any}

©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.