AvatarCreationService

Erhalte Daten über Regeln, die Assets einhalten müssen, um die UGC-Validierung zu bestehen.Die Validierung ist ein wesentlicher Schritt vor der Erstellung von Avataren und es gibt verschiedene Überprüfungen, die auftreten, einschließlich Netzwerk-Dreieckslimits, Texturgrößen, Körperteilgrößenlimits, Anbringungs位置 und mehr.

Die zurückgegebene Diktion der Validierungsregeln nimmt die folgende Form an:

{
	["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,
		},
		...
	}
}

Rückgaben

Parameter

Rückgaben

Hält die Details der Avatarerstellungs-Token für eine Liste von Avatarerstellungs-Token auf einmal bereit (Token werden durch den Token-Erstellungsprozess erzeugt).Gibt eine Reihe von Details der Avatarerstellungs-Token zurück; jedes Token-Detail ist ein Wörterbuch mit den Feldern, die im Beispiel-Ergebnis unten angezeigt werden:

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

Parameter

Rückgaben

Parameter

Rückgaben

Parameter

Rückgaben

Parameter

Rückgaben

Fragt einen Player nach, einen Avatar aus einem HumanoidDescription zu kaufen und zu erstellen.Der Preis der Erstellung wird durch den Preis bestimmt, der dem Avatar-Erstellungs-Token zugeschrieben wird.Dieses Avatar-Erstellungs-Token ist für den Kauf und die Erstellung des Körpers erforderlich und kann durch den Token-Erstellungsprozess generiert werden.

Für die Schöpfungwird erwartet, dass das HumanoidDescription neue Assets enthält, die für jedes der 6 Körperteile erstellt werden müssen (Head , Torso , RightLeg , LeftLeg , RightArm , LeftArm).Optional kann es auch ein neues Hair Accessoireenthalten.

Um dies zu unterstützen, sollte die 6 Kinder (eins für jedes Körperteil) enthalten (eins für jedes Körperteil).Für jede bezieht sich die -Eigenschaft auf eine , die alle Instanzen enthält, die den Körperteil bilden, zum Beispiel einen -Ordner, der , und enthält.Die Eigenschaft BodyPartDescription.BodyPart sollte auch auf die entsprechende Enum.BodyPart festgelegt werden.

Jedes Körperteil MeshPart muss auch enthalten:

• An EditableImage .
• Ein WrapDeformer mit einem EditableMesh.

Wenn ein Zubehör wie Haare enthalten ist, sollte die ein Kind enthalten, in dem:

• Die Eigenschaft AccessoryDescription.Instance verweist auf die Accessory Instanz.
• Die Eigenschaft AccessoryDescription.AccessoryType wird auf den relevanten Enum.AccessoryType festgelegt.

Schließlich sollte die HumanoidDescription die menschlichen Skalierungen von BodyTypeScale, HeadScale, HeightScale, WidthScale und ProportionScale enthalten.Achten Sie auf die Skalierungen, mit denen ein Basiskörper importiert wird, damit sie den Skalierungen entsprechen, die für den HumanoidDescription bereitgestellt wurden.

Parameter

Rückgaben

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

Nur Studio. Gegeben ein Player und Instance für ein Enum.AccessoryType , bestimmt, ob die UGC-Validierung bestanden wird.

Parameter

Rückgaben

Nur Studio.Angesichts von Player und Instance für ein Enum.BodyPart bestimmt es, ob die UGC-Validierung bestanden wird.Der instance -Parameter wird als Folder im folgenden Beispielformat mit relevanten MeshParts erwartet:

• LeftArm ( Folder )

  • R15ArtistIntent ( Folder )

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

Wenn jedoch das erwartete erwartet wird, nimmt die Funktion einen Singular direkt auf.

Parameter

Rückgaben

Nur Studio. Gegeben ein Player und HumanoidDescription , werden alle Instanzen in der HumanoidDescription validiert.

Es wird erwartet, dass das HumanoidDescription Instanzen enthält, die auf BodyPartDescription Kindern für jeden der 6 erforderlichen Enum.BodyPart Werte festgelegt sind.Optional kann es Instanzen enthalten, die auf Kindern für , und festgelegt sind.

Parameter

Rückgaben

Parameter