# HumanoidDescription（ロブロックス クラス）

> Describes the appearance of a Humanoid character including body parts, accessories, colors, scales, animations, and emotes.

- URL：https://roblox.minecraft-okinawa.com/reference/classes/HumanoidDescription/
- 公式：https://create.roblox.com/docs/reference/engine/classes/HumanoidDescription
- 受け継いでいるクラス：Instance

## プロパティ

- `HumanoidDescription.AccessoryBlob: string`：A JSON formatted array of Layered clothing where each table in the entry in the array describes an accessory's AssetId, AccessoryType, Order, and (optionally) Puffiness as key-value pairs.
- `HumanoidDescription.BackAccessory: string`：A comma-separated list of asset IDs that will be added as Class.Accessory|Accessories to a Humanoid rig when Class.Humanoid:ApplyDescriptionAsync()|applied, usually those attached to its back (such as capes).
- `HumanoidDescription.BodyTypeScale: float`：Determines the factor by which the shape of a Humanoid is interpolated from the standard R15 body shape (0) to a taller and more slender body type (1).
- `HumanoidDescription.ClimbAnimation: int64`：When this description is Class.Humanoid:ApplyDescriptionAsync()|applied to a Humanoid, this determines the Animation.AnimationId to play when its Class.Humanoid:GetState()|state is Enum.HumanoidStateType|Climbing.
- `HumanoidDescription.DepthScale: float`：Determines by what factor the depth (back-to-front distance) of a Humanoid is scaled.
- `HumanoidDescription.Face: int64`：Determines the asset ID of the Face to be applied to the Humanoid.
- `HumanoidDescription.FaceAccessory: string`：A comma-separated list of asset IDs that will be added as Class.Accessory|Accessories to a Humanoid rig when Class.Humanoid:ApplyDescriptionAsync()|applied, usually those attached to the front of its face (such as glasses).
- `HumanoidDescription.FallAnimation: int64`：When this description is Class.Humanoid:ApplyDescriptionAsync()|applied to a Humanoid, this determines the Animation.AnimationId to play when its Class.Humanoid:GetState()|state is Enum.HumanoidStateType|Freefall.
- `HumanoidDescription.FrontAccessory: string`：A comma-separated list of asset IDs that will be added as Class.Accessory|Accessories to a Humanoid rig when Class.Humanoid:ApplyDescriptionAsync()|applied, usually those attached to front of its torso (such as medals or ties).
- `HumanoidDescription.GraphicTShirt: int64`：Determines the Class.ShirtGraphic.Graphic|Graphic used by a ShirtGraphic.
- `HumanoidDescription.HairAccessory: string`：A comma-separated list of asset IDs that will be added as Class.Accessory|Accessories to a Humanoid rig when Class.Humanoid:ApplyDescriptionAsync()|applied, usually those attached to its head resembling hair.
- `HumanoidDescription.HatAccessory: string`：A comma-separated list of asset IDs that will be added as Class.Accessory|Accessories to a Humanoid rig when Class.Humanoid:ApplyDescriptionAsync()|applied, usually those attached to its head.
- `HumanoidDescription.Head: int64`：Determines the asset ID of the Head to be applied to the Humanoid.
- `HumanoidDescription.HeadColor: Color3`：Determines the BodyColors.HeadColor3 and BodyColors.HeadColor of a Humanoid when Class.Humanoid:ApplyDescriptionAsync()|applied.
- `HumanoidDescription.HeadScale: float`：Determines by what factor the **Head** object of a Humanoid is scaled, as well as any accessories attached to it.
- `HumanoidDescription.HeightScale: float`：Determines by what factor the height (top-to-bottom distance) of a Humanoid is scaled, as well as all accessories not attached to its head.
- `HumanoidDescription.IdleAnimation: int64`：When this description is Class.Humanoid:ApplyDescriptionAsync()|applied to a Humanoid, this determines the Animation.AnimationId to play when its Class.Humanoid:GetState()|state is Enum.HumanoidStateType|Running at a speed near zero.
- `HumanoidDescription.JumpAnimation: int64`：When this description is Class.Humanoid:ApplyDescriptionAsync()|applied to a Humanoid, this determines the Animation.AnimationId to play when its Class.Humanoid:GetState()|state is Enum.HumanoidStateType|Jumping.
- `HumanoidDescription.LeftArm: int64`：Determines the asset ID of the LeftArm to be applied to the Humanoid.
- `HumanoidDescription.LeftArmColor: Color3`：Determines the BodyColors.LeftArmColor3 and BodyColors.LeftArmColor of a Humanoid when applied.
- `HumanoidDescription.LeftLeg: int64`：Determines the asset ID of the LeftLeg to be applied to the Humanoid.
- `HumanoidDescription.LeftLegColor: Color3`：Determines the BodyColors.LeftLegColor3 and BodyColors.LeftLegColor of a Humanoid when applied.
- `HumanoidDescription.MoodAnimation: int64`：When this description is Class.Humanoid:ApplyDescriptionAsync()|applied to a Humanoid, this determines the asset ID of the mood animation that gives the character's face its persistent expression.
- `HumanoidDescription.NeckAccessory: string`：A comma-separated list of asset IDs that will be added as Class.Accessory|Accessories to a Humanoid rig when Class.Humanoid:ApplyDescriptionAsync()|applied, usually those attached to its neck (such as scarves or necklaces).
- `HumanoidDescription.Pants: int64`：Determines the Class.Pants.PantsTemplate|PantsTemplate used by a Pants instance.
- `HumanoidDescription.ProportionScale: float`：Determines how wide (0) or narrow (1) a Humanoid rig is.
- `HumanoidDescription.RightArm: int64`：Determines the asset ID of the RightArm to be applied to the Humanoid.
- `HumanoidDescription.RightArmColor: Color3`：Determines the BodyColors.RightArmColor3 and BodyColors.RightArmColor of a Humanoid when applied.
- `HumanoidDescription.RightLeg: int64`：Determines the asset ID of the RightLeg to be applied to the Humanoid.
- `HumanoidDescription.RightLegColor: Color3`：Determines the BodyColors.RightLegColor3 and BodyColors.RightLegColor of a Humanoid when applied.
- `HumanoidDescription.RunAnimation: int64`：When this description is Class.Humanoid:ApplyDescriptionAsync()|applied to a Humanoid, this determines the Animation.AnimationId to play when its Class.Humanoid:GetState()|state is Enum.HumanoidStateType|Running at a moderate speed.
- `HumanoidDescription.Shirt: int64`：Determines the Class.Shirt.ShirtTemplate|ShirtTemplate used by a Shirt instance.
- `HumanoidDescription.ShouldersAccessory: string`：A comma-separated list of asset IDs that will be added as Class.Accessory|Accessories to a Humanoid rig when Class.Humanoid:ApplyDescriptionAsync()|applied, usually those attached to its shoulders (such as shoulder-mounted critters).
- `HumanoidDescription.StaticFacialAnimation: boolean`：When true, disables facial animations on a Dynamic Head, displaying a static mood pose instead. Defaults to false.
- `HumanoidDescription.SwimAnimation: int64`：When this description is Class.Humanoid:ApplyDescriptionAsync()|applied to a Humanoid, this determines the Animation.AnimationId to play when its Class.Humanoid:GetState()|state is Enum.HumanoidStateType|Swimming.
- `HumanoidDescription.Torso: int64`：Determines the asset ID of the Torso to be applied to the Humanoid.
- `HumanoidDescription.TorsoColor: Color3`：Determines the BodyColors.TorsoColor3 and BodyColors.TorsoColor of a Humanoid when applied.
- `HumanoidDescription.UseAvatarSettings: boolean`：When true, applying this description also applies the experience's Avatar Settings to the resulting model. Defaults to false.
- `HumanoidDescription.WaistAccessory: string`：A comma-separated list of asset IDs that will be added as Class.Accessory|Accessories to a Humanoid rig when Class.Humanoid:ApplyDescriptionAsync()|applied, usually those attached to its waist (such as belts).
- `HumanoidDescription.WalkAnimation: int64`：When this description is Class.Humanoid:ApplyDescriptionAsync()|applied to a Humanoid, this determines the Animation.AnimationId to play when its Class.Humanoid:GetState()|state is Enum.HumanoidStateType|Running at a low speed.
- `HumanoidDescription.WidthScale: float`：Determines by what factor the width (left-to-right distance) of a Humanoid is scaled, as well as all accessories not attached to its head.

## メソッド

- `HumanoidDescription:AddEmote(name: string, assetId: int64): ()`：Adds the emote to the description given a name and its asset ID.
- `HumanoidDescription:GetAccessories(includeRigidAccessories: boolean): List<AccessoriesInfo>`：Returns a table of an avatar's current accessories.
- `HumanoidDescription:GetEmotes(): Dictionary`：Returns a dictionary of emotes that have been Class.HumanoidDescription:AddEmote()|added or Class.HumanoidDescription:SetEmotes()|set to this description.
- `HumanoidDescription:GetEquippedEmotes(): Array`：Returns an array of tables describing the equipped emotes that have been Class.HumanoidDescription:SetEquippedEmotes()|set.
- `HumanoidDescription:RemoveEmote(name: string): ()`：Removes any emotes that have been added under the given name.
- `HumanoidDescription:SetAccessories(accessories: Array, includeRigidAccessories: boolean): ()`：Accepts a table that sets the accessories and related properties for an avatar.
- `HumanoidDescription:SetEmotes(emotes: Dictionary): ()`：Sets all of the emotes on this description.
- `HumanoidDescription:SetEquippedEmotes(equippedEmotes: Array): ()`：Sets the currently equipped emotes given an array of emote names.

## イベント

- `HumanoidDescription.EmotesChanged(newEmotes: Dictionary)`：Fires when emotes are added, removed or set on this description.
- `HumanoidDescription.EquippedEmotesChanged(newEquippedEmotes: Array)`：Fires when the equipped emotes are Class.HumanoidDescription:SetEquippedEmotes()|set on this description.

英語の説明とメンバー一覧：Roblox Creator Documentation（CC BY 4.0）。日本語の解説はこのサイト独自のものです。

執筆：鈴木孝昌（現役プロジェクトマネージャー／プログラミング講師）／運営：沖縄マイクラ部 プログラミングスクール「クロスウェーブ」（https://minecraft-okinawa.com/）