简介

HwCameraKit为开发者提供了一套兼容EMUI的相机能力开放接口,开发者可以通过HwCameraKit使自己的应用快速接入华为相机的私有能力,扩展应用的拍摄功能,为用户提供更好拍摄体验。

人像模式为HwCameraKit开放的多种相机模式其中之一,它将允许您:

您将建立什么

在本次Codelab中,您将使用HwCameraKit建立一款Android相机应用程序,使其可以获得华为相机的人像拍摄功能,实现人像的虚化、美肤等效果。

普通拍摄(左)VS人像模式开启虚化(右)

您将会学到什么

您需要什么

硬件要求

开发计算机(台式机或笔记本电脑)
操作系统为EMUI10.0及以上版本的华为手机

软件要求

JAVA JDK安装包
Android Studio 3.1或更高版本
Android SDK包
HwCameraKit IDE工具:DevEco,Android studio插件(还未正式上线,仅国内支持)

  1. 在工程的Manifest文件中添加相关权限:
    <uses-permission android:name="android.permission.CAMERA"/> <uses-permission android:name="android.permission.RECORD_AUDIO"/> <uses-permission android: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); }

通过IDE提供的功能卡片,可以快速获取示例代码并将其添加到工程中,以人像模式为例,首先找到人像能力卡片

找到CameraKit相关卡片

步骤1 模式创建:获取CameraKit实例,创建人像模式

private @Mode.Type int mCurrentModeType; private CameraKit mCameraKit; private ModeCharacteristics modeCharacteristics; private void startCamerakit() { /** 获取CameraKit对象*/ mCameraKit = CameraKit.getInstance(getApplicationContext()); mCameraKit.registerCameraDeviceCallback(mCameraCallback, mBackgroundHandler); String[] cameraLists = mCameraKit.getCameraIdList(); if ((cameraLists != null) && (cameraLists.length > 0)) { Log.d(TAG, "openCamera: cameraId=" + cameraLists[0]); @Mode.Type int[] modes = mCameraKit.getSupportedModes(cameraLists[0]); mCurrentModeType = Mode.Type.PORTRAIT_MODE; modeCharacteristics = mCameraKit.getModeCharacteristics(cameraLists[0], mCurrentModeType); mSensorOrientation = modeCharacteristics.get(CameraCharacteristics.SENSOR_ORIENTATION); if (!CameraKitHelper.contains(modes, mCurrentModeType)) { Log.w(TAG, "current mode is not support in this device!"); return; } mCameraKit.createMode(cameraLists[0], mCurrentModeType, mModeStateCallback, mBackgroundHandler); } }

步骤2 配置模式:配置模式的状态回调,数据回调及处理这些回调的Handler,以及预览、拍照分辨率等参数

从mModeStateCallback的onCreated回调后,可从入参可获得人像Mode实例

/** 在onCreated回调中获取mode对象,然后以行为的状态回调和数据回调及对应的线程为入参,初始化ModeConfig.Builder,配置预览的surface和拍照的大小,通过configure命令将配置项设置到mMode中,进行模式的激活*/ private void configMode(Mode mode) { mMode = mode; modeConfigBuilder = mMode.getModeConfigBuilder(); modeConfigBuilder.setStateCallback(actionStateCallback, mStatusCbHandler); modeConfigBuilder.setDataCallback(actionDataCallback, mDataCbHandler); SurfaceTexture texture = mTextureView.getSurfaceTexture(); runOnUiThread(new Runnable() { @Override public void run() { mTextureView.setAspectRatio(previewSize.getHeight(), previewSize.getWidth()); } }); texture.setDefaultBufferSize(previewSize.getWidth(), previewSize.getHeight()); Surface surface = new Surface(texture); modeConfigBuilder.addPreviewSurface(surface).addCaptureImage(captureSize, ImageFormat.JPEG); mMode.configure(); }

使用构造器ModeConfig.Builder配置模式的状态回调及数据回调及执行回调所在的Handler。从状态回调中,开发者可以获取如启动预览后状态变化、拍照结束状态、手动对焦结束、人脸检测结果返回等信息;从数据回调中,开发者可获取模式动作执行过程中产生数据结果(如拍照图像数据、深度数据等)。还可通过ModeConfig.Builder配置预览Surface及拍照分辨率

步骤3 模式操作

  1. 开启预览

    /* 在接收到到onConfigured回调后,说明mode配置成功,模式进入开启状态,此时调用startPreview命令开启预览。*/ private void startPreview() { mMode.startPreview(); }
  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

/* 以数据回调为例,在拍照后从回调里获取图片 */ private final 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(); } };

步骤5 模式释放

/* 应用切后台,需要将模式释放 */ @Override protected void onPause() { if (mBackgroundHandler != null) { mBackgroundHandler.post(new Runnable() { @Override public void run() { if (mMode != null) { mMode.release(); mMode = null; } } }); } super.onPause(); } /* 应用销毁时需要取消注册相机状态回调 */ @Override public void onDestroy() { Log.d(TAG, "onDestroy: "); if (mCameraKit != null) { mCameraKit.unregisterCameraDeviceCallback(mCameraCallback); } super.onDestroy(); stopBackgroundThread(); }

干得好,你已经成功完成了开发并学到了:

更多HwCameraKit相关信息请关注我们的官网:

https://developer.huawei.com/consumer/cn/CameraKit

已复制代码