修改目标图像 | PUT /target/<TargetID>¶
功能¶
修改目标图像。没有更新的参数保持不变,支持patch形式修改部分参数。
动作¶
PUT /target/<TargetID>
认证¶
是
请求参数:¶
字段名 |
类型 |
必须 |
描述 |
---|---|---|---|
image |
base64编码字符串 |
否 |
图像内容的base64编码字符串,支持JPG和PNG格式图像。文件最大2MB。 |
active |
字符串(整数型的内容) |
否 |
"1" 来启用目标,"0" 来停用目标。默认为 "1",不是维持不变请注意。 |
name |
字符串 |
否 |
目标名称,仅支持英文字母、英文标点、数字,长度最小1个字符,最大64个字符 |
size |
字符串(浮点型的内容) |
否 |
识别图宽度(单位cm)。识别图的高度将由系统根据您上传的图片自动计算。识别图的大小和虚拟内容的大小对应。默认20 |
meta |
字符串 |
否 |
一般用于存储AR内容信息,文本字符串格式,默认是""。 例如:识别物的JSON信息,图片的base64编码,或者是大文件在云存储的URL下载地址。 |
allowSimilar |
字符串 |
否 |
如果存在相似图是否强制允许添加,默认0.相似图可能影响识别结果,建议采用默认。 |
响应字段¶
样例¶
请求
PUT /target/e61db301-e80f-4025-b822-9a00eb48d8d2 HTTP/1.1
Host:
Date: Mon, 1 Jan 2018 00:00:00 GMT
Content-Type: application/json
{
"active":"1",
"name":"easyar",
"size":"5",
"meta":"496fbbabc2b38ecs3460a...",
"timestamp": 1514736000000,
"appKey": "test_app_key",
"signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
}
返回
HTTP/1.1 200 OK
Content-Type: application/json
{
"statusCode": 0,
"result": {
"target": {
"targetId":"e61db301-e80f-4025-b822-9a00eb48d8d2",
"trackingImage":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM...",
"name": "easyar",
"size": "5",
"meta": "496fbbabc2b38ecs3460a...",
"type": "ImageTarget",
"date": "2016-06-15T09:56:30.000Z",
"active":"1",
"active":"1",
"trackableRate": 0,
"detectableRate": 0,
“detectableDistinctiveness”:0,
"detectableFeatureCount", 0,
"trackableDistinctiveness", 0,
"trackableFeatureCount", 0,
"trackableFeatureDistribution", 0,
"trackablePatchContrast", 0,
"trackablePatchAmbiguity", 0
}
},
"timestamp": 1514736000000
}
样例实现:¶
EasyAR为开发者提供了几个语言的 Target Management Samples,方便程序调用实现自动化: