AvatarEditorService | Dokumentacja – Centrum twórców Roblox

Klasa silnika

AvatarEditorService

Brak możliwości tworzenia

Usługa

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Podsumowanie

Metody

CheckApplyDefaultClothing(humanoidDescription: HumanoidDescription):HumanoidDescription

Przestarzałe

CheckApplyDefaultClothingAsync(humanoidDescription: HumanoidDescription):HumanoidDescription

ConformToAvatarRules(humanoidDescription: HumanoidDescription):HumanoidDescription

Przestarzałe

ConformToAvatarRulesAsync(humanoidDescription: HumanoidDescription):HumanoidDescription

GetAccessoryType(avatarAssetType: Enum.AvatarAssetType):Enum.AccessoryType

GetAvatarRules():Dictionary

Przestarzałe

GetAvatarRulesAsync():Dictionary

GetBatchItemDetails(itemIds: {any},itemType: Enum.AvatarItemType):{any}

Przestarzałe

GetBatchItemDetailsAsync(itemIds: {any},itemType: Enum.AvatarItemType):{any}

GetBundlesByAssetIdAsync(assetId: number,limit: number):CatalogPages

GetFavorite(itemId: number,itemType: Enum.AvatarItemType):boolean

Przestarzałe

GetFavoriteAsync(itemId: number,itemType: Enum.AvatarItemType):boolean

GetHeadShapesAsync():{any}

GetInventory(assetTypes: {any}):InventoryPages

Przestarzałe

GetInventoryAsync(assetTypes: {any}):InventoryPages

GetItemDetails(itemId: number,itemType: Enum.AvatarItemType):Dictionary

Przestarzałe

GetItemDetailsAsync(itemId: number,itemType: Enum.AvatarItemType):Dictionary

GetOutfitDetails(outfitId: number):Dictionary

Przestarzałe

GetOutfitDetailsAsync(outfitId: number):Dictionary

GetOutfits(outfitSource: Enum.OutfitSource,outfitType: Enum.OutfitType):OutfitPages

Przestarzałe

GetOutfitsAsync(outfitSource: Enum.OutfitSource,outfitType: Enum.OutfitType):OutfitPages

GetRecommendedAssets(assetType: Enum.AvatarAssetType,contextAssetId: number):{any}

Przestarzałe

GetRecommendedAssetsAsync(assetType: Enum.AvatarAssetType,contextAssetId: number):{any}

GetRecommendedBundles(bundleId: number):{any}

Przestarzałe

PromptAllowInventoryReadAccess():()

PromptCreateOutfit(outfit: HumanoidDescription,rigType: Enum.HumanoidRigType,outfitOptions: Dictionary,outfitType: Variant):()

PromptDeleteOutfit(outfitId: number):()

PromptRenameOutfit(outfitId: number):()

PromptSaveAvatar(humanoidDescription: HumanoidDescription,rigType: Enum.HumanoidRigType):()

PromptSetFavorite(itemId: number,itemType: Enum.AvatarItemType,shouldFavorite: boolean):()

PromptUpdateOutfit(outfitId: number,updatedOutfit: HumanoidDescription,rigType: Enum.HumanoidRigType):()

SearchCatalog(searchParameters: CatalogSearchParams):CatalogPages

Przestarzałe

SearchCatalogAsync(searchParameters: CatalogSearchParams):CatalogPages

Zdarzenia

PromptAllowInventoryReadAccessCompleted(result: Enum.AvatarPromptResult):RBXScriptSignal

PromptCreateOutfitCompleted(result: Enum.AvatarPromptResult,failureType: Variant):RBXScriptSignal

PromptDeleteOutfitCompleted(result: Enum.AvatarPromptResult):RBXScriptSignal

PromptRenameOutfitCompleted(result: Enum.AvatarPromptResult):RBXScriptSignal

PromptSaveAvatarCompleted(result: Enum.AvatarPromptResult,humanoidDescription: HumanoidDescription):RBXScriptSignal

PromptSetFavoriteCompleted(result: Enum.AvatarPromptResult):RBXScriptSignal

PromptUpdateOutfitCompleted(result: Enum.AvatarPromptResult):RBXScriptSignal

Członkowie odziedziczeni

57 odziedziczonych od: Instance

6 odziedziczonych od: Object

Materiały referencyjne dotyczące interfejsów API

Metody

CheckApplyDefaultClothing

Przestarzałe

CheckApplyDefaultClothingAsync

Wynik

Możliwości: AvatarAppearance

AvatarEditorService:CheckApplyDefaultClothingAsync(humanoidDescription:HumanoidDescription):HumanoidDescription

Parametry

humanoidDescription:HumanoidDescription

Zwroty

HumanoidDescription

ConformToAvatarRules

Przestarzałe

ConformToAvatarRulesAsync

Wynik

Możliwości: AvatarAppearance

AvatarEditorService:ConformToAvatarRulesAsync(humanoidDescription:HumanoidDescription):HumanoidDescription

Parametry

humanoidDescription:HumanoidDescription

Zwroty

HumanoidDescription

GetAccessoryType

AvatarEditorService:GetAccessoryType(avatarAssetType:Enum.AvatarAssetType):Enum.AccessoryType

Parametry

avatarAssetType:Enum.AvatarAssetType

Zwroty

Enum.AccessoryType

GetAvatarRules

Przestarzałe

GetAvatarRulesAsync

Wynik

AvatarEditorService:GetAvatarRulesAsync():Dictionary

Zwroty

Dictionary

GetBatchItemDetails

Przestarzałe

GetBatchItemDetailsAsync

Wynik

Możliwości: AssetRead

AvatarEditorService:GetBatchItemDetailsAsync(

itemIds:{any}, itemType:Enum.AvatarItemType

):{any}

Parametry

itemIds:{any}

itemType:Enum.AvatarItemType

Zwroty

{any}

GetBundlesByAssetIdAsync

Wynik

Możliwości: AssetRead

AvatarEditorService:GetBundlesByAssetIdAsync(

assetId:number, limit:number

):CatalogPages

Parametry

assetId:number

limit:number

Wartość domyślna: 10

Zwroty

CatalogPages

GetFavorite

Przestarzałe

GetFavoriteAsync

Wynik

Możliwości: Players, AssetRead

AvatarEditorService:GetFavoriteAsync(

itemId:number, itemType:Enum.AvatarItemType

):boolean

Parametry

itemId:number

itemType:Enum.AvatarItemType

Zwroty

boolean

GetHeadShapesAsync

Wynik

Możliwości: Players, AssetRead

AvatarEditorService:GetHeadShapesAsync():{any}

Zwroty

{any}

Przykłady kodu

Uzyskiwanie kształtów głów

TEST
local AvatarEditorService = game:GetService("AvatarEditorService")

AvatarEditorService:PromptAllowInventoryReadAccess()

local result = AvatarEditorService.PromptAllowInventoryReadAccessCompleted:Wait()

if result == Enum.AvatarPromptResult.Success then
	local shapes = AvatarEditorService:GetHeadShapesAsync()
	for i, shape in ipairs(shapes) do
		print(i, shape)
	end
end

GetInventory

Przestarzałe

GetInventoryAsync

Wynik

Możliwości: Players, AssetRead

AvatarEditorService:GetInventoryAsync(assetTypes:{any}):InventoryPages

Parametry

assetTypes:{any}

Zwroty

InventoryPages

Przykłady kodu

Znajdowanie Wygasających Przedmiotów

local AvatarEditorService = game:GetService("AvatarEditorService")
local pages = AvatarEditorService:GetInventoryAsync({ Enum.AvatarAssetType.Hat })

local currentPage = pages:GetCurrentPage()
for _, item in currentPage do
	if item.ExpirationTime then
		local secondsLeft = item.ExpirationTime.UnixTimestamp - DateTime.now().UnixTimestamp
		local hoursLeft = math.floor(secondsLeft / 3600)
		if hoursLeft < 24 then
			warn(string.format("%s wygasa za %d godzin", item.Name, hoursLeft))
		end
	end
end

GetItemDetails

Przestarzałe

GetItemDetailsAsync

Wynik

Możliwości: AssetRead

AvatarEditorService:GetItemDetailsAsync(

itemId:number, itemType:Enum.AvatarItemType

):Dictionary

Parametry

itemId:number

itemType:Enum.AvatarItemType

Zwroty

Dictionary

Przykłady kodu

Sprawdzanie wygaśnięcia przedmiotu

local AvatarEditorService = game:GetService("AvatarEditorService")
local details = AvatarEditorService:GetItemDetailsAsync(105589844216517, Enum.AvatarItemType.Asset)

if details.ExpirationTime then
	local secondsLeft = details.ExpirationTime.UnixTimestamp - DateTime.now().UnixTimestamp
	local hoursLeft = math.floor(secondsLeft / 3600)
	if hoursLeft < 24 then
		warn(details.Name .. " wygasa za mniej niż 24 godziny!")
	end
end

GetOutfitDetails

Przestarzałe

GetOutfitDetailsAsync

Wynik

Możliwości: AssetRead

AvatarEditorService:GetOutfitDetailsAsync(outfitId:number):Dictionary

Parametry

outfitId:number

Zwroty

Dictionary

GetOutfits

Przestarzałe

GetOutfitsAsync

Wynik

Możliwości: Players, AssetRead

AvatarEditorService:GetOutfitsAsync(

outfitSource:Enum.OutfitSource, outfitType:Enum.OutfitType

):OutfitPages

Parametry

outfitSource:Enum.OutfitSource

Wartość domyślna: "All"

outfitType:Enum.OutfitType

Wartość domyślna: "All"

Zwroty

OutfitPages

GetRecommendedAssets

Przestarzałe

GetRecommendedAssetsAsync

Wynik

Możliwości: AssetRead

AvatarEditorService:GetRecommendedAssetsAsync(

assetType:Enum.AvatarAssetType, contextAssetId:number

):{any}

Parametry

assetType:Enum.AvatarAssetType

contextAssetId:number

Wartość domyślna: 0

Zwroty

{any}

Przykłady kodu

Uzyskiwanie rekomendacji kapelusza

local AvatarEditorService = game:GetService("AvatarEditorService")

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

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

GetRecommendedBundles

Przestarzałe

GetRecommendedBundlesAsync

Wynik

Możliwości: AssetRead

AvatarEditorService:GetRecommendedBundlesAsync(bundleId:number):{any}

Parametry

bundleId:number

Zwroty

{any}

PromptAllowInventoryReadAccess

Możliwości: Players, AssetRead

AvatarEditorService:PromptAllowInventoryReadAccess():()

Zwroty

()

PromptCreateOutfit

Możliwości: Players, PlatformAvatarEditing

AvatarEditorService:PromptCreateOutfit(

outfit:HumanoidDescription, rigType:Enum.HumanoidRigType, outfitOptions:Dictionary, outfitType:Variant

):()

Parametry

outfit:HumanoidDescription

rigType:Enum.HumanoidRigType

outfitOptions:Dictionary

Wartość domyślna: "nil"

outfitType:Variant

Zwroty

()

PromptDeleteOutfit

Możliwości: Players, PlatformAvatarEditing

AvatarEditorService:PromptDeleteOutfit(outfitId:number):()

Parametry

outfitId:number

Zwroty

()

PromptRenameOutfit

Możliwości: Players, PlatformAvatarEditing

AvatarEditorService:PromptRenameOutfit(outfitId:number):()

Parametry

outfitId:number

Zwroty

()

PromptSaveAvatar

Możliwości: Players, PlatformAvatarEditing

AvatarEditorService:PromptSaveAvatar(

humanoidDescription:HumanoidDescription, rigType:Enum.HumanoidRigType

):()

Parametry

humanoidDescription:HumanoidDescription

rigType:Enum.HumanoidRigType

Zwroty

()

PromptSetFavorite

Możliwości: Players, PlatformAvatarEditing

AvatarEditorService:PromptSetFavorite(

itemId:number, itemType:Enum.AvatarItemType, shouldFavorite:boolean

):()

Parametry

itemId:number

itemType:Enum.AvatarItemType

shouldFavorite:boolean

Zwroty

()

PromptUpdateOutfit

Możliwości: Players, PlatformAvatarEditing

AvatarEditorService:PromptUpdateOutfit(

outfitId:number, updatedOutfit:HumanoidDescription, rigType:Enum.HumanoidRigType

):()

Parametry

outfitId:number

updatedOutfit:HumanoidDescription

rigType:Enum.HumanoidRigType

Zwroty

()

SearchCatalog

Przestarzałe

SearchCatalogAsync

Wynik

Możliwości: AssetRead

AvatarEditorService:SearchCatalogAsync(searchParameters:CatalogSearchParams):CatalogPages

Parametry

searchParameters:CatalogSearchParams

Zwroty

CatalogPages

Przykłady kodu

Wyszukiwanie przedmiotów z opcjami czasowymi

local AvatarEditorService = game:GetService("AvatarEditorService")

local params = CatalogSearchParams.new()
params.SalesTypeFilter = Enum.SalesTypeFilter.TimedOptions
params.Limit = 10

local pages = AvatarEditorService:SearchCatalogAsync(params)
local results = pages:GetCurrentPage()

for _, item in results do
	if item.TimedOptions then
		for _, option in item.TimedOptions do
			local days = option.Duration / 86400
			print(string.format("%s: %d dni za %d R$", item.Name, days, option.Price))
		end
	end
end