ListFaces
描述
分批列出当前用户照片中包含的人脸
请求参数
参数名 | 类型 | 是否必须 | 说明 |
---|---|---|---|
Action | String | 是 | ListFaces |
State | String | 是 | 指定人脸的状态,服务端只返回指定状态的人脸。可选值有active, inactive, deleted, all。关于人脸状态的变化请参考:数据模型 |
StoreName | String | 是 | PhotoStore的名称 |
Cursor | String | 否 | 指定拉取数据的游标。默认值为0,表示从最老的数据开始分批获取。 |
Direction | String | 否 | 指定拉取数据的方向,可选值为backward和forward。forward表示获取比指定游标更新的数据,backward表示获取比指定游标更老的数据。默认值为forward |
Size | Integer | 否 | 指定服务端返回的最大记录条数,最大值为500。默认值为50。 |
LibraryId | String | 否 | 照片库标识。采用AK认证时必选,采用STS认证时可选。了解不同认证方式的区别。 |
请求示例
https://cloudphoto.cn-shanghai.aliyuncs.com/?Action=ListFaces
&Cursor=0
&Direction=forward
&Size=1
&State=active
&StoreName=cloudphoto-demo
&LibraryId=alice-001
&<公共请求参数>
返回参数
参数名 | 类型 | 说明 |
---|---|---|
RequestId | String | 唯一标识本次请求的ID |
Code | String | 响应状态码,Success表示成功的响应 |
Message | String | 响应状态详细描述 |
Action | String | ListFaces |
Faces | Face[] | Face数组 |
NextCursor | String | 表示获取下一批数据的起始游标,如果为EOF则表示没有数据了。 |
TotalCount | String | 符合条件的记录总数 |
Faces
参数名 | 类型 | 说明 |
---|---|---|
Axis | 数组 | 长度为4的数组,数组的元素为数字,前两个和后两个数字分别表示封面照片中的一个点的坐标。这两个点确定的矩形即为人脸在封面照片中的位置。比如,59,25,88,62,就表示人脸的左上角的坐标为(59,25),右下角的坐标为(88,62)。 |
Cover | Object | 人脸的封面照片 |
Ctime | String | 创建的时间戳,单位:毫秒 |
Id | Long | 记录的唯一标识 |
IsMe | Boolean | 人脸是否为用户自己 |
Mtime | String | 最后修改的时间戳,单位:毫秒 |
Name | String | 人脸的名称,为命名的为空字符串 |
PhotosCount | String | 包含有该人脸的照片总数 |
State | String | 人脸的状态 |
Cover
参数名 | 类型 | 说明 |
---|---|---|
Ctime | String | 创建的时间戳,单位:毫秒 |
FileId | String | 照片对应到存储在OSS上的文件名 |
Height | Integer | 照片的高度 |
Id | Long | 人脸封面的照片Id,可以通过这个Id来获取照片的下载地址 |
Md5 | String | 人脸封面的Md5值。如果文件是以OSS分块上传方式上传的话,文件MD5为异步计算,在计算完成以前,MD5值为空。 |
Mtime | String | 人脸封面的最后修改时间戳,单位:毫秒 |
State | String | 文件的状态 |
Title | String | 照片的名称 |
Width | Integer | 照片的宽度 |
返回示例
JSON格式
{
"TotalCount":8,
"Action":"ListFaces",
"Message":"success",
"RequestId":"F6D18E5D-DD05-4063-8DFA-11F7903D410E",
"Faces":[
{
"Name":"人脸ITTFZW",
"IsMe":false,
"Mtime":1500889601901,
"Axis":[
59,
25,
88,
62
],
"State":"active",
"Id":824116397045981184,
"Ctime":1500380320897,
"Cover":{
"Md5":"596cf2553f06ba5d2c249f206dc2f217",
"Mtime":1500628851724,
"State":"active",
"Height":201,
"Id":824117117514162176,
"Ctime":1500380492669,
"Width":300,
"Title":"u=151615998,4109027133&fm=26&gp=0.jpg",
"FileId":"3aNW0Z4rToeko4eKeZcUcQAAAApwZDIE"
},
"PhotosCount":1
}
],
"NextCursor":"1500889601901:824116397045981184",
"Code":"Success"
}
XML格式
<?xml version="1.0" encoding="UTF-8"?>
<ListFacesResponse>
<Action>ListFaces</Action>
<TotalCount>8</TotalCount>
<Message>success</Message>
<RequestId>AE1E3C70-FD84-4586-9E97-8DB7A5051808</RequestId>
<Faces>
<Face>
<Name>人脸ITTFZW</Name>
<IsMe>false</IsMe>
<Axis>
<Axis>59</Axis>
<Axis>25</Axis>
<Axis>88</Axis>
<Axis>62</Axis>
</Axis>
<Mtime>1500889601901</Mtime>
<State>active</State>
<Cover>
<Mtime>1500628851724</Mtime>
<Md5>596cf2553f06ba5d2c249f206dc2f217</Md5>
<State>active</State>
<Height>201</Height>
<Ctime>1500380492669</Ctime>
<Id>824117117514162176</Id>
<Width>300</Width>
<FileId>3aNW0Z4rToeko4eKeZcUcQAAAApwZDIE</FileId>
<Title><![CDATA[u=151615998,4109027133&fm=26&gp=0.jpg]]></Title>
</Cover>
<Ctime>1500380320897</Ctime>
<Id>824116397045981184</Id>
<PhotosCount>1</PhotosCount>
</Face>
</Faces>
<NextCursor>1500889601901:824116397045981184</NextCursor>
<Code>Success</Code>
</ListFacesResponse>
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论