From 0d1fb1fc11a7c4ba22e43b470bc6d5c3c3eae833 Mon Sep 17 00:00:00 2001 From: mamingshuai Date: Wed, 2 Jun 2021 00:06:09 +0800 Subject: [PATCH] update OpenHarmony 2.0 Canary --- .gitattributes | 0 LICENSE | 177 +++++ README.en.md | 36 - README.md | 49 +- README_zh.md | 32 + figures/camera组件架构图.png | Bin 0 -> 85224 bytes ...position-in-the-subsystem-architecture.png | Bin 0 -> 49396 bytes frameworks/innerkitsimpl/camera/BUILD.gn | 141 ++++ .../camera/include/camera_device.h | 121 ++++ .../camera/include/camera_impl.h | 59 ++ .../camera/include/camera_manager.h | 49 ++ .../camera/include/camera_service.h | 43 ++ .../camera/include/camera_service_callback.h | 43 ++ .../camera/include/hal_display.h | 67 ++ .../innerkitsimpl/camera/include/hal_media.h | 56 ++ .../camera/src/camera_ability.cpp | 70 ++ .../camera/src/camera_config.cpp | 64 ++ .../camera/src/camera_device.cpp | 670 ++++++++++++++++++ .../innerkitsimpl/camera/src/camera_impl.cpp | 183 +++++ .../innerkitsimpl/camera/src/camera_kit.cpp | 61 ++ .../camera/src/camera_manager.cpp | 168 +++++ .../camera/src/camera_service.cpp | 120 ++++ .../camera/src/event_handler.cpp | 74 ++ .../innerkitsimpl/camera/src/frame_config.cpp | 65 ++ frameworks/innerkitsimpl/camera/test/BUILD.gn | 20 + .../test/moduletest/cpp/camera_test/BUILD.gn | 50 ++ .../camera_test/include/camera_module_test.h | 71 ++ .../camera_test/src/camera_module_test.cpp | 494 +++++++++++++ .../innerkitsimpl/prebuilts/etcs/BUILD.gn | 27 + .../prebuilts/etcs/cameradev_imx307.ini | 256 +++++++ .../prebuilts/etcs/cameradev_imx335.ini | 272 +++++++ .../prebuilts/etcs/cameradev_jxf23.ini | 256 +++++++ interfaces/innerkits/native/include/camera.h | 156 ++++ .../innerkits/native/include/camera_ability.h | 116 +++ .../innerkits/native/include/camera_config.h | 105 +++ .../native/include/camera_device_callback.h | 77 ++ .../innerkits/native/include/camera_kit.h | 119 ++++ .../native/include/camera_state_callback.h | 94 +++ .../innerkits/native/include/event_handler.h | 71 ++ .../innerkits/native/include/frame_config.h | 142 ++++ .../native/include/frame_state_callback.h | 88 +++ .../innerkits/native/include/media_log.h | 54 ++ .../innerkits/native/include/meta_data.h | 100 +++ interfaces/innerkits/native/test/BUILD.gn | 46 ++ .../innerkits/native/test/camera_sample.cpp | 529 ++++++++++++++ ohos.build | 40 ++ 46 files changed, 5468 insertions(+), 63 deletions(-) create mode 100644 .gitattributes create mode 100755 LICENSE delete mode 100644 README.en.md mode change 100644 => 100755 README.md create mode 100755 README_zh.md create mode 100755 figures/camera组件架构图.png create mode 100755 figures/position-in-the-subsystem-architecture.png create mode 100644 frameworks/innerkitsimpl/camera/BUILD.gn create mode 100644 frameworks/innerkitsimpl/camera/include/camera_device.h create mode 100644 frameworks/innerkitsimpl/camera/include/camera_impl.h create mode 100644 frameworks/innerkitsimpl/camera/include/camera_manager.h create mode 100644 frameworks/innerkitsimpl/camera/include/camera_service.h create mode 100644 frameworks/innerkitsimpl/camera/include/camera_service_callback.h create mode 100644 frameworks/innerkitsimpl/camera/include/hal_display.h create mode 100644 frameworks/innerkitsimpl/camera/include/hal_media.h create mode 100644 frameworks/innerkitsimpl/camera/src/camera_ability.cpp create mode 100644 frameworks/innerkitsimpl/camera/src/camera_config.cpp create mode 100644 frameworks/innerkitsimpl/camera/src/camera_device.cpp create mode 100644 frameworks/innerkitsimpl/camera/src/camera_impl.cpp create mode 100644 frameworks/innerkitsimpl/camera/src/camera_kit.cpp create mode 100644 frameworks/innerkitsimpl/camera/src/camera_manager.cpp create mode 100644 frameworks/innerkitsimpl/camera/src/camera_service.cpp create mode 100644 frameworks/innerkitsimpl/camera/src/event_handler.cpp create mode 100755 frameworks/innerkitsimpl/camera/src/frame_config.cpp create mode 100644 frameworks/innerkitsimpl/camera/test/BUILD.gn create mode 100755 frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/BUILD.gn create mode 100644 frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/include/camera_module_test.h create mode 100644 frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/src/camera_module_test.cpp create mode 100644 frameworks/innerkitsimpl/prebuilts/etcs/BUILD.gn create mode 100644 frameworks/innerkitsimpl/prebuilts/etcs/cameradev_imx307.ini create mode 100644 frameworks/innerkitsimpl/prebuilts/etcs/cameradev_imx335.ini create mode 100644 frameworks/innerkitsimpl/prebuilts/etcs/cameradev_jxf23.ini create mode 100644 interfaces/innerkits/native/include/camera.h create mode 100644 interfaces/innerkits/native/include/camera_ability.h create mode 100644 interfaces/innerkits/native/include/camera_config.h create mode 100644 interfaces/innerkits/native/include/camera_device_callback.h create mode 100644 interfaces/innerkits/native/include/camera_kit.h create mode 100644 interfaces/innerkits/native/include/camera_state_callback.h create mode 100644 interfaces/innerkits/native/include/event_handler.h create mode 100644 interfaces/innerkits/native/include/frame_config.h create mode 100644 interfaces/innerkits/native/include/frame_state_callback.h create mode 100644 interfaces/innerkits/native/include/media_log.h create mode 100644 interfaces/innerkits/native/include/meta_data.h create mode 100644 interfaces/innerkits/native/test/BUILD.gn create mode 100644 interfaces/innerkits/native/test/camera_sample.cpp create mode 100644 ohos.build diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..e69de29 diff --git a/LICENSE b/LICENSE new file mode 100755 index 0000000..4947287 --- /dev/null +++ b/LICENSE @@ -0,0 +1,177 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS \ No newline at end of file diff --git a/README.en.md b/README.en.md deleted file mode 100644 index 2ab4f4e..0000000 --- a/README.en.md +++ /dev/null @@ -1,36 +0,0 @@ -# multimedia_camera_standard - -#### Description -Implementation of camera device management and camera capture functions | 相机设备和相机采集功能实现 - -#### Software Architecture -Software architecture description - -#### Installation - -1. xxxx -2. xxxx -3. xxxx - -#### Instructions - -1. xxxx -2. xxxx -3. xxxx - -#### Contribution - -1. Fork the repository -2. Create Feat_xxx branch -3. Commit your code -4. Create Pull Request - - -#### Gitee Feature - -1. You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md -2. Gitee blog [blog.gitee.com](https://blog.gitee.com) -3. Explore open source project [https://gitee.com/explore](https://gitee.com/explore) -4. The most valuable open source project [GVP](https://gitee.com/gvp) -5. The manual of Gitee [https://gitee.com/help](https://gitee.com/help) -6. The most popular members [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) diff --git a/README.md b/README.md old mode 100644 new mode 100755 index 71d1ca5..640bd43 --- a/README.md +++ b/README.md @@ -1,37 +1,32 @@ -# multimedia_camera_standard +# Camera -#### 介绍 -Implementation of camera device management and camera capture functions | 相机设备和相机采集功能实现 +- [Introduction](#section11660541593) +- [Directory Structure](#section176641621345) +- [Repositories Involved](#section16511040154318) -#### 软件架构 -软件架构说明 +## Introduction +The **camera\_standard** repository enables your application to provide camera functions. You can access and operate the camera device and develop new functions through open APIs. Common operations include preview, photographing, and video recording. -#### 安装教程 +**Figure 1** Position in the subsystem architecture +![](figures/position-in-the-subsystem-architecture.png "position-in-the-subsystem-architecture") -1. xxxx -2. xxxx -3. xxxx +## Directory Structure -#### 使用说明 +The structure of the repository directory is as follows: -1. xxxx -2. xxxx -3. xxxx +``` +/foundation/multimedia/camera +├── frameworks # Framework code +│ ├── include # Header files required by the framework +│ └── src # Framework implementation +├── interfaces # External APIs +│ └── kits # External API files +├── LICENSE # License file +└── ohos.build # Build file +``` -#### 参与贡献 +## Repositories Involved -1. Fork 本仓库 -2. 新建 Feat_xxx 分支 -3. 提交代码 -4. 新建 Pull Request +multimedia\_camera\_standard - -#### 特技 - -1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md -2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com) -3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目 -4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目 -5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help) -6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) diff --git a/README_zh.md b/README_zh.md new file mode 100755 index 0000000..2b735fe --- /dev/null +++ b/README_zh.md @@ -0,0 +1,32 @@ +# Camera组件 + +- [简介](#section11660541593) +- [目录](#section176641621345) +- [相关仓](#section16511040154318) + +## 简介 + +相机组件支持相机业务的开发，开发者可以通过已开放的接口实现相机硬件的访问、操作和新功能开发，最常见的操作如：预览、拍照和录像等。 + +**图 1** camera组件架构图 +![](figures/camera组件架构图.png "camera组件架构图") + +## 目录 + +仓目录结构如下： + +``` +/foundation/multimedia/camera_standard # 相机组件业务代码 +├── frameworks # 框架代码 +│ ├── include # 框架所需头文件 +│ └── src # 框架层实现 +├── interfaces # 外部接口层 +│ └── kits # 外部接口文件 +├── LICENSE # 证书文件 +└── ohos.build # 编译文件 +``` + +## 相关仓 + +媒体子系统仓：multimedia\_camera\_standard + diff --git a/figures/camera组件架构图.png b/figures/camera组件架构图.png new file mode 100755 index 0000000000000000000000000000000000000000..9bddb30b68e156218ecfc5c3f927651751e9ecb5 GIT binary patch literal 85224 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 !`1S88s4OEx3 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
  • v4`8|LtI@Om7{-`VIsY$Z@F^ z3ZFF~6zHVzxd_{gADRa%^g2HM__e2HVwO^+uB`Ef;kRKVI5U3yANt8zEQ5z|56_yg zzHn%|^>=Z5kLoWOG*o$n&-U~UCYGJ!ze2nq)N=3&RPK1w2zHbl-&g)`LeePCx?p+N T_R_xR +#include +#include + +#include "camera_ability.h" +#include "camera_config.h" +#include "codec_type.h" +#include "frame_config.h" +#include "hal_media.h" +#include "surface.h" + +namespace OHOS { +namespace Media { +enum LoopState { + LOOP_IDLE, + LOOP_READY, + LOOP_LOOPING, + LOOP_STOP, + LOOP_ERROR, +}; + +class DeviceAssistant { +public: + std::thread *thrd_ = nullptr; + LoopState state_ = LOOP_IDLE; + FrameConfig *fc_ = nullptr; + + virtual int32_t + SetFrameConfig(FrameConfig &fc, std::vector &hdls, std::vector &attrs) + { + return -1; + } + virtual int32_t Start() + { + return -1; + } + virtual int32_t Stop() + { + return -1; + } +}; + +class RecordAssistant : public DeviceAssistant { +public: + int32_t SetFrameConfig(FrameConfig &fc, + std::vector &hdls, + std::vector &attrs) override; + int32_t Start() override; + int32_t Stop() override; + + std::vector vencHdls_; + std::vector> vencSurfaces_; + std::vector vencAttr_; + int32_t VideoEncIsExist(const HalVideoProcessorAttr &attr); + static int OnVencBufferAvailble(UINTPTR hComponent, UINTPTR dataIn, OutputInfo *buffer); + static CodecCallback recordCodecCb_; + sptr mProducerSurface; +}; + +class PreviewAssistant : public DeviceAssistant { +public: + int32_t SetFrameConfig(FrameConfig &fc, + std::vector &hdls, + std::vector &attrs) override; + int32_t Start() override; + virtual int32_t Stop() override; +}; + +class CaptureAssistant : public DeviceAssistant { + int32_t SetFrameConfig(FrameConfig &fc, + std::vector &hdls, + std::vector &attrs) override; + int32_t Start() override; + virtual int32_t Stop() override; + CODEC_HANDLETYPE vencHdl_ = nullptr; + Surface *capSurface_ = nullptr; +}; + +class CameraDevice { +public: + CameraDevice(); + virtual ~CameraDevice(); + + int32_t Initialize(CameraAbility &ability); + int32_t UnInitialize(); + int32_t SetCameraConfig(CameraConfig &cc); + + int32_t TriggerLoopingCapture(FrameConfig &fc); + void StopLoopingCapture(); + + int32_t TriggerSingleCapture(FrameConfig &fc); + +private: + CameraConfig *cc_ = nullptr; + std::vector prcessorHdls_; + std::vector prcessorAttrs_; + RecordAssistant recordAssistant_; + PreviewAssistant previewAssistant_; + CaptureAssistant captureAssistant_; +}; +} // namespace Media +} // namespace OHOS +#endif // OHOS_CAMERA_DEVICE_H diff --git a/frameworks/innerkitsimpl/camera/include/camera_impl.h b/frameworks/innerkitsimpl/camera/include/camera_impl.h new file mode 100644 index 0000000..ab76aea --- /dev/null +++ b/frameworks/innerkitsimpl/camera/include/camera_impl.h @@ -0,0 +1,59 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef OHOS_CAMERA_IMPL_H +#define OHOS_CAMERA_IMPL_H + +#include "camera.h" +#include "camera_ability.h" +#include "camera_device.h" +#include "camera_state_callback.h" + +namespace OHOS { +namespace Media { +class CameraImpl : public Camera { +public: + CameraImpl() = delete; + CameraImpl(std::string &id, const CameraAbility &ability); + virtual ~CameraImpl() = default; + + std::string GetCameraId() override; + const CameraConfig *GetCameraConfig() const override; + FrameConfig *GetFrameConfig(int32_t type) override; + + void Configure(CameraConfig &config) override; + void Release() override; + + int32_t TriggerLoopingCapture(FrameConfig &frameConfig) override; + void StopLoopingCapture() override; + int32_t TriggerSingleCapture(FrameConfig &frameConfig) override; + + const CameraAbility *GetAbility(); + void OnCreate(CameraDevice &device); + void OnCreateFailed(); + void RegistCb(CameraStateCallback &callback, EventHandler &handler); + +private: + std::string id_; + std::list frameConfigs_; + CameraConfig *config_ = nullptr; + CameraStateCallback *stateCb_ = nullptr; + EventHandler *handler_ = nullptr; + const CameraAbility *ability_ = nullptr; + CameraDevice *device_ = nullptr; +}; +} // namespace Media +} // namespace OHOS +#endif // OHOS_CAMERA_IMPL_H diff --git a/frameworks/innerkitsimpl/camera/include/camera_manager.h b/frameworks/innerkitsimpl/camera/include/camera_manager.h new file mode 100644 index 0000000..4fc68a3 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/include/camera_manager.h @@ -0,0 +1,49 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef OHOS_CAMERA_MANAGER_H +#define OHOS_CAMERA_MANAGER_H + +#include +#include + +#include "camera_ability.h" +#include "camera_device_callback.h" +#include "camera_state_callback.h" +#include "event_handler.h" + +namespace OHOS { +namespace Media { +class CameraManager { +public: + virtual ~CameraManager() = default; + static CameraManager *GetInstance(); + + virtual std::list GetCameraIds() = 0; + virtual const CameraAbility *GetCameraAbility(const std::string &cameraId) + { + return nullptr; + } + virtual void RegisterCameraDeviceCallback(CameraDeviceCallback &callback, EventHandler &handler) {} + virtual void UnregisterCameraDeviceCallback(const CameraDeviceCallback &callback) {} + virtual void CreateCamera(const std::string &cameraId, CameraStateCallback &callback, EventHandler &handler) {} + +protected: + CameraManager() {} +}; +} // namespace Media +} // namespace OHOS + +#endif // OHOS_CAMERA_MANAGER_H diff --git a/frameworks/innerkitsimpl/camera/include/camera_service.h b/frameworks/innerkitsimpl/camera/include/camera_service.h new file mode 100644 index 0000000..e2a5e40 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/include/camera_service.h @@ -0,0 +1,43 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef OHOS_CAMERA_SERVICE_H +#define OHOS_CAMERA_SERVICE_H + +#include "camera_device.h" +#include "camera_service_callback.h" + +namespace OHOS { +namespace Media { +class CameraService { +public: + virtual ~CameraService(); + static CameraService *GetInstance(); + + void Initialize(CameraServiceCallback &callback); + const CameraAbility *GetCameraAbility(std::string &cameraId); + void CreateCamera(std::string cameraId); + +private: + CameraService(); + int32_t InitCameraDevices(); + CameraDevice *device_ = nullptr; + CameraAbility *ability_ = nullptr; + CameraServiceCallback *cameraServiceCb_ = nullptr; +}; +} // namespace Media +} // namespace OHOS + +#endif // OHOS_CAMERA_SERVICE_H diff --git a/frameworks/innerkitsimpl/camera/include/camera_service_callback.h b/frameworks/innerkitsimpl/camera/include/camera_service_callback.h new file mode 100644 index 0000000..7ae40d1 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/include/camera_service_callback.h @@ -0,0 +1,43 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef OHOS_CAMERA_SERVICE_CALLBACK_H +#define OHOS_CAMERA_SERVICE_CALLBACK_H + +#include +#include + +#include "camera_device.h" + +namespace OHOS { +namespace Media { +class CameraServiceCallback { +public: + CameraServiceCallback() = default; + virtual ~CameraServiceCallback() = default; + + enum CameraStauts { + CAMERA_STATUS_AVAIL, + CAMERA_STATUS_UNAVAIL, + CAMERA_STATUS_CREATED, + CAMERA_STATUS_CREATE_FAILED + }; + virtual void OnCameraServiceInitialized(const std::list &availCameraIdList) {} + virtual void OnCameraStatusChange(const std::string &cameraId, CameraStauts status, const CameraDevice &device) {} +}; +} // namespace Media +} // namespace OHOS + +#endif // OHOS_CAMERA_SERVICE_CALLBACK_H diff --git a/frameworks/innerkitsimpl/camera/include/hal_display.h b/frameworks/innerkitsimpl/camera/include/hal_display.h new file mode 100644 index 0000000..21572e9 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/include/hal_display.h @@ -0,0 +1,67 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef COMMON_PLATFORM_VO_H +#define COMMON_PLATFORM_VO_H + +#include + +#ifdef __cplusplus +#if __cplusplus +extern "C" { +#endif +#endif /* End of #ifdef __cplusplus */ + +typedef int32_t HalVideoOutputHdl; + +typedef struct { + int32_t regionPositionX; + int32_t regionPositionY; + int32_t regionWidth; + int32_t regionHeight; + uint32_t priority; +} HalVideoOutputAttr; + +int32_t HalCreateVideoOutput(HalVideoOutputHdl *handle, HalVideoOutputAttr attr); + +int32_t HalConfigVideoOutput(HalVideoOutputHdl handle, HalVideoOutputAttr attr); + +int32_t HalGetVideoOutputConfig(HalVideoOutputHdl handle, HalVideoOutputAttr *attr); + +int32_t HalDestroyVideoOutput(HalVideoOutputHdl handle); + +int32_t HalStartVideoOutput(HalVideoOutputHdl handle); + +int32_t HalStopVideoOutput(HalVideoOutputHdl handle); + +int32_t HalWriteVo(HalVideoOutputHdl handle, const void *buffer); + +int32_t HalPlayerVoInit(HalVideoOutputHdl *handle); + +int32_t HalPlayerSysInit(void); + +void HalPlayerVoDeinit(HalVideoOutputHdl handle); + +int32_t HalCreateCameraVideoOutput(uint32_t deviceId, HalVideoOutputAttr *attr); + +int32_t HalDestroyCameraVideoOutput(); + +#ifdef __cplusplus +#if __cplusplus +} +#endif +#endif /* End of #ifdef __cplusplus */ + +#endif // COMMON_PLATFORM_VO_H \ No newline at end of file diff --git a/frameworks/innerkitsimpl/camera/include/hal_media.h b/frameworks/innerkitsimpl/camera/include/hal_media.h new file mode 100644 index 0000000..9de1ccc --- /dev/null +++ b/frameworks/innerkitsimpl/camera/include/hal_media.h @@ -0,0 +1,56 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef OHOS_CAMERA_HAL_H +#define OHOS_CAMERA_HAL_H + +#include "stdbool.h" +#include "stdint.h" + +#ifdef __cplusplus +#if __cplusplus +extern "C" { +#endif +#endif /* End of #ifdef __cplusplus */ + +#define HAL_MEDIA_OK 0 +#define HAL_MEDIA_ERR 1 + +typedef int32_t HalProcessorHdl; +#define HAL_INVALID_PROCESSOR (-1) +#define HAL_MAX_VPSS_NUM 10 +/* necessary and significant attr */ +typedef struct { + uint32_t width; + uint32_t height; + uint32_t fps; +} HalVideoProcessorAttr; + +HalProcessorHdl HalCreateVideoProcessor(HalVideoProcessorAttr *attr); +void HalCameraGetProcessorAttr(HalProcessorHdl hdls[HAL_MAX_VPSS_NUM], HalVideoProcessorAttr attrs[HAL_MAX_VPSS_NUM], + int32_t *size); +uint32_t HalGetProcessorDeviceId(HalProcessorHdl hdl); +void HalDestroyVideoProcessor(); + +/* camera */ +int32_t HalMediaInitialize(); +int32_t HalCameraInitialize(); +void HalCameraUnInitialize(); +#ifdef __cplusplus +#if __cplusplus +} +#endif +#endif /* End of #ifdef __cplusplus */ +#endif // OHOS_CAMERA_HAL_H \ No newline at end of file diff --git a/frameworks/innerkitsimpl/camera/src/camera_ability.cpp b/frameworks/innerkitsimpl/camera/src/camera_ability.cpp new file mode 100644 index 0000000..52492b9 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/src/camera_ability.cpp @@ -0,0 +1,70 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "camera_ability.h" + +#include "media_log.h" + +using namespace std; +namespace OHOS { +namespace Media { +CameraAbility::CameraAbility() {} +CameraAbility::~CameraAbility() {} + +list CameraAbility::GetSupportedSizes() const +{ + if (supportProperties_.find(PARAM_KEY_SIZE) != supportProperties_.end()) { + auto target = sizeMap_.find(PARAM_KEY_SIZE); + return target->second; + } + list emptyList; + return emptyList; +} + +list CameraAbility::GetSupportParameterRange(uint32_t key) const +{ + switch (key) { + case PARAM_KEY_SIZE: { + auto target = sizeMap_.find(PARAM_KEY_SIZE); + return target->second; + } + default: { + list emptyList; + return emptyList; + } + } +} + +void CameraAbility::SetSupportParameterRange(uint32_t key, list &rangeList) +{ + switch (key) { + case PARAM_KEY_SIZE: + supportProperties_.emplace(key); + sizeMap_[key] = rangeList; + break; + default: + break; + } +} + +bool CameraAbility::IsParameterSupport(uint32_t key) const +{ + if (key != PARAM_KEY_SIZE) { + return false; + } + return true; +} +} // namespace Media +} // namespace OHOS \ No newline at end of file diff --git a/frameworks/innerkitsimpl/camera/src/camera_config.cpp b/frameworks/innerkitsimpl/camera/src/camera_config.cpp new file mode 100644 index 0000000..4b5a80a --- /dev/null +++ b/frameworks/innerkitsimpl/camera/src/camera_config.cpp @@ -0,0 +1,64 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef OHOS_CAMERA_CONFIG_IMPL_H +#define OHOS_CAMERA_CONFIG_IMPL_H + +#include "camera_config.h" +#include "media_log.h" + +namespace OHOS { +namespace Media { +class CameraConfigImpl : public CameraConfig { +public: + CameraConfigImpl() = default; + virtual ~CameraConfigImpl() = default; + + void SetFrameStateCallback(const FrameStateCallback &callback, const EventHandler &handler) override + { + if (inUse_) { + MEDIA_ERR_LOG("This config is in use, do not support config modify."); + } + + callback_ = (FrameStateCallback *) &callback; + handler_ = (EventHandler *) &handler; + inUse_ = true; + } + + EventHandler *GetEventHandler() const override + { + EventHandler *evtHandler = handler_; + return evtHandler; + } + + FrameStateCallback *GetFrameStateCb() const override + { + FrameStateCallback *fsCb = callback_; + return fsCb; + } + +private: + FrameStateCallback *callback_ = nullptr; + EventHandler *handler_ = nullptr; + bool inUse_ = false; +}; + +CameraConfig *CameraConfig::CreateCameraConfig() +{ + return new (std::nothrow) CameraConfigImpl(); +} +} // namespace Media +} // namespace OHOS +#endif // OHOS_CAMERA_CONFIG_IMPL_H \ No newline at end of file diff --git a/frameworks/innerkitsimpl/camera/src/camera_device.cpp b/frameworks/innerkitsimpl/camera/src/camera_device.cpp new file mode 100644 index 0000000..fd73db1 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/src/camera_device.cpp @@ -0,0 +1,670 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "camera_device.h" + +#include "codec_interface.h" +#include "hal_display.h" +#include "media_log.h" +#include "meta_data.h" +#include "securec.h" + +#include +#include + +using namespace OHOS; +using namespace OHOS::Media; +using namespace std; + +namespace OHOS { +namespace Media { +inline PicSize Convert2CodecSize(int32_t width, int32_t height) +{ + struct SizeMap { + PicSize res_; + int32_t width_; + int32_t height_; + }; + static SizeMap sizeMap[] = { + {Resolution_CIF, 352, 288}, {Resolution_360P, 640, 360}, + {Resolution_D1_PAL, 720, 576}, {Resolution_D1_NTSC, 720, 480}, + {Resolution_720P, 1280, 720}, {Resolution_1080P, 1920, 1080} + }; + for (uint32_t i = 0; i < sizeof(sizeMap) / sizeof(SizeMap); i++) { + if (sizeMap[i].width_ == width && sizeMap[i].height_ == height) { + return sizeMap[i].res_; + } + } + return Resolution_INVALID; +} + +static int32_t SetVencSource(CODEC_HANDLETYPE codecHdl, uint32_t deviceId) +{ + Param param = {.key = KEY_DEVICE_ID, .val = (void *)&deviceId, .size = sizeof(uint32_t)}; + int32_t ret = CodecSetParameter(codecHdl, ¶m, 1); + if (ret != 0) { + MEDIA_ERR_LOG("Set enc source failed.(ret=%d)", ret); + return ret; + } + return MEDIA_OK; +} + +static int32_t CreateCodecAndSet(const Param *param, uint32_t paramIndex, + uint32_t srcDev, const CODEC_HANDLETYPE &codecHdlRef) +{ + const char *name = "codec.video.hardware.encoder"; + CODEC_HANDLETYPE *codecHdl = (CODEC_HANDLETYPE *)&codecHdlRef; + + int32_t ret = CodecCreate(name, param, paramIndex, codecHdl); + if (ret != 0) { + MEDIA_ERR_LOG("Create video encoder failed."); + return HAL_MEDIA_ERR; + } + + ret = SetVencSource(*codecHdl, srcDev); + if (ret != 0) { + CodecDestroy(codecHdl); + return HAL_MEDIA_ERR; + } + + return HAL_MEDIA_OK; +} + +static int32_t CameraCreateVideoEnc(const FrameConfig &fc, + const HalVideoProcessorAttr &attr, uint32_t srcDev, + const CODEC_HANDLETYPE &codecHdl) +{ + const uint32_t maxParamNum = 10; + uint32_t paramIndex = 0; + Param param[maxParamNum]; + + CodecType domainKind = VIDEO_ENCODER; + param[paramIndex].key = KEY_CODEC_TYPE; + param[paramIndex].val = &domainKind; + param[paramIndex++].size = sizeof(CodecType); + + AvCodecMime codecMime = MEDIA_MIMETYPE_VIDEO_HEVC; + param[paramIndex].key = KEY_MIMETYPE; + param[paramIndex].val = &codecMime; + param[paramIndex++].size = sizeof(AvCodecMime); + + VenCodeRcMode rcMode = VENCOD_RC_CBR; + param[paramIndex].key = KEY_VIDEO_RC_MODE; + param[paramIndex].val = &rcMode; + param[paramIndex++].size = sizeof(VenCodeRcMode); + + VenCodeGopMode gopMode = VENCOD_GOPMODE_NORMALP; + param[paramIndex].key = KEY_VIDEO_GOP_MODE; + param[paramIndex].val = &gopMode; + param[paramIndex++].size = sizeof(VenCodeGopMode); + + Profile profile = HEVC_MAIN_PROFILE; + param[paramIndex].key = KEY_VIDEO_PROFILE; + param[paramIndex].val = &profile; + param[paramIndex++].size = sizeof(Profile); + + PicSize picSize = Convert2CodecSize(attr.width, attr.height); + MEDIA_DEBUG_LOG("picSize=%d", picSize); + param[paramIndex].key = KEY_VIDEO_PIC_SIZE; + param[paramIndex].val = &picSize; + param[paramIndex++].size = sizeof(PicSize); + + uint32_t frameRate = attr.fps; + MEDIA_DEBUG_LOG("frameRate=%u", frameRate); + param[paramIndex].key = KEY_VIDEO_FRAME_RATE; + param[paramIndex].val = &frameRate; + param[paramIndex++].size = sizeof(uint32_t); + + return CreateCodecAndSet(param, paramIndex, srcDev, codecHdl); +} + +static int32_t CameraCreateJpegEnc(const FrameConfig &fc, uint32_t srcDev, + const HalVideoProcessorAttr &attr, const CODEC_HANDLETYPE &codecHdlRef) +{ + CODEC_HANDLETYPE *codecHdl = (CODEC_HANDLETYPE *)&codecHdlRef; + const char *videoEncName = "codec.jpeg.hardware.encoder"; + const uint32_t maxParamNum = 5; + Param param[maxParamNum]; + uint32_t paramIndex = 0; + + CodecType domainKind = VIDEO_ENCODER; + param[paramIndex].key = KEY_CODEC_TYPE; + param[paramIndex].val = &domainKind; + param[paramIndex].size = sizeof(CodecType); + paramIndex++; + + AvCodecMime codecMime = MEDIA_MIMETYPE_IMAGE_JPEG; + param[paramIndex].key = KEY_MIMETYPE; + param[paramIndex].val = &codecMime; + param[paramIndex].size = sizeof(AvCodecMime); + paramIndex++; + + PicSize picSize = Convert2CodecSize(attr.width, attr.height); + param[paramIndex].key = KEY_VIDEO_PIC_SIZE; + param[paramIndex].val = &picSize; + param[paramIndex].size = sizeof(PicSize); + paramIndex++; + + int32_t ret = CodecCreate(videoEncName, param, paramIndex, codecHdl); + if (ret != 0) { + MEDIA_ERR_LOG("CodecCreate failed.(ret=%d)", ret); + return HAL_MEDIA_ERR; + } + + int32_t qfactor = -1; + ((FrameConfig &) fc).GetParameter(PARAM_KEY_IMAGE_ENCODE_QFACTOR, qfactor); + if (qfactor != -1) { + MEDIA_DEBUG_LOG("qfactor=%d", qfactor); + Param jpegParam = { + .key = KEY_IMAGE_Q_FACTOR, + .val = &qfactor, + .size = sizeof(qfactor) + }; + ret = CodecSetParameter(*codecHdl, &jpegParam, 1); + if (ret != 0) { + MEDIA_ERR_LOG("CodecSetParameter set jpeg qfactor failed.(ret=%u)", ret); + } + } + + ret = SetVencSource(*codecHdl, srcDev); + if (ret != 0) { + MEDIA_ERR_LOG("Set video encoder source failed."); + CodecDestroy(*codecHdl); + return HAL_MEDIA_ERR; + } + + return HAL_MEDIA_OK; +} + +static int32_t CopyCodecOutput(char *dstBuf, uint32_t *size, const OutputInfo &buffer) +{ + int32_t bufferSize = 0; + for (uint32_t i = 0; i < buffer.bufferCnt; i++) { + uint32_t packSize = buffer.buffers[i].length - buffer.buffers[i].offset; + errno_t ret = memcpy_s(dstBuf, *size, buffer.buffers[i].addr + buffer.buffers[i].offset, packSize); + if (ret != EOK) { + return HAL_MEDIA_ERR; + } + bufferSize = bufferSize + packSize; + *size -= packSize; + dstBuf += packSize; + } + + return bufferSize; +} + +static int32_t FindAvailProcessorIdx(const Surface &surface, + const vector &attrs) +{ + uint32_t surfaceWidth = stoi(((Surface &) surface).GetUserData("surface_width")); + uint32_t surfaceHeight = stoi(((Surface &) surface).GetUserData("surface_height")); + for (uint32_t i = 0; i < attrs.size(); i++) { + if (attrs[i].width == surfaceWidth && attrs[i].height == surfaceHeight) { + return i; + } + } + return -1; +} + +static void GetSurfaceBufferConfig(const Surface &surface, BufferRequestConfig &config) +{ + config.width = stoi(((Surface &) surface).GetUserData("surface_width")); + config.height = stoi(((Surface &) surface).GetUserData("surface_height")); + config.strideAlignment = stoi(((Surface &) surface).GetUserData("surface_stride_Alignment")); + config.format = stoi(((Surface &) surface).GetUserData("surface_format")); + config.usage = stoi(((Surface &) surface).GetUserData("surface_usage")); + config.timeout = stoi(((Surface &) surface).GetUserData("surface_timeout")); +} + +int RecordAssistant::OnVencBufferAvailble(UINTPTR hComponent, UINTPTR dataIn, OutputInfo *buffer) +{ + const int32_t KEY_IS_SYNC_FRAME = 1; // "is-sync-frame" + const int32_t KEY_TIME_US = 2; // "timeUs" + CODEC_HANDLETYPE hdl = reinterpret_cast(hComponent); + RecordAssistant *assistant = reinterpret_cast(dataIn); + list *surfaceList = nullptr; + + if (buffer == nullptr) { + MEDIA_ERR_LOG("Codec buffer is null"); + return MEDIA_ERR; + } + + for (uint32_t idx = 0; idx < assistant->vencHdls_.size(); idx++) { + if (assistant->vencHdls_[idx] == hdl) { + surfaceList = &(assistant->vencSurfaces_[idx]); + break; + } + } + if (surfaceList == nullptr || surfaceList->empty()) { + MEDIA_ERR_LOG("Encoder handle is illegal."); + return -1; + } + int32_t ret = SURFACE_ERROR_OK; + for (auto &surface : *surfaceList) { + if (surface == nullptr) { + continue; + } + sptr surfaceBuffer; + int32_t releaseFence; + BufferRequestConfig config; + GetSurfaceBufferConfig(*surface, config); + SurfaceError result = assistant->mProducerSurface->RequestBuffer(surfaceBuffer, releaseFence, config); + if (result != SURFACE_ERROR_OK) { + MEDIA_ERR_LOG("No available buffer in surface."); + ret = SURFACE_ERROR_NO_BUFFER; + break; + } + + uint32_t size = surfaceBuffer->GetSize(); + void *buf = surfaceBuffer->GetVirAddr(); + if (buf == nullptr) { + MEDIA_ERR_LOG("Invalid buffer address."); + ret = SURFACE_ERROR_NULLPTR; + break; + } + int32_t copiedSize = CopyCodecOutput((char *)buf, &size, *buffer); + if (copiedSize == HAL_MEDIA_ERR) { + MEDIA_ERR_LOG("No available buffer in surface."); + assistant->mProducerSurface->CancelBuffer(surfaceBuffer); + ret = SURFACE_ERROR_NOMEM; + break; + } + surface->SetUserData("surface_buffer_size", to_string(copiedSize)); + surfaceBuffer->SetInt32(KEY_IS_SYNC_FRAME, + (((buffer->flag & STREAM_FLAG_KEYFRAME) == 0) ? 0 : 1)); + surfaceBuffer->SetInt64(KEY_TIME_US, buffer->timeStamp); + BufferFlushConfig flushConfig; + if (assistant->mProducerSurface->FlushBuffer(surfaceBuffer, -1, flushConfig) != 0) { + MEDIA_ERR_LOG("Flush surface failed."); + assistant->mProducerSurface->CancelBuffer(surfaceBuffer); + ret = SURFACE_ERROR_ERROR; + break; + } + } + + if ((ret = CodecQueueOutput(hdl, buffer, 0, -1)) != 0) { + MEDIA_ERR_LOG("Codec queue output failed."); + } + + return ret; +} + +CodecCallback RecordAssistant::recordCodecCb_ = {nullptr, nullptr, RecordAssistant::OnVencBufferAvailble}; + +int32_t RecordAssistant::SetFrameConfig(FrameConfig &fc, + vector &hdls, + vector &attrs) +{ + fc_ = &fc; + + auto surfaceList = fc.GetSurfaces(); + if (surfaceList.size() != 1) { + MEDIA_ERR_LOG("Only support one surface in frame config now."); + return MEDIA_ERR; + } + for (auto &surface : surfaceList) { + CODEC_HANDLETYPE codecHdl = nullptr; + int32_t ProcessorIdx = FindAvailProcessorIdx(*surface, attrs); + sptr producer = surface->GetProducer(); + mProducerSurface = Surface::CreateSurfaceAsProducer(producer); + if (ProcessorIdx < 0) { + MEDIA_ERR_LOG("No suitble procesor for recording."); + return MEDIA_ERR; + } + uint32_t deviceId = HalGetProcessorDeviceId(hdls[ProcessorIdx]); + int32_t encIdx = VideoEncIsExist(attrs[deviceId]); + if (encIdx >= 0) { + vencSurfaces_[encIdx].emplace_back(surface); + continue; + } + + int32_t ret = CameraCreateVideoEnc(fc, attrs[ProcessorIdx], deviceId, codecHdl); + if (ret != MEDIA_OK) { + MEDIA_ERR_LOG("Cannot create suitble video encoder."); + return MEDIA_ERR; + } + + ret = CodecSetCallback(codecHdl, &recordCodecCb_, reinterpret_cast(this)); + if (ret != 0) { + MEDIA_ERR_LOG("Set codec callback failed.(ret=%d)", ret); + CodecDestroy(codecHdl); + return MEDIA_ERR; + } + vencHdls_.emplace_back(codecHdl); + list conList({surface}); + vencSurfaces_.emplace_back(conList); + vencAttr_.emplace_back(&attrs[deviceId]); + } + state_ = LOOP_READY; + return MEDIA_OK; +} + +int32_t RecordAssistant::Start() +{ + if (state_ != LOOP_READY) { + return MEDIA_ERR; + } + + int32_t ret = HAL_MEDIA_OK; + int32_t i; + for (i = 0; static_cast(i) < vencHdls_.size(); i++) { + ret = CodecStart(vencHdls_[i]); + if (ret != HAL_MEDIA_OK) { + MEDIA_ERR_LOG("Video encoder start failed."); + ret = MEDIA_ERR; + break; + } + } + if (ret == MEDIA_ERR) { + /* rollback */ + for (; i >= 0; i--) { + CodecStop(vencHdls_[i]); + } + return MEDIA_ERR; + } + state_ = LOOP_LOOPING; + + MEDIA_DEBUG_LOG("Start camera recording succeed."); + return MEDIA_OK; +} + +int32_t RecordAssistant::Stop() +{ + if (state_ != LOOP_LOOPING) { + return MEDIA_ERR; + } + + for (uint32_t i = 0; i < vencHdls_.size(); i++) { + CodecStop(vencHdls_[i]); + CodecDestroy(vencHdls_[i]); + } + vencHdls_.clear(); + vencAttr_.clear(); + vencSurfaces_.clear(); + + state_ = LOOP_STOP; + return MEDIA_OK; +} + +int32_t RecordAssistant::VideoEncIsExist(const HalVideoProcessorAttr &attr) +{ + for (uint32_t i = 0; i < vencAttr_.size(); i++) { + if (vencAttr_[i] == &attr) { + return i; + } + } + return -1; +} + +static void GetSurfaceRect(const Surface &surface, HalVideoOutputAttr &attr) +{ + attr.regionPositionX = stoi(((Surface &) surface).GetUserData("region_position_x")); + attr.regionPositionY = stoi(((Surface &) surface).GetUserData("region_position_y")); + attr.regionWidth = stoi(((Surface &) surface).GetUserData("region_width")); + attr.regionHeight = stoi(((Surface &) surface).GetUserData("region_height")); +} + +int32_t PreviewAssistant::SetFrameConfig(FrameConfig &fc, + vector &hdls, + vector &attrs) +{ + fc_ = &fc; + + auto surfaceList = fc.GetSurfaces(); + if (surfaceList.size() != 1) { + MEDIA_ERR_LOG("Only support one surface in frame config now."); + return MEDIA_ERR; + } + auto surface = surfaceList.front(); + int32_t ProcessorIdx = FindAvailProcessorIdx(*surface, attrs); + if (ProcessorIdx < 0) { + MEDIA_ERR_LOG("No suitble procesor for preview."); + return MEDIA_ERR; + } + + HalVideoOutputAttr attr; + GetSurfaceRect(*surface, attr); + + return MEDIA_OK; +} + +int32_t PreviewAssistant::Start() +{ + // enable vo + return MEDIA_OK; +} + +int32_t PreviewAssistant::Stop() +{ + return MEDIA_OK; +} + +int32_t CaptureAssistant::SetFrameConfig(FrameConfig &fc, + vector &hdls, + vector &attrs) +{ + auto surfaceList = fc.GetSurfaces(); + if (surfaceList.size() != 1) { + MEDIA_ERR_LOG("Only support one surface in frame config now."); + return MEDIA_ERR; + } + if (surfaceList.empty()) { + MEDIA_ERR_LOG("Frame config with empty surface list."); + return MEDIA_ERR; + } + if (surfaceList.size() > 1) { + MEDIA_WARNING_LOG("Capture only fullfill the first surface in frame config."); + } + Surface *surface = surfaceList.front(); + if (surface == nullptr) { + MEDIA_ERR_LOG("Surface is null."); + return MEDIA_ERR; + } + int32_t idx = FindAvailProcessorIdx(*surface, attrs); + if (idx < 0) { + MEDIA_ERR_LOG("No suitble procesor for venc."); + return MEDIA_ERR; + } + uint32_t deviceId = HalGetProcessorDeviceId(hdls[idx]); + int32_t ret = CameraCreateJpegEnc(fc, deviceId, attrs[idx], vencHdl_); + if (ret != HAL_MEDIA_OK) { + MEDIA_ERR_LOG("Create capture venc failed."); + return MEDIA_ERR; + } + + capSurface_ = surface; + + state_ = LOOP_READY; + return MEDIA_OK; +} + +/* Block method, waiting for capture completed */ +int32_t CaptureAssistant::Start() +{ + state_ = LOOP_LOOPING; + int32_t ret = CodecStart(vencHdl_); + if (ret != 0) { + MEDIA_ERR_LOG("Start capture encoder failed.(ret=%d)", ret); + return MEDIA_ERR; + } + MEDIA_DEBUG_LOG("surface = %p", capSurface_); + + sptr producer = capSurface_->GetProducer(); + sptr producerSurface = Surface::CreateSurfaceAsProducer(producer); + sptr surfaceBuffer; + int32_t releaseFence; + BufferRequestConfig config; + GetSurfaceBufferConfig(*capSurface_, config); + SurfaceError result = producerSurface->RequestBuffer(surfaceBuffer, releaseFence, config); + if (result != SURFACE_ERROR_OK) { + MEDIA_ERR_LOG("No available buffer in surface."); + return -1; + } + + OutputInfo outInfo; + ret = CodecDequeueOutput(vencHdl_, 0, nullptr, &outInfo); + if (ret != 0) { + producerSurface->CancelBuffer(surfaceBuffer); + MEDIA_ERR_LOG("Dequeue capture frame failed.(ret=%d)", ret); + return MEDIA_ERR; + } + + uint32_t size = surfaceBuffer->GetSize(); + void *buf = surfaceBuffer->GetVirAddr(); + if (buf == nullptr) { + MEDIA_ERR_LOG("Invalid buffer address."); + return -1; + } + int copiedSize = CopyCodecOutput((char *)buf, &size, outInfo); + if (copiedSize == HAL_MEDIA_ERR) { + MEDIA_ERR_LOG("No available buffer in producerSurface."); + producerSurface->CancelBuffer(surfaceBuffer); + return -1; + } + + capSurface_->SetUserData("surface_buffer_size", to_string(copiedSize)); + BufferFlushConfig flushConfig; + if (producerSurface->FlushBuffer(surfaceBuffer, -1, flushConfig) != 0) { + MEDIA_ERR_LOG("Flush surface buffer failed."); + producerSurface->CancelBuffer(surfaceBuffer); + return -1; + } + + CodecQueueOutput(vencHdl_, &outInfo, 0, -1); // 0:no timeout -1:no fd + CodecStop(vencHdl_); + CodecDestroy(vencHdl_); + + state_ = LOOP_STOP; + + return MEDIA_OK; +} + +int32_t CaptureAssistant::Stop() +{ + MEDIA_DEBUG_LOG("No support method."); + return MEDIA_OK; +} + +CameraDevice::CameraDevice() {} + +CameraDevice::~CameraDevice() {} + +int32_t CameraDevice::Initialize(CameraAbility &ability) +{ + int32_t ret = HalMediaInitialize(); + if (ret != HAL_MEDIA_OK) { + MEDIA_ERR_LOG("Media Init failed.(ret=%d)", ret); + return MEDIA_ERR; + } + /* Need to be Refactored when delete config file */ + ret = HalCreateVideoProcessor(nullptr); + if (ret != HAL_MEDIA_OK) { + MEDIA_ERR_LOG("Init camera device failed.(ret=%d)", ret); + return MEDIA_ERR; + } + HalVideoProcessorAttr attrs[HAL_MAX_VPSS_NUM]; + HalProcessorHdl hdls[HAL_MAX_VPSS_NUM]; + int32_t size; + list range; + HalCameraGetProcessorAttr(hdls, attrs, &size); + for (int i = 0; i < size; i++) { + prcessorAttrs_.emplace_back(attrs[i]); + prcessorHdls_.emplace_back(hdls[i]); + CameraPicSize tmpSize = {.width = attrs[i].width, .height = attrs[i].height}; + range.emplace_back(tmpSize); + } + ability.SetParameterRange(PARAM_KEY_SIZE, range); + + ret = CodecInit(); + if (ret != 0) { + MEDIA_ERR_LOG("Codec module init failed.(ret=%d)", ret); + return MEDIA_ERR; + } + MEDIA_DEBUG_LOG("Codec module init succeed."); + + captureAssistant_.state_ = LOOP_READY; + previewAssistant_.state_ = LOOP_READY; + recordAssistant_.state_ = LOOP_READY; + return MEDIA_OK; +} + +int32_t CameraDevice::UnInitialize() +{ + HalDestroyVideoProcessor(); + return MEDIA_OK; +} + +int32_t CameraDevice::TriggerLoopingCapture(FrameConfig &fc) +{ + MEDIA_DEBUG_LOG("Camera device start looping capture."); + + DeviceAssistant *assistant = nullptr; + int fcType = fc.GetFrameConfigType(); + switch (fcType) { + case FRAME_CONFIG_RECORD: + assistant = &recordAssistant_; + break; + case FRAME_CONFIG_PREVIEW: + assistant = &previewAssistant_; + break; + case FRAME_CONFIG_CAPTURE: + assistant = &captureAssistant_; + break; + default: + break; + } + if (assistant == nullptr) { + MEDIA_ERR_LOG("Invalid frame config type.(type=%d)", fcType); + return MEDIA_ERR; + } + if ((assistant->state_ == LOOP_IDLE) || (assistant->state_ == LOOP_LOOPING) || + (assistant->state_ == LOOP_ERROR)) { + MEDIA_ERR_LOG("Device state is %d, cannot start looping capture.", assistant->state_); + return MEDIA_ERR; + } + + int ret = assistant->SetFrameConfig(fc, prcessorHdls_, prcessorAttrs_); + if (ret != MEDIA_OK) { + MEDIA_ERR_LOG("Check and set frame config failed.(ret=%d)", ret); + return MEDIA_ERR; + } + + ret = assistant->Start(); + if (ret != MEDIA_OK) { + MEDIA_ERR_LOG("Start looping capture failed.(ret=%d)", ret); + return MEDIA_ERR; + } + + return MEDIA_OK; +} + +void CameraDevice::StopLoopingCapture() +{ + previewAssistant_.Stop(); + recordAssistant_.Stop(); +} + +int32_t CameraDevice::TriggerSingleCapture(FrameConfig &fc) +{ + return TriggerLoopingCapture(fc); +} + +int32_t CameraDevice::SetCameraConfig(CameraConfig &config) +{ + cc_ = &config; + return MEDIA_OK; +} +} // namespace Media +} // namespace OHOS diff --git a/frameworks/innerkitsimpl/camera/src/camera_impl.cpp b/frameworks/innerkitsimpl/camera/src/camera_impl.cpp new file mode 100644 index 0000000..fa9d3dc --- /dev/null +++ b/frameworks/innerkitsimpl/camera/src/camera_impl.cpp @@ -0,0 +1,183 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "camera_impl.h" +#include "camera_service.h" +#include "media_log.h" + +using namespace std; + +namespace OHOS { +namespace Media { +#define FREE_PTR(ptr) \ + delete ptr; \ + ptr = nullptr; \ + +CameraImpl::CameraImpl(std::string &id, const CameraAbility &ability) +{ + id_ = id; + ability_ = &ability; +} + +string CameraImpl::GetCameraId() +{ + return id_; +} + +const CameraConfig *CameraImpl::GetCameraConfig() const +{ + return config_; +} + +FrameConfig *CameraImpl::GetFrameConfig(int32_t type) +{ + for (auto i : frameConfigs_) { + if (i->GetFrameConfigType() == type) { + return i; + } + } + return nullptr; +} + +void CameraImpl::Configure(CameraConfig &config) +{ + if (config_ != nullptr) { + return; + } + + config_ = &config; + if (config.GetFrameStateCb() == nullptr || config.GetEventHandler() == nullptr) { + FREE_PTR(config_); + return; + } + + int32_t ret = device_->SetCameraConfig(config); + if (ret != MEDIA_OK) { + FREE_PTR(config_); + handler_->Post([this, ret] { this->stateCb_->OnConfigureFailed(this->GetCameraId(), ret); }); + return; + } + handler_->Post([this] { this->stateCb_->OnConfigured(*this); }); +} + +void CameraImpl::Release() +{ + if (config_ != nullptr) { + delete config_; + config_ = nullptr; + } + handler_->Post([this] { this->stateCb_->OnReleased(*this); }); +} + +int32_t CameraImpl::TriggerLoopingCapture(FrameConfig &fc) +{ + if (config_ == nullptr) { + MEDIA_ERR_LOG("Cannot find available configuration, configure the camera first."); + return MEDIA_INVALID_PARAM; + } + FrameConfig *curFc = GetFrameConfig(fc.GetFrameConfigType()); + if (curFc != nullptr) { + MEDIA_ERR_LOG("Frame config of the input type is already existed."); + return MEDIA_OK; + } + int32_t ret = device_->TriggerLoopingCapture(dynamic_cast(fc)); + if (ret != MEDIA_OK) { + MEDIA_ERR_LOG("Camera device start looping capture failed.(ret=%d)", ret); + return MEDIA_ERR; + } + frameConfigs_.emplace_back(&fc); + + return MEDIA_OK; +} + +void CameraImpl::StopLoopingCapture() +{ + device_->StopLoopingCapture(); + FrameStateCallback *fsc = config_->GetFrameStateCb(); + if (fsc == nullptr) { + return; + } + EventHandler *eventhdl = config_->GetEventHandler(); + if (eventhdl == nullptr) { + return; + } + + for (auto i : frameConfigs_) { + eventhdl->Post([fsc, this, i] { + FrameResult frameResult; + fsc->OnFrameFinished(*this, *i, frameResult); + }); + } + frameConfigs_.clear(); +} + +int32_t CameraImpl::TriggerSingleCapture(FrameConfig &fc) +{ + if (config_ == nullptr) { + MEDIA_ERR_LOG("Cannot find available configuration, configure the camera first."); + return MEDIA_INVALID_PARAM; + } + int32_t ret = device_->TriggerSingleCapture(dynamic_cast(fc)); + FrameStateCallback *fsc = config_->GetFrameStateCb(); + if (fsc == nullptr) { + return MEDIA_ERR; + } + EventHandler *eventhdl = config_->GetEventHandler(); + if (eventhdl == nullptr) { + return MEDIA_ERR; + } + if (ret != MEDIA_OK) { + eventhdl->Post([fsc, this, &fc] { + FrameResult frameResult; + fsc->OnFrameError(*this, fc, -1, frameResult); + }); + return MEDIA_ERR; + } + eventhdl->Post([fsc, this, &fc] { + FrameResult frameResult; + fsc->OnFrameFinished(*this, fc, frameResult); + }); + return MEDIA_OK; +} + +const CameraAbility *CameraImpl::GetAbility() +{ + return ability_; +} + +void CameraImpl::OnCreate(CameraDevice &device) +{ + device_ = &device; + if (stateCb_ == nullptr || handler_ == nullptr) { + return; + } + handler_->Post([this] { this->stateCb_->OnCreated(*this); }); +} + +void CameraImpl::OnCreateFailed() +{ + if (stateCb_ == nullptr || handler_ == nullptr) { + return; + } + handler_->Post([this] { this->stateCb_->OnCreateFailed(id_, MEDIA_ERR); }); +} + +void CameraImpl::RegistCb(CameraStateCallback &callback, EventHandler &handler) +{ + handler_ = &handler; + stateCb_ = &callback; +} +} // namespace Media +} // namespace OHOS \ No newline at end of file diff --git a/frameworks/innerkitsimpl/camera/src/camera_kit.cpp b/frameworks/innerkitsimpl/camera/src/camera_kit.cpp new file mode 100644 index 0000000..7581038 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/src/camera_kit.cpp @@ -0,0 +1,61 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "camera_kit.h" +#include "camera_manager.h" + +using namespace std; +namespace OHOS { +namespace Media { +CameraManager *g_cameraManager = nullptr; +CameraKit::CameraKit() +{ + g_cameraManager = CameraManager::GetInstance(); +} + +CameraKit::~CameraKit() {} + +CameraKit *CameraKit::GetInstance() +{ + static CameraKit kit; + return &kit; +} + +list CameraKit::GetCameraIds() +{ + return g_cameraManager->GetCameraIds(); +} + +const CameraAbility *CameraKit::GetCameraAbility(const string cameraId) +{ + return g_cameraManager->GetCameraAbility(cameraId); +} + +void CameraKit::RegisterCameraDeviceCallback(CameraDeviceCallback &callback, EventHandler &handler) +{ + g_cameraManager->RegisterCameraDeviceCallback(callback, handler); +} + +void CameraKit::UnregisterCameraDeviceCallback(CameraDeviceCallback &callback) +{ + g_cameraManager->UnregisterCameraDeviceCallback(callback); +} + +void CameraKit::CreateCamera(const string &cameraId, CameraStateCallback &callback, EventHandler &handler) +{ + g_cameraManager->CreateCamera(cameraId, callback, handler); +} +} // namespace Media +} // namespace OHOS diff --git a/frameworks/innerkitsimpl/camera/src/camera_manager.cpp b/frameworks/innerkitsimpl/camera/src/camera_manager.cpp new file mode 100644 index 0000000..f365405 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/src/camera_manager.cpp @@ -0,0 +1,168 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "camera_manager.h" + +#include +#include + +#include "camera_impl.h" +#include "camera_service.h" + +using namespace std; + +namespace OHOS { +namespace Media { +class CameraManagerImpl : public CameraManager, public CameraServiceCallback { +public: + CameraManagerImpl() + { + // get client instance of camera service + cameraService_ = CameraService::GetInstance(); + // Since service is running in the current process now, it always succeed + cameraService_->Initialize(*this); + } + + ~CameraManagerImpl() + { + for (auto &i : cameraMapCache_) { + delete i.second; + } + } + + void OnCameraServiceInitialized(const list &availCameraIdList) override + { + MEDIA_DEBUG_LOG("Camera manager initializing."); + /* cameraService_ cannot be nullptr as OnCameraServiceInitialized is a callback of cameraService_ */ + for (auto &cameraId : availCameraIdList) { + InitCameraAbility(cameraId); + } + } + + void OnCameraStatusChange(const string &cameraId, CameraStauts status, const CameraDevice &device) override + { + auto p = cameraMapCache_.find(cameraId); + switch (status) { + case CAMERA_STATUS_UNAVAIL: + if (p != cameraMapCache_.end()) { + for (auto &i : deviceCbList_) { + i.second->Post( + [i, cameraId]() { i.first->OnCameraStatus(cameraId, CAMERA_DEVICE_STATE_UNAVAILABLE); }); + } + // User may still using icamera now + delete p->second; + cameraMapCache_.erase(p); + } + break; + case CAMERA_STATUS_AVAIL: + InitCameraAbility(cameraId); + if (p == cameraMapCache_.end()) { + for (auto &i : deviceCbList_) { + i.second->Post( + [i, cameraId]() { i.first->OnCameraStatus(cameraId, CAMERA_DEVICE_STATE_AVAILABLE); }); + } + } + break; + case CAMERA_STATUS_CREATED: + if (p != cameraMapCache_.end()) { + p->second->OnCreate((CameraDevice &) device); + } + break; + case CAMERA_STATUS_CREATE_FAILED: + if (p != cameraMapCache_.end()) { + p->second->OnCreateFailed(); + } + break; + default: + break; + } + } + + void RegisterCameraDeviceCallback(CameraDeviceCallback &callback, EventHandler &handler) override + { + deviceCbList_.emplace_back(make_pair(&callback, &handler)); + for (auto &i : cameraMapCache_) { + string cameraId = i.first; + handler.Post([&callback, cameraId]() { callback.OnCameraStatus(cameraId, CAMERA_DEVICE_STATE_AVAILABLE); }); + } + } + + void UnregisterCameraDeviceCallback(const CameraDeviceCallback &callback) override + { + for (auto p = deviceCbList_.begin(); p != deviceCbList_.end(); p++) { + if (p->first == &callback) { + deviceCbList_.erase(p); + break; + } + } + } + + list GetCameraIds() override + { + list cameraList; + for (auto &i : cameraMapCache_) { + MEDIA_DEBUG_LOG("%s", i.first.c_str()); + cameraList.emplace_back(i.first); + } + return cameraList; + } + + const CameraAbility *GetCameraAbility(const string &cameraId) override + { + auto camera = cameraMapCache_.find(cameraId); + return camera->second->GetAbility(); + } + + void CreateCamera(const string &cameraId, CameraStateCallback &callback, EventHandler &handler) override + { + auto p = cameraMapCache_.find(cameraId); + if (p == cameraMapCache_.end()) { + MEDIA_FATAL_LOG("Camera impl not found."); + handler.Post([&callback, &cameraId] { callback.OnCreateFailed(cameraId, MEDIA_ERR); }); + return; + } + p->second->RegistCb(callback, handler); + cameraService_->CreateCamera(cameraId); + } + +private: + CameraService *cameraService_; + map cameraMapCache_; + list> deviceCbList_; + + void InitCameraAbility(const string &cameraId) + { + auto ability = cameraService_->GetCameraAbility((string &) cameraId); + if (ability == nullptr) { + MEDIA_FATAL_LOG("Camera ability is null."); + return; + } + + CameraImpl *cam = new (nothrow) CameraImpl((string &) cameraId, *ability); + if (cam == nullptr) { + MEDIA_FATAL_LOG("New object failed."); + return; + } + cameraMapCache_[cameraId] = cam; + } +}; + +CameraManager *CameraManager::GetInstance() +{ + static CameraManagerImpl cameraManagerImpl; + return &cameraManagerImpl; +} +} // namespace Media +} // namespace OHOS diff --git a/frameworks/innerkitsimpl/camera/src/camera_service.cpp b/frameworks/innerkitsimpl/camera/src/camera_service.cpp new file mode 100644 index 0000000..dbb12a8 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/src/camera_service.cpp @@ -0,0 +1,120 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "camera_service.h" +#include "hi_type.h" +#include "media_log.h" +#include "sdk.h" + +using namespace std; + +namespace OHOS { +namespace Media { +string g_mainCamera = "main"; +bool g_camSdkInit = false; + +CameraService::CameraService() +{ + HI_S32 ret = sdk_init(); + if (ret == SDK_INIT_SUCC) { + g_camSdkInit = true; + MEDIA_DEBUG_LOG("sdk intialized successfully"); + } else if (ret == SDK_INIT_REENTRY) { + MEDIA_DEBUG_LOG("sdk already intialized"); + } else { + MEDIA_ERR_LOG("sdk init failed, ret = %d", ret); + } +} + +CameraService::~CameraService() +{ + if (ability_) { + delete ability_; + ability_ = nullptr; + } + + if (device_) { + device_->UnInitialize(); + delete device_; + device_ = nullptr; + } + + if (g_camSdkInit) { + sdk_exit(); + g_camSdkInit = false; + MEDIA_DEBUG_LOG("sdk exited successfully"); + } +} + +CameraService *CameraService::GetInstance() +{ + static CameraService instance; + return &instance; +} + +void CameraService::Initialize(CameraServiceCallback &callback) +{ + MEDIA_DEBUG_LOG("Camera service initializing."); + cameraServiceCb_ = &callback; + InitCameraDevices(); + + list cameraList = {g_mainCamera}; + cameraServiceCb_->OnCameraServiceInitialized(cameraList); +} + +const CameraAbility *CameraService::GetCameraAbility(std::string &cameraId) +{ + if ((cameraId == g_mainCamera) && (device_ != nullptr)) { + return ability_; + } + return nullptr; +} + +void CameraService::CreateCamera(string cameraId) +{ + if (cameraId != g_mainCamera) { + MEDIA_ERR_LOG("This camera does not exist. (cameraId=%s)", cameraId.c_str()); + return; + } + cameraServiceCb_->OnCameraStatusChange(cameraId, CameraServiceCallback::CAMERA_STATUS_CREATED, *device_); +} + +int32_t CameraService::InitCameraDevices() +{ + /* Only one camera device now, support more cameras in future */ + device_ = new (nothrow) CameraDevice; + if (device_ == nullptr) { + MEDIA_FATAL_LOG("New object failed."); + return MEDIA_ERR; + } + ability_ = new (nothrow) CameraAbility; + if (ability_ == nullptr) { + delete device_; + device_ = nullptr; + MEDIA_FATAL_LOG("New object failed."); + return MEDIA_ERR; + } + + if (device_->Initialize(*ability_) != MEDIA_OK) { + delete device_; + delete ability_; + device_ = nullptr; + ability_ = nullptr; + return MEDIA_ERR; + } + return MEDIA_OK; +} +} // namespace Media +} // namespace OHOS \ No newline at end of file diff --git a/frameworks/innerkitsimpl/camera/src/event_handler.cpp b/frameworks/innerkitsimpl/camera/src/event_handler.cpp new file mode 100644 index 0000000..11c4ee2 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/src/event_handler.cpp @@ -0,0 +1,74 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "event_handler.h" + +using namespace std; + +namespace OHOS { +namespace Media { +EventHandler::EventHandler() : running_(false) +{ + hdlThrd_ = new thread(EventDispatch, this); +} + +EventHandler::~EventHandler() +{ + while (!running_) { + this_thread::yield(); + } + running_ = false; + cv_.notify_all(); + hdlThrd_->join(); + delete hdlThrd_; + hdlThrd_ = nullptr; +} + +bool EventHandler::IsRunning() +{ + return running_; +} + +void EventHandler::EventDispatch(EventHandler *hdl) +{ + if (hdl == nullptr) { + return; + } + std::unique_lock lock(hdl->mtx_); + hdl->running_ = true; + while (hdl->running_) { + if (hdl->msgQ_.empty()) { + hdl->cv_.wait(lock); // wait for task or exit signal + } else { + auto mission = hdl->msgQ_.front(); + hdl->msgQ_.pop(); + lock.unlock(); + mission->Exec(); + delete mission; + lock.lock(); + } + } + /* Exec all tasks before exit */ + while (!hdl->msgQ_.empty()) { + auto mission = hdl->msgQ_.front(); + hdl->msgQ_.pop(); + lock.unlock(); + mission->Exec(); + delete mission; + lock.lock(); + } +} +} // namespace Media +} // namespace OHOS \ No newline at end of file diff --git a/frameworks/innerkitsimpl/camera/src/frame_config.cpp b/frameworks/innerkitsimpl/camera/src/frame_config.cpp new file mode 100755 index 0000000..4865819 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/src/frame_config.cpp @@ -0,0 +1,65 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "frame_config.h" +#include "media_log.h" + +using namespace std; + +namespace OHOS { +namespace Media { +int32_t FrameConfig::GetFrameConfigType() +{ + return type_; +} + +list FrameConfig::GetSurfaces() +{ + return surfaceList_; +} + +void FrameConfig::AddSurface(Surface &surface) +{ + surfaceList_.emplace_back(&surface); +} + +void FrameConfig::RemoveSurface(Surface &surface) +{ + surfaceList_.remove(&surface); +} + +void *FrameConfig::GetValue(uint32_t key) +{ + auto p = keyMap_.find(key); + return (p == keyMap_.end()) ? nullptr : (&p->second); +} + +void FrameConfig::SetValue(uint32_t key, const void *value) +{ + if (value == nullptr) { + return; + } + switch (key) { + case PARAM_KEY_IMAGE_ENCODE_QFACTOR: + keyMap_[key] = *(static_cast(value)); + break; + default: + break; + } +} + +FrameConfig::FrameConfig(int32_t type) : type_(type) {} +} // namespace Media +} // namespace OHOS \ No newline at end of file diff --git a/frameworks/innerkitsimpl/camera/test/BUILD.gn b/frameworks/innerkitsimpl/camera/test/BUILD.gn new file mode 100644 index 0000000..10bb48f --- /dev/null +++ b/frameworks/innerkitsimpl/camera/test/BUILD.gn @@ -0,0 +1,20 @@ +# Copyright (C) 2021 Huawei Device Co., Ltd. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +group("cameramoduletest") { + testonly = true + + deps = [ + "moduletest/cpp/camera_test:moduletest", + ] +} \ No newline at end of file diff --git a/frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/BUILD.gn b/frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/BUILD.gn new file mode 100755 index 0000000..8004a04 --- /dev/null +++ b/frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/BUILD.gn @@ -0,0 +1,50 @@ +# Copyright (C) 2021 Huawei Device Co., Ltd. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import("//build/test.gni") + +module_output_path = "camera_standard/camera" + +group("moduletest") { + testonly = true + + deps = [ ":camera_module_test" ] +} + +ohos_moduletest("camera_module_test") { + module_out_path = module_output_path + include_dirs = [ + "./include", + "//foundation/multimedia/camera_standard/interfaces/innerkits/native/include", + "//base/hiviewdfx/hilog/interfaces/native/innerkits/include/", + "//drivers/peripheral/codec/interfaces/include", + "//drivers/peripheral/display/interfaces/include", + "//foundation/graphic/standard/frameworks/surface/include", + "//foundation/graphic/standard/interfaces/kits/surface", + "//foundation/graphic/standard/window_manager/include", + "//foundation/multimedia/camera_standard/frameworks/innerkitsimpl/camera/include", + "//foundation/multimedia/camera_standard/interfaces/innerkits/native/include", + "//utils/native/base/include", + ] + + sources = [ "src/camera_module_test.cpp" ] + + deps = [ + "//foundation/graphic/standard:libsurface", + "//foundation/graphic/standard:libwms_client", + "//foundation/multimedia/camera_standard/frameworks/innerkitsimpl/camera:camera", + "//utils/native/base:utils", + ] + + external_deps = [ "ipc:ipc_core" ] +} diff --git a/frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/include/camera_module_test.h b/frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/include/camera_module_test.h new file mode 100644 index 0000000..942b65b --- /dev/null +++ b/frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/include/camera_module_test.h @@ -0,0 +1,71 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef CAMERA_MODULE_TEST_H +#define CAMERA_MODULE_TEST_H + +#include + +#include "gtest/gtest.h" +#include "camera_kit.h" +#include "display_type.h" + +// VideoSize +enum TestVideoSize { + WIDTH = 1920, + HEIGHT = 1080, +}; + +// CameraSetupFlag +bool g_onGetCameraAbilityFlag; +bool g_onConfigureFlag; +bool g_onGetSupportedSizesFlag; +// CameraDeviceCallBack Flag +bool g_onCameraAvailableFlag; +bool g_onCameraUnavailableFlag; +// CameraStateCallback +bool g_onCreatedFlag; +bool g_onCreateFailedFlag; +bool g_onReleasedFlag; +bool g_onConfiguredFlag; +bool g_onConfigureFailedFlag; +// FrameStateCallback +bool g_onCaptureTriggerAbortedFlag; +bool g_onCaptureTriggerCompletedFlag; +bool g_onCaptureTriggerStartedFlag; +bool g_onGetFrameConfigureType; +bool g_onFrameFinishedFlag; +bool g_onFrameErrorFlag; +bool g_onFrameProgressedFlag; + +class CameraModuleTest : public testing::Test { +public: + /* SetUpTestCase:The preset action of the test suite is executed before the first TestCase */ + static void SetUpTestCase(void); + + /* TearDownTestCase:The test suite cleanup action is executed after the last TestCase */ + static void TearDownTestCase(void); + + /* SetUp:Execute before each test case */ + void SetUp(); + + /* TearDown:Execute after each test case */ + void TearDown(); + + /* Gets the camera Id */ + static void GetCameraId(OHOS::Media::CameraKit *cameraKit, + std::list &camList, std::string &camId); +}; +#endif // CAMERA_MODULE_TEST_H diff --git a/frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/src/camera_module_test.cpp b/frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/src/camera_module_test.cpp new file mode 100644 index 0000000..e39c15a --- /dev/null +++ b/frameworks/innerkitsimpl/camera/test/moduletest/cpp/camera_test/src/camera_module_test.cpp @@ -0,0 +1,494 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "camera_module_test.h" + +using namespace std; +using namespace OHOS; +using namespace OHOS::Media; +using namespace testing::ext; + +void CameraModuleTest::SetUpTestCase(void) {} +void CameraModuleTest::TearDownTestCase(void) {} + +/* SetUp:Execute before each test case */ +void CameraModuleTest::SetUp() +{ + /* CameraSetUp */ + g_onGetCameraAbilityFlag = false; + g_onConfigureFlag = false; + g_onGetSupportedSizesFlag = false; + /* CameraDeviceCallBack */ + g_onCameraAvailableFlag = false; + g_onCameraUnavailableFlag = false; + /* CameraStateCallback */ + g_onCreatedFlag = false; + g_onCreateFailedFlag = false; + g_onConfiguredFlag = false; + g_onConfigureFailedFlag = false; + g_onReleasedFlag = false; + /* FrameStateCallback */ + g_onCaptureTriggerAbortedFlag = false; + g_onCaptureTriggerCompletedFlag = false; + g_onFrameFinishedFlag = false; + g_onGetFrameConfigureType = false; + g_onFrameErrorFlag = false; + g_onFrameProgressedFlag = false; +} + +void CameraModuleTest::TearDown(void) {} + +/* * + * Get camera Id + */ +void CameraModuleTest::GetCameraId(CameraKit *cameraKit, list &camList, + string &camId) +{ + camList = cameraKit->GetCameraIds(); + for (auto &cam : camList) { + const CameraAbility *ability = cameraKit->GetCameraAbility(cam); + ASSERT_NE(ability, nullptr); + g_onGetCameraAbilityFlag = true; + /* find camera which fits user's ability */ + list sizeList = ability->GetSupportedSizes(); + if (sizeList.size() != 0) { + g_onGetSupportedSizesFlag = true; + } + for (auto &pic : sizeList) { + if (pic.width == WIDTH && pic.height == HEIGHT) { + /* 1920:width,1080:height */ + camId = cam; + break; + } + } + } + if (camId.empty()) { + cout << "No available camera.(1080p wanted)" << endl; + return; + } +} + +class SampleFrameStateCallback : public FrameStateCallback { + void SampleSaveCapture(const char &buffer, uint32_t size) + { + ofstream pic("/data/Capture_sample.jpg", ofstream::out); + pic.write(&buffer, size); + pic.close(); + } + + void OnFrameFinished(const Camera &camera, const FrameConfig &fc, + const FrameResult &result) override + { + g_onFrameProgressedFlag = true; + if (((FrameConfig &) fc).GetFrameConfigType() == FRAME_CONFIG_CAPTURE) { + g_onGetFrameConfigureType = true; + list surfaceList = ((FrameConfig &) fc).GetSurfaces(); + for (Surface *surface : surfaceList) { + sptr buffer; + int32_t flushFence; + int64_t timestamp; + Rect damage; + SurfaceError ret = surface->AcquireBuffer(buffer, flushFence, timestamp, damage); + if (ret == SURFACE_ERROR_OK) { + char *virtAddr = static_cast(buffer->GetVirAddr()); + if (virtAddr != nullptr) { + int32_t bufferSize = stoi(surface->GetUserData("surface_buffer_size")); + SampleSaveCapture(*virtAddr, bufferSize); + } else { + g_onFrameErrorFlag = true; + } + surface->ReleaseBuffer(buffer, -1); + } else { + g_onFrameErrorFlag = true; + } + } + delete &fc; + } else { + g_onFrameErrorFlag = true; + } + g_onFrameFinishedFlag = true; + } +}; + +class SurfaceListener : public IBufferConsumerListener { +public: + void OnBufferAvailable() override {} +}; + +class SampleCameraStateMng : public CameraStateCallback { +public: + Camera *cam_ = nullptr; + SampleCameraStateMng() = delete; + explicit SampleCameraStateMng(EventHandler &eventHdlr) : eventHdlr_(eventHdlr) + { + captureConSurface = nullptr; + } + + ~SampleCameraStateMng() + { + if (cam_) { + cam_->Release(); + } + } + + void OnCreated(const Camera &c) override + { + g_onCreatedFlag = true; + CameraConfig *config = CameraConfig::CreateCameraConfig(); + if (config != nullptr) { + config->SetFrameStateCallback(fsCb_, eventHdlr_); + ((Camera &)c).Configure(*config); + g_onConfigureFlag = true; + cam_ = (Camera *) &c; + } else { + cout << "Create Camera Config return null" << endl; + } + } + + void OnCreateFailed(const std::string cameraId, int32_t errorCode) override + { + g_onCreateFailedFlag = true; + } + + void OnReleased(const Camera &c) override + { + g_onReleasedFlag = true; + } + + void OnConfigured(const Camera &c) override + { + g_onConfiguredFlag = true; + } + + void OnConfigureFailed(const std::string cameraId, int32_t errorCode) override + { + g_onConfigureFailedFlag = true; + } + + void Capture() + { + if (cam_ == nullptr) { + cout << "Camera capture is not ready." << endl; + return; + } + FrameConfig *fc = new FrameConfig(FRAME_CONFIG_CAPTURE); + + captureConSurface = Surface::CreateSurfaceAsConsumer(); + if (captureConSurface == nullptr) { + delete fc; + cout << "CreateSurface failed" << endl; + return; + } + + sptr listener = new SurfaceListener(); + captureConSurface->RegisterConsumerListener(listener); + auto refSurface = captureConSurface; // to keep the reference count + + int usage = HBM_USE_CPU_READ | HBM_USE_CPU_WRITE | HBM_USE_MEM_DMA; + captureConSurface->SetUserData("surface_width", "1920"); + captureConSurface->SetUserData("surface_height", "1080"); + captureConSurface->SetUserData("surface_stride_Alignment", "8"); + captureConSurface->SetUserData("surface_format", to_string(PIXEL_FMT_RGBA_8888)); + captureConSurface->SetUserData("surface_usage", to_string(usage)); + captureConSurface->SetUserData("surface_timeout", "0"); + fc->AddSurface(*refSurface); + int32_t ret = cam_->TriggerSingleCapture(*fc); + if (ret != MEDIA_OK) { + delete fc; + } else { + g_onCaptureTriggerCompletedFlag = true; + } + } + +private: + EventHandler &eventHdlr_; + SampleFrameStateCallback fsCb_; + sptr captureConSurface; +}; + +class SampleCameraDeviceCallback : public CameraDeviceCallback { +public: + SampleCameraDeviceCallback() {} + + ~SampleCameraDeviceCallback() {} + + void OnCameraStatus(const std::string cameraId, int32_t status) override + { + if (status == CAMERA_DEVICE_STATE_AVAILABLE) { + g_onCameraAvailableFlag = true; + } else if (status == CAMERA_DEVICE_STATE_UNAVAILABLE) { + g_onCameraUnavailableFlag = true; + } + } +}; + +/* + * Feature: Camera + * Function: GetCameraIds + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: Get Camera IDs, main camera should be returned + */ +HWTEST_F(CameraModuleTest, media_camera_GetCameraId_test_001, TestSize.Level1) +{ + CameraKit *cameraKit = CameraKit::GetInstance(); + list camList; + string camId; + EventHandler eventHdlr; + CameraModuleTest::GetCameraId(cameraKit, camList, camId); + EXPECT_FALSE(camId.empty()); + EXPECT_EQ("main", camId); + cameraKit = nullptr; +} + +/* + * Feature: Camera + * Function: GetCameraAbility + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: Camera Ability should not be null + */ +HWTEST_F(CameraModuleTest, media_camera_GetCameraAbility_test_001, TestSize.Level1) +{ + CameraKit *cameraKit = CameraKit::GetInstance(); + list camList; + string camId; + EventHandler eventHdlr; + CameraModuleTest::GetCameraId(cameraKit, camList, camId); + SampleCameraStateMng camStateMng(eventHdlr); + EXPECT_EQ(g_onGetCameraAbilityFlag, true); + cameraKit = nullptr; +} + +/* + * Feature: Camera + * Function: CreateCamera + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: CreateCamera should create "main" CameraImpl object successfully + */ +HWTEST_F(CameraModuleTest, media_camera_CreateCamerakit_test_001, TestSize.Level1) +{ + CameraKit *cameraKit = CameraKit::GetInstance(); + list camList; + string camId; + EventHandler eventHdlr; + CameraModuleTest::GetCameraId(cameraKit, camList, camId); + SampleCameraStateMng camStateMng(eventHdlr); + sleep(1); + cameraKit->CreateCamera(camId, camStateMng, eventHdlr); + sleep(1); + EXPECT_EQ(g_onCreatedFlag, true); + EXPECT_NE(g_onCreateFailedFlag, true); + EXPECT_NE(camStateMng.cam_, nullptr); + cameraKit = nullptr; +} + +/* + * Feature: Camera + * Function: CreateCamera + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: CreateCamera should not create "0" camera object + */ +HWTEST_F(CameraModuleTest, media_camera_CreateCamerakit_test_002, TestSize.Level1) +{ + CameraKit *cameraKit = CameraKit::GetInstance(); + cameraKit = CameraKit::GetInstance(); + string camId = "0"; + EventHandler eventHdlr; + SampleCameraStateMng camStateMng(eventHdlr); + sleep(1); + cameraKit->CreateCamera(camId, camStateMng, eventHdlr); + sleep(1); + EXPECT_EQ(g_onCreatedFlag, false); + EXPECT_EQ(g_onCreateFailedFlag, true); + cameraKit = nullptr; +} + +/* + * Feature: Camera + * Function: CameraDeviceCallback + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: creation of CameraDeviceCallback object should not fail + */ +HWTEST_F(CameraModuleTest, media_camera_DeviceCallback_test_001, TestSize.Level1) +{ + SampleCameraDeviceCallback *deviceCallback = nullptr; + deviceCallback = new SampleCameraDeviceCallback(); + EXPECT_NE(nullptr, deviceCallback); + delete deviceCallback; + deviceCallback = nullptr; +} + +/* + * Feature: Camera + * Function: RegisterCameraDeviceCallback + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: Registering of CameraDeviceCallback should be success + */ +HWTEST_F(CameraModuleTest, media_camera_RegisterCameraDeviceCallback_test_001, + TestSize.Level1) +{ + CameraKit *cameraKit = CameraKit::GetInstance(); + list camList; + string camId; + EventHandler eventHdlr; + CameraModuleTest::GetCameraId(cameraKit, camList, camId); + SampleCameraStateMng camStateMng(eventHdlr); + SampleCameraDeviceCallback *deviceCallback = nullptr; + deviceCallback = new SampleCameraDeviceCallback(); + ASSERT_NE(nullptr, deviceCallback); + cameraKit->RegisterCameraDeviceCallback(*deviceCallback, eventHdlr); + sleep(1); + EXPECT_EQ(g_onCameraAvailableFlag, true); + delete deviceCallback; + deviceCallback = nullptr; + cameraKit = nullptr; +} + +/* + * Feature: Camera + * Function: UnregisterCameraDeviceCallback + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: Unregistering of CameraDeviceCallback should be success + */ +HWTEST_F(CameraModuleTest, media_camera_UnregisterCameraDeviceCallback_test_001, + TestSize.Level1) +{ + CameraKit *cameraKit = CameraKit::GetInstance(); + list camList; + string camId; + EventHandler eventHdlr; + CameraModuleTest::GetCameraId(cameraKit, camList, camId); + SampleCameraStateMng camStateMng(eventHdlr); + SampleCameraDeviceCallback *deviceCallback = nullptr; + deviceCallback = new SampleCameraDeviceCallback(); + ASSERT_NE(nullptr, deviceCallback); + cameraKit->RegisterCameraDeviceCallback(*deviceCallback, eventHdlr); + sleep(1); + EXPECT_EQ(g_onCameraAvailableFlag, true); + cameraKit->UnregisterCameraDeviceCallback(*deviceCallback); + sleep(1); + EXPECT_EQ(g_onCameraUnavailableFlag, false); + delete deviceCallback; + deviceCallback = nullptr; + cameraKit = nullptr; +} + +/* + * Feature: Camera + * Function: GetSupportedSizes + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: Checks if GetSupportedSizes returns the correct resolution + */ +HWTEST_F(CameraModuleTest, media_camera_GetSupportedSizes_test_001, TestSize.Level1) +{ + CameraKit *cameraKit = CameraKit::GetInstance(); + list camList; + string camId; + EventHandler eventHdlr; + CameraModuleTest::GetCameraId(cameraKit, camList, camId); + EXPECT_EQ(g_onGetSupportedSizesFlag, true); + cameraKit = nullptr; +} + +/* + * Feature: Camera + * Function: GetCameraId + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: Checks if setting of cameraconfig to camera is success + */ +HWTEST_F(CameraModuleTest, media_camera_OnConfigure_test_001, TestSize.Level1) +{ + CameraKit *cameraKit = CameraKit::GetInstance(); + list camList; + string camId; + EventHandler eventHdlr; + CameraModuleTest::GetCameraId(cameraKit, camList, camId); + SampleCameraStateMng camStateMng(eventHdlr); + sleep(1); + cameraKit->CreateCamera(camId, camStateMng, eventHdlr); + sleep(1); + EXPECT_EQ(g_onConfigureFlag, true); + EXPECT_NE(camStateMng.cam_, nullptr); + cameraKit = nullptr; +} + +/* + * Feature: Camera + * Function: FrameConfig + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: Checks if creation of FrameConfig object is success + */ +HWTEST_F(CameraModuleTest, media_camera_FrameConfig_test_001, TestSize.Level1) +{ + CameraKit *cameraKit = CameraKit::GetInstance(); + list camList; + string camId; + EventHandler eventHdlr; + CameraModuleTest::GetCameraId(cameraKit, camList, camId); + SampleCameraStateMng camStateMng(eventHdlr); + cameraKit->CreateCamera(camId, camStateMng, eventHdlr); + sleep(1); + FrameConfig *fc = new FrameConfig(FRAME_CONFIG_CAPTURE); + EXPECT_NE(fc, nullptr); + delete fc; + cameraKit = nullptr; +} + +/* + * Feature: Camera + * Function: GetCameraId + * SubFunction: NA + * FunctionPoints: NA + * EnvConditions: NA + * CaseDescription: Checks if the capture is done successfully + */ +HWTEST_F(CameraModuleTest, media_camera_Capture_test_003, TestSize.Level1) +{ + CameraKit *cameraKit = CameraKit::GetInstance(); + list camList; + string camId; + EventHandler eventHdlr; + CameraModuleTest::GetCameraId(cameraKit, camList, camId); + SampleCameraStateMng camStateMng(eventHdlr); + sleep(1); + cameraKit->CreateCamera(camId, camStateMng, eventHdlr); + sleep(1); + camStateMng.Capture(); + sleep(1); + EXPECT_EQ(g_onCaptureTriggerCompletedFlag, true); + EXPECT_EQ(g_onGetFrameConfigureType, true); + EXPECT_EQ(g_onFrameFinishedFlag, true); + EXPECT_NE(g_onFrameErrorFlag, true); + cameraKit = nullptr; +} diff --git a/frameworks/innerkitsimpl/prebuilts/etcs/BUILD.gn b/frameworks/innerkitsimpl/prebuilts/etcs/BUILD.gn new file mode 100644 index 0000000..6fc8170 --- /dev/null +++ b/frameworks/innerkitsimpl/prebuilts/etcs/BUILD.gn @@ -0,0 +1,27 @@ +# Copyright (C) 2021 Huawei Device Co., Ltd. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import("//build/ohos.gni") + +## Install cameradev.ini to /system/etc/ {{{ +ohos_prebuilt_etc("cameradev.ini") { + if (device_type == "Hi3516DV300") { + source = "cameradev_imx335.ini" + } else { + source = "cameradev_imx307.ini" + } + relative_install_dir = "." + part_name = "multimedia_camera_standard" + subsystem_name = "multimedia" +} +## Install cameradev.ini to /system/etc/ }}} diff --git a/frameworks/innerkitsimpl/prebuilts/etcs/cameradev_imx307.ini b/frameworks/innerkitsimpl/prebuilts/etcs/cameradev_imx307.ini new file mode 100644 index 0000000..d700e30 --- /dev/null +++ b/frameworks/innerkitsimpl/prebuilts/etcs/cameradev_imx307.ini @@ -0,0 +1,256 @@ +; +; Copyright (C) 2021 Huawei Device Co., Ltd. +; Licensed under the Apache License, Version 2.0 (the "License"); +; you may not use this file except in compliance with the License. +; You may obtain a copy of the License at +; +; http://www.apache.org/licenses/LICENSE-2.0 +; +; Unless required by applicable law or agreed to in writing, software +; distributed under the License is distributed on an "AS IS" BASIS, +; WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +; See the License for the specific language governing permissions and +; limitations under the License. +; +; ============= VideoMode Specified Configure ============= +[common] +mediamode = "HI_PARAM_MEDIAMODE_1080P_30" + +[common.vcap.pipe.0] +vcappipe_hdl = "0" +vivpssmode = "3"; 0:vi offline,vpss offline, 1:vi offline,vpss online,2:vi online,vpss offline,3:vi online,vpss online,4:vi parallel,vpss offline,5:vi parallel,vpss parallel,6:butt +[common.vcap.pipe.1] +vcappipe_hdl = "3" +vivpssmode = "0"; 0:vi offline,vpss offline, 1:vi offline,vpss online,2:vi online,vpss offline,3:vi online,vpss online,4:vi parallel,vpss offline,5:vi parallel,vpss parallel,6:butt + +; ============= VB Configure ============= +[vb] +max_poolcnt = 2 +[vb.pool.0] +image_width = "1920" +image_height = "1080" +pix_format = "26" +data_bitwidth = "0" +compress_mode = "0" +default_align = "8" +blk_count = "3" +[vb.pool.1] +image_width = "1280" +image_height = "720" +pix_format = "26" +data_bitwidth = "0" +compress_mode = "0" +default_align = "8" +blk_count = "3" +[vb.pool.2] +image_width = "1280" +image_height = "720" +pix_format = "26" +data_bitwidth = "0" +compress_mode = "1" +default_align = "8" +blk_count = "3" +; ============= Vcapture Configure ============= + +[vcap.dev] +sensocnt = "1" +sensor_type0 = "6" +sensor_mode = "0" +sensor_width = "1920";stSize.u32Width +sensor_height = "1080";stSize.u32Width +bas_width = "1920";VI_BAS_SCALE_ATTR_S.stBasSize.u32Width +bas_height = "1080";VI_BAS_SCALE_ATTR_S.stBasSize.u32Height +wdr_mode = "0"; 0:none, 1:build in,2:qudra line, 3:2_1 line, 4:2_1 frame ;VI_WDR_ATTR_S.enWDRMode +data_type = "2"; 0:RAW_8BIT, 1:RAW_10BIT, 2:RAW_12BIT, 3: RAW_14BIT, 4:RAW_16BIT, 5:YUV420_8BIT_NORMAL, 6:YUV420_8BIT_LEGACY, 7: YUV422_8BIT, 8:DATA_TYPE_BUTT; +componentmask0 = "4293918720"; 0xFFF00000 ; au32ComponentMask +componentmask1 = "0" ; 0x00000000;au32ComponentMask +pipecnt = "2" + +[vcap.mipi] +enable = "1"; +combo_dev_t = "0";combo_dev_t +input_mode_t = "0";0:INPUT_MODE_MIPI +mipi_data_rate_t = "0";0:MIPI_DATA_RATE_X1 +img_rect_x = "0" +img_rect_y = "0" +img_rect_w = "1920" +img_rect_h = "1080" +data_type_t = "1" ;2:DATA_TYPE_RAW_12BIT +mipi_wdr_mode_t = "0" +lane_id_num = "2" +lane_id_0 = "0" +lane_id_1 = "2" +lane_id_2 = "-1" +lane_id_3 = "-1" + +[vcap.isp_pub] +enable = "1"; +stWndRect_x = "0"; +stWndRect_y = "0"; +stWndRect_w = "1920"; +stWndRect_h = "1080"; +outImageSize_x = "1920"; +outImageSize_y = "1080"; +frameRate = "30" +enBayer = "0";BAYER_RGGB +wdrMode = "0";WDR_MODE_NONE +snsMode = "0";0 + +[vcap.pipe.0] +chncnt = "1" +enPipeBypassMode = "0"; +bYuvSkip = "0"; +bIspBypass = "0"; +u32MaxW = "1920"; +u32MaxH = "1080"; +enPixFmt = "19"; +enCompressMode = "0"; +enBitWidth = "2"; +bNrEn = "1"; +enNrRefSource = "0"; +bSharpenEn = "1"; +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S +bDiscardProPic = "0"; + +[vcap.pipe.0.chl.0] +out_width = "1920" +out_height = "1080" +enPixelFormat = "26"; +enDynamicRange = "0"; +enVideoFormat = "0"; +enCompressMode = "0"; +bMirror = "0" +bFlip = "0" +u32Depth = "0" +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S + +[vcap.pipe.1] +chncnt = "1" +enPipeBypassMode = "0"; +bYuvSkip = "0"; +bIspBypass = "0"; +u32MaxW = "1920"; +u32MaxH = "1080"; +enPixFmt = "19"; +enCompressMode = "0"; +enBitWidth = "2"; +bNrEn = "1"; +enNrRefSource = "0"; +bSharpenEn = "1"; +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S +bDiscardProPic = "0"; + +[vcap.pipe.1.chl.0] +out_width = "1920" +out_height = "1080" +enPixelFormat = "26"; +enDynamicRange = "0"; +enVideoFormat = "0"; +enCompressMode = "0"; +bMirror = "0" +bFlip = "0" +u32Depth = "0" +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S +; ============= Vprocessor Configure ============= +[vpss.0] +vportcnt = "2" +max_width = "1920" +max_height = "1080" +src_framerate = "30" +dst_framerate = "30" +pix_format = "26" +[vpss.0.vport.0] +enable = "1" +res_width = "1920" +res_height = "1080" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +[vpss.0.vport.1] +enable = "1" +res_width = "1280" +res_height = "720" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +[vpss.0.vport.2] +enable = "1" +res_width = "720" +res_height = "576" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +[vpss.0.extvport.0] +enable = "0" +res_width = "160" +res_height = "120" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +; ============= Vcoder Configure ============= +[venc] +venccnt ="4" +[venc.0] +res_width = "1920" +res_height = "1080" +bufsize = "1258290"; 1920*1080*3/4 bytes +gop = "30" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "10240"; kbps +h264bitrate = "12288" +stat_time = "2"; second +[venc.1] +res_width = "640" +res_height = "360" +bufsize = "230400"; 640*480*3/4 bytes +gop = "30" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "2048"; kbps +h264bitrate = "2048" +stat_time = "2"; second +[venc.2] +res_width = "1920" +res_height = "1080" +bufsize = "1258290"; +gop = "0" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "0"; kbps +h264bitrate = "0" +stat_time = "2"; second +[venc.3] +res_width = "320" +res_height = "180" +bufsize = "57600"; bytes +gop = "0" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "0"; Kbps +h264bitrate = "0" +stat_time = "2"; second diff --git a/frameworks/innerkitsimpl/prebuilts/etcs/cameradev_imx335.ini b/frameworks/innerkitsimpl/prebuilts/etcs/cameradev_imx335.ini new file mode 100644 index 0000000..5c5bf80 --- /dev/null +++ b/frameworks/innerkitsimpl/prebuilts/etcs/cameradev_imx335.ini @@ -0,0 +1,272 @@ +; +; Copyright (C) 2021 Huawei Device Co., Ltd. +; Licensed under the Apache License, Version 2.0 (the "License"); +; you may not use this file except in compliance with the License. +; You may obtain a copy of the License at +; +; http://www.apache.org/licenses/LICENSE-2.0 +; +; Unless required by applicable law or agreed to in writing, software +; distributed under the License is distributed on an "AS IS" BASIS, +; WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +; See the License for the specific language governing permissions and +; limitations under the License. +; +; ============= VideoMode Specified Configure ============= +[common] +mediamode = "HI_PARAM_MEDIAMODE_1080P_30" + +[common.vcap.pipe.0] +vcappipe_hdl = "0" +vivpssmode = "0"; 0:vi offline,vpss offline, 1:vi offline,vpss online,2:vi online,vpss offline,3:vi online,vpss online,4:vi parallel,vpss offline,5:vi parallel,vpss parallel,6:butt +[common.vcap.pipe.1] +vcappipe_hdl = "3" +vivpssmode = "0"; 0:vi offline,vpss offline, 1:vi offline,vpss online,2:vi online,vpss offline,3:vi online,vpss online,4:vi parallel,vpss offline,5:vi parallel,vpss parallel,6:butt + +; ============= VB Configure ============= +[vb] +max_poolcnt = 5 +[vb.pool.0] +image_width = "2592" +image_height = "1944" +pix_format = "26" +data_bitwidth = "0" +compress_mode = "0" +default_align = "8" +blk_count = "3" +[vb.pool.1] +image_width = "1920" +image_height = "1080" +pix_format = "19" +data_bitwidth = "0" +compress_mode = "0" +default_align = "8" +blk_count = "3" +[vb.pool.2] +image_width = "1280" +image_height = "720" +pix_format = "26" +data_bitwidth = "0" +compress_mode = "1" +default_align = "8" +blk_count = "3" +[vb.pool.3] +image_width = "1944" +image_height = "2592" +pix_format = "26" +data_bitwidth = "0" +compress_mode = "0" +default_align = "8" +blk_count = "16" +[vb.pool.4] +image_width = "720" +image_height = "480" +pix_format = "26" +data_bitwidth = "0" +compress_mode = "0" +default_align = "8" +blk_count = "3" +; ============= Vcapture Configure ============= + +[vcap.dev] +sensocnt = "1" +sensor_type0 = "12" +sensor_mode = "0" +sensor_width = "2592";stSize.u32Width +sensor_height = "1944";stSize.u32Width +bas_width = "2592";VI_BAS_SCALE_ATTR_S.stBasSize.u32Width +bas_height = "1944";VI_BAS_SCALE_ATTR_S.stBasSize.u32Height +wdr_mode = "0"; 0:none, 1:build in,2:qudra line, 3:2_1 line, 4:2_1 frame ;VI_WDR_ATTR_S.enWDRMode +data_type = "2"; 0:RAW_8BIT, 1:RAW_10BIT, 2:RAW_12BIT, 3: RAW_14BIT, 4:RAW_16BIT, 5:YUV420_8BIT_NORMAL, 6:YUV420_8BIT_LEGACY, 7: YUV422_8BIT, 8:DATA_TYPE_BUTT; +componentmask0 = "4293918720"; 0xFFF00000 ; au32ComponentMask +componentmask1 = "0" ; 0x00000000;au32ComponentMask +pipecnt = "2" + +[vcap.mipi] +enable = "1"; +combo_dev_t = "0";combo_dev_t +input_mode_t = "0";0:INPUT_MODE_MIPI +mipi_data_rate_t = "0";0:MIPI_DATA_RATE_X1 +img_rect_x = "0" +img_rect_y = "0" +img_rect_w = "2592" +img_rect_h = "1944" +data_type_t = "1" ;2:DATA_TYPE_RAW_12BIT +mipi_wdr_mode_t = "0" +lane_id_num = "4" +lane_id_0 = "0" +lane_id_1 = "1" +lane_id_2 = "2" +lane_id_3 = "3" + +[vcap.isp_pub] +enable = "1"; +stWndRect_x = "0"; +stWndRect_y = "0"; +stWndRect_w = "2592"; +stWndRect_h = "1944"; +outImageSize_x = "2592"; +outImageSize_y = "1944"; +frameRate = "30" +enBayer = "0";BAYER_RGGB +wdrMode = "0";WDR_MODE_NONE +snsMode = "0";0 + +[vcap.pipe.0] +chncnt = "1" +enPipeBypassMode = "0"; +bYuvSkip = "0"; +bIspBypass = "0"; +u32MaxW = "2592"; +u32MaxH = "1944"; +enPixFmt = "19"; +enCompressMode = "0"; +enBitWidth = "2"; +bNrEn = "1"; +enNrRefSource = "0"; +bSharpenEn = "1"; +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S +bDiscardProPic = "0"; + +[vcap.pipe.0.chl.0] +out_width = "2592" +out_height = "1944" +enPixelFormat = "26"; +enDynamicRange = "0"; +enVideoFormat = "0"; +enCompressMode = "0"; +bMirror = "0" +bFlip = "0" +u32Depth = "0" +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S + +[vcap.pipe.1] +chncnt = "1" +enPipeBypassMode = "0"; +bYuvSkip = "0"; +bIspBypass = "0"; +u32MaxW = "2592"; +u32MaxH = "1944"; +enPixFmt = "19"; +enCompressMode = "0"; +enBitWidth = "2"; +bNrEn = "1"; +enNrRefSource = "0"; +bSharpenEn = "1"; +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S +bDiscardProPic = "0"; + +[vcap.pipe.1.chl.0] +out_width = "2592" +out_height = "1944" +enPixelFormat = "26"; +enDynamicRange = "0"; +enVideoFormat = "0"; +enCompressMode = "0"; +bMirror = "0" +bFlip = "0" +u32Depth = "0" +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S +; ============= Vprocessor Configure ============= +[vpss.0] +vportcnt = "3" +max_width = "2592" +max_height = "1944" +src_framerate = "30" +dst_framerate = "30" +pix_format = "26" +[vpss.0.vport.0] +enable = "1" +res_width = "2592" +res_height = "1944" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +[vpss.0.vport.1] +enable = "1" +res_width = "1920" +res_height = "1080" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +[vpss.0.vport.2] +enable = "1" +res_width = "720" +res_height = "480" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +[vpss.0.extvport.0] +enable = "0" +res_width = "160" +res_height = "120" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +; ============= Vcoder Configure ============= +[venc] +venccnt ="4" +[venc.0] +res_width = "1920" +res_height = "1080" +bufsize = "1258290"; 1920*1080*3/4 bytes +gop = "30" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "10240"; kbps +h264bitrate = "12288" +stat_time = "2"; second +[venc.1] +res_width = "640" +res_height = "360" +bufsize = "230400"; 640*480*3/4 bytes +gop = "30" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "2048"; kbps +h264bitrate = "2048" +stat_time = "2"; second +[venc.2] +res_width = "1920" +res_height = "1080" +bufsize = "1258290"; +gop = "0" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "0"; kbps +h264bitrate = "0" +stat_time = "2"; second +[venc.3] +res_width = "320" +res_height = "180" +bufsize = "57600"; bytes +gop = "0" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "0"; Kbps +h264bitrate = "0" +stat_time = "2"; second diff --git a/frameworks/innerkitsimpl/prebuilts/etcs/cameradev_jxf23.ini b/frameworks/innerkitsimpl/prebuilts/etcs/cameradev_jxf23.ini new file mode 100644 index 0000000..f9ef3c3 --- /dev/null +++ b/frameworks/innerkitsimpl/prebuilts/etcs/cameradev_jxf23.ini @@ -0,0 +1,256 @@ +; +; Copyright (C) 2021 Huawei Device Co., Ltd. +; Licensed under the Apache License, Version 2.0 (the "License"); +; you may not use this file except in compliance with the License. +; You may obtain a copy of the License at +; +; http://www.apache.org/licenses/LICENSE-2.0 +; +; Unless required by applicable law or agreed to in writing, software +; distributed under the License is distributed on an "AS IS" BASIS, +; WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +; See the License for the specific language governing permissions and +; limitations under the License. +; +; ============= VideoMode Specified Configure ============= +[common] +mediamode = "HI_PARAM_MEDIAMODE_1080P_30" + +[common.vcap.pipe.0] +vcappipe_hdl = "0" +vivpssmode = "3"; 0:vi offline,vpss offline, 1:vi offline,vpss online,2:vi online,vpss offline,3:vi online,vpss online,4:vi parallel,vpss offline,5:vi parallel,vpss parallel,6:butt +[common.vcap.pipe.1] +vcappipe_hdl = "3" +vivpssmode = "0"; 0:vi offline,vpss offline, 1:vi offline,vpss online,2:vi online,vpss offline,3:vi online,vpss online,4:vi parallel,vpss offline,5:vi parallel,vpss parallel,6:butt + +; ============= VB Configure ============= +[vb] +max_poolcnt = 2 +[vb.pool.0] +image_width = "1920" +image_height = "1080" +pix_format = "26" +data_bitwidth = "0" +compress_mode = "0" +default_align = "8" +blk_count = "3" +[vb.pool.1] +image_width = "1280" +image_height = "720" +pix_format = "26" +data_bitwidth = "0" +compress_mode = "0" +default_align = "8" +blk_count = "3" +[vb.pool.2] +image_width = "1280" +image_height = "720" +pix_format = "26" +data_bitwidth = "0" +compress_mode = "1" +default_align = "8" +blk_count = "3" +; ============= Vcapture Configure ============= + +[vcap.dev] +sensocnt = "1" +sensor_type0 = "21" +sensor_mode = "0" +sensor_width = "1920";stSize.u32Width +sensor_height = "1080";stSize.u32Width +bas_width = "1920";VI_BAS_SCALE_ATTR_S.stBasSize.u32Width +bas_height = "1080";VI_BAS_SCALE_ATTR_S.stBasSize.u32Height +wdr_mode = "0"; 0:none, 1:build in,2:qudra line, 3:2_1 line, 4:2_1 frame ;VI_WDR_ATTR_S.enWDRMode +data_type = "2"; 0:RAW_8BIT, 1:RAW_10BIT, 2:RAW_12BIT, 3: RAW_14BIT, 4:RAW_16BIT, 5:YUV420_8BIT_NORMAL, 6:YUV420_8BIT_LEGACY, 7: YUV422_8BIT, 8:DATA_TYPE_BUTT; +componentmask0 = "4293918720"; 0xFFF00000 ; au32ComponentMask +componentmask1 = "0" ; 0x00000000;au32ComponentMask +pipecnt = "2" + +[vcap.mipi] +enable = "1"; +combo_dev_t = "0";combo_dev_t +input_mode_t = "0";0:INPUT_MODE_MIPI +mipi_data_rate_t = "0";0:MIPI_DATA_RATE_X1 +img_rect_x = "0" +img_rect_y = "0" +img_rect_w = "1920" +img_rect_h = "1080" +data_type_t = "1" ;2:DATA_TYPE_RAW_12BIT +mipi_wdr_mode_t = "0" +lane_id_num = "2" +lane_id_0 = "0" +lane_id_1 = "2" +lane_id_2 = "-1" +lane_id_3 = "-1" + +[vcap.isp_pub] +enable = "1"; +stWndRect_x = "0"; +stWndRect_y = "0"; +stWndRect_w = "1920"; +stWndRect_h = "1080"; +outImageSize_x = "1920"; +outImageSize_y = "1080"; +frameRate = "30" +enBayer = "3";BAYER_BGGR +wdrMode = "0";WDR_MODE_NONE +snsMode = "0";0 + +[vcap.pipe.0] +chncnt = "1" +enPipeBypassMode = "0"; +bYuvSkip = "0"; +bIspBypass = "0"; +u32MaxW = "1920"; +u32MaxH = "1080"; +enPixFmt = "19"; +enCompressMode = "0"; +enBitWidth = "2"; +bNrEn = "1"; +enNrRefSource = "0"; +bSharpenEn = "1"; +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S +bDiscardProPic = "0"; + +[vcap.pipe.0.chl.0] +out_width = "1920" +out_height = "1080" +enPixelFormat = "26"; +enDynamicRange = "0"; +enVideoFormat = "0"; +enCompressMode = "0"; +bMirror = "0" +bFlip = "0" +u32Depth = "0" +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S + +[vcap.pipe.1] +chncnt = "1" +enPipeBypassMode = "0"; +bYuvSkip = "0"; +bIspBypass = "0"; +u32MaxW = "1920"; +u32MaxH = "1080"; +enPixFmt = "19"; +enCompressMode = "0"; +enBitWidth = "2"; +bNrEn = "1"; +enNrRefSource = "0"; +bSharpenEn = "1"; +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S +bDiscardProPic = "0"; + +[vcap.pipe.1.chl.0] +out_width = "1920" +out_height = "1080" +enPixelFormat = "26"; +enDynamicRange = "0"; +enVideoFormat = "0"; +enCompressMode = "0"; +bMirror = "0" +bFlip = "0" +u32Depth = "0" +src_framerate = "30";FRAME_RATE_CTRL_S +dst_framerate = "30";FRAME_RATE_CTRL_S +; ============= Vprocessor Configure ============= +[vpss.0] +vportcnt = "2" +max_width = "1920" +max_height = "1080" +src_framerate = "30" +dst_framerate = "30" +pix_format = "26" +[vpss.0.vport.0] +enable = "1" +res_width = "1920" +res_height = "1080" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +[vpss.0.vport.1] +enable = "1" +res_width = "1280" +res_height = "720" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +[vpss.0.vport.2] +enable = "1" +res_width = "720" +res_height = "576" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +[vpss.0.extvport.0] +enable = "0" +res_width = "160" +res_height = "120" +src_framerate = "30" +dst_framerate = "30" +video_format = "0" +pix_format = "26" +compressMode = "0" +depth = "0" +mirror = "0" +flip = "0" +; ============= Vcoder Configure ============= +[venc] +venccnt ="4" +[venc.0] +res_width = "1920" +res_height = "1080" +bufsize = "1258290"; 1920*1080*3/4 bytes +gop = "30" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "10240"; kbps +h264bitrate = "12288" +stat_time = "2"; second +[venc.1] +res_width = "640" +res_height = "360" +bufsize = "230400"; 640*480*3/4 bytes +gop = "30" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "2048"; kbps +h264bitrate = "2048" +stat_time = "2"; second +[venc.2] +res_width = "1920" +res_height = "1080" +bufsize = "1258290"; +gop = "0" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "0"; kbps +h264bitrate = "0" +stat_time = "2"; second +[venc.3] +res_width = "320" +res_height = "180" +bufsize = "57600"; bytes +gop = "0" +src_framerate = "30" +dst_framerate = "30" +h265bitrate = "0"; Kbps +h264bitrate = "0" +stat_time = "2"; second diff --git a/interfaces/innerkits/native/include/camera.h b/interfaces/innerkits/native/include/camera.h new file mode 100644 index 0000000..f3cc50e --- /dev/null +++ b/interfaces/innerkits/native/include/camera.h @@ -0,0 +1,156 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup MultiMedia_Camera + * @{ + * + * @brief Defines the Camera class for camera-related operations. + * + * @since 1.0 + * @version 1.0 + */ + +/** + * @file camera.h + * + * @brief Declares functions in the Camera class to implement camera + * operations. + * + * + * @since 1.0 + * @version 1.0 + */ + +#ifndef OHOS_CAMERA_H +#define OHOS_CAMERA_H + +#include +#include + +#include "camera_config.h" +#include "frame_config.h" + +namespace OHOS { +namespace Media { +/** + * + * @brief Provides functions in the Camera class to implement camera operations. + * operations. + * + * + * @since 1.0 + * @version 1.0 + */ +class Camera { +public: + /** + * @brief A destructor used to delete the Camera instance. + * + */ + virtual ~Camera() = default; + + /** + * @brief Obtains the camera ID. + * + * @return Returns the camera ID if obtained; returns the "Error" string if + * the camera fails to be created. + */ + virtual std::string GetCameraId() + { + return std::string(); + } + + /** + * @brief Obtains the camera configuration. + * You can use the obtained CameraConfig object to configure the + * camera. + * @return Returns the pointer to the CameraConfig object if obtained; + * returns NULL otherwise. + */ + virtual const CameraConfig *GetCameraConfig() const + { + return nullptr; + } + + /** + * @brief Obtains the frame configuration. + * + * @param type Indicates the type of the frame configuration. + * @return Returns the pointer to the FrameConfig object if obtained; + * returns NULL otherwise. + */ + virtual FrameConfig *GetFrameConfig(int32_t type) + { + return nullptr; + } + + /** + * @brief Configures the camera using the CameraConfig object. + * + * @param config Indicates the pointer to the CameraConfig object. + */ + virtual void Configure(CameraConfig &config) {} + + /** + * @brief Triggers looping-frame capture. + * + * @param fc Indicates the frame configuration. + * @return Returns true if the looping-frame capture is successfully + * started; returns false otherwise. + */ + virtual int32_t TriggerLoopingCapture(FrameConfig &frameConfig) + { + return -1; + } + + /** + * @brief Stops looping-frame capture. + * + * @return Returns true if the looping-frame capture is successfully + * stopped; returns false otherwise. + */ + virtual void StopLoopingCapture() {} + + /** + * @brief Starts single-frame capture. The frame parameters are set through + * the FrameConfig object, and the captured image data is stored in the + * surface of the FrameConfig object. + * + * @param fc Indicates the frame configuration. + * @return Returns true if the single-frame capture is successfully + * started and the data is stored; returns false otherwise. + */ + virtual int32_t TriggerSingleCapture(FrameConfig &frameConfig) + { + return -1; + } + + /** + * @brief Releases the Camera object and associated resources. + * + */ + virtual void Release() {} + +protected: + /** + * @brief A constructor used to create a Camera instance. + * + */ + Camera() = default; +}; +} // namespace Media +} // namespace OHOS +#endif // OHOS_CAMERA_H diff --git a/interfaces/innerkits/native/include/camera_ability.h b/interfaces/innerkits/native/include/camera_ability.h new file mode 100644 index 0000000..88217c1 --- /dev/null +++ b/interfaces/innerkits/native/include/camera_ability.h @@ -0,0 +1,116 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup MultiMedia_CameraAbility + * @{ + * + * @brief Defines the camera capability set for applications to achieve and access the capabilities. + * + * @since 1.0 + * @version 1.0 + */ + +/** + * @file camera_ability.h + * + * @brief Declares functions of the CameraAbility class. + * + * + * @since 1.0 + * @version 1.0 + */ + +#ifndef OHOS_CAMERA_ABILITY_H +#define OHOS_CAMERA_ABILITY_H + +#include "media_log.h" +#include "meta_data.h" + +#include +#include +#include +#include + +namespace OHOS { +namespace Media { +/** + * @brief Declares functions of the CameraAbility class. + * + * + * @since 1.0 + * @version 1.0 + */ +class CameraAbility { +public: + /** + * @brief A constructor used to create a CameraAbility instance. + * + */ + CameraAbility(); + + /** + * @brief A destructor used to delete the CameraAbility instance. + * + */ + virtual ~CameraAbility(); + + /** + * @brief Obtains the supported image sizes for a specified image format. + * + * @return Returns the image size list if obtained; returns empty image list otherwise. + */ + std::list GetSupportedSizes() const; + + /** + * @brief Sets value ranges for a specified parameter. + * + * @param key Indicates the parameter key. + * @param rangeList Indicates the list of parameter value ranges. + * @return Returns SUCCESS if the setting is successful; returns FAIL otherwise. + */ + template int32_t SetParameterRange(uint32_t key, std::list rangeList) + { + if (IsParameterSupport(key)) { + SetSupportParameterRange(key, rangeList); + return MEDIA_OK; + } + return MEDIA_ERR; + } + + /** + * @brief Obtains the parameter value range based on a specified parameter key. + * + * @param key Indicates the parameter key. + * @return Returns the parameter value range if obtained; returns NULL otherwise. + */ + template std::list GetParameterRange(uint32_t key) const + { + if (supportProperties_.find(key) != supportProperties_.end()) { + return GetSupportParameterRange(key); + } + } + +private: + void SetSupportParameterRange(uint32_t key, std::list &rangeList); + std::list GetSupportParameterRange(uint32_t key) const; + bool IsParameterSupport(uint32_t key) const; + + std::map> sizeMap_; + std::set supportProperties_; +}; +} // namespace Media +} // namespace OHOS +#endif // OHOS_CAMERA_ABILITY_H diff --git a/interfaces/innerkits/native/include/camera_config.h b/interfaces/innerkits/native/include/camera_config.h new file mode 100644 index 0000000..3404587 --- /dev/null +++ b/interfaces/innerkits/native/include/camera_config.h @@ -0,0 +1,105 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup MultiMedia_CameraConfig + * @{ + * + * @brief Defines the CameraConfig class for operations on camera configurations. + * + * @since 1.0 + * @version 1.0 + */ + +/** + * @file camera_config.h + * + * @brief Declares functions in the CameraConfig class. + * + * + * @since 1.0 + * @version 1.0 + */ + +#ifndef OHOS_CAMERA_CONFIG_H +#define OHOS_CAMERA_CONFIG_H + +#include "event_handler.h" +#include "frame_state_callback.h" + +namespace OHOS { +namespace Media { +/** + * + * @brief Provides functions to configure camera parameters. + * + * + * @since 1.0 + * @version 1.0 + */ +class CameraConfig { +public: + /** + * @brief A destructor used to delete the CameraAbility instance. + * + */ + virtual ~CameraConfig() {} + + /** + * @brief Creates the CameraConfig instance of this singleton class to configure + * and read the required parameters. + * + * @return Returns the CameraConfig instance if created; returns NULL otherwise. + */ + static CameraConfig *CreateCameraConfig(); + + /** + * @brief Sets a frame state callback to responds to state changes. + * + * @param callback Indicates the frame state callback. + * @param handler Indicates the event handler. + */ + virtual void SetFrameStateCallback(const FrameStateCallback &callback, const EventHandler &handler) {} + + /** + * @brief Obtains the EventHandler object. + * + * @return Returns the pointer to the EventHandler object if obtained; returns NULL otherwise. + */ + virtual EventHandler *GetEventHandler() const + { + return nullptr; + } + + /** + * @brief Obtains a FrameStateCallback object. + * + * @return Returns the pointer to the FrameStateCallback object if obtained; returns NULL otherwise. + */ + virtual FrameStateCallback *GetFrameStateCb() const + { + return nullptr; + } + +protected: + /** + * @brief A constructor used to create a CameraConfig instance. + * + */ + CameraConfig() {} +}; +} // namespace Media +} // namespace OHOS +#endif // OHOS_CAMERA_CONFIG_H diff --git a/interfaces/innerkits/native/include/camera_device_callback.h b/interfaces/innerkits/native/include/camera_device_callback.h new file mode 100644 index 0000000..c70422c --- /dev/null +++ b/interfaces/innerkits/native/include/camera_device_callback.h @@ -0,0 +1,77 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup MultiMedia_CameraDeviceCallback + * @{ + * + * @brief Defines the CameraDeviceCallback class to response to device changes. + * + * @since 1.0 + * @version 1.0 + */ + +/** + * @file camera_device_callback.h + * + * @brief Declares functions in the CameraDeviceCallback class to response to device changes. + * + * + * @since 1.0 + * @version 1.0 + */ + +#ifndef OHOS_CAMERA_DEVICE_CALLBACK_H +#define OHOS_CAMERA_DEVICE_CALLBACK_H + +#include + +namespace OHOS { +namespace Media { +constexpr int32_t CAMERA_DEVICE_STATE_AVAILABLE = 0; +constexpr int32_t CAMERA_DEVICE_STATE_UNAVAILABLE = 1; +/** + * + * @brief Provides functions to response to device changes. + * + * + * @since 1.0 + * @version 1.0 + */ +class CameraDeviceCallback { +public: + /** + * @brief A constructor used to create a CameraDeviceCallback instance. + * + */ + CameraDeviceCallback() = default; + + /** + * @brief A destructor used to delete the CameraDeviceCallback instance. + * + */ + virtual ~CameraDeviceCallback() = default; + + /** + * @brief Called when the camera state changes. + * + * @param cameraId Indicates the camera ID. + * @param status Indicates the camera state. + */ + virtual void OnCameraStatus(const std::string cameraId, int32_t status) {} +}; +} // namespace Media +} // namespace OHOS +#endif // OHOS_CAMERA_DEVICE_CALLBACK_H \ No newline at end of file diff --git a/interfaces/innerkits/native/include/camera_kit.h b/interfaces/innerkits/native/include/camera_kit.h new file mode 100644 index 0000000..590357b --- /dev/null +++ b/interfaces/innerkits/native/include/camera_kit.h @@ -0,0 +1,119 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup MultiMedia_CameraKit + * @{ + * + * @brief Defines the CameraKit class for using camera functionalities. + * @since 1.0 + * @version 1.0 + */ + +/** + * @file camera_kit.h + * + * @brief Declares functions in the CameraKit class. + * + * + * @since 1.0 + * @version 1.0 + */ + +#ifndef OHOS_CAMERA_KIT_H +#define OHOS_CAMERA_KIT_H + +#include +#include + +#include "camera_ability.h" +#include "camera_device_callback.h" +#include "camera_state_callback.h" +#include "event_handler.h" + +namespace OHOS { +namespace Media { +/** + * + * @brief Provides functions in the CameraKit class. + * + * + * @since 1.0 + * @version 1.0 + */ +class CameraKit { +public: + /** + * @brief A destructor used to delete the CameraKit instance. + * + */ + ~CameraKit(); + /** + * @brief Obtains a single instance of the CameraKit. + * @return Returns the CameraKit instance if obtained; returns NULL otherwise. + */ + static CameraKit *GetInstance(); + + /** + * @brief Obtains IDs of cameras that are currently available. + * + * @return Returns the camera IDs if obtained; returns NULL otherwise. + */ + std::list GetCameraIds(); + + /** + * @brief Obtains the camera capability, including the resolutions and frame rates. + * + * @param cameraId Indicates the camera ID. + * @return Returns the CameraAbility object. + */ + const CameraAbility *GetCameraAbility(const std::string cameraId); + + /** + * @brief Registers a camera callback for camera status changes + * and an event callback to respond to a triggered event. + * + * @param callback Indicates the camera callback to register. + * @param handler Indicates the event callback to register. + */ + void RegisterCameraDeviceCallback(CameraDeviceCallback &callback, EventHandler &handler); + + /** + * @brief Unregisters a camera callback. + * + * @param callback Indicates the camera callback to unregister. + */ + void UnregisterCameraDeviceCallback(CameraDeviceCallback &callback); + + /** + * @brief Creates a camera object. + * + * @param cameraId Indicates the camera ID. + * @param callback Indicates the camera callback. + * @param handler Indicates the event callback to register. + */ + void CreateCamera(const std::string &cameraId, CameraStateCallback &callback, EventHandler &handler); + +private: + /** + * @brief A constructor used to create a CameraDeviceCallback instance. + * + */ + CameraKit(); +}; +} // namespace Media +} // namespace OHOS + +#endif // OHOS_CAMERA_KIT_H diff --git a/interfaces/innerkits/native/include/camera_state_callback.h b/interfaces/innerkits/native/include/camera_state_callback.h new file mode 100644 index 0000000..757497b --- /dev/null +++ b/interfaces/innerkits/native/include/camera_state_callback.h @@ -0,0 +1,94 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + + /** + * @addtogroup MultiMedia_CameraStateCallback + * @{ + * + * @brief Provides callbacks for camera states to configure responses to the states. + * + * @since 1.0 + * @version 1.0 + */ + /** + * @file camera_state_callback.h + * + * @brief Declares functions in the CameraStateCallback class. + * + * @since 1.0 + * @version 1.0 + */ +#ifndef OHOS_CAMERA_STATE_CALLBACK_H +#define OHOS_CAMERA_STATE_CALLBACK_H + +#include +#include "camera.h" + +namespace OHOS { +namespace Media { +/** +* +* @brief Provides functions to response to camera states. +* +* @since 1.0 +* @version 1.0 +*/ +class CameraStateCallback { +public: + /** + * @brief A constructor used to create a CameraStateCallback instance. + * + */ + CameraStateCallback() = default; + /** + * @brief A destructor used to delete the CameraStateCallback instance. + * + */ + virtual ~CameraStateCallback() {} + /** + * @brief Called when the camera is successfully created. + * + * @param c Indicates the Camera object. + */ + virtual void OnCreated(const Camera &c) {} + /** + * @brief Called when the camera fails to be created. + * + * @param cameraId Indicates the camera ID. + * @param errorCode Indicates the error code. + */ + virtual void OnCreateFailed(const std::string cameraId, int32_t errorCode) {} + /** + * @brief Called when the camera is released. + * + * @param c Indicates the Camera object. + */ + virtual void OnReleased(const Camera &c) {} + /** + * @brief Called when the camera is configured. + * @param c camera Indicates the Camera object. + */ + virtual void OnConfigured(const Camera &c) {} + /** + * @brief Called when the camera fails to be configured. + * + * @param c Indicates the Camera object. + * @param errorCode Indicates the error code. + */ + virtual void OnConfigureFailed(const std::string cameraId, int32_t errorCode) {} +}; +} // namespace Media +} // namespace OHOS +#endif // OHOS_CAMERA_STATE_CALLBACK_H diff --git a/interfaces/innerkits/native/include/event_handler.h b/interfaces/innerkits/native/include/event_handler.h new file mode 100644 index 0000000..b82fa5f --- /dev/null +++ b/interfaces/innerkits/native/include/event_handler.h @@ -0,0 +1,71 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef OHOS_EVENTHANDLER_H +#define OHOS_EVENTHANDLER_H + +#include +#include +#include +#include + +namespace OHOS { +namespace Media { +class EventHandler { +public: + EventHandler(); + virtual ~EventHandler(); + /* After construct the event handler, user should check whether the thread is running before post or + * destroy this handler */ + bool IsRunning(); + + template + void Post(const F &f) + { + auto task = new PostTask(f); + std::unique_lock lock(mtx_); + msgQ_.emplace(task); + cv_.notify_all(); + } + +private: + struct EventObj { + EventObj() = default; + virtual ~EventObj(){}; + virtual void Exec(){}; + }; + + std::queue msgQ_; + std::thread *hdlThrd_; + bool running_; + std::condition_variable cv_; + std::mutex mtx_; + + template + struct PostTask : public EventObj { + PostTask(const F &f) : f_(f) {} + const F f_; + void Exec() override + { + f_(); + } + }; + + static void EventDispatch(EventHandler *hdl); +}; +} // namespace Media +} // namespace OHOS + +#endif // OHOS_EVENTHANDLER_H diff --git a/interfaces/innerkits/native/include/frame_config.h b/interfaces/innerkits/native/include/frame_config.h new file mode 100644 index 0000000..22079a5 --- /dev/null +++ b/interfaces/innerkits/native/include/frame_config.h @@ -0,0 +1,142 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup MultiMedia_FrameConfig + * @{ + * + * @brief Defines the FrameConfig class for operations related to frame + * configurations. + * + * @since 1.0 + * @version 1.0 + */ + +/** + * @file frame_config.h + * + * @brief Declares APIs of the FrameConfig class. + * + * + * @since 1.0 + * @version 1.0 + */ + +#ifndef OHOS_FRAME_CONFIG_H +#define OHOS_FRAME_CONFIG_H + +#include "meta_data.h" +#include "surface.h" +#include +#include + +namespace OHOS { +namespace Media { +constexpr int32_t FRAME_CONFIG_PREVIEW = 0; +constexpr int32_t FRAME_CONFIG_RECORD = 1; +constexpr int32_t FRAME_CONFIG_CAPTURE = 2; +/** + * @brief Provides functions to configure frames. + * + * + * @since 1.0 + * @version 1.0 + */ +class FrameConfig { +public: + /** + * @brief A constructor used to create a FrameConfig instance. + * + */ + FrameConfig() = delete; + /** + * @brief A constructor used to create a FrameConfig instance based on the configuration mode. + * + * @param type Indicates the frame configuration mode, which can be FRAME_CONFIG_PREVIEW, + * @FRAME_CONFIG_RECORD, or FRAME_CONFIG_CAPTURE. + */ + FrameConfig(int32_t type); + + /** + * @brief A destructor used to delete the FrameConfig instance. + * + */ + ~FrameConfig() {} + + /** + * @brief Obtains the frame configuration type. + * + * @return Returns the frame configuration type if obtained; returns -1 + * otherwise. + */ + int32_t GetFrameConfigType(); + + /** + * @brief Obtains a list of shared memories (surface objects). + * + * @return Returns the list of shared memories if obtained; returns + * NULL otherwise. + * + */ + std::list GetSurfaces(); + + /** + * @brief Adds a surface (an object of shared memory). + * + * @param surface Indicates the surface to add. + */ + void AddSurface(Surface &surface); + + /** + * @brief Removes a surface (an object of shared memory). + * You can call this function to release the surface when your + * application does not need to obtain data. + * + * @param surface Indicates the surface to remove. + */ + void RemoveSurface(Surface &surface); + + /** + * @brief Sets the common parameter. + * @param key Indicates the common parameter key to set. + * @param value Indicates the common parameter value to set. + */ + template void SetParameter(uint32_t key, const T value) + { + SetValue(key, static_cast(&value)); + } + + /** + * @brief Obtains the value of a common parameter based on its key. For + * details, see {@link CAMERA_FUC_KEY}. + * @param key Indicates the common parameter key. + */ + template void GetParameter(uint32_t key, T &value) + { + T *pvalue = static_cast(GetValue(key)); + if (pvalue != nullptr) { + value = *pvalue; + } + } +private: + int32_t type_; + std::list surfaceList_; + std::map keyMap_; + void *GetValue(uint32_t key); + void SetValue(uint32_t key, const void *value); +}; +} // namespace Media +} // namespace OHOS +#endif // OHOS_FRAME_CONFIG_H diff --git a/interfaces/innerkits/native/include/frame_state_callback.h b/interfaces/innerkits/native/include/frame_state_callback.h new file mode 100644 index 0000000..27c5558 --- /dev/null +++ b/interfaces/innerkits/native/include/frame_state_callback.h @@ -0,0 +1,88 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/** + * @addtogroup MultiMedia_FrameStateCallback + * @{ + * + * @brief Provides callbacks for frame state changes, in which you can implement operations to response to the changes. + * + * @since 1.0 + * @version 1.0 + */ + +/** + * @file camera_kit.h + * + * @brief Declares functions in the FrameStateCallback class. + * + * + * @since 1.0 + * @version 1.0 + */ + +#ifndef OHOS_FRAME_STATE_CALLBACK_H +#define OHOS_FRAME_STATE_CALLBACK_H + +namespace OHOS { +namespace Media { +class Camera; +class FrameConfig; +class FrameResult {}; +/** + * @brief Provides functions to listen for frame states and response to the state changes. + * + * + * @since 1.0 + * @version 1.0 + */ +class FrameStateCallback { +public: + /** + * @brief A constructor used to create a FrameStateCallback instance. + * + */ + FrameStateCallback() = default; + + /** + * @brief A destructor used to delete the FrameStateCallback instance. + * + */ + ~FrameStateCallback() = default; + + /** + * @brief Called when the frame capture is finished. + * + * @param camera Indicates the camera. + * @param frameConfig Indicates the frame configuration. + * @param frameResult Indicates the capture results. + */ + virtual void OnFrameFinished(const Camera &camera, + const FrameConfig &frameConfig, const FrameResult &frameResult) {} + + /** + * @brief Called when the frame capture fails. + * + * @param camera Indicates the camera. + * @param frameConfig Indicates the frame configuration. + * @param errorCode Indicates the error code. + * @param frameResult Indicates the capture results. + */ + virtual void OnFrameError(const Camera &camera, const FrameConfig &frameConfig, + int32_t errorCode, const FrameResult &frameResult) {} +}; +} // namespace Media +} // namespace OHOS +#endif // OHOS_FRAME_STATE_CALLBACK_H diff --git a/interfaces/innerkits/native/include/media_log.h b/interfaces/innerkits/native/include/media_log.h new file mode 100644 index 0000000..4596dd9 --- /dev/null +++ b/interfaces/innerkits/native/include/media_log.h @@ -0,0 +1,54 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef OHOS_MEDIA_LOG_H +#define OHOS_MEDIA_LOG_H + +#include + +#include "hilog/log.h" + +#undef LOG_DOMAIN +#undef LOG_TAG +#define LOG_DOMAIN 0xD002B00 +#define LOG_TAG "MultiMedia" + +#define __FILENAME__ (__builtin_strrchr(__FILE__, '/') ? __builtin_strrchr(__FILE__, '/') + 1 : __FILE__) + +#ifndef OHOS_DEBUG +#define DECORATOR_HILOG(op, fmt, args...) \ + do { \ + op(LOG_CORE, fmt, ##args); \ + } while (0) +#else +#define DECORATOR_HILOG(op, fmt, args...) \ + do { \ + op(LOG_CORE, "{%s()-%s:%d} " fmt, __FUNCTION__, __FILENAME__, __LINE__, ##args); \ + } while (0) +#endif + +#define MEDIA_DEBUG_LOG(fmt, ...) DECORATOR_HILOG(HILOG_DEBUG, fmt, ##__VA_ARGS__) +#define MEDIA_ERR_LOG(fmt, ...) DECORATOR_HILOG(HILOG_ERROR, fmt, ##__VA_ARGS__) +#define MEDIA_WARNING_LOG(fmt, ...) DECORATOR_HILOG(HILOG_WARN, fmt, ##__VA_ARGS__) +#define MEDIA_INFO_LOG(fmt, ...) DECORATOR_HILOG(HILOG_INFO, fmt, ##__VA_ARGS__) +#define MEDIA_FATAL_LOG(fmt, ...) DECORATOR_HILOG(HILOG_FATAL, fmt, ##__VA_ARGS__) + +#define MEDIA_OK 0 +#define MEDIA_INVALID_PARAM (-1) +#define MEDIA_INIT_FAIL (-2) +#define MEDIA_ERR (-3) +#define MEDIA_PERMISSION_DENIED (-4) + +#endif // OHOS_MEDIA_LOG_H diff --git a/interfaces/innerkits/native/include/meta_data.h b/interfaces/innerkits/native/include/meta_data.h new file mode 100644 index 0000000..ba03058 --- /dev/null +++ b/interfaces/innerkits/native/include/meta_data.h @@ -0,0 +1,100 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#ifndef OHOS_META_DATA_H +#define OHOS_META_DATA_H + +#include "stdint.h" + +#ifdef __cplusplus +#if __cplusplus +extern "C" { +#endif +#endif /* End of #ifdef __cplusplus */ + +typedef struct { + int32_t x; + int32_t y; + int32_t w; + int32_t h; +} CameraRect; + +typedef struct { + uint32_t width; + uint32_t height; +} CameraPicSize; + +typedef enum { + /* Frame rate */ + CAM_FRAME_FPS = 0, + /* Auto exposure mode */ + CAM_AE_MODE, + /* Auto exposure time */ + CAM_AE_EXPO_TIME, + /* Auto exposure compensation value */ + CAM_AE_COMPENSATION, + /* Auto exposure lock */ + CAM_AE_LOCK, + /* Auto exposure region */ + CAM_AE_REGIONS, + /* White balance mode */ + CAM_AWB_MODE, + /* White balance lock */ + CAM_AWB_LOCK, + /* White balance region */ + CAM_AWB_REGION, + /* Video stabilization feature */ + CAM_VIDEO_STABILIZATION_NABLE, + /* Image luminance */ + CAM_IMAGE_LUMA, + /* Image contrast */ + CAM_IMAGE_CONTRAST, + /* Image hue */ + CAM_IMAGE_HUE, + /* Image saturation */ + CAM_IMAGE_SATURATION, + /* Hot pixel correction */ + CAM_HOT_PIXEL_ENABLE, + /* Level of hot pixel correction */ + CAM_HOT_PIXEL_LEVEL, + /* Image denoising mode */ + CAM_IMAGE_DENOISE_MODE, + /* Image denoising level */ + CAM_IMAGE_DENOISE_LEVEL, +} CameraFuncKey; + +/** + @brief Enumerates parameters for image rotation and mirroring. + */ +typedef enum { + CAM_CENTER_MIRROR = 0, /**< Central mirroring */ + CAM_HORIZONTAL_MIRROR = 1, /**< Horizontal mirroring */ + CAM_VETICALLY_MIRROR = 2, /**< Vertical mirroring */ + CAM_ROTATION_90 = 3, /**< 90-degree rotation */ + CAM_ROTATION_180 = 4, /**< 180-degree rotation */ +} CameraInvertMode; + +#define PARAM_KEY_SIZE 0 +#define PARAM_KEY_IMAGE_ENCODE_QFACTOR 1 + +#define ENCODER_TYPE 0 +typedef enum { CAM_ENCODE_JPEG, CAM_ENCODE_H264, CAM_ENCODE_H265, CAM_ENCODE_FORMAT_BUTT } CameraEncodeFormat; + +#ifdef __cplusplus +#if __cplusplus +} +#endif +#endif /* End of #ifdef __cplusplus */ +#endif // OHOS_META_DATA_H \ No newline at end of file diff --git a/interfaces/innerkits/native/test/BUILD.gn b/interfaces/innerkits/native/test/BUILD.gn new file mode 100644 index 0000000..a21e760 --- /dev/null +++ b/interfaces/innerkits/native/test/BUILD.gn @@ -0,0 +1,46 @@ +# Copyright (C) 2021 Huawei Device Co., Ltd. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +import("//build/ohos.gni") + +ohos_executable("camera_sample") { + install_enable = false + sources = [ "camera_sample.cpp" ] + cflags = [ "-Wall" ] + cflags_cc = cflags + include_dirs = [ + "//base/hiviewdfx/hilog/interfaces/native/innerkits/include/", + "//drivers/peripheral/codec/interfaces/include", + "//drivers/peripheral/display/interfaces/include", + "//foundation/graphic/standard/frameworks/surface/include", + "//foundation/graphic/standard/interfaces/kits/surface", + "//foundation/graphic/standard/window_manager/include", + "//foundation/multimedia/camera_standard/frameworks/innerkitsimpl/camera/include", + "//foundation/multimedia/camera_standard/interfaces/innerkits/native/include", + "//utils/native/base/include", + ] + + deps = [ + "//foundation/graphic/standard:libwms_client", + "//foundation/multimedia/camera_standard/frameworks/innerkitsimpl/camera:camera", + "//utils/native/base:utils", + ] + + external_deps = [ + "ipc:ipc_core", + "multimedia_media_standard:recorder", + ] + + part_name = "multimedia_camera_standard" + subsystem_name = "multimedia" +} diff --git a/interfaces/innerkits/native/test/camera_sample.cpp b/interfaces/innerkits/native/test/camera_sample.cpp new file mode 100644 index 0000000..573d1b0 --- /dev/null +++ b/interfaces/innerkits/native/test/camera_sample.cpp @@ -0,0 +1,529 @@ +/* + * Copyright (C) 2021 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include "camera_kit.h" +#include "display_type.h" +#include "meta_data.h" +#include "recorder.h" +#include "window_manager.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +using namespace std; +using namespace OHOS; +using namespace OHOS::Media; +static void SampleSaveCapture(const char &buffer, uint32_t size) +{ + cout << "Start saving picture" << endl; + struct timeval tv = {}; + gettimeofday(&tv, nullptr); + struct tm *ltm = localtime(&tv.tv_sec); + if (ltm != nullptr) { + ostringstream ss("Capture_"); + ss << "Capture" << ltm->tm_hour << "-" << ltm->tm_min << "-" << ltm->tm_sec << ".jpg"; + + ofstream pic("/data/" + ss.str(), ofstream::out | ofstream::trunc); + cout << "write " << size << " bytes" << endl; + pic.write(&buffer, size); + cout << "Saving picture end" << endl; + pic.close(); + } +} + +class SampleRecorderCallback : public RecorderCallback { +public: + void OnError(int32_t errorType, int32_t errorCode) {} + void OnInfo(int32_t type, int32_t extra) {} + virtual ~SampleRecorderCallback() {} +}; + +class SampleFrameStateCallback : public FrameStateCallback { + void OnFrameFinished(const Camera &camera, const FrameConfig &fc, const FrameResult &result) override + { + cout << "Receive frame complete inform." << endl; + if (((FrameConfig &) fc).GetFrameConfigType() == FRAME_CONFIG_CAPTURE) { + cout << "Capture frame received." << endl; + list surfaceList = ((FrameConfig &) fc).GetSurfaces(); + for (Surface *surface : surfaceList) { + sptr buffer; + int32_t flushFence; + int64_t timestamp; + Rect damage; + SurfaceError ret = surface->AcquireBuffer(buffer, flushFence, timestamp, damage); + if (ret == SURFACE_ERROR_OK) { + char *virtAddr = static_cast(buffer->GetVirAddr()); + if (virtAddr != nullptr) { + int32_t bufferSize = stoi(surface->GetUserData("surface_buffer_size")); + SampleSaveCapture(*virtAddr, bufferSize); + } + surface->ReleaseBuffer(buffer, -1); + } + } + delete &fc; + } + } +}; + +class SampleCameraStateMng : public CameraStateCallback { +public: + SampleCameraStateMng() = delete; + explicit SampleCameraStateMng(EventHandler &eventHdlr) : eventHdlr_(eventHdlr) {} + ~SampleCameraStateMng() + { + CloseRecorder(); + if (cam_) { + cam_->Release(); + } + } + void OnCreated(const Camera &c) override + { + cout << "Sample recv OnCreate camera." << endl; + if (((Camera &)c).GetCameraConfig() == nullptr) { + CameraConfig *config = CameraConfig::CreateCameraConfig(); + config->SetFrameStateCallback(fsCb_, eventHdlr_); + ((Camera &)c).Configure(*config); + } + cam_ = (Camera *) &c; + } + void OnCreateFailed(const std::string cameraId, int32_t errorCode) override {} + void OnReleased(const Camera &c) override {} + + Recorder *SampleCreateRecorder() + { + int ret = 0; + int32_t sampleRate = 48000; + int32_t channelCount = 1; + AudioCodecFormat audioFormat = AAC_LC; + AudioSourceType inputSource = AUDIO_MIC; + int32_t audioEncodingBitRate = sampleRate; + VideoSourceType source = VIDEO_SOURCE_SURFACE_ES; + int32_t frameRate = 30; + double fps = 30; + int32_t rate = 4096; + int32_t sourceId = 0; + int32_t audioSourceId = 0; + int32_t width = 1920; + int32_t height = 1080; + VideoCodecFormat encoder = HEVC; + + Recorder *recorder = new Recorder(); + if ((ret = recorder->SetVideoSource(source, sourceId)) != SUCCESS) { + cout << "SetVideoSource failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetVideoEncoder(sourceId, encoder)) != SUCCESS) { + cout << "SetVideoEncoder failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetOutputFormat(FORMAT_MPEG_4)) != SUCCESS) { + cout << "SetOutputFormat failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetVideoSize(sourceId, width, height)) != SUCCESS) { + cout << "SetVideoSize failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetVideoFrameRate(sourceId, frameRate)) != SUCCESS) { + cout << "SetVideoFrameRate failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetVideoEncodingBitRate(sourceId, rate)) != SUCCESS) { + cout << "SetVideoEncodingBitRate failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetCaptureRate(sourceId, fps)) != SUCCESS) { + cout << "SetCaptureRate failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetAudioSource(inputSource, audioSourceId)) != SUCCESS) { + cout << "SetAudioSource failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetAudioEncoder(audioSourceId, audioFormat)) != SUCCESS) { + cout << "SetAudioEncoder failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetAudioSampleRate(audioSourceId, sampleRate)) != SUCCESS) { + cout << "SetAudioSampleRate failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetAudioChannels(audioSourceId, channelCount)) != SUCCESS) { + cout << "SetAudioChannels failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetAudioEncodingBitRate(audioSourceId, audioEncodingBitRate)) != SUCCESS) { + cout << "SetAudioEncodingBitRate failed." << ret << endl; + delete recorder; + return nullptr; + } + if ((ret = recorder->SetMaxDuration(36000)) != SUCCESS) { // 36000s=10h + cout << "SetAudioEncodingBitRate failed." << ret << endl; + delete recorder; + return nullptr; + } + std::shared_ptr recCB = std::make_shared(); + if ((ret = recorder->SetRecorderCallback(recCB)) != SUCCESS) { + delete recorder; + return nullptr; + } + + return recorder; + } + + void CloseRecorder() + { + if (recorder_ != nullptr) { + recorder_->Stop(true); + delete recorder_; + recorder_ = nullptr; + } + } + + int PrepareRecorder() + { + if (cam_ == nullptr) { + cout << "Camera is not ready." << endl; + return -1; + } + if (recorder_ == nullptr) { + recorder_ = SampleCreateRecorder(); + } + if (recorder_ == nullptr) { + cout << "Recorder not available." << endl; + return -1; + } + return SUCCESS; + } + + void StartRecord() + { + if (recordState_ == STATE_RUNNING) { + cout << "Camera is already recording." << endl; + return; + } + int ret = PrepareRecorder(); + if (ret != SUCCESS) { + cout << "PrepareRecorder failed." << endl; + CloseRecorder(); + return; + } + const string path = "/data"; + ret = recorder_->SetOutputPath(path); + if (ret != SUCCESS) { + cout << "SetOutputPath failed. ret=" << ret << endl; + CloseRecorder(); + return; + } + ret = recorder_->Prepare(); + if (ret != SUCCESS) { + cout << "Prepare failed. ret=" << ret << endl; + CloseRecorder(); + return; + } + ret = recorder_->Start(); + if (ret != SUCCESS) { + cout << "recorder start failed. ret=" << ret << endl; + CloseRecorder(); + return; + } + FrameConfig *fc = new FrameConfig(FRAME_CONFIG_RECORD); + Surface *surface = (recorder_->GetSurface(0)).get(); + + int queueSize = 10; + int oneKilobytes = 1024; + int surfaceSize = oneKilobytes * oneKilobytes; + int usage = HBM_USE_CPU_READ | HBM_USE_CPU_WRITE | HBM_USE_MEM_DMA; + surface->SetUserData("surface_width", "1920"); + surface->SetUserData("surface_height", "1080"); + surface->SetQueueSize(queueSize); + surface->SetUserData("surface_size", to_string(surfaceSize)); + surface->SetUserData("surface_stride_Alignment", "8"); + surface->SetUserData("surface_format", to_string(PIXEL_FMT_RGBA_8888)); + surface->SetUserData("surface_usage", to_string(usage)); + surface->SetUserData("surface_timeout", "0"); + + fc->AddSurface(*surface); + ret = cam_->TriggerLoopingCapture(*fc); + if (ret != 0) { + delete fc; + CloseRecorder(); + cout << "camera start recording failed. ret=" << ret << endl; + return; + } + recordConfig = fc; + recordState_ = STATE_RUNNING; + cout << "camera start recording succeed." << endl; + } + + void StartPreview() + { + if (cam_ == nullptr) { + cout << "Camera is not ready." << endl; + return; + } + if (previewState_ == STATE_RUNNING) { + cout << "Camera is already previewing." << endl; + return; + } + + WindowConfig config; + memset_s(&config, sizeof(WindowConfig), 0, sizeof(WindowConfig)); + config.height = 480; + config.width = 480; + config.format = PIXEL_FMT_RGBA_8888; + config.pos_x = 0; + config.pos_y = 0; + + WindowConfig subConfig = config; + subConfig.type = WINDOW_TYPE_VIDEO; + + int queueSize = 10; + window = WindowManager::GetInstance()->CreateWindow(&config); + sptr buffer; + int32_t releaseFence; + BufferRequestConfig requestConfig; + window->GetRequestConfig(requestConfig); + SurfaceError error = window->GetSurface()->RequestBuffer(buffer, releaseFence, requestConfig); + if (error != SURFACE_ERROR_OK) { + cout << "camera request buffer fail, ret=" << error << endl; + return; + } + uint32_t buffSize = buffer->GetSize(); + void *bufferVirAddr = buffer->GetVirAddr(); + if (bufferVirAddr == nullptr) { + cout << "bufferVirAddr is nullptr"; + return; + } + memset_s(bufferVirAddr, buffSize, 0, buffSize); + BufferFlushConfig flushConfig = { + .damage = { + .x = 0, + .y = 0, + .w = requestConfig.width, + .h = requestConfig.height, + }, + .timestamp = 0, + }; + error = window->GetSurface()->FlushBuffer(buffer, -1, flushConfig); + if (error != SURFACE_ERROR_OK) { + cout << "camera flush buffer fail, ret=" << error << endl; + return; + } + + subWindow = WindowManager::GetInstance()->CreateSubWindow(window->GetWindowID(), &subConfig); + subWindow->GetSurface()->SetQueueSize(queueSize); + sptr consumerSurface = subWindow->GetSurface(); + consumerSurface->SetUserData("surface_stride_Alignment", "8"); + consumerSurface->SetUserData("surface_format", to_string(PIXEL_FMT_YCBCR_422_SP)); + consumerSurface->SetUserData("surface_width", "720"); + consumerSurface->SetUserData("surface_height", "480"); + consumerSurface->SetUserData("region_position_x", "0"); + consumerSurface->SetUserData("region_position_y", "0"); + consumerSurface->SetUserData("region_width", "720"); + consumerSurface->SetUserData("region_height", "480"); + + FrameConfig *fc = new FrameConfig(FRAME_CONFIG_PREVIEW); + fc->AddSurface(*consumerSurface); + int32_t ret = cam_->TriggerLoopingCapture(*fc); + if (ret != 0) { + delete fc; + cout << "camera start preview failed. ret=" << ret << endl; + return; + } + previewConfig = fc; + previewState_ = STATE_RUNNING; + cout << "camera start preview succeed." << endl; + } + + class SurfaceListener : public IBufferConsumerListener { + public: + void OnBufferAvailable() override + { + cout << "SurfaceListener OnBufferAvailable"; + } + }; + + void Capture() + { + if (cam_ == nullptr) { + cout << "Camera is not ready." << endl; + return; + } + FrameConfig *fc = new FrameConfig(FRAME_CONFIG_CAPTURE); + + captureConSurface = Surface::CreateSurfaceAsConsumer(); + if (captureConSurface == nullptr) { + delete fc; + cout << "CreateSurface failed" << endl; + return; + } + + sptr listener = new SurfaceListener(); + captureConSurface->RegisterConsumerListener(listener); + auto refSurface = captureConSurface; // to keep the reference count + + int usage = HBM_USE_CPU_READ | HBM_USE_CPU_WRITE | HBM_USE_MEM_DMA; + captureConSurface->SetUserData("surface_width", "1920"); + captureConSurface->SetUserData("surface_height", "1080"); + captureConSurface->SetUserData("surface_stride_Alignment", "8"); + captureConSurface->SetUserData("surface_format", to_string(PIXEL_FMT_RGBA_8888)); + captureConSurface->SetUserData("surface_usage", to_string(usage)); + captureConSurface->SetUserData("surface_timeout", "0"); + fc->AddSurface(*refSurface); + int32_t ret = cam_->TriggerSingleCapture(*fc); + if (ret != 0) { + cout << "TriggerSingleCapture failed" << endl; + delete fc; + } + } + + void Stop() + { + if (cam_ == nullptr) { + cout << "Camera is not ready." << endl; + return; + } + cam_->StopLoopingCapture(); + if (recordState_ == STATE_RUNNING) { + CloseRecorder(); + } + if (recordConfig) { + delete recordConfig; + recordConfig = nullptr; + } + if (previewConfig) { + delete previewConfig; + previewConfig = nullptr; + } + recordState_ = STATE_IDLE; + previewState_ = STATE_IDLE; + } + +private: + enum State : int32_t { STATE_IDLE, STATE_RUNNING, STATE_BUTT }; + State previewState_ = STATE_IDLE; + State recordState_ = STATE_IDLE; + EventHandler &eventHdlr_; + Camera *cam_ = nullptr; + Recorder *recorder_ = nullptr; + SampleFrameStateCallback fsCb_; + sptr captureConSurface; + std::unique_ptr window; + std::unique_ptr subWindow; + FrameConfig *recordConfig = nullptr; + FrameConfig *previewConfig = nullptr; +}; + +class SampleCameraDeviceCallback : public CameraDeviceCallback { +}; + +inline void SampleHelp() +{ + cout << "*******************************************" << endl; + cout << "Select the behavior of avrecorder." << endl; + cout << "1: Capture" << endl; + cout << "2: Record(Press s to stop)" << endl; + cout << "3: Preview(Press s to stop)" << endl; + cout << "q: quit the sample." << endl; + cout << "*******************************************" << endl; +} + +int main() +{ + cout << "Camera sample begin." << endl; + const int supportedPixWidth = 1920; + const int supportedPixHeight = 1080; + + SampleHelp(); + CameraKit *camKit = CameraKit::GetInstance(); + if (camKit == nullptr) { + cout << "Can not get CameraKit instance" << endl; + return 0; + } + list camList = camKit->GetCameraIds(); + string camId; + for (auto &cam : camList) { + cout << "camera name:" << cam << endl; + const CameraAbility *ability = camKit->GetCameraAbility(cam); + /* find camera which fits user's ability */ + list sizeList = ability->GetSupportedSizes(); + for (CameraPicSize picSize: sizeList) { + cout<< "\npicSize.width= "<< picSize.width; + cout<< "\npicSize.height= "<< picSize.height; + if ((picSize.width == supportedPixWidth) && + (picSize.height == supportedPixHeight)) { + cout << "\nGot the 1080p camera"; + camId = cam; + break; + } + } + } + + if (camId.empty()) { + cout << "No available camera.(1080p wanted)" << endl; + return 0; + } + + EventHandler eventHdlr; // Create a thread to handle callback events + SampleCameraStateMng camStateMng(eventHdlr); + + camKit->CreateCamera(camId, camStateMng, eventHdlr); + + char input; + while (cin >> input) { + switch (input) { + case '1': + camStateMng.Capture(); + break; + case '2': + camStateMng.StartRecord(); + break; + case '3': + camStateMng.StartPreview(); + break; + case 's': + camStateMng.Stop(); + break; + case 'q': + camStateMng.Stop(); + cout << "Camera sample end." << endl; + return 0; + default: + SampleHelp(); + break; + } + } +} diff --git a/ohos.build b/ohos.build new file mode 100644 index 0000000..074d752 --- /dev/null +++ b/ohos.build @@ -0,0 +1,40 @@ +{ + "subsystem": "multimedia", + "parts": { + "multimedia_camera_standard": { + "variants": [ + "phone" + ], + "module_list": [ + "//foundation/multimedia/camera_standard/frameworks/innerkitsimpl/camera:camera", + "//foundation/multimedia/camera_standard/frameworks/innerkitsimpl/prebuilts/etcs:cameradev.ini", + "//foundation/multimedia/camera_standard/interfaces/innerkits/native/test:camera_sample" + ], + "inner_kits": [ + { + "type": "none", + "name": "//foundation/multimedia/camera_standard/frameworks/innerkitsimpl/camera:camera", + "header": { + "header_files": [ + "camera.h", + "camera_ability.h", + "camera_config.h", + "camera_device_callback.h", + "camera_kit.h", + "camera_state_callback.h", + "event_handler.h", + "frame_config.h", + "frame_state_callback.h", + "meta_data.h", + "media_log.h" + ], + "header_base": "//foundation/multimedia/camera_standard/interfaces/innerkits/native/include" + } + } + ], + "test_list": [ + "//foundation/multimedia/camera_standard/frameworks/innerkitsimpl/camera/test:cameramoduletest" + ] + } + } +}