伊宁 發表於 2020-4-30 10:27:00

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

<p></p><div class="toc"><div class="toc-container-header">目录</div><ul><li>介绍</li><li>简介</li><li>关于本次CodeLab<ul><li><ul><li>你将建立什么</li><li>你会学到什么</li><li>你需要什么</li></ul></li></ul></li><li>申请Camera相关权限</li><li>集成HwCameraKit开放能力<ul><li>步骤1模式创建：获取CameraKit实例，创建人像模式</li><li>步骤2 配置模式：配置模式的状态回调，数据回调及处理这些回调的Handler，以及预览、拍照分辨率等参数</li><li>步骤3模式操作<ul><li>3.1开启预览</li><li>3.2参数设置</li><li>步骤4操作Callback</li><li>步骤5模式释放</li></ul></li></ul></li><li>恭喜你</li></ul></div><p></p>
<h1 id="介绍">介绍</h1>
<p><img src="https://img-blog.csdnimg.cn/20200430091808160.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<h1 id="简介">简介</h1>
<p>  HwCameraKit为开发者提供了一套兼容EMUI的相机能力开放接口，开发者可以通过HwCameraKit使自己的应用快速接入华为相机的私有能力，扩展应用的拍摄功能，为用户提供更好拍摄体验。</p>
<p>  人像模式为HwCameraKit开放的多种相机模式其中之一，它将允许您：</p>
<ul>
<li>获取华为相机的人像拍摄能力，包括背景虚化、环境光、瘦脸，皮肤光滑、调色等能力；</li>
<li>提供相机模式高级编程接口，简化相机应用开发，并借助IDE工具快速接入上述能力。</li>
</ul>
<hr>
<h1 id="关于本次codelab">关于本次CodeLab</h1>
<h3 id="你将建立什么">你将建立什么</h3>
<p>  在本次CodeLab中，您将使用HwCameraKit建立一款Android相机应用程序，使其可以获得华为相机的人像拍摄功能，实现人像的虚化、美肤等效果。<br>
<img src="https://img-blog.csdnimg.cn/20200430101016471.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"><br>
<em>普通拍摄（左） VS 人像模式开启虚化（右）</em></p>
<h3 id="你会学到什么">你会学到什么</h3>
<ul>
<li>使用HwCameraKit IDE高效集成华为相机开放能力</li>
<li>熟悉HwCameraKit基本开发模式</li>
</ul>
<h3 id="你需要什么">你需要什么</h3>
<p><strong>硬件要求</strong></p>
<ol>
<li>开发计算机（台式机或笔记本电脑）</li>
<li>操作系统为EMUI10.0及以上版本的华为手机</li>
</ol>
<p><strong>软件要求</strong></p>
<ol>
<li>JAVA JDK安装包</li>
<li>Android SDK包</li>
<li>HwCameraKit IDE工具:DevEco</li>
</ol>
<hr>
<h1 id="申请camera相关权限">申请Camera相关权限</h1>
<p>Duration: 0:05<br>
  1. 在工程的Manifest文件中添加相关权限：</p>
<pre><code class="language-java">&lt;uses-permission   android:name="android.permission.CAMERA"/&gt;

&lt;uses-permission android:name="android.permission.RECORD_AUDIO"/&gt;

&lt;uses-permission   android:name="android.permission.WRITE_EXTERNAL_STORAGE"/&gt;
</code></pre>
<p>  2. 动态申请相关权限：</p>
<pre><code class="language-java">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&lt;String&gt; permissionsList = new ArrayList&lt;&gt;(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 ), REQUEST_CODE_ASK_PERMISSIONS);
}
</code></pre>
<hr>
<h1 id="集成hwcamerakit开放能力">集成HwCameraKit开放能力</h1>
<p>Duration: 0:60<br>
  通过IDE提供的功能卡片，可以快速获取示例代码并将其添加到工程中，以人像模式为例，找到人像能力卡片:可通过Tools-&gt;EMUI Kits-&gt;Kit Assistant-&gt;Camera-&gt;Portrait Mode 来找到该卡片。</p>
<p><img src="https://img-blog.csdnimg.cn/20200430101113554.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center"></p>
<blockquote>
<p>提示：本次Codelabs提供了配套的app开发工程，请使用IDE工具导入，并根据如下步骤，实现提供的配套工程中带有/* TODO */注释的方法，从而快速集成人像模式。</p>
</blockquote>
<h2 id="步骤1--模式创建获取camerakit实例创建人像模式">步骤1模式创建：获取CameraKit实例，创建人像模式</h2>
<pre><code class="language-java">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) &amp;&amp; (cameraLists.length &gt; 0)) {
      
      Log.i(TAG, "Try to use camera   with id " + cameraLists);
      
      /** Query supported modes of this   device*/

      int[] modes = mCameraKit . getSupportedModes (cameraLists);
      
      if (!Arrays.stream(modes).anyMatch((i)   -&gt; i == mCurrentModeType)) {
            Log.w(TAG, "Current mode is   not supported in this device!");
            return;
      }
      mCameraKit.createMode(cameraLists, mCurrentModeType, mModeStateCallback, mCameraKitHandler);
    }
   
}
</code></pre>
<h2 id="步骤2-配置模式配置模式的状态回调数据回调及处理这些回调的handler以及预览拍照分辨率等参数">步骤2 配置模式：配置模式的状态回调，数据回调及处理这些回调的Handler，以及预览、拍照分辨率等参数</h2>
<p>  从mModeStateCallback的onCreated回调后，可从入参可获得人像Mode实例</p>
<pre><code class="language-java">/** 在onCreated回调中获取mode对象，然后以行为的状态回调和数据回调及对应的线程为入参，初始化ModeConfig.Builder，配置预览的surface和拍照的大小，通过configure命令将配置项设置到mMode中，进行模式的激活*/
private   void configMode() {

    Log.i(TAG, "configMode begin");

    /** Query supported preview size*/

    List&lt;Size&gt; previewSizes =   mModeCharacteristics.getSupportedPreviewSizes(SurfaceTexture.class);

    /** Query supported capture size*/

    List&lt;Size&gt; 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) -&gt; Math.abs((1.0f * size.getHeight() /   size.getWidth()) - (1.0f * mCaptureSize.getHeight() /   mCaptureSize.getWidth())) &lt; 0.01).findFirst().get();
    Log.i(TAG, "configMode: mCaptureSize   = " + mCaptureSize + ";mPreviewSize=" + mPreviewSize);

    /** Update view*/

    runOnUiThread(() -&gt;   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");
}
</code></pre>
<p>  使用构造器ModeConfig.Builder配置模式的状态回调及数据回调及执行回调所在的Handler。从状态回调中，开发者可以获取如启动预览后状态变化、拍照结束状态、手动对焦结束、人脸检测结果返回等信息；从数据回调中，开发者可获取模式动作执行过程中产生数据结果（如拍照图像数据等）。还可通过ModeConfig.Builder配置预览Surface及拍照分辨率。</p>
<h2 id="步骤3--模式操作">步骤3模式操作</h2>
<h3 id="31--开启预览">3.1开启预览</h3>
<pre><code class="language-java">/* 在接收到到onConfigured回调后，说明mode配置成功，模式进入开启状态，此时调用startPreview命令开启预览。*/

private   void startPreview() {
    mMode.startPreview();
}
</code></pre>
<h3 id="32--参数设置">3.2参数设置</h3>
<pre><code class="language-java">/* 用户可以通过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 &amp;&amp; smoothLevels.length != 0) {
mMode.setBeauty(Metadata.BeautyType.HW_BEAUTY_SKIN_SMOOTH,smoothLevels);
}
/* 用户可以通过设计按钮等方式，调用takePicture进行拍照，异步通过onImageAvailable回调，返回照片Image数据。*/
mMode.takePicture();
</code></pre>
<h3 id="步骤4--操作callback">步骤4操作Callback</h3>
<pre><code class="language-java">/* 以数据回调为例，在拍照后从回调里获取图片 */
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();
    }
};
</code></pre>
<blockquote>
<p>提示：除了从ActionDataCallback获取拍照图片等数据以外，从ActionStateCallback中还可获取模式动作执行过程中，执行状态结果的回调处理，如启动预览后状态变化、拍照结束状态、手动对焦结束、人脸检测结果返回等。</p>
</blockquote>
<h3 id="步骤5--模式释放">步骤5模式释放</h3>
<pre><code class="language-java">/* 应用切后台，需要将模式释放 */
@Override
protected   void onPause() {
    if (mBackgroundHandler != null) {
      mBackgroundHandler.post(new   Runnable() {
            @Override
            public void run() {
                if (mMode != null) {
                  mMode.release();
                  mMode = null;
                }
            }
      });
    }
    super.onPause();
}
</code></pre>
<hr>
<h1 id="恭喜你">恭喜你</h1>
<ul>
<li>HwCameraKit IDE插件的安装和使用</li>
<li>利用HwCameraKit将华为相机开放能力接入app</li>
</ul>
<p>更多HwCameraKit相关信息请关注我们的官网：<br>
https://developer.huawei.com/consumer/cn/CameraKit</p>
<hr>
<p>往期链接：Android | 教你如何快速集成机器学习能力<br>
内容来源：https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201234569803940158&amp;fid=3467<br>
原作者：艾罗门特</p><br><br>
来源：https://www.cnblogs.com/developer-huawei/p/12807242.html
頁: [1]
查看完整版本: Android | 教你如何使用HwCameraKit接入相机人像模式