云相册的API人脸接口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的数组，数组的元素为数字，前两个和后两个数字分别表示封面照片中的一个点的坐标。这两个点确定的矩形即为人脸在封面照片中的位置。
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	记录的唯一标识
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>

云相册的API人脸接口ListFaces怎么使用

相关课程

相关电子书

相关实验场景

云相册的API人脸接口ListFaces怎么使用

相关课程

相关文章

相关电子书

相关实验场景