AvatarCreationService

Obtient des données relatives aux règles auxquelles les ressources doivent adhérer pour passer la validation UGC.La validation est une étape essentielle avant la création d'avatars et il y a plusieurs vérifications qui survernir, y compris les limites du triangle de maillage, les tailles des textures, les limites de la taille des parties du corps, les positions d'attachement et plus encore.

Le dictionnaire de règles de validation retourné prend la forme suivante :

{
	["MeshRules"] = {
		["BodyPartMaxTriangles"] = {
			Enum.AssetType.DynamicHead: number,
			Enum.AssetType.LeftArm: number,
			Enum.AssetType.RightArm: number,
			Enum.AssetType.Torso: number,
			Enum.AssetType.LeftLeg: number,
			Enum.AssetType.RightLeg: number,
		},
			["AccessoryMaxTriangles"]: number,
			["MeshVertColor"]: Color3,
			["CageMeshMaxDistanceFromRenderMesh"]: number,
	},
	["TextureRules"] = {
		["MaxTextureSize"]: number,
	},
	["BodyPartRules"] = {
		[Enum.AssetType.DynamicHead] = {
			["Bounds"] = {
				["Classic"] = {
					["MinSize"]: Vector3,
					["MaxSize"]: Vector3,
			},
				["ProportionsSlender"] = {
					["MinSize"]: Vector3,
					["MaxSize"]: Vector3,
				},
				["ProportionsNormal"] = {
					["MinSize"]: Vector3,
					["MaxSize"]: Vector3,
				},
			},
			["SubParts"] = {
				["Head"] = {
					["NeckRigAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
					["FaceFrontAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
					["HatAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
					["HairAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
					["FaceCenterAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
				},
			},
		},
		[Enum.AssetType.LeftArm] = {
			["Bounds"] = {
				["Classic"] = {
					["MinSize"]: Vector3,
					["MaxSize"]: Vector3,
				},
				["ProportionsSlender"] = {
					["MinSize"]: Vector3,
					["MaxSize"]: Vector3,
				},
				["ProportionsNormal"] = {
					["MinSize"]: Vector3,
					["MaxSize"]: Vector3,
				},
			},
			["SubParts"] = {
				["LeftHand"] = {
					["LeftWristRigAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
					["LeftGripAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
				},
				["LeftUpperArm"] = {
					["LeftShoulderRigAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
					["LeftShoulderAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
						["LeftElbowRigAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
				},
				["LeftLowerArm"] = {
					["LeftElbowRigAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
					["LeftWristRigAttachment"] = {
						["LowerBound"]: Vector3,
						["UpperBound"]: Vector3,
					},
				},
			},
		},
		...
	},
	["AccessoryRules"] = {
		[Enum.AssetType.HairAccessory] = {
			["Attachments"] = {
				{
					["Size"]: Vector3,
					["Offset"]: Vector3,
					["Name"]: string,
				},
			},
			["RigidAllowed"]: boolean,
		},
		...
	}
}

Retours

Paramètres

Retours

Obtient les détails du jeton de création d'avatar pour une liste de jetons de création d'avatar à la fois (les jetons sont générés via le processus de création de jeton ).Renvoie une série de détails de création de jeton d'avatar ; chaque détail de jeton est un dictionnaire avec les champs indiqués dans le résultat d'exemple ci-dessous :

{
	["Name"] = "string",
	["Description"] = "string",
	["UniverseId"] = 0,
	["CreatorId"] = 0,
	["CreatorType"] = Enum.CreatorType.User,
	["OnSale"] = true,
	["Price"] = 0,
	["OffSaleReasons"] = {
		"string",
	}
}

Paramètres

Retours

Paramètres

Retours

Paramètres

Retours

Paramètres

Retours

Demande à un Player d'acheter et de créer un avatar à partir d'un HumanoidDescription .Le prix de la création est dicté par le prix attribué au jeton de création d'avatar.Ce jeton de création d'avatar est requis pour l'achat et la création du corps et peut être généré en suivant le processus de création de jeton .

Pour la créationsd'un avatar, on s'attend à ce que le HumanoidDescription inclue de nouvelles ressources à créer pour chacune des 6 parties du corps (Head, Torso, RightLeg, LeftLeg, RightArm, LeftArm).Facultativement, il peut également inclure un nouvel accesoireHair .

Pour soutenir cela, le HumanoidDescription devrait inclure 6 BodyPartDescription enfants (un pour chaque partie du corps).Pour chacun, la propriété réfère à un qui inclut toutes les instances qui composent la partie du corps, par exemple un dossier qui contient , et .La propriété BodyPartDescription.BodyPart doit également être définie sur le Enum.BodyPart pertinent.

Chaque partie du corps MeshPart devra également inclure :

• An EditableImage .
• Un WrapDeformer avec un EditableMesh.

Si vous incluez un accessoire tel que les cheveux, le HumanoidDescription devrait inclure un enfant AccessoryDescription où :

• La propriété AccessoryDescription.Instance réfère à l'instance Accessory.
• La propriété AccessoryDescription.AccessoryType est définie sur la valeur pertinente Enum.AccessoryType.

Enfin, le HumanoidDescription devrait inclure les écailles humanoïdes de BodyTypeScale, HeadScale, HeightScale, WidthScale et ProportionScale.Gardez à l'esprit les échelles avec lesquelles un corps de base est importé afin qu'elles correspondent aux échelles fournies à la HumanoidDescription.

Paramètres

Retours

local AvatarCreationService = game:GetService("AvatarCreationService")
export type BodyPartInfo = {
	bodyPart: Enum.BodyPart,
	instance: Instance, --Folder with Created MeshParts
}
export type BodyPartList = { BodyPartInfo }

local function publishAvatar(bodyPartInstances: BodyPartList, player: Player, tokenId: string)
	local humanoidDescription = Instance.new("HumanoidDescription")
	for _, bodyPartInfo in bodyPartInstances do
		local bodyPartDescription = Instance.new("BodyPartDescription")
		bodyPartDescription.Instance = bodyPartInfo.instance
		bodyPartDescription.BodyPart = bodyPartInfo.bodyPart
		bodyPartDescription.Parent = humanoidDescription
	end

	local pcallSuccess, result, resultMessage = pcall(function()
		return AvatarCreationService:PromptCreateAvatarAsync(tokenId, player, humanoidDescription)
	end)
	if pcallSuccess then
		if result == Enum.PromptCreateAvatarResult.Success then
			print("Successfully uploaded with BundleId: ", resultMessage)
		else
			print("Unsuccessfully uploaded with error message:", resultMessage)
		end
	else
		print("Avatar failed to create.")
	end
end

Studio uniquement. Donné un Player et Instance pour un Enum.AccessoryType, détermine si la validation de l'UGC passe.

Paramètres

Retours

Studio uniquement.Donné un Player et Instance pour un Enum.BodyPart , détermine si la validation de l'UGC passe.Le paramètre instance est attendu comme un Folder dans le format d'exemple suivant avec le paramètre pertinent MeshParts :

• LeftArm ( Folder )

  • R15ArtistIntent ( Folder )

    • LeftLowerArm ( MeshPart )
    • LeftUpperArm ( MeshPart )
    • LeftHand ( MeshPart )

Cependant, si la valeur attendue bodyPart est Enum.BodyPart.Head , la fonction prend un singulier Head``Class.MeshPart directement.

Paramètres

Retours

Studio uniquement. Étant donné un Player et HumanoidDescription, toutes les instances dans le HumanoidDescription seront validées.

On s'attend à ce que le HumanoidDescription inclue des instances définies sur BodyPartDescription les enfants pour chacune des 6 valeurs Enum.BodyPart requises.Facultativement, elle peut inclure des instances définies sur AccessoryDescription enfants pour Eyebrow , Eyelash , et Hair``Enum.AccessoryType|AccessoryTypes .

Paramètres

Retours

Paramètres