@@ -63,13 +63,15 @@
- 请提前加载内核及相关驱动，参考内核及驱动子系统readme。
- 配置合适的配置文件，可以参考applications/sample/camera/media下配置文件，如果适配其他sensor可在开源社区中求助。用户使用时将配置文件放入到开发板/storage/data目录，开发者通过该配置文件可以去适配sensor及分辨率、帧率等能力。
-- 应用接口调用参见applications/sample/camera/media下demo实现。
## 使用
Native应用接口调用可以参考applications/sample/camera/media下demo实现
+
应用开发者使用多媒体接口实现录像、预览和播放音视频，使用可以参考《多媒体开发指南》。
+
例：下面是用户重写事件类的实例
+
用户先创建camerakit组件对象，注册各种事件回调，这些事件回调是用户实现用来响应多媒体模块中事件响应的，之后调用创建camera就可以创建一个操作camera资源的对象，使用这个对象可以启动预览、录像或抓拍取流，及设置取流的相关参数。
```
@@ -456,3 +458,5 @@ multimedia\_services\_media\_lite
multimedia\_utils\_lite
+
+
--
Gitee
From ff25639911a1ad29eb081e62d6b467e033fa895f Mon Sep 17 00:00:00 2001
From: harmony_zhangjian <623595017@qq.com>
Date: Tue, 15 Sep 2020 09:58:29 +0800
Subject: [PATCH 2/2] =?UTF-8?q?update=20docs-en/readme/media-subsystem.md.?=
=?UTF-8?q?=20=E5=90=8C=E6=AD=A5=E5=AA=92=E4=BD=93readme?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs-en/readme/media-subsystem.md | 50 ++++++++++++++++---------------
1 file changed, 26 insertions(+), 24 deletions(-)
diff --git a/docs-en/readme/media-subsystem.md b/docs-en/readme/media-subsystem.md
index 438ddd76052..d201b0d7651 100755
--- a/docs-en/readme/media-subsystem.md
+++ b/docs-en/readme/media-subsystem.md
@@ -1,20 +1,18 @@
-# Media Subsystem
+# Multimedia Subsystem
## Overview
-This repository stores source code information of the multimedia subsystem. It provides unified interfaces for you to develop media applications. With this repository, you can easily obtain media resources and focus on service development.
+This repository stores source code information of the multimedia subsystem. It provides unified interfaces for you to develop media applications. With this repository, you can easily obtain media resources and focus on service development. The following two figures show the framework and service flow of the multimedia subsystem, respectively.
-Based on code information about this repository, the device configuration file is stored in **test\\lite\\devini**. When using the configuration file, you can place it in the **/data** directory of the development board in use. You use the configuration file for the adaption to the sensor, resolution, frame rate, and more.
+**Figure 1** Subsystem architecture
+
-Subsystem architecture
+As shown in Figure 1, the multimedia framework supports the camera, recording, and playback functions. These functions support the development of HarmonyOS JavaScript applications and various kit modules that use media capabilities. The multimedia framework consists of the framework and core service layers. The framework layer provides native APIs and corresponding service implementation for applications. It implements audio/video input and output, audio/video encoding and decoding, as well as video file packing and demultiplexing for camera, recording, and playback services. The core service layer leverages the capabilities provided by the hardware platform to use the underlying hardware and related drivers. In addition, the core server implements file management, storage management, and log management.
-
+**Figure 2** Multimedia service flow
+
-Service process
-
-
-
-As shown in these figures, the multimedia subsystem consists of camera, recorder, and player modules. The camera module provides YUV or RGB, JPEG, and H.264 or H.265 data, which is stored in the surface \(shared memory\); the recorder module packs H.264 or H.265 and AAC data in the surface into MP4 files; the player module demultiplexes the MP4 files into audio and video data, sends the data to corresponding decoders, and then plays the audio and video.
+As shown in Figure 2, the multimedia subsystem consists of camera, recorder, and player modules. The camera module provides YUV or RGB, JPEG, and H.264 or H.265 data, which is stored in the surface \(shared memory\); the recorder module packs H.264 or H.265 and AAC data in the surface into MP4 files; the player module demultiplexes the MP4 files into audio and video data, sends the data to corresponding decoders, and then plays the audio and video.
## Directory Structure
@@ -27,29 +25,29 @@ As shown in these figures, the multimedia subsystem consists of camera, recorder
-
foundation\multimedia\frameworks
+
foundation/multimedia/frameworks
-
Internal framework implementation, including Audio, Camera, and Player.Recorder
+
Internal framework implementation, including Audio, Camera, Player, and Recorder.
-
foundation\multimedia\interfaces\kits
+
foundation/multimedia/interfaces/kits
External header files
-
foundation\multimedia\services\media_lite
+
foundation/multimedia/services/media_lite
Underlying service implementation
-
foundation\multimedia\utils\lite
+
foundation/multimedia/utils/lite
Common module implementation
-
foundation\multimedia\test\lite
+
foundation/multimedia/hals
-
API testing code
+
Header files of multimedia adaptation APIs related to the hardware platform
@@ -58,20 +56,24 @@ As shown in these figures, the multimedia subsystem consists of camera, recorder
## Constraints
- C++11 or later
-- Currently, Hi3516DV300 and Hi3518EV300 are supported, and only Hi3516DV300 supports the playback function.
+- Hi3516DV300 and Hi3518EV300 are supported, and only Hi3516DV300 supports the playback function.
+- By default, Hi3516DV300 supports Sony IMX335, and Hi3518EV300 supports crystalline phase JXF23.
## Installation
- Load the kernel and related drivers before installing the repository. For details, see readme files of kernel and driver subsystems.
-- Modify required configuration files, such as those in **test/devini**. For details, see the _Configuration File Description_. Currently, only IMX335 and IMX327 sensors are supported. For other sensors, seek help from the open source community.
-- For details about how to invoke native APIs, see the demonstration in the **test** directory.
+- Configure a proper configuration file. For details, see the configuration file in **applications/sample/camera/media** directory. If you want to adapt to other sensors, seek help from the open source community. Ensure that the configuration file is stored in the **/storage/data** directory of the development board in use. You can use this configuration file to adapt to the sensor, resolution, and frame rate.
+
+## Usage
-## Use Case
+For details about how to call native APIs, see the demo in the **applications/sample/camera/media** directory.
-You can use media APIs to record, preview, and play audios and videos. Before using these resources, create a **CameraKit** object and register various callbacks to respond to many events in the media module. You create a **Camera** object to operate camera resources, for example, to start preview, recording, and stream capturing, and set related parameters.
+For details about how to call multimedia APIs to implement the video recording, preview, and playback, see _Multimedia Development Guide_.
The following example overrides the event class:
+Create a **CameraKit** object and register various callbacks to respond to many events in the media module. Then, create a **Camera** object to operate camera resources, for example, to start preview, recording, and stream capturing, and set related parameters.
+
```
/*
* Copyright (c) 2020 Huawei Device Co., Ltd.
@@ -429,6 +431,7 @@ EXIT:
cout << "Camera sample end." << endl;
return 0;
}
+
```
## Repositories Involved
@@ -453,5 +456,4 @@ multimedia\_interfaces\_kits\_player\_lite
multimedia\_services\_media\_lite
-multimedia\_utils\_lite
-
+multimedia\_utils\_lite
\ No newline at end of file
--
Gitee