You need to enable JavaScript to run this app.
导航
素材包结构说明(v4.2.1及以上)
最近更新时间:2025.05.27 11:57:09首次发布时间:2022.02.25 17:16:51
我的收藏
有用
有用
无用
无用
素材包结构说明(421及以上)
前言

此文档适用于SDK v4.2.1及以上的版本。
如果使用的CV SDK版本在4.7.1及以上,美颜和微整形的素材详解 可移步至:美颜&微整形素材详解(v4.7.1及以上) , 其他模块的素材路径可继续查看该文档。

ModelResource.bundle

此bundle内包含不同算法相关模型文件,应用相应算法时需要有对应算法模型文件

StickerResource.bundle

此bundle内包含已授权的贴纸素材

LicenseBag.bundle

此bundle内包含授权license文件

ComposeMakeup.bundle

大部分的特效素材都在 ComposeMakeup.bundle 中,包括美颜、微整形、美体、美妆。 其中美颜、微整形、美体是一个素材支持多种类型的,开放的功能可以到各自的文件夹下找到 .config_file,解析出支持的内容。

性能消耗建议:

  • 若同一素材包,包含多个小项功能,只开启一个小项与开启全部小项的性能消耗是一样的。

举例: beauty_Android_lite(包含美白、磨皮、锐化、清晰),4项全开和1项全开性能消耗是一样的,其余如reshape_lite(微整形若干项)同理。 特别注意部分素材包下存在两个子素材包,例如beauty_4Item(法令纹、亮眼、黑眼圈、白牙)中白牙和(法令纹、亮眼、黑眼圈)分属两个子素材包,开关白牙对整体性能有影响,而法令纹、亮眼、黑眼圈 3个全开和只开1个是一样的性能消耗。

  • 加载素材包后,将素材强度置为0,与强度非0为一样的性能消耗,不加载素材包时才不存在对应性能消耗。

  • 整体而言,pro素材的性能消耗大于lite素材。

结构说明

└── ComposeMakeup 
   ├── beauty_4Items                           // 包含白牙、亮眼、法令纹、黑眼圈四项 
   ├── beauty_Android_lite                     // lite 特效美颜,含美白、磨皮、锐化, 442版本及以后新增清晰 
   ├── beauty_Android_standard                 // standard 特效美颜,含美白、磨皮、锐化, 442版本及以后新增清晰 
   ├── beauty_IOS_lite                         // lite 特效美颜,含美白、磨皮、锐化, 442版本及以后新增清晰 
   ├── beauty_IOS_standard                     // standard特效美颜,含美白、磨皮、锐化, 442版本及以后新增清晰 
   ├── beauty_Android_lengbai_lite             // lite 冷白,4.5.0后新增素材 
   ├── beauty_IOS_lengbai_lite                 // lite 冷白,4.5.0后新增素材 
   ├── beauty_Android_fenbai_lite              // lite 粉白,4.5.2后新增素材 
   ├── beauty_iOS_fenbai_lite                  // lite 粉白,4.5.2后新增素材 
   ├── beauty_Android_rosy_lite                // lite 美白-红润,4.7.0新增素材
   ├── beauty_IOS_rosy_lite                    // lite 美白-红润,4.7.0新增素材
   ├── beauty_Android_fenbai_standard          // standard 粉白,4.5.2后新增素材 
   ├── beauty_iOS_fenbai_standard              // standard 粉白,4.5.2后新增素材 
   ├── reshape_lite                            // lite 特效微整形,包括面部、眼睛、鼻子、嘴巴等若干项 
   ├── reshape_standard                        // standard 特效微整形,包括面部、眼睛、鼻子、眉毛、嘴巴等若干项;4.7.0版本微整形pro里的瘦脸-瘦脸、小脸、窄脸、小头、v脸、发际线单独有子文件夹。
   ├── reshape_boy                             // lite 瘦脸-男神瘦脸,4.4.3版本新增 
   ├── reshape_girl                            // lite 瘦脸-女神瘦脸,4.4.3版本新增 
   ├── reshape_nature                          // lite 瘦脸-自然脸,4.4.3版本新增 
   ├── reshape_lite_eye_size                   // lite 大眼,4.5.0新增素材 
   ├── reshape_standard_girl                   // standard 瘦脸-女神瘦脸,4.5.0版本新增 
   ├── reshape_standard_boy                    // standard 瘦脸-男神瘦脸,4.5.2版本新增 
   ├── reshape_standard_nature                 // standard 瘦脸-自然脸,4.5.2版本新增 
   ├── reshape_v8                              // 包含微整形pro里的瘦脸-瘦脸、小脸、窄脸、小头、v脸,4.7.0版本新增
   ├── reshape_forehead                        // 微整形pro里的发际线,4.7.0版本新增
   ├── body 
   │   └── allslimqy                           // 美体,含长腿、瘦身 
   │   └── allslim                             // 美体,含长腿、瘦身、小头、瘦腿、瘦腰、丰胸、美胯、天鹅颈、瘦手臂(3931后美体更新至此子文件夹,但在390及以上版本可使用)。4.5.0版本后丰胸美胯单独有子文件夹。4.7.0版本瘦腿单独有子文件夹。   
   │   └── allslim_breast                      // 4.5.0版本后美颜美型pro的丰胸和美胯两个小项 
   │   └── allslim_prev                        // 4.7.0版本新增,只包含瘦腿
   ├── blush                                    // 腮红 
   │   └── lite                                // lite 腮红 
   │   └── standard                            // standard 腮红,可调节颜色 
   ├── eyebrow                                  // 眉毛 
   │   └── lite                                // lite 眉毛 
   │   └── standard                            // standard 眉毛,可调节颜色 
   ├── eyelashes                                // 睫毛,可调节颜色 
   ├── eyeshadow                                // 眼影 
   ├── eyelight                                 // 眼神光 
   ├── double_eye_lid                           // 双眼皮 
   ├── wocan/double_eye_lid                     // 卧蚕/双眼皮 
   ├── facial                                   // 修容 
   │   └── jingzhi                             // lite 修容-精致
   │   └── ziran                               // pro 修容-自然
   │   └── xiaov                               // pro 修容-小v脸
   │   └── fajixian                            // pro 修容-发际线
   │   └── gaoguang                            // pro 修容-高光
   │   └── shensui                             // lite 修容-深邃,4.7.0版本新增
   │   └── yingjun                             // pro 修容-英俊,4.7.0版本新增
   ├── hair                                     // 染发 
   ├── hack                                     // 祛斑祛痘 
   ├── lip                                      // 口红 
   │   └── lite                                // lite 口红 
   │   └── standard                            // standard 口红,可调节颜色 
   ├── pupil                                    // 美瞳 
   ├── palette                                          // 画质 
   ├── hack/yunfu_fengying_liuchanglian_standard        //原肤(匀肤)、面部填充(丰盈)、轮廓平滑(流畅脸)  
   ├── hack/acne_removal_lite                           //祛斑祛痘 
   ├── style_makeup                                     // 风格妆,包含滤镜、妆容                                                  
                               └── qise                                                                                                                                  
                               └── xxxx

开放功能说明

.config_file 示例:

[

    "whiten",

    "sharp",

    "smooth"

]

文件内容为一个 json 列表,每一项对应一个功能的 key。

滤镜序号对应

471之前版本: 每一个滤镜都对应一个序号,可通过滤镜素材名查找,如 Filter_01_38 对应为序号为 1 的滤镜,下面为查询表,前面为滤镜在 sample 中的名称拼音,后面为对应的滤镜序号。
471及之后版本: 471版本起,滤镜命名和之前有差异,可直接查看demo中tab和滤镜以及序号的对应关系

{
"roubai": 1,    
"baixi": 1,    
"naiyou": 2,    
"yangqi": 3,    
"jiegeng": 4,    
"luolita": 5,   
"mitao": 6,   
"makalong": 7,   
"paomo": 8,   
"yinghua": 9,   
"qiannuan": 10,   
"wuyu": 11,   
"beihaidao": 12,    
"riza": 13,    
"xiyatu": 14,    
"jingmi": 15,    
"jiaopian": 16,    
"nuanyang": 17,    
"jiuri": 18,    
"hongchun": 19,    
"julandiao": 20,    
"tuise": 21,    
"heibai": 22,    
"wenrou": 23,    
"lianaichaotian": 24,    
"chujian": 25,    
"andiao": 26,    
"naicha": 27,    
"soft": 28,    
"xiyang": 29,    
"lengyang": 30,    
"haibianrenxiang": 31,   
"gaojihui": 32,   
"haidao": 33,    
"qianxia": 34,    
"yese": 35,    
"hongzong": 36,    
"qingtou": 37,    
"ziran2": 38,    
"suda": 39,    
"jiazhou": 40,    
"shise": 41,    
"chuanwei": 42,    
"meishijiaopian": 43,    
"hongsefugu": 44,    
"lvtu": 45,    
"nuanhuang": 46,   
"landiaojiaopian": 47,
"lengbaipi": 48,
"touliang": 49,
"liangju": 50,
"hutaomu": 51,
"shenhe": 52,
"degula": 53,
"lise": 54,
"yelin": 55,
"nuanshi": 56,
"qipaoshui": 57,
"liaoli": 58,
"tanshao": 59,
"jingdu": 60,
"haian": 61,
"lvyan": 62,
"wanying": 63,
"qingcheng": 64,
"aizhicheng": 65,
"CT": 66,
"EK": 67,
"FJ": 68,
"heijin": 69
"heben": 70
}

demo中tab和滤镜以及序号的对应关系

demo中的tabdemo中的名称(中文)demo中的名称(英文)素材包备注

Portrait 人像
(55个)

自然

Natural

  • 470及之前:Filter_38_F1

  • 471开始:Filter_9125911

原生OriginalFilter_10649375471新增
焕肤Renewed SkinFilter_10649376471新增

冷白皮

Pale

  • 470及之前:Filter_48_4001

  • 471开始:Filter_10649377

粉瓷Pink PorcelainFilter_10649378471新增
假日HolidayFilter_10649379471新增
柔白Snow WhiteFilter_01_38
初见First SightFilter_25_Po3
清透ClearFilter_37_L5
温柔GentleFilter_23_Po1
恋爱超甜Sweet LoveFilter_24_Po2
softSoftFilter_28_Po6
透亮LucencyFilter_49_4002
亮橘Bright OrangeFilter_50_4003
正常NormalFilter_10649368471新增
白皙FairFilter_10649369471新增
轻氧Light OxygenFilter_10649372471新增
超白Ultra FairFilter_10649371471新增
冷系Cold ToneFilter_45035902471新增
柔和SoftFilter_10649374471新增
微醺TipsyFilter_10649373471新增

奶油

Creamy

  • 470及之前:Filter_02_14

  • 471开始:Filter_10649335

初恋First LoveFilter_10649370471新增
清纯Pure InnocentFilter_10649328471新增
白雪Snow WhiteFilter_10649330471新增
慕斯MousseFilter_10649333471新增
非凡ExtrodinaryFilter_10649329471新增
活泼LivelyFilter_10649332471新增
初心Original AspirationFilter_10649334471新增
蔷薇RoseFilter_10649331471新增
马卡龙MacaroonFilter_07_06
氧气OxygenFilter_03_20
物语StoryFilter_11_09
洛丽塔DollFilter_05_10
桔梗GrandiflorumFilter_04_12
栗色MaroonFilter_54_4007
椰林Coconut ForestFilter_55_4008
动人CharmingFilter_10649337471新增
日系Japanese StyleFilter_10649336471新增
蓝调Blue ToneFilter_10649339471新增
奶灰Creamy GreyFilter_10649340471新增
深邃DeepFilter_10649341471新增
曲奇CookieFilter_10649338471新增
硬朗Hard EdgeFilter_13781776471新增
金属MetallicFilter_9125909471新增
高级灰Advanced GreyFilter_32_Po10
海边人像Beach PortraitFilter_31_Po9
冷氧Cool OxygenFilter_30_Po8
红棕Red BrownFilter_36_L4
奶茶Bubble TeaFilter_27_Po5
暗调DarkFilter_26_Po4
浅暖MousseFilter_10_11
胡桃木WalnutFilter_51_4004
深褐Dark BrownFilter_52_4005
德古拉DraculaFilter_53_4006

Daily 日常
(4个)

原相机

Original Camera

Filter_9125971

471新增

ABGABGFilter_9125970471新增
高清HDFilter_9125969471新增
油画Oil PaintingFilter_9125968471新增

Food 美食
(8个)

暖食

Warm Food

  • 470及之前:Filter_56_4009

  • 471开始:Filter_9125731

气泡水

Sparkling Water

  • 470及之前:Filter_57_4010

  • 471开始:Filter_9126008

料理

Cuisine

  • 470及之前:Filter_58_4011

  • 471开始:Filter_10649342

深夜食堂Midnight DinerFilter_10649347471新增
食色YummyFilter_41_F4
川味SpicyFilter_42_F5
苏打SodaFilter_39_F2
炭烧GrillFilter_59_4012

Landscape 风景
(16个)

绿妍

Green Bloom

  • 470及之前:Filter_62_4015

  • 471开始:Filter_9126023

晚樱

Evening Cherry

  • 470及之前:Filter_63_4016

  • 471开始:Filter_13782150

宿营CampingFilter_13782151471新增
雾野Foggy FieldFilter_48172766471新增
樱花SakuraFilter_09_19
加州CaliforniaFilter_40_F3
蜜桃PeachFilter_06_03
浅夏Early SummerFilter_34_L2
海岛IslandFilter_33_L1
北海道HokkaidoFilter_12_08
夕阳SunsetFilter_29_Po7
夜色NightFilter_35_L3
京都KyotoFilter_60_4013
海岸CoastFilter_61_4014
青橙Green OrangeFilter_64_4017
爱之城City of loveFilter_65_4018

Retro 复古
(11个)

卡梅尔

Carmel

Filter_9125992

471新增

HUJIHUJIFilter_9125994471新增
美式胶片MovieFilter_43_S1
红色复古Vintage RedFilter_44_S2
旅途JourneyFilter_45_S3
暖黄Warm YellowFilter_46_S4
蓝调胶片Blue FilmFilter_47_S5
日杂Japan MagazineFilter_13_02
CTCTFilter_66_4019
EKEKFilter_67_4020
FJFJFilter_68_4021

Stylization 风格化
(8个)

默片

Silent Flim

Filter_9126033

471新增

过往NostalgicFilter_13782178471新增
红唇Red LipsFilter_19_37
橘蓝调Orange BlueFilter_20_05
褪色Color FadingFilter_21_01
黑白Black and WhiteFilter_22_16
黑金Black GoldFilter_69_4022
赫本HepburnFilter_70_4023
Un-grouped 未分组泡沫FoamFilter_08_17440下架
西雅图SeattleFilter_14_15
静谧QuietFilter_15_07
胶片FilmFilter_16_13
暖阳SunFilter_17_04
旧日Old DaysFilter_18_18