AvatarEditorService

Métodos

GetAccessoryType(avatarAssetType : Enum.AvatarAssetType):Enum.AccessoryType
PromptAllowInventoryReadAccess():void
Prompts the Players.LocalPlayer to allow the developer to read what items the user has in their inventory and other avatar editor related information.
PromptCreateOutfit(outfit : HumanoidDescription,rigType : Enum.HumanoidRigType):void
Prompts the Players.LocalPlayer to save the given HumanoidDescription as an outfit.
PromptDeleteOutfit(outfitId : number):void
Prompts the Players.LocalPlayer to delete the given outfit.
PromptRenameOutfit(outfitId : number):void
Prompts the Players.LocalPlayer to rename the given outfit.
PromptSaveAvatar(humanoidDescription : HumanoidDescription,rigType : Enum.HumanoidRigType):void
Prompts the Players.LocalPlayer to update their avatar based on the given HumanoidDescription and Enum.RigType of R6 or R15.
PromptSetFavorite(itemId : number,itemType : Enum.AvatarItemType,shouldFavorite : bool):void
Prompts the Players.LocalPlayer to favorite or unfavorite the given asset or bundle.
PromptUpdateOutfit(outfitId : number,updatedOutfit : HumanoidDescription,rigType : Enum.HumanoidRigType):void
Prompts the Players.LocalPlayer to update the given outfit.
CheckApplyDefaultClothing(humanoidDescription : HumanoidDescription):HumanoidDescription
proporciona
Used to apply default clothing to the HumanoidDescription if necessary.
ConformToAvatarRules(humanoidDescription : HumanoidDescription):HumanoidDescription
proporciona
GetAvatarRules():Dictionary
proporciona
Returns the platform Avatar rules for things such as scaling, default shirts and pants, number of wearable assets.
GetBatchItemDetails(itemIds : Array,itemType : Enum.AvatarItemType):Array
proporciona
Gets the item details for a list of items at once.
GetFavorite(itemId : number,itemType : Enum.AvatarItemType):bool
proporciona
Returns if the Players.LocalPlayer has favorited the given bundle or asset.
GetInventory(assetTypes : Array):InventoryPages
proporciona
Returns an InventoryPages object with information about owned items in the users inventory with the given AvatarAssetTypes.
GetItemDetails(itemId : number,itemType : Enum.AvatarItemType):Dictionary
proporciona
Returns the item details for the given item.
GetOutfitDetails(outfitId : number):Dictionary
proporciona
Returns the outfit details for the given outfit.
GetOutfits(outfitSource : Enum.OutfitSource,outfitType : Enum.OutfitType):OutfitPages
proporciona
Returns outfit data for the Players.LocalPlayer.
GetRecommendedAssets(assetType : Enum.AvatarAssetType,contextAssetId : number):Array
proporciona
Returns a list of recommended assets based on a given Enum.AssetType and asset id.
GetRecommendedBundles(bundleId : number):Array
proporciona
Returns a list of recommended bundles for a given bundle id.
SearchCatalog(searchParameters : CatalogSearchParams):CatalogPages
proporciona
Returns a CatalogPages object containing the result of the given search.

Eventos

PromptAllowInventoryReadAccessCompleted(result : Enum.AvatarPromptResult):RBXScriptSignal
Fires when the AvatarEditorService:PromptAllowInventoryReadAccess() prompt is responded to by the user.
PromptCreateOutfitCompleted(result : Enum.AvatarPromptResult,failureType : Variant):RBXScriptSignal
Fires when the PromptSaveOutfit operation is completed.
PromptDeleteOutfitCompleted(result : Enum.AvatarPromptResult):RBXScriptSignal
Fires when the PromptDeleteOutfit operation is completed.
PromptRenameOutfitCompleted(result : Enum.AvatarPromptResult):RBXScriptSignal
Fires when the PromptRenameOutfit operation is completed.
PromptSaveAvatarCompleted(result : Enum.AvatarPromptResult,humanoidDescription : HumanoidDescription):RBXScriptSignal
Fires when the AvatarEditorService:PromptSaveAvatar() operation is completed.
PromptSetFavoriteCompleted(result : Enum.AvatarPromptResult):RBXScriptSignal
Fires when the AvatarEditorService:PromptSetFavorite() operation is completed.
PromptUpdateOutfitCompleted(result : Enum.AvatarPromptResult):RBXScriptSignal
Fires when the AvatarEditorService:PromptUpdateOutfit() operation is completed.

Propiedades

Métodos

PromptAllowInventoryReadAccess

void

Prompts the Players.LocalPlayer to allow the developer to read what items the user has in their inventory and other avatar editor related information. The prompt needs to be confirmed by the user for the developer to use AvatarEditorService:GetInventory(), AvatarEditorService:GetOutfits() and AvatarEditorService:GetFavorite(). Permission does not persist between sessions.

Devuelve

void

PromptCreateOutfit

void

Prompts the Players.LocalPlayer to save the given HumanoidDescription as an outfit. Does not yield. The result can be retrieved by listening to the AvatarEditorService.PromptCreateOutfitCompleted event.

Parámetros

outfit: HumanoidDescription

The Outfit that the player will be prompted to created.

rigType: Enum.HumanoidRigType

The Enum.RigType that the outfit will be created for if the player confirms the prompt.

Devuelve

void

PromptDeleteOutfit

void

Prompts the Players.LocalPlayer to delete the given outfit. Does not yield. The result can be retrieved by listening to the AvatarEditorService.PromptDeleteOutfitCompleted event.

Parámetros

outfitId: number

The outfitId of the outfit to delete.

Devuelve

void

PromptRenameOutfit

void

Prompts the Players.LocalPlayer to rename the given outfit. Does not yield. The result can be retrieved by listening to the AvatarEditorService.PromptRenameOutfitCompleted event.

Parámetros

outfitId: number

The outfitId of the outfit to rename.

Devuelve

void

PromptSaveAvatar

void

This function prompts the Players.LocalPlayer to update their avatar based on the given HumanoidDescription and Enum.RigType (R6 or R15). Does not yield and can get the result by listening to the PromptSaveAvatarCompleted event. This is similar to how other prompts such as PromptPurchase work.

Parámetros

humanoidDescription: HumanoidDescription

The given HumanoidDescription being prompted to save.

rigType: Enum.HumanoidRigType

The Enum.RigType that the avatar will be saved for if the player confirms the prompt.

Devuelve

void

PromptSetFavorite

void

This function prompts the Players.LocalPlayer to favorite or unfavorite the given asset or bundle.

Parámetros

itemId: number

The ItemId of the item being prompted to favorite.

itemType: Enum.AvatarItemType

The type of item being prompted to favorite.

shouldFavorite: bool

Devuelve

void

PromptUpdateOutfit

void

Prompts the Players.LocalPlayer to update the given outfit with the given HumanoidDescription.

Parámetros

outfitId: number

The outfitId of the outfit to update.

updatedOutfit: HumanoidDescription

A HumanoidDescription that represents the new outfit data.

rigType: Enum.HumanoidRigType

The HumanoidRigType to update the outfit to.

Devuelve

void

CheckApplyDefaultClothing

proporciona

Returns a new HumanoidDescription with the Shirt and Pants properties updated if necessary. Returns nil if default clothing was not needed.

Default clothing is necessary if the HumanoidDescription does not currently have Shirt and Pants equipped and the body colors are too similar.

Parámetros

humanoidDescription: HumanoidDescription

The HumanoidDescription to check if default clothing is required.

Devuelve

Returns a HumanoidDescription if default clothing was necessary. Otherwise returns nil.

ConformToAvatarRules

proporciona

Parámetros

humanoidDescription: HumanoidDescription

Devuelve

GetAvatarRules

proporciona

This function returns the platform Avatar rules for things like scaling, default shirts and pants, number of wearable assets, ect.

The returned table includes the following fields:


{
  "PlayerAvatarTypes": [
    "R6"
  ],
  "Scales": {},
  "WearableAssetTypes": [
    {
      "MaxNumber": 0,
      "Id": 0,
      "Name": "string"
    }
  ],
  "BodyColorsPalette": [
    {
      "BrickColorId": 0,
      "NexColor": "string",
      "Name": "string"
    }
  ],
  "BasicBodyColorsPalette": [
    {
      "BrickColorId": 0,
      "HexColor": "string",
      "Name": "string"
    }
  ],
  "MinimumDeltaEBodyColorDifference": 0,
  "ProportionsAndBodyTypeEnabledForUser": true,
  "DefaultClothingAssetLists": {
    "DefaultShirtAssetIds": [
      0
    ],
    "DefaultPantAssetIds": [
      0
    ]
  },
  "BundlesEnabledForUser": true,
  "EmotesEnabledForUser": true
}

Devuelve

A dictionary containing the platform Avatar rules for things like scaling, default shirts and pants, number of wearable assets, ect. See the example return in the main description above.

GetBatchItemDetails

proporciona

Gets the item details for a list of items at once. More efficient than AvatarEditorService:GetItemDetails if you need to get all the item details of a list.

Parámetros

itemIds: Array

The list of item ids to get details of.

itemType: Enum.AvatarItemType

The type of the item ids provided.

Devuelve

Returns an array of item details with the following fields:


{
    "AssetType" = "string",
    "CreatorName" = "string",
    "CreatorTargetId" = 0,
    "CreatorType" = "string",
    "Description" = "string",
    "FavoriteCount" = 0,
    "Genres" = [
      "All"
    ],
    "Id" = 0,
    "ItemRestrictions" = [
      "Limited"
    ],
    "ItemStatus": [
      "New"
    ],
    "ItemType" = "string",
    "LowestPrice" = 0,
    "Name" = "string",
    "Price" = 0,
    "ProductId" = 0
  }

GetFavorite

bool

proporciona

This function returns if the Players.LocalPlayer has favorited the given bundle or asset.

Parámetros

itemId: number

The id of the specified asset or bundle.

itemType: Enum.AvatarItemType

The Enum.AvatarItemType of the specified asset or bundle.

Devuelve

bool

Whether the LocalPlayer has favorited the given bundle or asset.

GetInventory

InventoryPages

proporciona

Returns an InventoryPages object with information about owned items in the users inventory with the given AvatarAssetTypes.

The returned table includes the following fields:


[
    {
      "AssetId": 0,
      "AssetType" : "string",
      "Created": "string",
      "Name": "string",
    }
]

Parámetros

assetTypes: Array

The Enum.AvatarAssetType that can will be checked for in the player's inventory.

Devuelve

InventoryPages

GetItemDetails

proporciona

This function returns the item details for the given item. It accepts two parameters - the first indicating the ID of the item being retrieved and the second indicating its Enum.ItemType.

Data returned in the format:


{
  "IsForRent": true,
  "ExpectedSellerId": 0,
  "Owned": true,
  "IsPurchasable": true,
  "Id": 0,
  "ItemType": "Asset",
  "AssetType": "Image",
  "BundleType": "BodyParts",
  "Name": "string",
  "Description": "string",
  "ProductId": 0,
  "Genres": [
    "All"
  ],
  "BundledItems": [
    {
      "Owned": true,
      "Id": 0,
      "Name": "string",
      "Type": "string"
    }
  ],
  "ItemStatus": [
    "New"
  ],
  "ItemRestrictions": [
    "ThirteenPlus"
  ],
  "CreatorType": "User",
  "CreatorTargetId": 0,
  "CreatorName": "string",
  "Price": 0,
  "PremiumPricing": {
    "PremiumDiscountPercentage": 0,
    "PremiumPriceInRobux": 0
  },
  "LowestPrice": 0,
  "PriceStatus": "string",
  "UnitsAvailableForConsumption": 0,
  "PurchaseCount": 0,
  "FavoriteCount": 0
}

To query for limited or unlimited assets, use the following itemRestrictions values:

itemRestrictions	Limited or Unlimited
empty	Unlimited
Collectible	UGC Limited
Limited	Roblox Limited
LimitedUnique	Roblox Limited Unique

Parámetros

itemId: number

The ID of the item whose details are being retrieved.

itemType: Enum.AvatarItemType

An enum value indicating the type of item whose details are being retrieved.

Devuelve

A table containing the item info for the retrieved item. See above for a sample table.

GetOutfitDetails

proporciona

This function returns the outfit details for the given outfit. It accepts one parameter: the ID of the outfit.

Data returns in the following format:


{
  "Assets": [
    {
      "AssetType": {
        "Id": 31,
        "Name": "RightLeg"
      }
      "CurrentVersionId": 16447385805,
      "Id": 11584239464,
      "Name": "Anime Female - Right Leg"
    }
  ],
  "BodyColors": {
    "HeadColor": Color3(204, 142, 105),
    "LeftArmColor": Color3(204, 142, 105),
    "LeftLegColor": Color3(204, 142, 105),
    "RightArmColor": Color3(204, 142, 105),
    "RightLegColor": Color3(204, 142, 105),
    "TorsoColor": Color3(204, 142, 105)
  },
  "Id": 14703770624,
  "IsEditable": true,
  "ModerationStatus": Enum.ModerationStatus.ReviewedApproved,
  "Name": "Your Costume",
  "OutfitType": "Avatar",
  "PlayerAvatarType": "R15",
  "Scale": {
    "BodyType": 0,
    "Depth": 1,
    "Head": 1,
    "Height": 1,
    "Proportion": 0,
    "Width": 1
  },
}

Parámetros

outfitId: number

The ID of the outfit whose details are being retrieved.

Devuelve

A table containing the outfit info for the retrieved outfit. See above for a sample table.

GetOutfits

OutfitPages

proporciona

This function returns outfit data for the Players.LocalPlayer. This would be used with Players:GetHumanoidDescriptionFromOutfitId() to update the players character to the outfit. Access to this would also depend on AvatarEditorService:PromptAllowInventoryReadAccess() being accepted by the user.

The returned table includes the following fields:


[
    {
      "Id": 0,
      "Name": "string",
      "IsEditable": true
    }
]

Name	type	Description
id	int
name	string
isEditable	boolean

Parámetros

outfitSource: Enum.OutfitSource

Valor predeterminado: "All"

outfitType: Enum.OutfitType

Valor predeterminado: "All"

Devuelve

OutfitPages

GetRecommendedAssets

proporciona

Returns a list of recommended assets based on a given Enum.AssetType and asset id. Use this to gather a list of similar assets to the asset provided. Take a look at the code sample below for more information on possible usages for this function.

Data is in the format:


[
    {
      "Item": {
        "AssetId": 0,
        "Name": "string",
        "Price": 0,
        "PremiumPrice": 0,
      },
      "Creator": {
        "CreatorId": 0,
        "CreatorType": "string",
        "Name": "string",
      },
      "Product": {
        "Id": 0,
        "PriceInRobux": 0,
        "IsForSale": true,
        "IsResellable": true,
        "IsLimited": true,
        "IsLimitedUnique": true,
        "TotalPrivateSales": 0,
        "OffsaleDeadline": "string",
        "IsFree": true
      }
    }
]

Parámetros

assetType: Enum.AvatarAssetType

The type of asset recommendations to retrieve recommendations for. Only affects the response when item based recommendations don't exist for the given contextAssetId.

contextAssetId: number

The id of an asset with a type matching the provided assetType used for context when retrieving recommendations.

Valor predeterminado: 0

Devuelve

A list of recommendations based on the given Enum.AssetType.

Muestras de código

Getting a Hat Recommendation

local AvatarEditorService = game:GetService("AvatarEditorService")

local assets = AvatarEditorService:GetRecommendedAssets(Enum.AvatarAssetType.Hat, 9255093)

for _, asset in ipairs(assets) do
	print(asset.Item.Name)
end

GetRecommendedBundles

proporciona

This function returns a list of recommended bundles for a given bundle id.

Data is in the format:


[
    {
      "Id": 0,
      "Name": "string",
      "Description": "string",
      "BundleType": "string",
      "Items": [
        {
          "Owned": true,
          "Id": 0,
          "Name": "string",
          "Type": "string"
        }
      ],
      "Creator": {
        "Id": 0,
        "Name": "string",
        "Type": "string"
      },
      "Product": {
        "Id": 0,
        "Type": "string",
        "IsPublicDomain": true,
        "IsForSale": true,
        "PriceInRobux": 0,
        "PremiumPricing": {
          "PremiumDiscountPercentage": 0,
          "PremiumPriceInRobux": 0
        }
      }
    }
]

Parámetros

bundleId: number

A list of recommended bundles.

Devuelve

The bundle ID that the recommended bundles will be returned for.

SearchCatalog

CatalogPages

proporciona

This function returns a CatalogPages object containing the result of the given search.

The returned data has the format:


[
    {
      "Id": 0,
      "ItemType": "Asset",
      "AssetType": "Image",
      "BundleType": "BodyParts",
      "Name": "string",
      "Description": "string",
      "ProductId": 0,
      "Genres": [
        "All"
      ],
      "BundledItems": [
        {
          "Owned": true,
          "Id": 0,
          "Name": "string",
          "Type": "string"
        }
      ],
      "ItemStatus": [
        "New"
      ],
      "ItemRestrictions": [
        "ThirteenPlus"
      ],
      "CreatorType": "User",
      "CreatorTargetId": 0,
      "CreatorName": "string",
      "Price": 0,
      "PremiumPricing": {
        "PremiumDiscountPercentage": 0,
        "PremiumPriceInRobux": 0
      },
      "LowestPrice": 0,
      "PriceStatus": "string",
      "UnitsAvailableForConsumption": 0,
      "PurchaseCount": 0,
      "FavoriteCount": 0
    }
]

Parámetros

searchParameters: CatalogSearchParams

An object containing the parameters used for the search.

Devuelve

CatalogPages

Eventos

PromptAllowInventoryReadAccessCompleted

This event fires when the AvatarEditorService:PromptAllowInventoryReadAccess() prompt is responded to by the user. It can only return the Success or PermissionDenied enum statuses as it does not perform any web requests which could fail.

Parámetros

The result of the prompt.

PromptCreateOutfitCompleted

This event fires when the PromptSaveOutfit operation is completed. It gives a status enum indicating whether the prompt succeeded, failed or permission was not granted by the user.

Parámetros

The result of the prompt.

failureType: Variant

PromptDeleteOutfitCompleted

Fires when the PromptDeleteOutfit operation is completed. It gives a status enum indicating whether the prompt succeeded, failed or permission was not granted by the user.

Parámetros

The result of the prompt.

PromptRenameOutfitCompleted

Fires when the PromptRenameOutfit operation is completed. It gives a status enum indicating whether the prompt succeeded, failed or permission was not granted by the user.

Parámetros

The result of the prompt.

PromptSaveAvatarCompleted

This event fires when the AvatarEditorService:PromptSaveAvatar() operation is completed. It gives a status enum indicating whether the prompt succeeded, failed or permission was not granted by the user.

Parámetros

The result of the prompt.

humanoidDescription: HumanoidDescription

PromptSetFavoriteCompleted

Fires when the AvatarEditorService:PromptSetFavorite() operation is completed. It gives a status enum indicating whether the prompt succeeded, failed or permission was not granted by the user.

Parámetros

The result of the prompt.

PromptUpdateOutfitCompleted

Fires when the AvatarEditorService:PromptUpdateOutfit() operation is completed. It gives a status enum indicating whether the prompt succeeded, failed or permission was not granted by the user.

Parámetros

The result of the prompt.