使用Camera Engine接入华为相机人像模式

Last Updated:

简介

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

人像模式为Camera Engine开放的多种相机模式其中之一，它将允许您：

获取华为相机的人像拍摄能力，包括背景虚化、环境光、瘦脸，皮肤光滑、调色等能力；
提供相机模式高级编程接口，简化相机应用开发，并借助IDE工具快速接入上述能力。

你将建立什么

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

普通拍摄（左）VS人像模式开启虚化（右）

你会学到什么

使用Camera Engine IDE高效集成华为相机开放能力
熟悉Camera Engine基本开发模式

你需要什么

硬件要求

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

软件要求

JAVA JDK安装包
Android SDK包
Camera Engine IDE工具:DevEco

在工程的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"/>

动态申请相关权限：


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提供的功能卡片，可以快速获取示例代码并将其添加到工程中，以人像模式为例，找到人像能力卡片:可通过EMUI->Kit Assistant->Media->Camera Engine->Portrait Mode 来找到该卡片

找到Camera Engine相关卡片

步骤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 模式操作

开启预览


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

参数设置


/* 用户可以通过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();
}

干得好，你已经成功完成了开发并学到了：

Camera Engine IDE插件的安装和使用
利用Camera Engine将华为相机开放能力接入app

更多Camera Engine相关信息请关注我们的官网：

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

已复制代码