手势动作类型接口

1 引言

1.1 概述

通过http(s)接口的方式实现摄像头抓取jpg图像的人手势识别,输出手势动作的类型结果。

1.2 错误类型定义

status 状态码

reason 描述

0

操作成功

106

被识别图片格式不对

1010

超过当天识别上限

1011

识别错误

1012

错误的账号(aiKey)类型

2 接口说明

2.1

请求方式:POST

Content-Type: application/json

请求地址:http://ai-api.easyar.com:8080/v1/pose/hand

HTTPS: https://ai-api.easyar.com:8443/v1/pose/hand

2.1.1 请求参数

属性

类型

约束

说明

image

String

必选

被识别的JPG图像用base64编码

输入是移动端摄像头采集的RGB图像(不要带alpha通道)。

2.1.2 请求示例

POST /v1/pose/hand HTTP/1.1
Host:
Date: Mon, 1 Jan 2018 00:00:00 GMT
Content-Type: application/json
{
    "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgM..."
}

2.1.3 返回示例

成功的返回:

{
    "result": {
        "hand": {
            "requestTime": "1536132612462",
            "class": {
                "gun": 0.9999999987457104,
                "others": 0,
                "onehandheart": 0
            }
        }
    },
    "statusCode": 0,
    "msg": "Success",
    "timestamp": 1536132613871
}

异常的返回:

{
    "result": "",
    "statusCode": 106,
    "msg": "Error: upload invalid RGB image",
    "timestamp": 1536132790001
}

返回说明:

statusCode:认证结果,0表示认证正确,1表示无效的应用秘钥,2表示无效的签名,3表示无效的日期

result:各个接口的返回结果在这里出现

timestamp:响应返回时的服务器端时间,用于在需要时调整需认证的请求中的时间

hand: 该请求是识别的手势

requestTime:客户端请求的时间

class: 这里的参数是识别结果,值最大的就是最有可能的结果

gun: 手枪

onehandheart: 单手比心

others: 非以上手势类型

nohand: 没有手

six: 六

victory: V胜利