图像处理之滤镜、图文智能排版开发详解，从入门到起飞

在上一篇?如何给应用增加图片编辑功能：剪裁、滤镜、贴纸、排版、标签，我们详细讲解了“图片”风口下，各类应用可能面临的“窘境”：由于应用内缺乏图片编辑设计能力，或者提供的图片编辑设计能力不足，导致原本功能强大的优质应用，没法提高用户留存率，影响应用自身竞争实力。华为图像服务旨在为各类交互应用解决这一问题，可以说是应时而生，应势而生。在详细介绍华为图像服务五大图像编辑能力分别是什么、各自的应用场景以及功能价值的基础上，接下来将为大家带来五大图片编辑功能的具体开发步骤。

滤镜服务

开发步骤

滤镜服务开发步骤如下，需要您提供图片和相关参数，得到相应的返回值。

1、导入滤镜服务包。

import com.huawei.hms.image.vision.*;
import com.huawei.hms.image.vision.bean.ImageVisionResult;

2、获取滤镜服务实例。

// 获取ImageVisionImpl对象
ImageVisionImpl imageVisionAPI = ImageVision.getInstance(this);

3、服务初始化，调用setVisionCallBack时需要实现ImageVision.VisionCallBack接口，重写其中的onSuccess(int successCode)和onFailure(int errorCode)方法。

• 框架初始化成功后会回调onSuccess方法，在onSuccess方法中，需要再初始化滤镜服务。调用滤镜初始化接口时，只有通过校验，第三方应用才能使用滤镜服务，initCode必须为0，滤镜服务初始化成功。
• 框架初始化失败时会回调onFailure方法，传回失败错误码。

imageVisionAPI.setVisionCallBack(new ImageVision.VisionCallBack() {
    @Override
    public void onSuccess(int successCode) {
       int initCode = imageVisionAPI.init(context, authJson);
       ...
    }
    @Override
    public void onFailure(int errorCode) {
        ...
    }
});

入参authJson：

说明：图文智能排版服务，图像主题标签服务token为必选值，获取方式参见：token获取方式。  

4、构建参数对象。

requestJson字段信息：

 滤镜的taskJson字段信息：

filterType映射表：

authJson映射表：请参见authJson表

滤镜服务requestJson示例：

{
  "requestId":"requestId",
  "taskJson":{"intensity":"1","filterType":"1","compressRate":"1"},
  "authJson":{"projectId":"projectIdTest","appId":"appIdTest","authApiKey":"authApiKeyTest","clientSecret":"CSecretTest","clientId":"CIdTest","token":"tokenTest"}
}

5、滤镜服务获取结果。

您在调用getColorFilter接口时，需要输入待处理图片的Bitmap，并选择需要的滤镜效果。滤镜服务根据传入的参数对原始图片进行处理后，返回处理后图片的Bitmap。

// 获取visionResult返回值
new Thread(new Runnable() {
    @Override    
    public void run() {
        ImageVisionResult visionResult = imageVisionAPI.getColorFilter(requestJson,imageBitmap);
        }           
    }).start();

visionResult返回值：

response字段信息：

  说明：调用getColorFilter接口时，需要开启一个子线程去执行，不能在主线程执行。

6、停止服务。

当不再需要滤镜效果时，调用该接口停止服务，stopCode为0时，停止服务成功。

if (null != imageVisionAPI) {
    int stopCode = imageVisionAPI.stop();
}

图文智能排版服务
开发步骤

图文智能排版服务开发步骤如下，需要您提供图片和相关参数，得到相应的返回值。

1、导入图文智能排版服务包。

import com.huawei.hms.image.vision.bean.ImageLayoutInfo ;
import com.huawei.hms.image.vision.*;

2、获取图文智能排版服务实例

// 获取ImageVisionImpl 对象
ImageVisionImpl imageVisionAPI = ImageVision.getInstance(this);

3、服务初始化，与滤镜服务一致，可参见开发步骤中的相关描述。

构建参数对象。

requestJson字段信息：

 图文智能排版的taskJson字段信息：

authJson映射表：请参见authJson字段定义。

图文智能排版服务requestJson示例：

{
  "requestId":"requestId",
  "taskJson":{"title":"轻奢新生代","description":"远离城市的喧嚣","copyRight":"华为杂志锁屏","isNeedMask":false,"anchor":"查看详情","styleList":["info1"]},
  "authJson":{"projectId":"projectIdTest","appId":"appIdTest","authApiKey":"authApiKeyTest","clientSecret":"CSecretTest","clientId":"CIdTest","token":"tokenTest"}
}

 ImageLayoutInfo返回值：

response字段：

 说明：①因为接口涉及网络请求，需要开启子线程去调用接口。②使用图文智能排版服务时，您需要保证提供的token是有效的，否则无法使用该服务。③token的获取方式可参见token获取方式。

6、停止服务。

当不再需要图文智能排版效果时，调用该接口停止服务，stopCode为0时，执行成功。

if (null != imageVisionAPI) {
    int stopCode = imageVisionAPI.stop();
}

在下一篇中，将继续带来在应用中添加图像裁剪能力、图像主题标签能力、贴纸花字能力的开发详解，敬请期待~

>>访问华为图像服务官网，了解更多相关内容
>>获取华为图像服务开发指导文档
>>华为HMS Core官方论坛
>>华为图像服务开源仓库地址：GitHub、Gitee

点击右上角头像右方的关注，第一时间了解华为移动服务最新技术~