介紹

簡介

??HwCameraKit為開發(fā)者提供了一套兼容EMUI的相機能力開放接口，開發(fā)者可以通過HwCameraKit使自己的應(yīng)用快速接入華為相機的私有能力，擴展應(yīng)用的拍攝功能，為用戶提供更好拍攝體驗。

??人像模式為HwCameraKit開放的多種相機模式其中之一，它將允許您：

• 獲取華為相機的人像拍攝能力，包括背景虛化、環(huán)境光、瘦臉，皮膚光滑、調(diào)色等能力；
• 提供相機模式高級編程接口，簡化相機應(yīng)用開發(fā)，并借助IDE工具快速接入上述能力。

關(guān)于本次CodeLab

你將建立什么

??在本次CodeLab中，您將使用HwCameraKit建立一款A(yù)ndroid相機應(yīng)用程序，使其可以獲得華為相機的人像拍攝功能，實現(xiàn)人像的虛化、美膚等效果。

普通拍攝(左) VS 人像模式開啟虛化(右)

你會學(xué)到什么

• 使用HwCameraKit IDE高效集成華為相機開放能力
• 熟悉HwCameraKit基本開發(fā)模式

你需要什么

硬件要求

1. 開發(fā)計算機(臺式機或筆記本電腦)
2. 操作系統(tǒng)為EMUI10.0及以上版本的華為手機

軟件要求

1. JAVA JDK安裝包

2. Android SDK包

   1. HwCameraKit IDE工具:DevEco

—

# 申請Camera相關(guān)權(quán)限
Duration: 0:05

   1. 在工程的Manifest文件中添加相關(guān)權(quán)限：
 

<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. 動態(tài)申請相關(guān)權(quán)限：

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);

/**

 * 動態(tài)請求WRITE_EXTERNAL_STORAGE CAMERA RECORD_AUDIO權(quán)限
 *
 * @param activity 應(yīng)用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開發(fā)工程，請使用IDE工具導(dǎo)入，并根據(jù)如下步驟，實現(xiàn)提供的配套工程中帶有/ TODO /注釋的方法，從而快速集成人像模式。

步驟1 模式創(chuàng)建：獲取CameraKit實例，創(chuàng)建人像模式

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 配置模式：配置模式的狀態(tài)回調(diào)，數(shù)據(jù)回調(diào)及處理這些回調(diào)的Handler，以及預(yù)覽、拍照分辨率等參數(shù)

??從mModeStateCallback的onCreated回調(diào)后，可從入?yún)⒖色@得人像Mode實例

/** 在onCreated回調(diào)中獲取mode對象，然后以行為的狀態(tài)回調(diào)和數(shù)據(jù)回調(diào)及對應(yīng)的線程為入?yún)?，初始化ModeConfig.Builder，配置預(yù)覽的surface和拍照的大小，通過configure命令將配置項設(shè)置到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");
}

??使用構(gòu)造器ModeConfig.Builder配置模式的狀態(tài)回調(diào)及數(shù)據(jù)回調(diào)及執(zhí)行回調(diào)所在的Handler。從狀態(tài)回調(diào)中，開發(fā)者可以獲取如啟動預(yù)覽后狀態(tài)變化、拍照結(jié)束狀態(tài)、手動對焦結(jié)束、人臉檢測結(jié)果返回等信息；從數(shù)據(jù)回調(diào)中，開發(fā)者可獲取模式動作執(zhí)行過程中產(chǎn)生數(shù)據(jù)結(jié)果(如拍照圖像數(shù)據(jù)等)。還可通過ModeConfig.Builder配置預(yù)覽Surface及拍照分辨率。

步驟3 模式操作

3.1 開啟預(yù)覽

/* 在接收到到onConfigured回調(diào)后，說明mode配置成功，模式進入開啟狀態(tài)，此時調(diào)用startPreview命令開啟預(yù)覽。*/

private   void startPreview() {
    mMode.startPreview();
}

3.2 參數(shù)設(shè)置

/* 用戶可以通過ModeCharacteristics#getSupportedParameters查詢當前模式下支持的參數(shù)(以人像模式為例：支持背景虛化，美膚等)，通過ModeCharacteristics#getParameterRange查詢參數(shù)支持的取值范圍，通過Mode#setParameter設(shè)置對應(yīng)效果。*/

/* 設(shè)置人像虛化 */ 
mMode.setParameter(RequestKey.HW_PORTRAIT_SPOTS_BOKEH,   validValue);

/* 設(shè)置美膚：皮膚光滑 */
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]);
}
/* 用戶可以通過設(shè)計按鈕等方式，調(diào)用takePicture進行拍照，異步通過onImageAvailable回調(diào)，返回照片Image數(shù)據(jù)。*/
mMode.takePicture();

步驟4 操作Callback

/* 以數(shù)據(jù)回調(diào)為例，在拍照后從回調(diào)里獲取圖片 */
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獲取拍照圖片等數(shù)據(jù)以外，從ActionStateCallback中還可獲取模式動作執(zhí)行過程中，執(zhí)行狀態(tài)結(jié)果的回調(diào)處理，如啟動預(yù)覽后狀態(tài)變化、拍照結(jié)束狀態(tài)、手動對焦結(jié)束、人臉檢測結(jié)果返回等。

步驟5 模式釋放

/* 應(yīng)用切后臺，需要將模式釋放 */
@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

更多HwCameraKit相關(guān)信息請關(guān)注我們的官網(wǎng)：https://developer.huawei.com/consumer/cn/CameraKit

往期鏈接：Android | 教你如何快速集成機器學(xué)習(xí)能力
內(nèi)容來源：https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201234569803940158&fid=3467
原作者：艾羅門特