升级版本=》 2.4.4 新增图像处理，一些接口更新

Author: ruanshimin

package.json

@@ -1,6 +1,6 @@
 {
   "name": "baidu-aip-sdk",
-  "version": "2.3.6",
+  "version": "2.4.4",
   "description": "百度AI开放平台Nodejs SDK, 文档以及详情请访问官网: https://ai.baidu.com",
   "main": "src/index.js",
   "scripts": {

src/AipBodyAnalysis.js

@@ -30,6 +30,8 @@ const BODY_ATTR_PATH = '/rest/2.0/image-classify/v1/body_attr';
 const BODY_NUM_PATH = '/rest/2.0/image-classify/v1/body_num';
 const GESTURE_PATH = '/rest/2.0/image-classify/v1/gesture';
 const BODY_SEG_PATH = '/rest/2.0/image-classify/v1/body_seg';
+const DRIVER_BEHAVIOR_PATH = '/rest/2.0/image-classify/v1/driver_behavior';
+const BODY_TRACKING_PATH = '/rest/2.0/image-classify/v1/body_tracking';
 
 
 /**
@@ -72,12 +74,12 @@ class AipBodyAnalysis extends BaseClient {
     }
 
     /**
-     * 人体属性识别接口
+     * 人体检测与属性识别接口
      *
      * @param {string} image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
      * @param {Object} options - 可选参数对象，key: value都为string类型
      * @description options - options列表:
-     *   type gender,<br>age,<br>lower_wear,<br>upper_wear,<br>headwear,<br>glasses,<br>upper_color,<br>lower_color,<br>cellphone,<br>upper_wear_fg,<br>upper_wear_texture,<br>lower_wear_texture,<br>orientation,<br>umbrella,<br>bag,<br>smoke,<br>vehicle,<br>carrying_item,<br>upper_cut,<br>lower_cut,<br>occlusion &#124; 1）可选值说明：<br>gender-性别，<br>age-年龄阶段，<br>lower_wear-下身服饰，<br>upper_wear-上身服饰，<br>headwear-是否戴帽子，<br>glasses-是否戴眼镜，<br>upper_color-上身服饰颜色，<br>lower_color-下身服饰颜色，<br>cellphone-是否使用手机，<br>upper_wear_fg-上身服饰细分类，<br>upper_wear_texture-上身服饰纹理，<br>orientation-身体朝向，<br>umbrella-是否撑伞；<br>bag-背包,<br>smoke-是否吸烟,<br>vehicle-交通工具,<br>carrying_item-是否有手提物,<br>upper_cut-上方截断,<br>lower_cut-下方截断,<br>occlusion-遮挡<br>2）type 参数值可以是可选值的组合，用逗号分隔；**如果无此参数默认输出全部20个属性**
+     *   type gender,<br>age,<br>lower_wear,<br>upper_wear,<br>headwear,<br>glasses,<br>upper_color,<br>lower_color,<br>cellphone,<br>upper_wear_fg,<br>upper_wear_texture,<br>lower_wear_texture,<br>orientation,<br>umbrella,<br>bag,<br>smoke,<br>vehicle,<br>carrying_item,<br>upper_cut,<br>lower_cut,<br>occlusion,<br>is_human | 1）可选值说明：<br>gender-性别，<br>age-年龄阶段，<br>lower_wear-下身服饰，<br>upper_wear-上身服饰，<br>headwear-是否戴帽子，<br>glasses-是否戴眼镜，<br>upper_color-上身服饰颜色，<br>lower_color-下身服饰颜色，<br>cellphone-是否使用手机，<br>upper_wear_fg-上身服饰细分类，<br>upper_wear_texture-上身服饰纹理，<br>orientation-身体朝向，<br>umbrella-是否撑伞；<br>bag-背包,<br>smoke-是否吸烟,<br>vehicle-交通工具,<br>carrying_item-是否有手提物,<br>upper_cut-上方截断,<br>lower_cut-下方截断,<br>occlusion-遮挡,<br>is_human-是否是正常人体<br>2）type 参数值可以是可选值的组合，用逗号分隔；**如果无此参数默认输出全部21个属性**
      * @return {Promise} - 标准Promise对象
      */
     bodyAttr(image, options) {
@@ -94,7 +96,7 @@ class AipBodyAnalysis extends BaseClient {
      * @param {string} image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
      * @param {Object} options - 可选参数对象，key: value都为string类型
      * @description options - options列表:
-     *   area 特定框选区域坐标，逗号分隔，如‘x1,y1,x2,y2,x3,y3...xn,yn'，默认尾点和首点相连做闭合，**此参数为空或无此参数默认识别整个图片的人数**
+     *   area 特定框选区域坐标，支持多个多边形区域，最多支持10个区域，如输入超过10个区域，截取前10个区域进行识别。<br>**此参数为空或无此参数、或area参数设置错误时，默认识别整个图片的人数** 。<br>area参数设置错误的示例：某个坐标超过原图大小，x、y坐标未成对出现等；注意：**设置了多个区域时，任意一个坐标设置错误，则认为area参数错误、失效**。<br>**area参数设置格式**：<br>1）多个区域用英文分号“;”分隔；<br>2）同一个区域内的坐标用英文逗号“,”分隔，默认尾点和首点相连做闭合。<br>示例：<br>1）单个多边形区域：x1,y1,x2,y2,x3,y3...xn,yn<br>2）多个多边形区域：xa1,ya1,xa2,ya2,xa3,ya3...xan,yan;xb1,yb1,xb2,yb2,xb3,yb3...xbn,ybn;..
      *   show 是否输出渲染的图片，默认不返回，**选true时返回渲染后的图片(base64)**，其它无效值或为空则默认false
      * @return {Promise} - 标准Promise对象
      */
@@ -128,6 +130,7 @@ class AipBodyAnalysis extends BaseClient {
      * @param {string} image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
      * @param {Object} options - 可选参数对象，key: value都为string类型
      * @description options - options列表:
+     *   type 可以通过设置type参数，自主设置返回哪些结果图，避免造成带宽的浪费<br>1）可选值说明：<br>labelmap - 二值图像，需二次处理方能查看分割效果<br>scoremap - 人像前景灰度图<br>foreground - 人像前景抠图，透明背景<br>2）type 参数值可以是可选值的组合，用逗号分隔；如果无此参数默认输出全部3类结果图
      * @return {Promise} - 标准Promise对象
      */
     bodySeg(image, options) {
@@ -137,6 +140,45 @@ class AipBodyAnalysis extends BaseClient {
         };
         return this.commonImpl(objectTools.merge(param, options));
     }
+
+    /**
+     * 驾驶行为分析接口
+     *
+     * @param {string} image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
+     * @param {Object} options - 可选参数对象，key: value都为string类型
+     * @description options - options列表:
+     *   type smoke,cellphone,<br>not_buckling_up,<br>both_hands_leaving_wheel,<br>not_facing_front |识别的属性行为类别，英文逗号分隔，默认所有属性都识别；<br>smoke //吸烟，<br>cellphone //打手机 ，<br>not_buckling_up // 未系安全带，<br>both_hands_leaving_wheel // 双手离开方向盘，<br>not_facing_front // 视角未看前方
+     * @return {Promise} - 标准Promise对象
+     */
+    driverBehavior(image, options) {
+        let param = {
+            image: image,
+            targetPath: DRIVER_BEHAVIOR_PATH
+        };
+        return this.commonImpl(objectTools.merge(param, options));
+    }
+
+    /**
+     * 人流量统计-动态版接口
+     *
+     * @param {string} image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
+     * @param {string} dynamic - true：动态人流量统计，返回总人数、跟踪ID、区域进出人数；<br>false：静态人数统计，返回总人数
+     * @param {Object} options - 可选参数对象，key: value都为string类型
+     * @description options - options列表:
+     *   case_id 当dynamic为True时，必填；任务ID（通过case_id区分不同视频流，自拟，不同序列间不可重复即可）
+     *   case_init 当dynamic为True时，必填；每个case的初始化信号，为true时对该case下的跟踪算法进行初始化，为false时重载该case的跟踪状态。当为false且读取不到相应case的信息时，直接重新初始化
+     *   show 否返回结果图（含统计值和跟踪框渲染），默认不返回，选true时返回渲染后的图片(base64)，其它无效值或为空则默认false
+     *   area 当dynamic为True时，必填；静态人数统计时，只统计区域内的人，缺省时为全图统计。<br>动态人流量统计时，进出区域的人流会被统计。<br>逗号分隔，如‘x1,y1,x2,y2,x3,y3...xn,yn'，按顺序依次给出每个顶点的xy坐标（默认尾点和首点相连），形成闭合多边形区域。<br>服务会做范围（顶点左边需在图像范围内）及个数校验（数组长度必须为偶数，且大于3个顶点）。只支持单个多边形区域，建议设置矩形框，即4个顶点。**坐标取值不能超过图像宽度和高度，比如1280的宽度，坐标值最小建议从1开始，最大到1279**。
+     * @return {Promise} - 标准Promise对象
+     */
+    bodyTracking(image, dynamic, options) {
+        let param = {
+            image: image,
+            dynamic: dynamic,
+            targetPath: BODY_TRACKING_PATH
+        };
+        return this.commonImpl(objectTools.merge(param, options));
+    }
 }
 
 module.exports = AipBodyAnalysis;

src/AipContentCensor.js

@@ -30,7 +30,9 @@ const CONTENT_TYPE_JSON = 'application/json';
 
 const METHOD_POST = 'POST';
 
-const PATH_USER_DEFINED = '/rest/2.0/solution/v1/img_censor/user_defined';
+const PATH_USER_DEFINED_IMAGE = '/rest/2.0/solution/v1/img_censor/v2/user_defined';
+const PATH_USER_DEFINED_TEXT = '/rest/2.0/solution/v1/text_censor/v2/user_defined';
+
 const PATH_ANTIPORN_GIF = '/rest/2.0/antiporn/v1/detect_gif';
 const PATH_FACEAUDIT = '/rest/2.0/solution/v1/face_audit';
 const PATH_COMBOCENSOR = '/api/v1/solution/direct/img_censor';
@@ -133,7 +135,14 @@ class AipImageCensor extends BaseClient {
         if (type === 'base64') {
             param.image = image;
         }
-        param.targetPath = PATH_USER_DEFINED;
+        param.targetPath = PATH_USER_DEFINED_IMAGE;
+        return this.commonImpl(param);
+    }
+
+    textCensorUserDefined(text, type) {
+        let param = {};
+        param.text = text;
+        param.targetPath = PATH_USER_DEFINED_TEXT;
         return this.commonImpl(param);
     }