AvatarEditorService

매개 변수

반환

개발자가 사용자의 인벤토리 및 다른 아바타 편집기 관련 정보를 읽을 수 있도록 Players.LocalPlayer 에 대한 액세스 권한을 부여합니다. 권한은 사용자가 개발자에게 사용권을 확인하도

반환

Class.Players.LocalPlayer 을 호출하여 지정된 HumanoidDescription 을 의상으로 저장하도록 합니다. 생성되지 않습니다. 결과는 AvatarEditorService.PromptCreateOutfitCompleted 이벤트에서 수신할 수 있습니다.

매개 변수

반환

Class.Players.LocalPlayer 에 대한 지정된 의상을 삭제하라는 메시지를 표시합니다. 생성되지 않습니다. 결과는 AvatarEditorService.PromptDeleteOutfitCompleted 이벤트에 대한 듣기로 검색할 수 있습니다.

매개 변수

반환

Class.Players.LocalPlayer 에게 주어진 의상을 이름 변경하라는 프롬프트를 표시합니다. 생성되지 않습니다. 결과는 AvatarEditorService.PromptRenameOutfitCompleted 이벤트에서 수신할 수 있습니다.

매개 변수

반환

이 함수는 Players.LocalPlayer에게 지정된 HumanoidDescription 및 Enum.RigType (R6 또는 R15)에 따라 아바타를 업데이트하도록 요청합니다. 결과를 생성하지 않고 프롬프트 저장 완료 이벤트를 수신하여

매개 변수

반환

이 함수는 Players.LocalPlayer에게 주어진 자산이나 번들을 즐겨찾기 또는 즐겨찾기해제하도록 요청합니다.

매개 변수

반환

Class.Players.LocalPlayer에 요청하여 지정된 의상을 지정된 인간 설명과 함께 업데이트합니다.

매개 변수

반환

셔츠와 바지 속성이 업데이트된 경우 새로운 HumanoidDescription를 반환합니다. 기본 의류가 필요하지 않은 경우 일반 의류에 대해 반환합니다.

기본 의류는 HumanoidDescription에 셔츠와 바지가 없으며 신체 색상이 너무 유사하기 때문에 필요합니다.

매개 변수

반환

매개 변수

반환

이 함수는 크기 조정, 기본 셔츠 및 바지, 착용 가능한 자산 수 등과 같은 것들을 위해 플랫폼 아바타 규칙을 반환합니다.

반환된 테이블에는 다음과 같은 필드가 포함됩니다.

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

반환

목록의 항목 세부 정보를 한 번에 가져옵니다. 아바타 편집기 서비스보다 더 효율적입니다. 목록의 모든 항목 세부 정보를 필요로 하는 경우 AvatarEditorService:GetItemDetails 보다 더 효율적입니다.

매개 변수

반환

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

이 함수는 Players.LocalPlayer가 지정된 번들이나 자산을 선호하는 경우 반환합니다.

매개 변수

반환

Class.InventoryPages 개체를 반환하여 사용자 인벤토리에 있는 아이템에 대한 정보를 포함한 AvatarAssetTypes 개체를 반환합니다.

반환된 테이블에는 다음과 같은 필드가 포함됩니다.

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

매개 변수

반환

이 함수는 지정된 아이템세부 정보를 반환합니다. 두 매개 변수가 있습니다. - 첫 번째는 항목이 검색되는 ID를 나타내고 두 번째는 Enum.ItemType입니다.

다음과 같은 형식으로 반환된 데이터:

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

제한된 또는 제한되지 않은 자산에 대해 쿼리하려면 다음 itemRestrictions 값을 사용합니다.

| itemRestrictions | 제한 또는 제한 없음 | | :--------------: | :-------------------: | | empty | Unlimited | | Collectible | Roblox 한정 | | Limited | Roblox 한정 유니크 |

매개 변수

반환

이 함수는 지정된 의상의 세부 정보를 반환합니다. 하나의 매개 변수만 허용됩니다: 의상의 ID입니다.

다음과 같은 형식으로 데이터가 반환됩니다.

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

매개 변수

반환

이 함수는 Players.LocalPlayer에 대한 의상 데이터를 반환합니다. 이것은 플레이어 캐릭터를 의상으로 업데이트하기 위해 Players:GetHumanoidDescriptionFromOutfitId()에 사용됩니다. 이 함수에 액세스하려면 Class.AvatarEditorService:PromptAllowInventoryReadAccess

반환된 테이블에는 다음과 같은 필드가 포함됩니다.

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

<tbody>
  <tr>
    <td>아이디</td>
    <td>정수</td>

    <td />
  </tr>

  <tr>
    <td>이름</td>
    <td>문자열</td>

    <td />
  </tr>

  <tr>
    <td>편집 가능</td>
    <td>부울</td>

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

매개 변수

반환

지정된 Enum.AssetType 및 자산 ID에 따라 권장 자산 목록을 반환합니다. 이를 사용하여 자산 제공자와 유사한 자산을 모으십시오. 아래 코드 샘플을 참조하십시오. 이 함수에 대한 가능한 사용 사례에 대한 자세한 내용은 코드 샘플을 참조하십시오.

데이터는 다음과 같은 형식입니다.

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

매개 변수

반환

local AvatarEditorService = game:GetService("AvatarEditorService")

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

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

이 함수는 지정된 번들 ID에 대해 권장 번들 목록을 반환합니다.

데이터는 다음과 같은 형식입니다.

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

매개 변수

반환

이 함수는 지정된 검색의 결과를 포함하는 CatalogPages 개체를 반환합니다.

반환된 데이터는 다음과 같은 형식을 가지고 있습니다.

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

매개 변수

반환

이 이벤트는 사용자가 AvatarEditorService:PromptAllowInventoryReadAccess() 응답을 수행할 때 발생합니다. 그것은 웹 요청을 수행하지 않기 때문에 성공 또는 권한 거부 enum 상태만 반환할 수 있습니다.

매개 변수

이 이벤트는 프롬프트 저장 의상 작업이 완료되면 발생합니다. 상태 enum.AvatarPromptResult|enum</num> 을 나타내는 스테이터스 를 지정하여 프롬프트가 성공했는지, 실패했는지 또는 사용자가 권한을 부여하지 않았는지를 나타냅니다.

매개 변수

프롬프트 삭제 의상 작업이 완료되면 시작됩니다. 프롬프트 성공, 실패 또는 사용자가 권한을 부여하지 않은 경우 상태 enum 를 나타냅니다.

매개 변수

프롬프트 이름 변경 작업이 완료되면 시작됩니다. 프롬프트가 성공했는지, 사용자가 권한을 부여하지 않았는지 또는 요청이 거부되었는지를 나타내는 상태 enum 를 표시합니다.

매개 변수

이 이벤트는 AvatarEditorService:PromptSaveAvatar() 작업이 완료되면 발생합니다. 상태 enum을 나타내며, 프롬프트가 성공했는지, 실패했는지 또는 사용자가 권한을 부여하지 않았는지를 나타냅니다.

매개 변수

Class.AvatarEditorService:PromptSetFavorite() 작업이 완료되면 화면에 상태 enum 를 표시합니다. 이 상태는 프롬프트 성공, 실패 또는 사용자가 권한을 부여하지 않은 경우에 나타납니다.

매개 변수

Class.AvatarEditorService:PromptUpdateOutfit() 작업이 완료되면 화면에 상태 enum 가 표시되어 알림을 표시합니다. 이 경우 사용자가 요청을 성공하지 못했거나 권한이 부여되지 않았음을 나타내는 상태 Enum.AvatarPromptResult 가 표시됩니다.

매개 변수