배우기
엔진 클래스
AvatarCreationService
만들 수 없음
서비스

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.



API 참조
메서드
AutoSetupAvatarAsync
생성
기능: DynamicGeneration
AvatarCreationService:AutoSetupAvatarAsync(
player:Player, autoSetupParams:Dictionary, progressCallback:function?
매개 변수
player:Player
autoSetupParams:Dictionary
progressCallback:function?
반환
코드 샘플
자동 설정 아바타 비동기
local AvatarCreationService = game:GetService("AvatarCreationService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local LoadAvatarEvent = ReplicatedStorage.LoadAvatarEvent
local generatedAvatars = {}
-- 서버에서 호출해야 합니다.
local function setupAvatar(player: Player, avatarModel: Model, layeredShirtModel : Model)
local arguments = {
Body = avatarModel,
Accessories = {}
}
local accessoryArgument = {
AccessoryType = Enum.AccessoryType.Shirt,
IsLayered = true,
Instance = layeredShirtModel,
}
table.insert(arguments.Accessories, accessoryArgument)
local pcallSuccess, result = pcall(function()
local generationId = AvatarCreationService:AutoSetupAvatarAsync(
player,
arguments,
function(progressInfo)
print(`AutoSetup 진행 중: {progressInfo.Progress * 100}%`)
end
)
-- PromptCreateAvatarAsync와 함께 사용하기 위해 서버에 로드하고 저장합니다.
local humanoidDescription = AvatarCreationService:LoadGeneratedAvatarAsync(generationId)
generatedAvatars[generationId] = humanoidDescription
-- 클라이언트에 신호를 보내 아바타를 로컬 미리보기로 로드할 수 있도록 합니다.
LoadAvatarEvent:FireClient(player, generationId)
end)
if not pcallSuccess then
warn("아바타 설정 실패:", result)
end
end

GenerateAvatar2DPreviewAsync
생성
기능: DynamicGeneration
AvatarCreationService:GenerateAvatar2DPreviewAsync(
avatarGeneration2dPreviewParams:Dictionary, progressCallback:function?
매개 변수
avatarGeneration2dPreviewParams:Dictionary
progressCallback:function?
반환

GenerateAvatarAsync
생성
기능: DynamicGeneration
AvatarCreationService:GenerateAvatarAsync(
avatarGenerationParams:Dictionary, progressCallback:function?
매개 변수
avatarGenerationParams:Dictionary
progressCallback:function?
반환

GetBatchTokenDetailsAsync
생성
기능: Monetization
AvatarCreationService:GetBatchTokenDetailsAsync(tokenIds:{any}):{any}
매개 변수
tokenIds:{any}
반환

GetValidationRules
AvatarCreationService:GetValidationRules():Dictionary

LoadAvatar2DPreviewAsync
생성
기능: DynamicGeneration
AvatarCreationService:LoadAvatar2DPreviewAsync(previewId:string):EditableImage
매개 변수
previewId:string

LoadGeneratedAvatarAsync
생성
기능: DynamicGeneration
AvatarCreationService:LoadGeneratedAvatarAsync(generationId:string):HumanoidDescription
매개 변수
generationId:string
코드 샘플
로드 생성된 아바타 비동기
local AvatarCreationService = game:GetService("AvatarCreationService")
local Players = game:GetService("Players")
-- 서버나 클라이언트에서 호출할 수 있습니다
local function loadAvatar(generationId: string): Model?
local pcallSuccess, result = pcall(function()
local humanoidDescription = AvatarCreationService:LoadGeneratedAvatarAsync(generationId)
local model = Players:CreateHumanoidModelFromDescriptionAsync(humanoidDescription, Enum.HumanoidRigType.R15)
return model
end)
if pcallSuccess then
return result
else
print("아바타 로딩에 실패했습니다:", result)
return nil
end
end

PrepareAvatarForPreviewAsync
생성
기능: AvatarAppearance
AvatarCreationService:PrepareAvatarForPreviewAsync(humanoidModel:Model):()
매개 변수
humanoidModel:Model
반환
()

PromptCreateAvatarAssetAsync
생성
AvatarCreationService:PromptCreateAvatarAssetAsync(
tokenId:string, player:Player, assetInstance:Instance, assetType:Enum.AvatarAssetType
매개 변수
tokenId:string
player:Player
assetInstance:Instance
반환
코드 샘플
아바타 자산 생성 요청
local AvatarCreationService = game:GetService("AvatarCreationService")
local function publishAvatarAsset(tokenId: string, player: Player, assetInstance: Accessory, assetType: Enum.AvatarAssetType)
local pcallSuccess, result, resultMessage = pcall(function()
return AvatarCreationService:PromptCreateAvatarAssetAsync(tokenId, player, assetInstance, assetType)
end)
if pcallSuccess then
if result == Enum.PromptCreateAssetResult.Success then
print("자산 ID로 성공적으로 업로드되었습니다: ", resultMessage)
else
print("오류 메시지로 업로드에 실패했습니다:", resultMessage)
end
else
print("아바타 자산 생성에 실패했습니다.")
end
end

PromptCreateAvatarAsync
생성
기능: AssetCreateUpdate, Monetization
AvatarCreationService:PromptCreateAvatarAsync(
tokenId:string, player:Player, humanoidDescription:HumanoidDescription
매개 변수
tokenId:string
player:Player
humanoidDescription:HumanoidDescription
반환
코드 샘플
아바타생성프롬프트비동기
local AvatarCreationService = game:GetService("AvatarCreationService")
export type BodyPartInfo = {
bodyPart: Enum.BodyPart,
instance: Instance, -- 생성된 메시 파트가 들어 있는 폴더
}
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("번들 ID로 성공적으로 업로드됨: ", resultMessage)
else
print("오류 메시지와 함께 업로드 실패:", resultMessage)
end
else
print("아바타 생성에 실패했습니다.")
end
end

PromptSelectAvatarGenerationImageAsync
생성
기능: SensitiveInput
AvatarCreationService:PromptSelectAvatarGenerationImageAsync(player:Player):string
매개 변수
player:Player
반환

RequestAvatarGenerationSessionAsync
생성
기능: DynamicGeneration
AvatarCreationService:RequestAvatarGenerationSessionAsync(
player:Player, callback:function
매개 변수
player:Player
callback:function
반환

ValidateUGCAccessoryAsync
생성
AvatarCreationService:ValidateUGCAccessoryAsync(
player:Player, accessory:Instance, accessoryType:Enum.AccessoryType
매개 변수
player:Player
accessory:Instance
accessoryType:Enum.AccessoryType
반환

ValidateUGCBodyPartAsync
생성
AvatarCreationService:ValidateUGCBodyPartAsync(
player:Player, instance:Instance, bodyPart:Enum.BodyPart
매개 변수
player:Player
instance:Instance
bodyPart:Enum.BodyPart
반환

ValidateUGCFullBodyAsync
생성
AvatarCreationService:ValidateUGCFullBodyAsync(
player:Player, humanoidDescription:HumanoidDescription
매개 변수
player:Player
humanoidDescription:HumanoidDescription
반환

이벤트
AvatarAssetModerationCompleted
기능: DynamicGeneration
AvatarCreationService.AvatarAssetModerationCompleted(
assetId:number, moderationStatus:Enum.ModerationStatus
매개 변수
assetId:number
moderationStatus:Enum.ModerationStatus
코드 샘플
local AvatarCreationService = game:GetService("AvatarCreationService")
local conn = AvatarCreationService.AvatarAssetModerationCompleted:Connect(function(assetId, moderationStatus)
print("자산, " .. assetId .. ", 검토 상태가 준비되었습니다: " .. moderationStatus)
end)

AvatarModerationCompleted
기능: DynamicGeneration
AvatarCreationService.AvatarModerationCompleted(
outfitId:number, moderationStatus:Enum.ModerationStatus
매개 변수
outfitId:number
moderationStatus:Enum.ModerationStatus

©2026 Roblox Corporation. Roblox 및 Roblox 로고, 'Powering Imagination'은 미국 및 기타 국가 내 당사의 등록 및 미등록 상표입니다.