爱站程序员基地简介
HwCameraKit为开发者提供了一套兼容EMUI的相机能力开放接口，开发者可以通过HwCameraKit使自己的应用快速接入华为相机的私有能力，扩展应用的拍摄功能，为用户提供更好拍摄体验。
人像模式为HwCameraKit开放的多种相机模式其中之一，它将允许您：
获取华为相机的人像拍摄能力，包括背景虚化、环境光、瘦脸，皮肤光滑、调色等能力；
提供相机模式高级编程接口，简化相机应用开发，并借助IDE工具快速接入上述能力。
关于本次CodeLab
你将建立什么
在本次CodeLab中，您将使用HwCameraKit建立一款Android相机应用程序，使其可以获得华为相机的人像拍摄功能，实现人像的虚化、美肤等效果。
在这里插入图片描述
普通拍摄（左） VS 人像模式开启虚化（右）
你会学到什么
使用HwCameraKit IDE高效集成华为相机开放能力
熟悉HwCameraKit基本开发模式
你需要什么
硬件要求
开发计算机（台式机或笔记本电脑）
操作系统为EMUI10.0及以上版本的华为手机
软件要求
JAVA JDK安装包
Android SDK包
HwCameraKit IDE工具:DevEco
申请Camera相关权限
Duration: 0:05
1. 在工程的Manifest文件中添加相关权限：
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 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 来找到该卡片。
在这里插入图片描述
提示：本次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 not support CameraKit！\");}/** Query camera id list*/String[] cameraLists = mCameraKit . getCameraIdList ();if ((cameraLists != null) && (cameraLists.length > 0)) {Log.i(TAG, \"Try to use camera with id \" + cameraLists[0]);/** Query supported modes of this device*/int[] modes = mCameraKit . getSupportedModes (cameraLists[0]);if (!Arrays.stream(modes).anyMatch((i) -> i == mCurrentModeType)) {Log.w(TAG, \"Current mode is not supported in this device!\");return;}mCameraKit.createMode(cameraLists[0], mCurrentModeType, mModeStateCallback, mCameraKitHandler);}
}
步骤2 配置模式：配置模式的状态回调，数据回调及处理这些回调的Handler，以及预览、拍照分辨率等参数
从mModeStateCallback的onCreated回调后，可从入参可获得人像Mode实例
/** 在onCreated回调中获取mode对象，然后以行为的状态回调和数据回调及对应的线程为入参，初始化ModeConfig.Builder，配置预览的surface和拍照的大小，通过configure命令将配置项设置到mMode中，进行模式的激活*/
private void 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 default 4000x3000*/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 to config 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命令开启预览。*/
private void 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
/* 以数据回调为例，在拍照后从回调里获取图片 */
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();
}
};
提示：除了从ActionDataCallback获取拍照图片等数据以外，从ActionStateCallback中还可获取模式动作执行过程中，执行状态结果的回调处理，如启动预览后状态变化、拍照结束状态、手动对焦结束、人脸检测结果返回等。
步骤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();
}
恭喜你
HwCameraKit IDE插件的安装和使用
利用HwCameraKit将华为相机开放能力接入app
