AvatarEditorService

Tham Số

Lợi Nhuận

Yêu cầu Players.LocalPlayer để cho phép nhà phát triển đọc các mục mà người dùng có trong kho hàng và thông tin liên quan đến trình chỉnh sửa avatar khác.Lời nhắc cần được xác nhận bởi người dùng để nhà phát triển sử dụng AvatarEditorService:GetInventory() , AvatarEditorService:GetOutfits() và AvatarEditorService:GetFavorite() .Quyền không tồn tại giữa các phiên.

Lợi Nhuận

Yêu cầu Players.LocalPlayer lưu các đường dẫn được cho HumanoidDescription như một bộ trang phục. Không thể hiện. Kết quả có thể được lấy lại bằng cách lắng nghe sự kiện AvatarEditorService.PromptCreateOutfitCompleted .

Tham Số

Lợi Nhuận

Yêu cầu Players.LocalPlayer để xóa trang phục đã cho. Không thể thu được. Kết quả có thể được lấy lại bằng cách lắng nghe sự kiện AvatarEditorService.PromptDeleteOutfitCompleted.

Tham Số

Lợi Nhuận

Yêu cầu Players.LocalPlayer đổi tên trang phục đã cho. Không thể thu được kết quả. Kết quả có thể được lấy lại bằng cách lắng nghe sự kiện AvatarEditorService.PromptRenameOutfitCompleted.

Tham Số

Lợi Nhuận

Chức năng này yêu cầu Players.LocalPlayer để cập nhật avatar của họ dựa trên HumanoidDescription và Enum.RigType (R6 hoặc R15).Không trả và có thể nhận được kết quả bằng cách lắng nghe sự kiện PromptSaveAvatarCompleted.Điều này tương tự như cách các thông báo khác như PromptPurchase hoạt động.

Tham Số

Lợi Nhuận

Chức năng này yêu cầu Players.LocalPlayer để yêu thích hoặc không yêu thích tài sản hoặc gói được cung cấp.

Tham Số

Lợi Nhuận

Yêu cầu Players.LocalPlayer để cập nhật trang phục đã cho với HumanoidDescription được cung cấp.

Tham Số

Lợi Nhuận

Trả về một cái mới HumanoidDescription với các thuộc tính Áo và Quần được cập nhật nếu cần thiết. Trả về nil nếu quần áo mặc định không cần thiết.

Trang phục mặc định là cần thiết nếu HumanoidDescription hiện không có áo sơ mi và quần được trang bị và màu cơ thể quá giống nhau.

Tham Số

Lợi Nhuận

Tham Số

Lợi Nhuận

Chức năng này trả về các quy tắc Avatar của nền tảng cho những thứ như phóng to, áo sơ mi và quần, số lượng tài sản có thể mặc, v.v.

Bảng trả về bao gồm các trường sau:

{
  "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
}

Lợi Nhuận

Nhận chi tiết vật phẩm cho một danh sách vật phẩm cùng một lúc.Hiệu quả hơn AvatarEditorService:GetItemDetails nếu bạn cần nhận tất cả chi tiết vật phẩm của một danh sách.

Tham Số

Lợi Nhuận

{
    "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
  }

Chức năng này trả về nếu Players.LocalPlayer đã yêu thích gói hoặc tài sản được cung cấp.

Tham Số

Lợi Nhuận

Trả về một đối tượng InventoryPages với thông tin về các vật phẩm đã sở hữu trong kho hàng của người dùng với AvatarAssetTypes được cung cấp.

Bảng trả về bao gồm các trường sau:

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

Tham Số

Lợi Nhuận

Chức năng này trả về chi tiết vật phẩm cho vật phẩm được cho.Nó chấp nhận hai tham số - thứ nhất chỉ ra ID của mục được truy xuất và thứ hai chỉ ra Enum.ItemType của nó.

Dữ liệu được trả lại trong định dạng:

{
  "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
}

Để truy vấn các tài sản giới hạn hoặc không giới hạn, sử dụng các giá trị sau itemRestrictions :

| itemRestrictions | Giới hạn hoặc Vô giới hạn | | :--------------: | :-------------------: | | empty | Vô giới hạn | | Collectible | UGC Giới hạn | | Limited | Roblox Giới hạn duy nhất | | LimitedUnique | Roblox Giới hạn duy nhất Unique |

Tham Số

Lợi Nhuận

Chức năng này trả lại chi tiết trang phục cho trang phục đã cho. Nó chấp nhận một tham số: ID của trang phục.

Dữ liệu trả về theo định dạng sau:

{
  "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,
  "Name": "Your Costume",
  "OutfitType": "Avatar",
  "PlayerAvatarType": "R15",
  "Scale": {
    "BodyType": 0,
    "Depth": 1,
    "Head": 1,
    "Height": 1,
    "Proportion": 0,
    "Width": 1
  },
}

Tham Số

Lợi Nhuận

Chức năng này trả về dữ liệu trang phục cho Players.LocalPlayer .Điều này sẽ được sử dụng với Players:GetHumanoidDescriptionFromOutfitId() để cập nhật nhân vật của người chơi lên trang phục.Truy cập vào nó cũng sẽ phụ thuộc vào AvatarEditorService:PromptAllowInventoryReadAccess() được chấp nhận bởi người dùng.

Bảng trả về bao gồm các trường sau:

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

<th>đánh máy</th>

    <th>Mô tả</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>id</td><td>nhân</td>

    <td />
  </tr>

  <tr>
    <td>tên</td><td>chuỗi</td>

    <td />
  </tr>

  <tr>
    <td>có thể chỉnh sửa</td><td>boolean</td>

    <td />
  </tr>
</tbody>

Tham Số

Lợi Nhuận

Trả về một danh sách các tài sản được đề xuất dựa trên một địa chỉ Enum.AssetType và ID tài sản đã cho.Sử dụng cái này để thu thập một danh sách các tài sản tương tự với tài sản được cung cấp.Hãy xem mẫu mã code bên dưới để biết thêm thông tin về các trường hợp sử dụng có thể cho chức năng này.

Dữ liệu có định dạng:

[
    {
      "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
      }
    }
]

Tham Số

Lợi Nhuận

local AvatarEditorService = game:GetService("AvatarEditorService")

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

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

Chức năng này trả về một danh sách các gói được đề xuất cho một ID gói cụ thể.

Dữ liệu có định dạng:

[
    {
      "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
        }
      }
    }
]

Tham Số

Lợi Nhuận

Chức năng này trả về một đối tượng CatalogPages chứa kết quả của cuộc tìm kiếm đã cho.

Dữ liệu trả về có định dạng:

[
    {
      "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
    }
]

Tham Số

Lợi Nhuận

Sự kiện này xảy ra khi lời nhắc AvatarEditorService:PromptAllowInventoryReadAccess() được đáp lại bởi người dùng.Nó chỉ có thể trả về tình trạng Thành công hoặc Bị từ chối enum vì nó không thực hiện bất kỳ yêu cầu web nào có thể thất bại.

Tham Số

Sự kiện này bắt lửa khi hoạt động PromptSaveOutfit được hoàn thành.Nó cung cấp một trạng thái enum cho thấy liệu lời nhắc có thành công, thất bại hay không được cho phép bởi người dùng.

Tham Số

Bắt lửa khi hoạt động PromptDeleteOutfit được hoàn thành.Nó cung cấp một trạng thái enum cho thấy liệu lời nhắc có thành công, thất bại hay không được cho phép bởi người dùng.

Tham Số

Nổ khi hoạt động PromptRenameOutfit được hoàn thành.Nó cung cấp một trạng thái enum cho thấy liệu lời nhắc có thành công, thất bại hay không được cho phép bởi người dùng.

Tham Số

Sự kiện này bắt lửa khi hoạt động AvatarEditorService:PromptSaveAvatar() hoàn thành.Nó cung cấp một trạng thái enum cho thấy liệu lời nhắc có thành công, thất bại hay không được cho phép bởi người dùng.

Tham Số

Bắt lửa khi hoạt động AvatarEditorService:PromptSetFavorite() hoàn thành.Nó cung cấp một trạng thái enum cho thấy liệu lời nhắc có thành công, thất bại hay không được cho phép bởi người dùng.

Tham Số

Bắt lửa khi hoạt động AvatarEditorService:PromptUpdateOutfit() hoàn thành.Nó cung cấp một trạng thái enum cho thấy liệu lời nhắc có thành công, thất bại hay không được cho phép bởi người dùng.

Tham Số