1、介绍

总览

机器学习服务(ML Kit)提供机器学习套件,为开发者使用机器学习能力开发各类应用,提供优质体验。得益于华为长期技术积累,ML Kit为开发者提供简单易用、服务多样、技术领先的机器学习能力,助力开发者更快更好地开发各类AI应用。

AppGallery Connect(简称AGC)云存储是一种可伸缩、免维护的云端存储服务,可用于存储图片、音频、视频或其他由用户生成的内容。借助云存储服务,您可以无需关心存储服务器的开发、部署、运维、扩容等事务,大大降低了应用使用存储的门槛,让您可以专注于应用的业务能力构建,助力您的商业成功。

您将建立什么

在本次Codelab中,您将建立一个示例项目并集成机器学习服务、云存储和认证服务。通过示例项目,当图像被拾取时,应用程序将从选定图片中删除背景。之后,再将图片可以上传到云。在该项目中,您可以:

1、使用ML Kit删除图片背景

2、将图片保存到手机存储

3、上传镜像文件到云存储

4、列举云存储中的文件

5、从云存储下载和删除图片

您将学会什么

在本codelab中,你需要学习:

1、如何在AppGallery Connect中创建项目和应用程序

2、如何ML Kit、云存储和认证服务

3、使用ML Kit并学习如何从图片中删除背景、使用认证服务和了解云存储的操作

 

2、您需要什么

硬件需求

  • 一台笔记本或台式电脑。

  • 华为手机:EMUI 5.0版本或以上,运行HMS Core (APK) 5.0.1.301及以上版本;非华为手机:Android 4.4或以上,运行HMS Core (APK) 5.0.1.301或以上版本。

  • 手机用于运行和调试demo

软件需求

  • JDK版本:1.8.211或以上

  • Android Studio版本:3.X或以上

  • minSdkVersion:19或以上(必须)

  • targetSdkVersion:31(推荐)

  • compileSdkVersion:31(推荐)

  • Gradle版本:4.6或以上(推荐)

必备知识

安卓应用开发基础知识

 

3、集成前准备

集成前,需要完成以下准备工作:

说明:

在进行准备前,请先注册开发者帐号

  • 在AppGallery Connect中创建项目和应用。

  • 创建Android Studio项目。

  • 生成签名证书。

  • 生成签名证书指纹。

  • 在AppGallery Connect中将签名指纹添加到应用中。

  • 添加必要配置。

  • 配置项目签名。

  • 同步项目。

详情请参见HUAWEI HMS Core集成准备

 

4、集成HMS Core SDK

添加您应用的AppGallery Connect配置文件

1.登录AppGallery Connect,点击“我的项目”,在项目列表中找到并点击您的项目。

2.在“项目设置”页面选择“常规”页签。

3.在“项目”区域下点击“数据处理位置”后的“启用”。

cke_19520.png

 

4.点击“应用”区域的“agconnect-services.json”下载配置文件。

111.PNG

 

5.将配置文件"agconnect-services.json"复制到应用级根目录下。

cke_43971.png

添加编译依赖

  1. 打开应用级的“build.gradle”文件。

  2. 在dependencies代码段中添加如下编译依赖。

    dependencies { 
    //Huawei Auth
    implementation 'com.huawei.agconnect:agconnect-auth:1.6.5.300'
    //Ml Kit
    implementation 'com.huawei.hms:ml-computer-vision-segmentation:3.7.0.302'
    // Import the multiclass segmentation model package.
    implementation 'com.huawei.hms:ml-computer-vision-image-segmentation-multiclass-model:3.7.0.302'
    // Import the human body segmentation model package.
    implementation 'com.huawei.hms:ml-computer-vision-image-segmentation-body-model:3.7.0.302'
    // Import the hair segmentation model package.
    implementation 'com.huawei.hms:ml-computer-vision-image-segmentation-hair-model:3.7.0.302'
    //Cloud Storage
    implementation "com.huawei.agconnect:agconnect-storage:1.5.0.100"
    }

    【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

  3. 在build.gradle文件中,设置Java源代码的兼容性模式为JDK1.8。

    compileOptions {
    sourceCompatibility = 1.8
        targetCompatibility = 1.8
    }

    【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

  4. 在应用级build.gradle文件中配置minSdkVersion。

    android {
     ... 
    compileSdk 32
       defaultConfig {
          ... 
       minSdkVersion 24
       targetSdk 32
          ... 
      }
       ... 
    }

    【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

  5. 检查是否已添加AppGallery Connect插件。如没有,在应用级build.gradle文件中添加该插件。

    apply plugin: 'com.huawei.agconnect'

    【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

配置混淆脚本

编译APK前需要配置混淆脚本,避免混淆HMS Core SDK。如果出现混淆,HMS Core SDK可能无法正常工作。

Android Studio开发环境里的混淆脚本是“proguard-rules.pro”。

加入排除HMS SDK的混淆配置。

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

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

 

5、设计UI

cke_2020.png

6、集成机器学习服务

步骤一:开通服务

1)登录AppGallery Connect,单击我的项目。

cke_3317.png

2)点击需要集成的项目卡片,在顶部的应用下拉列表中选择要开通服务的应用。

cke_8882.png

3)单击“API管理”,打开机器学习服务的开关。

cke_12695.png

步骤二:添加权限

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

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<application
.
.
. <meta-data
android:name="com.huawei.hms.ml.DEPENDENCY"
android:value="imgseg" />
</application>

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

步骤三:进行图像分割

1、创建图像分割器

1.1集成人像分割模型包

1.2集成多类型分割模型包

1.3使用多类型分割模型包对图像进行多类别分割时,只支持通过图像分割检测配置器MLImageSegmentationSetting创建图像分割检测器。

   var setting = MLImageSegmentationSetting.Factory()
            .setExact(true)
            .setAnalyzerType(MLImageSegmentationSetting.BODY_SEG)
            .setScene(MLImageSegmentationScene.FOREGROUND_ONLY)
            .create()
        analyzer = MLAnalyzerFactory.getInstance().getImageSegmentationAnalyzer(setting)
        val drawable: BitmapDrawable = binding.imageView.drawable as BitmapDrawable
        bitmap = drawable.bitmap
        val mlFrame = MLFrame.Creator().setBitmap(bitmap).create()
        val task: Task<MLImageSegmentation> = analyzer.asyncAnalyseFrame(mlFrame)
        task.addOnSuccessListener {
            removeBackGround(it)
        }.addOnFailureListener {
            Log.e(TAG1, "analyse -> asyncAnalyseFrame: ", it)
        }

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

2、使用MLImageSegmentation删除图像背景

private fun removeBackground(mlImageSegmentation: MLImageSegmentation?) {
        if (mlImageSegmentation != null) {
            if (bitmap == null) {
                Log.e(TAG1, "bitmap is null")
                return
            }
            val bitmapFore: Bitmap = mlImageSegmentation.getForeground()
            if (bitmapFore != null) {
                binding.imageView.setImageBitmap(bitmapFore)
            } else {
                Log.e(TAG1, "bitmap is null")
            }
        }    }

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

 

7、初始化认证服务

步骤一:开通服务

1)登录AppGallery Connect,单击我的项目。

cke_32494.png

2)点击需要集成的项目卡片,在顶部的应用下拉列表中选择要开通服务的应用。

cke_40759.png

3)单击“API管理”,打开认证服务的开关。

cke_57074.png

步骤二:实现认证服务

进行匿名登录

     if (AGConnectAuth.getInstance().currentUser != null) {
            DriverManager.println("already sign a user")
            Log.i(TAG2, "already sign a user")
            return
        } else {
            AGConnectAuth.getInstance().signInAnonymously()
                .addOnSuccessListener {
                    DriverManager.println("AGConnect OnSuccess")
                    Log.i(TAG2, "AGConnect OnSuccess")
                }
                .addOnFailureListener { e ->
                    DriverManager.println("AGConnect OnFail: " + e.message)
                    Log.i(TAG2, "AGConnect OnFail ${e.message}")
                }
        }

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

 

8、初始化云存储

步骤一:查看权限

<uses-permission android:name="android.permission.INTERNET"/> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <application
      android:allowBackup="false"
      android:requestLegacyExternalStorage="true"

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

步骤二:开通服务

1)登录AppGallery Connect,单击我的项目。

2)在项目列表中选择一个项目,单击需要添加云存储的应用。

3)在左侧导航栏中,选择“Serverless > 云存储”,在“云存储”页面,单击“立即开通”。

cke_2117.png

4)在弹出的页面中,设置“存储实例”和“默认数据处理位置”。

cke_8518.png

5)单击“下一步”,查看默认安全规则。

cke_14617.png

步骤三:初始化权限

private val permissions = 
arrayOf<String>(Manifest.permission.WRITE_EXTERNAL_STORAGE, 
Manifest.permission.READ_EXTERNAL_STORAGE)
ActivityCompat.requestPermissions(this, permissions, 1)

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

步骤四:初始化存储实例

前提条件

在应用客户端使用云存储功能前,都需要初始化存储实例。

您可以调用AGCStorageManagement.getInstance方法创建一个AGCStorageManagement对象来初始化默认存储实例。

private var mAGCStorageManagement: AGCStorageManagement? = null
val storageManagement = AGCStorageManagement.getInstance()
private fun initAGCStorageManagement() {
        mAGCStorageManagement = AGCStorageManagement.getInstance()
        Log.i(TAG2, "Init AGC Storage Management success! ")
    }

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

步骤五:上传文件

   val progressDialog = ProgressDialog(this)
        progressDialog.setMessage("Uploading File....")
        progressDialog.setCancelable(false)
        progressDialog.show()
        val systemCurrentTime: Long = System.currentTimeMillis()
        val path = "/images/${systemCurrentTime}.png"
        val agcSdkDirPath = agcSdkDirPath
        val file = File(agcSdkDirPath)
        if (!file.exists()) {
            Log.i(TAG2, "file is not exist!")
            return
        } else {
            Log.i(TAG2, "file is exist")
            val storageReference =
                mAGCStorageManagement!!.getStorageReference(path)
            val uploadTask = storageReference.putFile(file)

            uploadTask.addOnSuccessListener {
                Log.i(TAG2, "upload success!")
                progressDialog.dismiss()
            }
                .addOnFailureListener { e: Exception ->
                    progressDialog.dismiss()
                    Log.i(
                        TAG2,
                        "Upload Failed $e"
                    )
                }
        }
private val agcSdkDirPath: String
        get() {
            DriverManager.println("path=$path")
            val dir = File(path)
            if (!dir.exists()) {
                dir.mkdirs()
            }
            return path!!
        }

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

步骤六:列举文件

   val path = "images/"
        val storageReference = mAGCStorageManagement?.getStorageReference(path)
        var listResultTask: Task<ListResult>? = null
        listResultTask = storageReference?.list(100)
        listResultTask?.addOnSuccessListener {
            fileList = ArrayList(it.fileList)
            mAdapter = DownloadListAdapter(
                this@DownloadListActivity,
                fileList = fileList,
                mAGCStorageManagement,
                this@DownloadListActivity
            )
            binding.recyclerView.adapter = mAdapter
            mAdapter.notifyDataSetChanged()

            Log.i("MYSTORAGE", "SUCCEDD: ${fileList.size}")
        }?.addOnFailureListener {
            Log.e("MYSTORAGE", "FAIL: ${it.printStackTrace()}")
        }
    }

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

步骤七:下载文件

     val progressDialog = ProgressDialog(context)
        progressDialog.setMessage("Downloading File....")
        progressDialog.setCancelable(false)
        progressDialog.show()
        val fileName = fileName
        val path = path
        val agcSdkDirPath = agcSdkDirPath2
        val file = File(agcSdkDirPath, fileName)
        val storageReference = mAGCStorageManagement!!.getStorageReference(path)
        val downloadTask = storageReference.getFile(file)
        downloadTask.addOnSuccessListener {
            Toast.makeText(context, "Download Succeed", Toast.LENGTH_SHORT).show()
            progressDialog.dismiss()
        }.addOnFailureListener { e: Exception ->
            Toast.makeText(context, "Download Error", Toast.LENGTH_SHORT).show()
            progressDialog.dismiss()
            Log.i("MYSTORAGE", "DOWNLOAD ERROR: $e")
        }
private val agcSdkDirPath2: String
        get() {
            val path =
                Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).absoluteFile.toString()
            DriverManager.println("path=$path")
            val dir = File(path)
            if (!dir.exists()) {
                dir.mkdirs()
            }
            return path
        }

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

步骤八:删除文件

     val progressDialog = ProgressDialog(context)
        progressDialog.setMessage("Downloading File....")
        progressDialog.setCancelable(false)
        progressDialog.show()
        val fileName = fileName
        val path = path
        val agcSdkDirPath = agcSdkDirPath2
        val file = File(agcSdkDirPath, fileName)
        val storageReference = mAGCStorageManagement!!.getStorageReference(path)
        val downloadTask = storageReference.getFile(file)
        downloadTask.addOnSuccessListener {
            Toast.makeText(context, "Download Succeed", Toast.LENGTH_SHORT).show()
            progressDialog.dismiss()
        }.addOnFailureListener { e: Exception ->
            Toast.makeText(context, "Download Error", Toast.LENGTH_SHORT).show()
            progressDialog.dismiss()
            Log.i("MYSTORAGE", "DOWNLOAD ERROR: $e")
        }
private val agcSdkDirPath2: String
        get() {
            val path =
                Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).absoluteFile.toString()
            DriverManager.println("path=$path")
            val dir = File(path)
            if (!dir.exists()) {
                dir.mkdirs()
            }
            return path
        }

【HMS Core】机器学习服务助力APP快速集成图像分割与上传功能

 

9、恭喜您

祝贺您,您已经成功完成本codelab并学到了:

  • 如何集成机器学习服务、云存储和认证服务。

  • 如何从图像中去除背景,并学习了云存储的操作方法。

 

10、参考文件

点击下载源码。

 

​欲了解更多更全技术文章,欢迎访问https://developer.huawei.com/consumer/cn/forum/?ha_source=zzh