如何用华为图像服务快速实现滤镜功能

1、引言

随着手机拍照功能日益强大，拍照和修图成了我们每个人的必备技能，正所谓“拍照五分钟，修图两小时”好看的图片也成为很多年轻人的社交工具。因此，滤镜和修图成了很多社交APP内必不可少的功能。那么，如何给自己的APP添加一个滤镜功能呢？可以接入HUAWEI Image Kit, 提供24款颜色滤镜进行图像优化,帮助你快速实现滤镜功能。

2、功能演示和示例代码

如果你对实现方式感兴趣，可以去Github去下载源代码，可以基于具体应用场景优化。

Github demo下载地址：https://github.com/HMS-Core/hms-image-vision

3、准备工作

步骤1：配置AppGallery Connect

集成HUAWEI HMS Core能力，需要完成以下准备工作：

• 注册成为华为开发者

• 创建AppGallery Connect应用

• 创建Android Studio工程

• 生成签名证书

• 生成签名证书指纹

• 配置签名证书指纹

• 添加应用包名并保存配置文件

• 配置Maven仓地址及AppGallery Connect gradle插件

• 在Android Studio配置签名文件

具体操作，请按照《HUAWEI HMS Core集成准备》中详细说明来完成。

步骤2：打开Android Studio

步骤3：选择“File > Open > 示例工程解压路径”，点击“OK”

步骤4：添加HUAWEI agcp插件、配置仓库、依赖包、混淆脚本、权限（示例代码中已经配好，但后续你的工程需要参考配置）

1.在项目级“build.gradle”中配置maven仓库路径及HUAWEI agcp插件

• 在“allprojects > repositories”里面配置HMS SDK的maven仓地址

allprojects {      
     repositories { 
          maven { url 'https://developer.huawei.com/repo/' } 
          … 
     } 
  }

• 在“buildscript > repositories”里面配置HMS SDK的maven仓地址

buildscript { 
      repositories { 
          maven {url 'https://developer.huawei.com/repo/'} 
          … 
      } 
      … 
 }

• 在“buildscript > dependencies”里面增加配置

buildscript{ 
     dependencies { 
         classpath 'com.huawei.agconnect:agcp:1.3.1.300' 
     } 
 }

2.在应用级“build.gradle”中配置依赖包

• 在“dependencies”中添加依赖包

dependencies { 
     … 
             implementation 'com.huawei.hms:image-vision:1.0.2.301' 
     … 
 }

• 配置minSdkVersion

android { 
     ... 
     defaultConfig { 
         ... 
         minSdkVersion 26 
         ... 
     } 
     ... 
 }

• 在文件头添加配置

apply plugin: 'com.huawei.agconnect'

说明：apply plugin: 'com.huawei.agconnect’需要在apply plugin:'com.android.application’之后配置。

3.配置混淆脚本

• 在“app/proguard-rules.pro”文件中配置

-ignorewarnings 
 -keepattributes *Annotation* 
 -keepattributes Exceptions 
 -keepattributes InnerClasses 
 -keepattributes Signature 
 -keepattributes SourceFile,LineNumberTable 
 -keep class com.hianalytics.android.**{*;} 
 -keep class com.huawei.updatesdk.**{*;} 
 -keep class com.huawei.hms.**{*;}

• 如果开发者使用了AndResGuard，需要在混淆配置文件中加入AndResGuard白名单

"R.string.hms*", 
 "R.string.connect_server_fail_prompt_toast", 
 "R.string.getting_message_fail_prompt_toast", 
 "R.string.no_available_network_prompt_toast", 
 "R.string.third_app_*", 
 "R.string.upsdk_*", 
 "R.layout.hms*", 
 "R.layout.upsdk_*",  
 "R.drawable.upsdk*", 
 "R.color.upsdk*",  
 "R.dimen.upsdk*", 
 "R.style.upsdk*", 
 "R.string.agc*"

4.在“AndroidManifest.xml”文件中配置权限

步骤5：选择Android Studio的“File > Sync Project with Gradle Files”，同步工程。

4.在“AndroidManifest.xml”文件中配置权限

步骤1：新建一个Activity，导入服务包。

public class ImageKitVisionDemoActivity extends AppCompatActivity implements View.OnClickListener

导包

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

实现onCreate方法，在方法里关联activity_main.xml布局：setContentView(R.layout.activity_filter);

步骤2：新建一个activity_main.xml布局文件

定义有按钮和文本编辑布局：

步骤3：在ImageKitVisionDemoActivity中定义变量，在onCreate方法中关联变量与activity_main.xml中按钮和文本编辑布局

//定义文本编辑和按钮
private EditText btn_filter;
private Button btn_init;
//通过布局id，关联文本编辑变量和布局中文本编辑框
btn_filter = findViewById(R.id.btn_filter);
//通过布局id，关联按钮变量和布局中按钮
btn_init = findViewById(R.id.btn_init);
//设置按钮监听事件
btn_init.setOnClickListener(this);

步骤4：重写onClick方法，定义每个点击事件调用的方法，示例：

@Override
 public void onClick(View v) {
     switch (v.getId()) {
         case R.id.btn_init:
             initFilter(context);
             break;
     }
 }

步骤5：获取服务实例：该步骤主要是获取滤镜服务实例，例如，获取滤镜效果图等，写在上述监听点击事件中initFilter方法中。

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

步骤6：服务初始化，写在上述监听点击事件中initFilter方法中

调用setVisionCallBack时需要实现ImageVision的VisionCallBack接口，重写其中的onSuccess(ImageVisionImpl imageVision)和onFailure(int errorCode)方法。初始化框架成功时会回调onSuccess方法，初始化滤镜服务。初始化失败时会回调onFailure方法，传回失败错误码。调用初始化接口时，只有通过校验，第三方应用才能使用场景智能设计服务，初始化成功。

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

入参authJson：

说明：以上参数除了token之外，都可在agconnect-services.json文件中查找(参考开发指南)。因安全问题，示例代码中未显示真实鉴权信息，你在开发时需填写真实的鉴权信息。

步骤7：构建参数对象requestJson。

入参requestJson和imageBitmap：

requestJson字段信息：

taskJson字段信息：

filterType映射表：

requestJson 示例：

步骤8：获取渲染图。定义一个按钮，监听点击事件，通过点击事件调用接口，注意：调取接口时，需要开启一个子线程去执行，不能在主线程执行。

ImageVisionResult返回值：

response字段信息：

步骤9：停止服务。

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

5. 结束语

至此我们就已完成了滤镜功能开发，借助HMS Image Kit不需要花费太多时间就能给APP添加滤镜功能至此我们滤镜功能开发完成，借助HMS ImageKit只需要调用滤镜接口就可以给APP添加滤镜功能，简单易用，这24款滤镜也会给用户带来更多的选择和良好的体验。

欲了解更多详情，请参阅：

华为开发者联盟官网：https://developer.huawei.com/consumer/en/hms

获取开发指导文档：https://developer.huawei.com/consumer/en/doc/development

参与开发者讨论请到Reddit社区：https://www.reddit.com/r/HMSCore/

下载demo和示例代码请到Github：https://github.com/HMS-Core

解决集成问题请到Stack Overflow：https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest

原文链接：https://developer.huawei.com/consumer/cn/forum/topicview?tid=0203351141059660527&fid=18
作者：梦阳