本指南为 移动端v4.7.2 AI 特效平台(Ebox)素材配置指南的扩展，描述美颜素材如何配置。

美颜

添加

添加美颜素材

Step1. 添加到素材库

切换到素材库 tab，点击“新建素材”按钮：

上传素材zip包，配置名字等信息，素材类型选择“美颜”

如果素材有分级需求，比如对安卓和iOS平台分别配置不同的素材包，可以打开添加分级包功能

按平台添加素材分级包，分级包共用同一个素材 ID， 平台会根据分级信息返回合适的素材包

分级包确认无误后，点击确定添加到素材库中

Step2. 添加到业务列表

切换到配置 tab，选择应用版本，例如我们这里选择 1.0.0

点击素材配置 -> 选择 “美颜: beauty” 业务列表。
注意业务列表有环境的概念，我们这里在测试环境添加素材，并同步到正式环境

先选择测试环境，然后点击右上方“新增素材”按钮

在添加素材的二级页里配置名称、封面等业务项信息，更多参考本文后面业务项明细部分

点击确定按钮等待添加完成

Step3. 添加到页面配置

Sample 中的美颜 UI 多级列表结构，相对复杂，ebox 业务列表本身不支持多级列表结构，所以这里需要更新下页面配置美颜面板的 uiTree 配置，才能让新增的业务项显示出来（如果是接入场景，美颜 UI 需求没有多级结构，可以参考贴纸等业务，简单通过业务列表配置即可，不必关心 Sample 相对复杂的配置）
先打开页面配置，根据购买套餐例如B3，找到页面详pageDetail -> 美颜 uiTree

修改 json 添加新配的美颜业务项

{
    // 美颜面板 uiTree 配置                  
    "uiTree": {
        "uniqueId": "root",
        "subItems": [
            {
                // 美颜 Tab
                "uniqueId": "beauty",
                "subItems": [
                    {
                        "uniqueId": "beauty_smooth"
                    },
                    {
                        // 美白分组
                        "uniqueId": "beauty_whiten",
                        "subItems": [
                            // 添加 “美白-自然” 小项
                            {
                                "uniqueId": "beauty_whiten_ziran"
                            },
                            {
                                "uniqueId": "beauty_whiten_baixi"
                            },
                            {
                                "uniqueId": "beauty_whiten_fenbai"
                            },
                            {
                                "uniqueId": "beauty_whiten_hongrun"
                            }
                        ]
                    },
                    {
                        "uniqueId": "beauty_sharp"
                    },
                    {
                        "uniqueId": "beauty_clear"
                    }
                ]
            },
            // ...
        ]
    }
    
    // ...
}

// ...

点击右上方保存页面配置

重启 Sample App，打开美颜面板体验效果，注意 Sample 环境配置成测试环境

体验没问题后，可以同步到正式环境上线

注意页面配置也有环境的概念， 如需同步点击发布到正式环境

添加美颜业务列表

先点击业务列表右侧 + 按钮

填写业务列表信息，类型选美颜

业务列表创建成功后，即可按Step2的步骤添加素材到新的业务列表。
让 Sample 拉取到新的业务列表还需修改页面配置，与添加业务项类似找到美颜的面板配置并添加新建的业务列表

// 美颜的面板配置
{
    "id": "pkg_beauty_b3",
    "panels": [
        {
            "key": "beauty_b1",
            "bizLists": [
                // 添加新建的业务列表
                {
                    "key": "beauty_new"
                },
                {
                    "key": "_beauty"
                },
                {
                    "key": "beauty"
                },
                {
                    "key": "reshape"
                }
            ],
        }
    ]
}

// ...

然后按照前面添加美颜素材 Step3的步骤，在 uiTree 中添加业务项
配置完成后点击右上方保存页面配置，并同步正式环境

重启 Sample App，打开美颜面板观察效果

删除

在业务列表中找到要删除的项，点击 ... 更多下拉框选择移除即可，注意移除测试环境还是正式环境的素材

从业务列表删除后，参考前面添加美颜素材部分，业务项也需要在页面配置美颜 uiTree 中移除。
已经添加过业务列表的素材无法从素材库移除，但素材列表的 API 也不会返回没有被业务列表关联的素材

修改

在业务列表中找到要删除的项，点击 ... 更多下拉框选择编辑

与添加类似， 参考业务项明细，修改业务项。例如修改图标

美颜

美颜在 sample UI 中展示为嵌套多级列表，本质上是树形结构，配置相对复杂一些

叶子节点

挂载资源的节点，美颜资源包是 composer node 类型的复合资源包， 业务项和资源是多对一的关系。
例如微整形包 reshape_v8_lite 中包含面部、眼睛、鼻子、嘴巴等大部分小项。

业务扩展 ID 与前文页面配置中 uiTree 的 uniqueId 一一对应
自定义配置为 json 格式，cv sample 的字段定义如下：

{
  // 国际化标题文案
  "titleDict": {
    "en": "Natural Face",
    "zh": "自然脸"
  },
  // 可选，是否默认开启
  "defaultOn": 1,
  // composer node 节点数组
  "composerNodes": [
    {
      // 滑杆调节 key
      "key": "Face_ALL_nature",
      // 滑杆默认强度，单向显示范围 0-100，双向显示范围 -50-50，设置给 effect 时转化为 0.0-1.0
      "intensity": 30,
      // 滑杆调节范围
      "range": [0, 100]
    }
  ]
}
  
// pro 美颜特殊字段
// 美白多滑杆调节切换
{
  // composer node 节点数组
  "composerNodes": [
    {
      // 滑杆调节 key
      "key": "whiten",
      // 滑杆默认强度
      "intensity": 40,
      // 滑杆调节范围
      "range": [0, 100],
      // 滑杆切换按钮标题
      "slider_title": {
        "en": "Intensity",
        "zh": "程度"
      }
    },
    {
      "key": "warm",
      "intensity": 50,
      "range": [0, 100],
      "slider_title": {
        "en": "Cool/Warm Tone",
        "zh": "冷暖"
      }
    }
  ]
}

// 美妆口红等可选颜色
{
  "composerNodes": [
    // 口红强度可调节
    {
      "key": "Internal_Makeup_Lips",
      "intensity": 50,
      "range": [0, 100]
    },
    // 颜色分类 key 列表，不可调节
    {
      "key": "R"
    },
    {
      "key": "G"
    },
    {
      "key": "B"
    }
  ],
  // 可选颜色列表，ARGB 十六进制
  "selectable_colors": [
      "FFDD6363",
      "FFF3939E",
      "FFF18168",
      "FFB63963",
      "FFA10404"
  ]
}

非叶子节点

仅为了支持 UI 层级关系，可配置标题、图标等，不挂载素材

自定义配置为 json 格式，cv sample 的字段定义如下：

{
  // 国际化标题文案
  "titleDict": {
    "en": "Face",
    "zh": "面部"
  },
  // 是否支持多选
  "multipleSelection": true
}

素材包与key明细

美颜小项

微整形小项

美体小项id

美妆小项

画质小项

美颜pro

微整形pro

美妆pro

黑科技

分级素材包明细

cv 4.7.2 分级包有下面 9 个