Android | 教你如何使用HwCameraKit接入相机人像模式

我自横刀向天笑,去留肝胆两昆仑。这篇文章主要讲述Android | 教你如何使用HwCameraKit接入相机人像模式相关的知识,希望能为你提供帮助。
介绍

Android | 教你如何使用HwCameraKit接入相机人像模式

文章图片

简介    HwCameraKit为开发者提供了一套兼容EMUI的相机能力开放接口,开发者可以通过HwCameraKit使自己的应用快速接入华为相机的私有能力,扩展应用的拍摄功能,为用户提供更好拍摄体验。
    人像模式为HwCameraKit开放的多种相机模式其中之一,它将允许您:
  • 获取华为相机的人像拍摄能力,包括背景虚化、环境光、瘦脸,皮肤光滑、调色等能力;
  • 提供相机模式高级编程接口,简化相机应用开发,并借助IDE工具快速接入上述能力。
关于本次CodeLab 你将建立什么
    在本次CodeLab中,您将使用HwCameraKit建立一款android相机应用程序,使其可以获得华为相机的人像拍摄功能,实现人像的虚化、美肤等效果。
Android | 教你如何使用HwCameraKit接入相机人像模式

文章图片

普通拍摄(左) VS 人像模式开启虚化(右)
你会学到什么
  • 使用HwCameraKit IDE高效集成华为相机开放能力
  • 熟悉HwCameraKit基本开发模式
你需要什么
硬件要求
  1. 开发计算机(台式机或笔记本电脑)
  2. 操作系统为EMUI10.0及以上版本的华为手机
软件要求
  1. java JDK安装包
  2. Android SDK包
    1. HwCameraKit IDE工具:DevEco
    申请Camera相关权限Duration: 0:05
        1. 在工程的Manifest文件中添加相关权限:
< uses-permissionandroid:name="android.permission.CAMERA"/> < uses-permission android:name="android.permission.RECORD_AUDIO"/> < uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

    2. 动态申请相关权限:
private static final String [] PERMISSIONS_ARRAY = new String[]{ Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.CAMERA, Manifest.permission.RECORD_AUDIO, Manifest.permission.ACCESS_FINE_LOCATION }; private static List< String> permissionsList = new ArrayList< > (PERMISSIONS_ARRAY.length); /** * 动态请求WRITE_EXTERNAL_STORAGE CAMERA RECORD_AUDIO权限 * * @param activity 应用activity */public static void requestPermission (final Activity activity) { for (String permission : PERMISSIONS_ARRAY) { if (ContextCompat.checkSelfPermission(activity, permission) != PackageManager.PERMISSION_GRANTED) { permissionsList.add(permission); } } ActivityCompat.requestPermissions(activity, permissionsList.toArray(new String [permissionsList.size()]), REQUEST_CODE_ASK_PERMISSIONS); }

集成HwCameraKit开放能力Duration: 0:60
    通过IDE提供的功能卡片,可以快速获取示例代码并将其添加到工程中,以人像模式为例,找到人像能力卡片:可通过Tools-> EMUI Kits-> Kit Assistant-> Camera-> Portrait Mode 来找到该卡片。
Android | 教你如何使用HwCameraKit接入相机人像模式

文章图片

提示:本次Codelabs提供了配套的app开发工程,请使用IDE工具导入,并根据如下步骤,实现提供的配套工程中带有/ TODO /注释的方法,从而快速集成人像模式。
步骤1模式创建:获取CameraKit实例,创建人像模式
private@Mode.Type int mCurrentModeType; private CameraKit mCameraKit; private ModeCharacteristics mModeCharacteristics; private void createMode() {mCameraKit = CameraKit.getInstance(getApplicationContext()); if (mCameraKit == null) { Log.e(TAG, "This device does notsupport CameraKit!"); }/** Query camera id list*/String[] cameraLists = mCameraKit . getCameraIdList (); if ((cameraLists != null) & & (cameraLists.length > 0)) {Log.i(TAG, "Try to use camerawith id " + cameraLists[0]); /** Query supported modes of thisdevice*/int[] modes = mCameraKit . getSupportedModes (cameraLists[0]); if (!Arrays.stream(modes).anyMatch((i)-> i == mCurrentModeType)) { Log.w(TAG, "Current mode isnot supported in this device!"); return; } mCameraKit.createMode(cameraLists[0], mCurrentModeType, mModeStateCallback, mCameraKitHandler); }}

步骤2 配置模式:配置模式的状态回调,数据回调及处理这些回调的Handler,以及预览、拍照分辨率等参数    从mModeStateCallback的onCreated回调后,可从入参可获得人像Mode实例
/** 在onCreated回调中获取mode对象,然后以行为的状态回调和数据回调及对应的线程为入参,初始化ModeConfig.Builder,配置预览的surface和拍照的大小,通过configure命令将配置项设置到mMode中,进行模式的激活*/ privatevoid configMode() {Log.i(TAG, "configMode begin"); /** Query supported preview size*/List< Size> previewSizes =mModeCharacteristics.getSupportedPreviewSizes(SurfaceTexture.class); /** Query supported capture size*/List< Size> captureSizes =mModeCharacteristics.getSupportedCaptureSizes(ImageFormat.JPEG); Log.d(TAG, "configMode: captureSizes= " + captureSizes.size() + "; previewSizes=" +previewSizes.size()); /** Use the first one or default4000x3000*/ mCaptureSize =captureSizes.stream().findFirst().orElse(new Size(4000, 3000)); /** Use the same ratio with preview*/mPreviewSize =previewSizes.stream().filter((size) -> Math.abs((1.0f * size.getHeight() /size.getWidth()) - (1.0f * mCaptureSize.getHeight() /mCaptureSize.getWidth())) < 0.01).findFirst().get(); Log.i(TAG, "configMode: mCaptureSize= " + mCaptureSize + "; mPreviewSize=" + mPreviewSize); /** Update view*/runOnUiThread(() -> mTextureView.setAspectRatio(mPreviewSize.getHeight(), mPreviewSize.getWidth())); SurfaceTexture texture =mTextureView.getSurfaceTexture(); if (texture == null) { Log.e(TAG, "configMode:texture=null!"); return; }/** Set buffer size of view*/texture.setDefaultBufferSize(mPreviewSize.getWidth(),mPreviewSize.getHeight()); /** Get surface of texture*/Surface surface = new Surface(texture); /** Add preview and capture parameters toconfig builder*/modeConfigBuilder.addPreviewSurface(surface).addCaptureImage(mCaptureSize,ImageFormat.JPEG); /** Set callback for config builder*/modeConfigBuilder.setDataCallback(actionDataCallback,mCameraKitHandler); modeConfigBuilder.setStateCallback(actionStateCallback,mCameraKitHandler); /** Configure mode*/mMode.configure(); Log.i(TAG, "configMode end"); }

    使用构造器ModeConfig.Builder配置模式的状态回调及数据回调及执行回调所在的Handler。从状态回调中,开发者可以获取如启动预览后状态变化、拍照结束状态、手动对焦结束、人脸检测结果返回等信息;从数据回调中,开发者可获取模式动作执行过程中产生数据结果(如拍照图像数据等)。还可通过ModeConfig.Builder配置预览Surface及拍照分辨率。
步骤3模式操作 3.1开启预览
/* 在接收到到onConfigured回调后,说明mode配置成功,模式进入开启状态,此时调用startPreview命令开启预览。*/privatevoid startPreview() { mMode.startPreview(); }

3.2参数设置
/* 用户可以通过ModeCharacteristics#getSupportedParameters查询当前模式下支持的参数(以人像模式为例:支持背景虚化,美肤等),通过ModeCharacteristics#getParameterRange查询参数支持的取值范围,通过Mode#setParameter设置对应效果。*//* 设置人像虚化 */ mMode.setParameter(RequestKey.HW_PORTRAIT_SPOTS_BOKEH,validValue); /* 设置美肤:皮肤光滑 */ int[]smoothLevels =modeCharacteristics.getSupportedBeauty(Metadata.BeautyType.HW_BEAUTY_SKIN_SMOOTH); if(smoothLevels != null & & smoothLevels.length != 0) { mMode.setBeauty(Metadata.BeautyType.HW_BEAUTY_SKIN_SMOOTH,smoothLevels[smoothLevels.length - 1]); } /* 用户可以通过设计按钮等方式,调用takePicture进行拍照,异步通过onImageAvailable回调,返回照片Image数据。*/ mMode.takePicture();

步骤4操作Callback
/* 以数据回调为例,在拍照后从回调里获取图片 */ privatefinal ActionDataCallback actionDataCallback = new ActionDataCallback() { @Override public void onImageAvailable(Mode mode,int id, Image image) { super.onImageAvailable(mode, id,image); Log.d(TAG,"onImageAvailable"); new ImageSaver(image, mFile,CameraKitActivity.this).run(); } };

提示:除了从ActionDataCallback获取拍照图片等数据以外,从ActionStateCallback中还可获取模式动作执行过程中,执行状态结果的回调处理,如启动预览后状态变化、拍照结束状态、手动对焦结束、人脸检测结果返回等。
步骤5模式释放
/* 应用切后台,需要将模式释放 */ @Override protectedvoid onPause() { if (mBackgroundHandler != null) { mBackgroundHandler.post(newRunnable() { @Override public void run() { if (mMode != null) { mMode.release(); mMode = null; } } }); } super.onPause(); }

恭喜你
  • HwCameraKit IDE插件的安装和使用
  • 利用HwCameraKit将华为相机开放能力接入app
更多HwCameraKit相关信息请关注我们的官网:
https://developer.huawei.com/consumer/cn/CameraKit
【Android | 教你如何使用HwCameraKit接入相机人像模式】往期链接:Android | 教你如何快速集成机器学习能力
内容来源:https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201234569803940158&fid=3467
原作者:艾罗门特

    推荐阅读