五、用户形象
5.1 创建用户形象
1. 接口说明
创建用户形象2. 请求地址
POST api/v3/user_image/3. 请求参数
参数
说明
字段类型
是否必传
figure_library
角色ID
Int
是
# 示例
{
"figure_library": 1
}4. 返回示例
{
"msg": "ok",
"status": 200,
"results": {
"id": 2079,
"user_image_color": [
{
"id": 2891,
"pure_color": {
"id": 1,
"color_value": "#2879e4"
},
"pattern": {
"id": 10,
"material_type": 83,
"material_type_info": {
"is_reselection": true,
"calling_interface_name": "Beard",
"asset_mutual_exclusion": [],
"name": "胡须",
"mfg_process": null,
"extra_business": []
},
"owns": false,
"brand_logo": "",
"brand_logo1": "",
"b_price": "",
"grade": null,
"create_time": "2022-06-10 22:46:48",
"creator": "yangjiaxin",
"is_delete": false,
"update_time": "2022-12-06 18:35:19",
"update_user": null,
"name": "beard_004",
"thumbnail": "https://vbs-staging.oss-cn-beijing.aliyuncs.com/pattern/thumbnail/prop_beard_004_suf.png",
"thumbnail52": "https://vbs-staging.oss-cn-beijing.aliyuncs.com/pattern/thumbnail52/prop_beard_004_suf.png",
"ma_file": null,
"fbx_file": null,
"obb_file": "https://vbs-staging.oss-cn-beijing.aliyuncs.com/pattern/file/prop_beard_004_rig.pak",
"android_pak_file_astc": null,
"android_pak_file_dxt": null,
"android_pak_file_etc2": null,
"ios_pak_file": "https://vbs-staging.oss-cn-beijing.aliyuncs.com/pattern/file/ios/prop_beard_004_ios_rig.pak",
"json_file": null,
"order": null,
"blend_shape": "10",
"web_gl": null,
"nft_name": null,
"nft_issue_number": null,
"nft_surplus": 0,
"nft_price": "0.00",
"lock_up_volume": 0,
"usage_number": 0,
"is_up_chain": 0,
"is_nft": false,
"introduction": null,
"nft_author": "夸克因子",
"glb_file": null,
"display_url": null,
"hash_glb": null,
"md5_glb": null,
"status": 1,
"nft_publish_ts": null,
"is_set": false,
"translate": [
0.0,
0.0,
0.0
],
"rotate": [
0.0,
0.0,
0.0
],
"scale": [
1.0,
1.0,
1.0
],
"bones_point_name": "",
"modify_nft_price": "0.00",
"modify_nft_price_take_effect_time": null,
"genre": 1,
"thumbnail600": null,
"thumbnail1024": null,
"video": null,
"issuer": null,
"chain_type": null,
"chain_video": null,
"buy_video": null,
"unity_files": {
"ab_def_file": {
"ios": null,
"win": null,
"android": null
},
"ab_depe_file": {
"ios": null,
"win": null,
"android": null
},
"unity_fbx_file": null,
"unity_may_file": null
},
"production_technology": [
0
],
"is_ar": false,
"web_gl_file": null,
"uid": "beard_004",
"is_start": true,
"ue_pak": null,
"auto_upload": 0,
"win_low_pak": {
"male": null,
"female": null,
"unisex": null
},
"mac_pak": null,
"same_name_tag": null,
"series": null,
"brand": null,
"tags": [
2,
15,
59
],
"ue_tags": [
496,
67
],
"unity_tags": [],
"figure": [
21,
22
],
"web_gl_tags": [],
"class_id": null,
"classification_name": null,
"b_genre": null,
"b_is_start": false,
"inventory": null
},
"scheme": {
"id": 1,
"name": "瞳色方案",
"production_process": "贴图",
"tags": {
"colorPresentationForm": [
{
"id": 66,
"create_time": "2022-05-19 17:27:54",
"creator": "admin",
"is_delete": false,
"update_time": "2022-12-06 18:35:19",
"update_user": null,
"name": "色块展示",
"help_text": null,
"is_modify": false
}
],
"assetMutualExclusion": [
{
"id": 71,
"create_time": "2022-05-19 17:27:54",
"creator": "admin",
"is_delete": false,
"update_time": "2022-12-06 18:35:19",
"update_user": null,
"name": "资产互斥规则01",
"help_text": "瞳花纹、瞳色",
"is_modify": false
}
],
"programmePurpose": [
{
"id": 78,
"create_time": "2022-05-19 17:27:54",
"creator": "admin",
"is_delete": false,
"update_time": "2022-12-06 18:35:19",
"update_user": null,
"name": "颜色方案",
"help_text": null,
"is_modify": false
}
],
"reselection": [
{
"id": 80,
"create_time": "2022-05-19 17:27:54",
"creator": "admin",
"is_delete": false,
"update_time": "2022-12-06 18:35:19",
"update_user": null,
"name": "反选",
"help_text": null,
"is_modify": false
}
],
"callingUEInterfaceName": [
{
"id": 97,
"create_time": "2022-05-20 11:56:45",
"creator": "zhaoyingli",
"is_delete": false,
"update_time": "2022-12-06 18:35:19",
"update_user": null,
"name": "EyeColor",
"help_text": "瞳色",
"is_modify": true
}
]
}
}
}
],
"user": {
"id": 3524,
"nickname": "VBS99175368"
},
"pattern": [],
"suit": [],
"b_end": "VBS",
"is_face": true,
"create_time": "2023-11-17 14:24:08",
"creator": null,
"is_delete": false,
"update_time": "2023-11-17 14:29:59",
"update_user": null,
"face_json": "https://vbs-dev.oss-accelerate.aliyuncs.com/media/app_user/init/Female_FaceAndEye.json",
"body_json": null,
"ini_file": null,
"gender": "female",
"is_element_model": false,
"is_experience": true,
"thumbnail": null,
"is_selected": true,
"pc_thumbnail": null,
"brand": null,
"figure_library": 22
}
}5. 返回示例说明
results对象
参数
说明
字段类型
是否必传
id
形象ID
int
是
user_image_color
用户形象颜色方案
list[object]
否
user
用户信息
object
是
pattern
资产列表（同资产）
list[object]
是
suit
套装列表（同套装）
list[object]
否
is_face
是否支持捏脸
bool
是
face_json
捏脸数据
str
是
is_selected
是否选中（多个角色形象适用）
bool
是
figure_library
形象所属的角色
int
是
user_image_color对象
参数
说明
字段类型
是否必传
id
颜色ID
int
是
pure_color
色值
object
否
scheme
方案
object
是
pattern
资产
object
是
pure_color对象
参数
说明
字段类型
是否必传
id
色值ID
int
是
color_value
色值
object
是
scheme对象
参数
说明
字段类型
是否必传
id
方案ID
int
是
name
方案名
str
是
production_process
制作工艺
str
是
tags
业务标签
object
是
tags对象
参数
说明
字段类型
是否必传
id
方案ID
int
是
name
方案名
str
是
production_process
制作工艺
str
是
tags
业务标签
object
是
user对象
参数
说明
字段类型
是否必传
id
用户ID
int
是
nickname
用户昵称
str
是
5.2 修改用户形象
1. 接口说明
2. 请求地址
3. 请求参数
参数
说明
字段类型
是否必传
figure_library
角色ID
str
是
user_image_color
形象的颜色方案
list[object]
否
pattern
资产集合
list[int]
否
suit
套装集合
list[int]
否
is_selected
是否选中
bool
否
face_json
捏脸数据json文件
file
否
thumbnail
缩略图
str
否
pc_thumbnail
半身缩略图（数字身份用）
str
否
user_image_color对象
参数
说明
字段类型
是否必传
pure_color
色值ID
int
是
scheme
方案ID
int
是
pattern
资产ID
int
是
4. 返回示例及说明
同创建用户形象
5.3 获取用户形象
1. 接口说明
2. 请求地址
3. 请求参数
参数
说明
字段类型
是否必传
figure_library
角色ID
否
4. 返回示例及说明
同创建用户形象
5.4 获取所有用户形象
1. 接口说明
2. 请求地址
3. 请求参数
无
4. 返回示例
5. 返回示例说明
参数
说明
字段类型
是否必传
msg
业务信息
str
是
status
业务码
Int
是
results
结果
list[object]
是
results数组内对象说明同创建用户形象
5.5 选中用户形象
1. 接口说明
2. 请求地址
3. 请求参数
参数
说明
字段类型
是否必传
figure_library
角色ID
int
是
4. 返回示例
5. 返回示例说明
参数
说明
字段类型
是否必传
msg
业务信息
str
是
status
业务码
Int
是
最后更新于