사진에서 아바타 생성 기능은 현재 알파 버전입니다. 최신 정보는 DevForum 발표를 참조하세요.
다음 가이드는 스크립팅 및 Roblox Studio에 익숙한 제작자에게 적용되며, 사용자 생성 아바타 아이템을 허용하는 게임을 개발할 의도가 있는 경우에 해당합니다.
사진과 텍스트 프롬프트를 사용하여 플레이어가 완전한 기능을 갖춘 아바타 캐릭터를 생성할 수 있는 게임을 만들 수 있습니다.
이 과정은 다음 단계로 구성됩니다:
- 아바타 생성 세션 요청.
- 사용자가 셀카를 찍고 아바타의 2D 미리보기 이미지를 생성하도록 유도.
- HumanoidDescription을 사용하여 전체 아바타 캐릭터 생성.
아바타 생성 세션 요청
사진에서 아바타 생성을 시작하려면, 서버에서 AvatarCreationService:RequestAvatarGenerationSessionAsync()를 호출하여 플레이어를 위한 세션을 요청합니다. 세션은 특정 수의 아바타 미리보기 및 아바타 생성을 Player에 제공합니다.
세션이 사용 가능해지기까지 시간이 걸릴 수 있으므로, AvatarCreationService:RequestAvatarGenerationSessionAsync()는 RBXScriptConnection과 대기 시간(초)을 반환합니다. 대기 시간은 Player에게 생성 시작까지 걸리는 시간을 제공하는 데 사용할 수 있습니다.
세션이 준비되면, 콜백이 세션에 대한 정보가 담긴 Dictionary와 함께 호출됩니다. Dictionary에는 다음이 포함됩니다:
- SessionId — AvatarCreationService:GenerateAvatar2DPreviewAsync() 및 AvatarCreationService:GenerateAvatarAsync()를 호출할 때 인수로 전달됩니다.
- Allowed2DGenerations — 세션에서 허용되는 2D 미리보기 생성 수.
- Allowed3DGenerations — 세션에서 허용되는 아바타 생성 수.
- SessionTime — 세션의 최대 시간(초).
셀카 촬영 및 2D 미리보기 생성
세션이 시작된 후, 사용자가 셀카를 찍도록 유도하고 서버에서 AvatarCreationService:PromptSelectAvatarGenerationImageAsync() 메서드를 호출하여 fileId string을 가져옵니다. 이 fileId는 AvatarCreationService:GenerateAvatar2DPreviewAsync() 메서드에 전달됩니다.
아바타의 2D 미리보기 이미지를 생성하려면 다음 메서드를 호출합니다:
AvatarCreationService:GenerateAvatar2DPreviewAsync()는 SessionId, fileId 및 선택적 텍스트 프롬프트를 입력으로 받아 2D 아바타 미리보기를 생성합니다. 이 메서드는 previewId를 반환합니다.
이 previewId는 클라이언트로 전송되어 EditableImage로 미리보기를 검색하는 데 사용될 수 있습니다.
사용자가 생성된 미리보기에 만족하지 않는 경우, 이 작업 흐름을 반복할 수 있습니다.
아바타 생성
사용자가 미리보기에 만족하면, 전체 3D 아바타 캐릭터를 생성할 수 있습니다.
아바타 캐릭터를 생성하려면:
- 서버에서 AvatarCreationService:GenerateAvatarAsync()를 호출하고 SessionId와 PreviewId를 포함하는 Dictionary를 전달합니다.
- 이 메서드 호출은 string generationId를 반환합니다.
- 게임 서버와 클라이언트 모두에서 AvatarCreationService:LoadGeneratedAvatarAsync() 메서드를 사용하여 생성된 아바타 데이터를 HumanoidDescription으로 가져옵니다.
- Players.CreateHumanoidModelFromDescription 메서드를 사용하여 HumanoidDescription에서 아바타 모델을 생성하여 Player에게 표시합니다.
메시 및 텍스처 자산은 각각 EditableMesh 및 EditableImage 객체로 제공되어 생성된 아바타의 지속적인 편집을 허용합니다. 편집은 게임 서버와 클라이언트 복사본 모두에서 수행되어야 하며, 이를 통해 게시를 위해 동기화 상태를 유지해야 합니다.
아바타 게시
사용자가 결과 아바타에 만족하면 AvatarCreationService:PromptCreateAvatarAsync() 메서드를 사용하여 게시할 수 있습니다.
자세한 내용은 게임 내 생성을 참조하세요.