Tạo Avatar từ Ảnh

Bạn có thể tạo một trò chơi cho phép người chơi tạo ra một nhân vật avatar hoàn chỉnh sử dụng ảnh và một lời nhắc văn bản.

Quá trình này bao gồm các bước sau:

1. Yêu cầu một phiên AvatarGeneration
2. Yêu cầu người dùng chụp một bức ảnh tự sướng và tạo ra một hình ảnh xem trước 2D của avatar
3. Tạo ra nhân vật Avatar hoàn chỉnh sử dụng HumanoidDescription

Yêu cầu một phiên AvatarGeneration

Để bắt đầu quá trình tạo avatar từ ảnh, hãy gọi AvatarCreationService:RequestAvatarGenerationSessionAsync() từ máy chủ để yêu cầu một phiên cho người chơi. Một phiên cung cấp cho Player một số lượng xem trước Avatar và tạo Avatar nhất định.

Vì có thể mất một thời gian để phiên đang có sẵn, AvatarCreationService:RequestAvatarGenerationSessionAsync() trả về một RBXScriptConnection và một waitTime tính bằng giây. waitTime có thể được sử dụng để cung cấp cho Player thông tin về thời gian sẽ mất để họ có thể bắt đầu các phiên tạo của mình.

Khi một phiên đã sẵn sàng, callback sẽ được gọi với một Dictionary thông tin về phiên. Dictionary này bao gồm:

• SessionId — được truyền như một đối số khi gọi AvatarCreationService:GenerateAvatar2DPreviewAsync() và AvatarCreationService:GenerateAvatarAsync()
• Allowed2DGenerations — số lượng tạo xem trước 2D được phép trong một phiên
• Allowed3DGenerations — số lượng tạo avatar 3D được phép trong một phiên
• SessionTime — thời gian tối đa cho một phiên tính bằng giây

Yêu cầu tự sướng và tạo hình ảnh xem trước 2D

Sau khi một phiên đã được bắt đầu, hãy yêu cầu người dùng chụp một bức ảnh tự sướng và lấy fileId string bằng cách gọi phương thức AvatarCreationService:PromptSelectAvatarGenerationImageAsync() trên máy chủ. fileId này sẽ được chuyển đến phương thức AvatarCreationService:GenerateAvatar2DPreviewAsync().

Để tạo ra một hình ảnh xem trước 2D của Avatar, hãy gọi các phương thức sau:

1. AvatarCreationService:GenerateAvatar2DPreviewAsync() trên máy chủ
2. AvatarCreationService:LoadAvatar2DPreviewAsync() trên máy khách

AvatarCreationService:GenerateAvatar2DPreviewAsync() chấp nhận SessionId, fileId và một lời nhắc văn bản tùy chọn như đầu vào để tạo ra một hình ảnh xem trước 2D của Avatar. Phương thức này trả về một previewId.

previewId này nên được gửi đến máy khách và có thể được sử dụng để lấy xem trước dưới dạng EditableImage.

Nếu người dùng không hài lòng với hình ảnh xem trước đã tạo, quy trình này có thể được lặp lại.

Tạo avatar 3D

Khi người dùng hài lòng với hình ảnh xem trước, bạn có thể tạo ra nhân vật avatar 3D hoàn chỉnh.

Để tạo ra một nhân vật avatar:

1. Gọi AvatarCreationService:GenerateAvatarAsync() trên máy chủ với một Dictionary chứa SessionId và PreviewId.

   1. Cuộc gọi phương thức này trả về một string generationId.
2. Lấy dữ liệu avatar đã tạo dưới dạng HumanoidDescription bằng cách sử dụng phương thức AvatarCreationService:LoadGeneratedAvatarAsync() trên cả máy chủ trò chơi và máy khách.
3. Bạn có thể sử dụng phương thức Players.CreateHumanoidModelFromDescription để tạo ra một mô hình avatar từ HumanoidDescription để hiển thị cho Player.

Tài sản hình khối và kết cấu sẽ được cung cấp dưới dạng các đối tượng EditableMesh và EditableImage, tương ứng, để cho phép tiếp tục chỉnh sửa avatar đã tạo. Các chỉnh sửa nên được thực hiện trên cả máy chủ trò chơi và bản sao máy khách để giữ chúng đồng bộ cho việc xuất bản.

Xuất bản

Nếu người dùng hài lòng với avatar kết quả, nó có thể được xuất bản bằng cách sử dụng phương thức AvatarCreationService:PromptCreateAvatarAsync().

Để biết thêm chi tiết, hãy xem tạo trong trò chơi.